Aller au contenu

STRCPYSCN

Démarrer le télémiroir

En bref

La commande Démarrer la copie d'écran (STRCPYSCN) permet de copier sur votre poste d'affichage les écrans d'un autre poste d'affichage afin d'observer ce qui se passe et de diagnostiquer des problèmes. The Start Copy Screen (STRCPYSCN) command allows you to copy the screens of another display station on your display station to observe what is happening and diagnose problems.

STRCPYSCN se lit STR (Démarrer) + CPYSCN. Sur IBM i, le nom d'une commande associe presque toujours un verbe et un objet.

Syntaxe minimale

STRCPYSCN SRCDEV(…) OUTDEV(…)

Paramètres

  • SRCDEV Unité source obligatoire
  • OUTDEV Unité de sortie obligatoire
  • JOBQ File d'attente de travaux
  • OUTFILE Fichier recevant la sortie
  • OUTMBR Options pour membre de sortie

Astuce : dans une session 5250, tapez STRCPYSCN puis F4 pour l'invite de saisie, et F1 sur un paramètre pour son aide.

Aide IBM i de la commande

Texte du F1, IBM i 7.5 en français (bibliothèque QSYS)

Où s'exécute : Tous les environnements (*ALL)
Compatible multitâche : Non

La commande Démarrer la copie d'écran (STRCPYSCN) permet de copier sur votre poste d'affichage les écrans d'un autre poste d'affichage afin d'observer ce qui se passe et de diagnostiquer des problèmes. The Start Copy Screen (STRCPYSCN) command allows you to copy the screens of another display station on your display station to observe what is happening and diagnose problems.

Si la commande STRCPYSCN est utilisée pour copier des écrans d'une unité source dotée de la fonction d'affichage large vers une unité de sortie dotée d'un affichage de largeur normale, la commande est acceptée, mais les images d'affichage large ne sont pas montrées et un message d'information est envoyé au poste de travail cible pour indiquer que l'écran n'a pas été montré. If the STRCPYSCN command is used to copy displays from a source device that has the wide-display feature to an output device with a regular-width display, the command is accepted, but wide-display images are not shown and an informational message is sent to the target work station indicating that the display was not shown.

Si la commande STRCPYSCN est utilisée pour copier des écrans d'une unité source qui prend en charge les caractères DBCS graphiques, la commande est acceptée et les informations de caractères sont affichées, mais les caractères DBCS graphiques apparaissent sous forme d'octets simples. Aucun message n'est envoyé. If the STRCPYSCN command is used to copy displays from a source device that supports graphic DBCS characters, the command is accepted and character information is shown, but graphic DBCS characters appear as single byte. No message is sent.

Si l'unité de sortie n'est pas l'unité demandeuse, elle ne peut pas être connectée. Si l'unité de sortie est connectée, un message est envoyé au demandeur pour indiquer que l'unité n'est pas disponible pour la copie. Si l'unité source est déconnectée après le début de la copie d'écran, la fonction prend fin automatiquement. If the output device is not the requesting device, then the output device cannot be signed on. If the output device is signed on, a message is sent to the requester indicating that the device is not available for copying. If the source device is signed off after display copy has begun, the function automatically ends.

Remarque :La fonction de copie d'écran peut être arrêtée par l'unité cible. Remarque :The copy display function can be ended by the target device.

Restrictions:

  • L'autorisation doit être donnée par l'utilisateur du poste de travail source. Permission must be given from the user of the source work station.
  • Lorsqu'une demande de début de copie d'images d'écran est effectuée, un message d'interruption est envoyé à l'utilisateur du poste de travail source pour l'informer que ses écrans vont être copiés. L'utilisateur doit répondre à ce message avant que tout écran soit copié. When a request is made to begin display image copying, a break message is sent to the user of the source work station to inform the user that the displays are going to be copied. The user must reply to this message before any displays are copied.
  • *REQUESTER n'est pas valide pour les paramètres SRCDEV ou OUTDEV lorsque la commande est soumise en traitement par lots. *REQUESTER is not valid for the SRCDEV or OUTDEV parameters when the command is submitted to batch.

Paramètres

Mot-clé Description Valeurs possibles Remarques
SRCDEV Unité source Nom, *REQUESTER Obligatoire, positionnel 1
OUTDEV Unité de sortie Nom, *REQUESTER, *NONE Obligatoire, positionnel 2
JOBQ File d'attente de travaux Nom d'objet qualifié Facultatif
Qualificatif 1: File d'attente de travaux Nom, QCTL
Qualificatif 2: Biblio Nom, *LIBL, *CURLIB
OUTFILE Fichier recevant la sortie Valeurs uniques: *NONE
Autres valeurs: Nom d'objet qualifié
Facultatif
Qualificatif 1: Fichier recevant la sortie Nom
Qualificatif 2: Biblio Nom, *LIBL, *CURLIB
OUTMBR Options pour membre de sortie Liste d'éléments Facultatif
Élément 1: Membre recevant la sortie Nom, *FIRST
Élément 2: Remplacement ou ajout enregs *REPLACE, *ADD

Unité source (SRCDEV)

Indique le poste d'affichage utilisé comme source des images d'écran à copier. Specifies the display station that is used as the source for the screen images to be copied.

Ce paramètre est obligatoire. This is a required parameter.

*REQUESTER
Indique que les écrans doivent être copiés à partir du poste d'affichage qui a émis cette commande. Specifies that the screens are to be copied from the display station that issued this command.
nom
Indiquez le nom du poste d'affichage (autre que celui qui a émis cette commande) dont les écrans doivent être copiés. Specify the name of the display station (other than the one that issued this command) whose screens are to be copied.

Unité de sortie (OUTDEV)

Indique l'unité de sortie du processus de copie. Specifies the output device for the copying process.

Ce paramètre est obligatoire. This is a required parameter.

*REQUESTER
Indique que les écrans doivent être copiés vers le poste de travail à partir duquel cette commande est émise. *REQUESTER ne peut pas être indiqué ici s'il est également indiqué pour le paramètre Unité source (SRCDEV). Specifies that screens are to be copied to the work station from which this command is issued. *REQUESTER cannot be specified here if it is also specified for the Unité source (SRCDEV) parameter.
*NONE
Indique que les écrans copiés ne sont pas dirigés vers un poste d'affichage. Si *NONE est indiqué ici, une valeur doit être indiquée pour le paramètre Fichier recevant la sortie (OUTFILE). Specifies that the copied screens do not go to a display station. If *NONE is specified here, then a value must be specified for the Fichier recevant la sortie (OUTFILE) parameter.
nom
Indiquez le nom du poste d'affichage (autre que celui qui a émis cette commande) qui affichera les écrans copiés. Specify the name of the display station (other than the one that issued this command) that will display the copied screens.

File d'attente de travaux (JOBQ)

Indique la file d'attente de travaux utilisée pour soumettre le travail qui affiche les écrans de l'unité source sur l'unité cible lorsque l'unité demandeuse n'est pas l'unité cible. Lorsque *REQUESTER est indiqué pour le paramètre Unité de sortie (OUTDEV), ce paramètre est ignoré, car il prend par défaut les valeurs du poste d'affichage cible et aucune soumission de travail n'est alors nécessaire. Specifies the job queue used to submit the job which shows the screens from the source device on the target device when the requesting device is not the target device. When *REQUESTER is specified on the Unité de sortie (OUTDEV) parameter, this parameter is ignored, since it defaults to the values for the target display station and then a submit job is not necessary.

Qualificatif 1: File d'attente de travaux

QCTL
La file d'attente de travaux QCTL doit être utilisée. Job queue QCTL is to be used.
nom
Indiquez le nom de la file d'attente de travaux dans laquelle le travail qui traitera les écrans copiés doit être soumis. Specify the name of the job queue where the job which will process the copied screens is to be submitted.

Qualificatif 2: Biblio

*LIBL
Toutes les bibliothèques de la liste de bibliothèques de l'unité d'exécution en cours sont recherchées jusqu'à ce que la première occurrence soit trouvée. All libraries in the library list for the current thread are searched until the first match is found.
*CURLIB
La bibliothèque en cours du travail est utilisée pour localiser la file d'attente de travaux. Si la liste de bibliothèques ne comporte aucune entrée de bibliothèque en cours, QGPL est utilisée. The current library for the job is used to locate the job queue. If no current library entry exists in the library list, QGPL is used.
nom
Indiquez le nom de la bibliothèque dans laquelle se trouve la file d'attente de travaux. Specify the name of the library where the job queue is located.

Fichier recevant la sortie (OUTFILE)

Indique le fichier de base de données vers lequel la sortie de la commande est dirigée. Si le fichier n'existe pas, cette commande crée un fichier de base de données dans la bibliothèque indiquée. Si le fichier est créé, les droits publics sur le fichier sont identiques aux droits de création indiqués pour la bibliothèque dans laquelle le fichier est créé. Utilisez la commande Afficher la description de bibliothèque (DSPLIBD) pour afficher les droits de création de la bibliothèque. Specifies the database file to which the output of the command is directed. If the file does not exist, this command creates a database file in the specified library. If the file is created, the public authority for the file is the same as the create authority specified for the library in which the file is created. Use the Display Library Description (DSPLIBD) command to show the library's create authority.

Qualificatif 1: Fichier devant recevoir la sortie Qualificatif 1: File to receive output

nom
Indiquez le nom du fichier de base de données vers lequel la sortie de la commande est dirigée. Specify the name of the database file to which the command output is directed.

Qualificatif 2 : Bibliothèque Qualificatif 2: Library

*LIBL
La liste de bibliothèques est utilisée pour localiser le fichier. Si le fichier est introuvable, un fichier est créé dans la bibliothèque en cours. S'il n'existe pas de bibliothèque en cours, le fichier est créé dans la bibliothèque QGPL. The library list is used to locate the file. If the file is not found, one is created in the current library. If no current library exists, the file will be created in the QGPL library.
*CURLIB
La bibliothèque en cours de l'unité d'exécution est utilisée pour localiser le fichier. Si aucune bibliothèque n'est indiquée comme bibliothèque en cours de l'unité d'exécution, la bibliothèque QGPL est utilisée. The current library for the thread is used to locate the file. If no library is specified as the current library for the thread, the QGPL library is used.
nom
Indiquez le nom de la bibliothèque à rechercher. Specify the name of the library to be searched.

Remarque :Si un nouveau fichier est créé, le fichier système QASCCPY de la bibliothèque système QSYS, dont le nom de format est QSCCPY1, est utilisé comme modèle. Remarque :If a new file is created, system file QASCCPY in system library QSYS with a format name of QSCCPY1 is used as a model.

Options pour membre de sortie (OUTMBR)

Indique le nom du membre de fichier de base de données qui reçoit la sortie de la commande. Specifies the name of the database file member that receives the output of the command.

Élément 1: Member to receive output

*FIRST
Le premier membre du fichier reçoit la sortie. Si OUTMBR(*FIRST) est indiqué et que le membre n'existe pas, le système crée un membre portant le nom du fichier indiqué pour le paramètre Fichier recevant la sortie (OUTFILE). Si le membre existe déjà, vous avez la possibilité d'ajouter les nouveaux enregistrements à la fin du membre existant ou d'effacer le membre avant d'ajouter les nouveaux enregistrements. The first member in the file receives the output. If OUTMBR(*FIRST) is specified and the member does not exist, the system creates a member with the name of the file specified for the File to receive output (OUTFILE) parameter. If the member already exists, you have the option to add new records to the end of the existing member or clear the member and then add the new records.
nom
Indiquez le nom du membre de fichier qui reçoit la sortie. S'il n'existe pas, le système le crée. Specify the name of the file member that receives the output. If it does not exist, the system creates it.

Élément 2: Replace or add records

*REPLACE
Le système efface le membre existant et ajoute les nouveaux enregistrements. The system clears the existing member and adds the new records.
*ADD
Le système ajoute les nouveaux enregistrements à la fin des enregistrements existants. The system adds the new records to the end of the existing records.

Exemples

STRCPYSCN   SRCDEV(WS2)  OUTDEV(*REQUESTER)

Cette commande envoie un message de demande d'information à l'utilisateur du poste de travail WS2. Le message indique que les écrans du poste d'affichage sont sur le point d'être copiés vers un autre poste d'affichage. Si l'utilisateur de cet écran ne souhaite pas que cela se produise, une réponse d'annulation (C) empêche le démarrage de l'opération. Pour autoriser le démarrage de l'opération, l'utilisateur répond au message par la réponse « go » (G). This command sends an inquiry message to the user of work station, WS2. The message indicates that the display station displays are about to be copied to another display station. If the user of that display does not wish this to happen, then a cancel (C) reply prevents the operation from beginning. To allow the operation to begin, the user responds with a go (G) reply to the message.

Messages d'erreur

Messages *ESCAPE *ESCAPE Messages

CPF2207
Non autorisé à utiliser objet &1 de &3 type *&2.
CPF7AF4
La bibliothèque QTEMP n'est pas valide pour le mot clé OUTFILE. Library QTEMP is not valid for OUTFILE keyword.
CPF7AF5
L'unité source ne peut pas être utilisée avec l'unité cible. From device cannot be used with to device.
CPF7AF6
Unité &1 non disponible. Device &1 not available.
CPF7AF7
Le nom d'unité &1 n'est pas correct. Device name &1 not correct.
CPF9845
Erreur lors de l'ouverture du fichier &1.
CPF9860
Erreur lors du traitement du fichier de sortie.

Messages *NOTIFY *NOTIFY Messages

CPI7AF9
Image d'écran non affichée. Screen image not displayed.

© Copyright IBM Corp. Texte d'aide reproduit à des fins de formation.