TRCCPIC

La commande Tracer communications CPI (TRCCPIC) contrôle la trace de toutes les communications CPI qui se produisent dans le travail où la commande est entrée. La commande active ou désactive une trace, et trace (1) les appels de communications CPI émis par un programme et (2) les données envoyées et reçues. The Trace Common Programming Interface Communications (TRCCPIC) command controls tracing of all CPI Communications that occur in the job in which the command is entered. The command sets a trace on or off, and traces (1) CPI Communications calls issued by a program and (2) data that is sent and received.

Au fur et à mesure de leur collecte, les enregistrements de trace sont stockés dans une zone de stockage de trace interne. À la fin de la trace, les enregistrements de trace peuvent être dirigés vers un fichier de sortie spoule ou vers un fichier physique de base de données. As trace records are collected, they are stored in an internal trace storage area. When the trace is ended, the trace records can be directed to a spooled output file or a database physical file.

Si la commande Démarrer travail de service (STRSRVJOB) est entrée avant la commande TRCCPIC, le travail tracé est celui indiqué dans la commande STRSRVJOB. La sortie de trace du travail dont le service est assuré est renvoyée au travail de service une fois la trace désactivée ou une fois le travail terminé. If the Start Service Job (STRSRVJOB) command is entered before the TRCCPIC command, the job that is traced is the one specified on the STRSRVJOB command. The trace output from the serviced job is returned to the servicing job after the trace is set off or after the serviced job has ended.

Restrictions : (1) Le format d'enregistrement du fichier de sortie de base de données doit correspondre au format d'enregistrement du fichier de sortie fourni par IBM, QACM0TRC. (2) L'utilisateur doit avoir reçu un droit spécifique de l'administrateur de la sécurité pour utiliser cette commande. Restrictions: (1) The record format of the database output file must match the record format of the IBM-supplied output file, QACM0TRC. (2) The user must have specific authority from the security officer to use this command.

Paramètres

Option de trace (SET)

Indique si une trace des communications CPI est démarrée ou terminée. Specifies whether a CPI Communications trace is started or ended.

Les valeurs possibles sont : The possible values are:

*ON

La trace est démarrée. Si la zone de stockage de trace est pleine, l'action indiquée par le paramètre TRCFULL est exécutée. The trace is started. If the trace storage area becomes full, the action specified on the TRCFULL parameter is taken.

*OFF

La trace est terminée. Aucune autre information de trace n'est enregistrée et les informations en cours sont écrites dans le fichier de sortie spoule ou dans un fichier de base de données. The trace is ended. No other trace information is recorded, and the current information is written to the spooled output file or a database file.

*END

La trace est terminée. Aucune autre information de trace n'est enregistrée et toutes les informations de trace en cours sont supprimées. Aucune sortie n'est générée. The trace ends. No other trace information is recorded and all current trace information is deleted. No output is generated.

Mémoire maxi à utiliser (MAXSTG)

Indique la quantité maximale de mémoire (en kilooctets) utilisée pour les enregistrements de trace créés. Specifies the maximum amount of storage (in kilobytes) used for the created trace records.

Les valeurs possibles sont : The possible values are:

200

Jusqu'à 200 Ko de mémoire sont utilisés pour les enregistrements de trace. Up to 200KB of storage is used for trace records.

number-of-kilobytes

Indiquez le nombre de kilooctets de mémoire à utiliser pour les enregistrements de trace. Les valeurs valides vont de 1 à 16000. Specify the number of kilobytes of storage to use for trace records. Valid values range from 1 through 16000.

Trace pleine (TRCFULL)

Indique l'action exécutée lorsque la mémoire maximale indiquée est pleine. Specifies the action taken when the maximum storage specified is full.

Les valeurs possibles sont : The possible values are:

*WRAP

Lorsque la zone de stockage de trace est pleine, les nouvelles informations de trace écrasent les anciennes, à partir du début de la zone de stockage. When the trace storage area is full, new trace information is written over the old information, starting at the beginning of the storage area.

*STOPTRC

Lorsque la zone de stockage de trace est pleine, aucune nouvelle information de trace n'est sauvegardée. When the trace storage area is full, no new trace information is saved.

Longueur données utilisateur (DTALEN)

Indique la longueur maximale (en octets) des données utilisateur pouvant être sauvegardées pour chaque entrée de trace dans la zone de stockage. Si la valeur indiquée est supérieure à la longueur des données reçues ou envoyées sur la ligne de communication, seules les données réelles sont tracées. Si la valeur indiquée est inférieure à la longueur des données reçues ou envoyées, seule la longueur de données indiquée par ce paramètre est tracée. Specifies the maximum length (in bytes) of user data that can be saved for each trace entry in the storage area. If the value specified is greater than the length of data received or sent across the communications line, only the actual data is traced. If the value specified is less than the data length received or sent, only the data length specified on this parameter is traced.

Les valeurs possibles sont : The possible values are:

128

La longueur maximale des données utilisateur sauvegardées est de 128 octets. The maximum length of user data saved is 128 bytes.

number-of-bytes

Indiquez la longueur maximale des données utilisateur sauvegardées. Les valeurs valides vont de 0 à 4096. Specify the maximum length of user data saved. Valid values range from 0 through 4096.

Sortie (OUTPUT)

Indique si la sortie de la commande est affichée sur le poste de travail demandeur ou imprimée avec la sortie spoule du travail. Specifies whether the output from the command is displayed at the requesting work station or printed with the job's spooled output.

Les valeurs possibles sont : The possible values are:

*PRINT

La sortie est imprimée avec la sortie spoule du travail. The output is printed with the job's spooled output.

*OUTFILE

La sortie est dirigée vers le fichier de base de données indiqué pour le paramètre Fichier devant recevoir la sortie (OUTFILE). The output is directed to the database file specified for the File to receive output (OUTFILE) parameter.

Fichier de sortie (OUTFILE)

Indique le nom qualifié du fichier physique dans lequel la sortie de trace est dirigée. Si le fichier existe déjà, le système l'utilise. S'il n'existe pas, le système le crée. Si le fichier est créé, le texte est "Output file for TRCCPIC." Les valeurs possibles pour la bibliothèque sont les suivantes : Specifies the qualified name of the physical file to which the trace output is directed. If the file already exists, the system uses it. If the file does not exist, the system creates it. If the file is created, the text is "Output file for TRCCPIC." The possible library values are:

*LIBL

La liste de bibliothèques est utilisée pour localiser le fichier de base de données. The library list is used to locate the database file.

*CURLIB

La bibliothèque en cours du travail est utilisée pour localiser le fichier de base de données. Si aucune bibliothèque en cours n'est définie pour le travail, la bibliothèque QGPL est utilisée. The current library for the job is used to locate the database file. If no library is specified as the current library for the job, the QGPL library is used.

nom-bibliothèque

Indiquez le nom de la bibliothèque dans laquelle se trouve le fichier de base de données. Specify the name of the library where the database file is located.

file-name

Indiquez le nom du fichier physique de base de données auquel la sortie de trace est envoyée. Specify the name of the physical database file to which the trace output is sent.

Options pour membre de sortie (OUTMBR)

Indique le nom du membre du fichier physique qui reçoit la sortie de trace. Si le fichier est créé par le système, un membre est créé avec le nom indiqué dans ce paramètre. Si le fichier existe mais que le membre n'existe pas, un membre portant le nom indiqué est créé. Specifies the name of the member in the physical file that receives the trace output. If the file is created by the system, a member is created with the name specified on this parameter. If the file exists but the member does not, a member with the specified name is created.

Élément 1: Member to Receive Output

*FIRST

Le premier membre du fichier indiqué est utilisé. The first member of the specified file is used.

member-name

Indiquez le nom du membre du fichier qui reçoit la sortie de trace. Specify the name of the member in the file that receives the trace output.

Élément 2: Operation to Perform on Member

*REPLACE

Les nouvelles données remplacent les données existantes. The new data replaces the existing data.

*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

Exemple 1 : Démarrer l'opération de trace Example 1: Starting Trace Operation

TRCCPIC   MAXSTG(350)  DTALEN(256)

Cette commande trace les appels de communications CPI du travail en cours. Le fichier de trace contient 350 Ko de mémoire et reprend au début si cette quantité de mémoire est remplie d'enregistrements de trace. De plus, cette commande trace jusqu'à 256 octets de données utilisateur à chaque opération d'entrée/sortie. This command traces the CPI Communications calls of the current job. The trace file contains 350KB of storage and wraps to the beginning if that amount of storage is filled with trace records. In addition, this command traces up to 256 bytes of user data on each input/output operation.

Exemple 2 : Arrêter l'opération de trace Example 2: Stopping Trace Operation

TRCCPIC   SET(*OFF)  OUTPUT(*OUTFILE)  OUTFILE(TRACELIB/CPICTRACE)
          OUTMBR(TRACEMBR)

Cette commande arrête la trace et dirige la sortie vers le fichier de base de données CPICTRACE de la bibliothèque TRACELIB. La sortie est dirigée vers le membre TRACEMBR. This command stops the trace and directs the output to the database file CPICTRACE in library TRACELIB. The output is directed to the member TRACEMBR.

Messages d'erreur

Messages *ESCAPE *ESCAPE Messages

CPF2C90

La mémoire maximale indiquée est trop petite.

CPF2C94

Une erreur s'est produite lors du traitement de OUTFILE. Trace arrêtée.

CPF3B30

Aucun appel de communications CPI n'a été exécuté. Trace terminée. No CPI-Communications calls were run. Trace ended.

CPF3B31

Le service ou la trace du travail est déjà en cours. Job is already being serviced or traced.

CPF3B32

La trace est déjà désactivée. Trace already off.

CPF3B33

Une erreur inattendue de Tracer communications CPI s'est produite. Unexpected Trace CPI Communications error occurred.

CPF3B34

Impossible de désactiver la trace, trace démarrée à partir d'un autre travail. Cannot deactivate trace, trace started from another job.

CPF3548

L'exécution du travail dont le service est assuré est terminée. Serviced job completed running.

CPF3936

Le travail dont le service est assuré s'est terminé avant le démarrage de la trace. Job being serviced ended before trace started.

CPF9847

Erreur lors de la fermeture du fichier &1 de bibliothèque &2.

CPF9848

Ouverture du membre &3 du fichier &1 de &2 impossible.

CPF9849

Erreur lors du traitement du membre &3 de &1 dans &2.