TRCICF

La commande TRCICF (Tracer ICF) permet de démarrer et d'arrêter le traçage des opérations de langage et des fonctions ICF émises par un programme. Elle peut être lancée à partir d'un écran de saisie de commandes ou d'un programme CL.

Au fur et à mesure que des enregistrements de trace sont collectés, ils sont stockés dans l'espace mémoire du fichier trace interne. Lorsque la trace est terminée, les enregistrements de trace peuvent être dirigés vers un fichier spoule en sortie ou vers un fichier physique base de données.

Si la commande STRSRVJOB est entrée avant la commande TRCICF, le travail tracé est celui qui est indiqué dans la commande STRSRVJOB. Une fois la trace désactivée ou à la fin du travail faisant l'objet d'une maintenance, la sortie de trace provenant de ce travail est renvoyée au travail de maintenance.

Restrictions :

1. Le format d'enregistrement de fichier base de données en sortie doit correspondre à celui du fichier en sortie fourni par IBM, QAIFTRCF.
2. L'utilisateur doit disposer des droits spéciaux accordés par le responsable de la sécurité pour utiliser cette commande.

Paramètres

Option de trace (SET)

Indique si une trace ICF est démarrée, arrêtée ou achevée.

*ON

Indique que la trace ICF est démarrée. Si l'espace mémoire du fichier trace est rempli, l'action indiquée au paramètre TRCFULL est effectuée.

*OFF

Indique que la trace ICF est arrêtée. L'activité ICF n'est plus enregistrée et les enregistrements de traces créés sont envoyés dans le fichier imprimante ou un fichier base de données.

*END

Indique que la trace ICF est terminée et que toute information relative à ce fichier est supprimée. Aucune sortie n'est générée.

Mémoire maxi à utiliser (MAXSTG)

Indique la taille mémoire maximum (en kilo-octets) à utiliser pour créer les enregistrements trace. Ce paramètre n'est admis que si *ON est indiqué à l'invite Option de trace (paramètre SET).

200

Indique que 200 kilo-octets au maximum sont utilisés.

1-16000

Indiquez la mémoire disponible (en kilo-octets) à utiliser pour les enregistrements créés.

Trace pleine (TRCFULL)

Indique si les nouveaux enregistrements de trace doivent remplacer les anciens ou si la trace doit s'arrêter lorsque la capacité mémoire précisée à l'invite Mémoire maxi à utiliser (paramètre MAXSTG) a été utilisée. Ce paramètre n'est admis que si *ON est indiqué à l'invite Option de trace (paramètre SET).

*WRAP

Lorsque la table de trace est pleine, la trace boucle : au fur et à mesure que les enregistrements nouveaux sont créés, ils écrasent les anciens enregistrements.

*STOPTRC

Le traçage s'arrête lorsque la table de trace est pleine. Vous devez entrer la commande TRCICF et la paramètre *OFF pour obtenir la sortie de la trace.

Longueur données utilisateur (DTALEN)

Indique la longueur maximale (en octets) des données utilisateur tracées. Ce paramètre n'est admis que si *ON est indiqué à l'invite Option de trace (paramètre SET).

128

128 octets de données utilisateur sont tracés au maximum.

0-4096

Indiquez le nombre maximum d'octets de données utilisateur à tracer.

Sortie (OUTPUT)

Indique si la sortie générée par la commande doit être affichée sur le poste de travail demandeur, ou imprimée avec la sortie spoule du travail.

*PRINT

Le résultat est placé dans un fichier spoule de la file d'attente en sortie du travail.

*OUTFILE

Le résultat est sauvegardé dans un fichier base de données désigné par l'utilisateur.

Fichier de sortie (OUTFILE)

Indique le nom et la bibliothèque du fichier physique vers lequel la trace ICF est envoyée. Si le fichier base de données existe déjà, son format d'enregistrement doit être identique à celui du fichier de sortie QAIFTRCF, fourni par IBM.

Qualificatif 1 : Fichier de sortie

nom

Indique le nom du fichier physique vers lequel est dirigée la sortie de trace.

Qualificatif 2 : Biblio

*LIBL

Le fichier est recherché dans la liste des bibliothèques.

*CURLIB

Le fichier est recherché dans la bibliothèque en cours du travail. Si cette dernière n'est pas précisée, QGPL est prise par défaut.

nom

Indiquez le nom de la bibliothèque contenant le fichier.

Options pour membre de sortie (OUTMBR)

Indique le nom du membre du fichier physique qui reçoit la sortie de trace. Si le fichier indiqué à l'invite Fichier de sortie (paramètre OUTFILE) est créé par le système, un membre est créé pour le fichier avec le nom indiqué. Si OUTFILE existe sans OUTMBR, un membre portant le nom indiqué sera ajouté. Ce paramètre n'est admis que si SET(*OFF) est indiqué.

Elément 1 : Membre recevant la sortie

*FIRST

Le premier membre du fichier indiqué pour le paramètre OUTFILE reçoit la sortie de trace. Si le fichier est créé et que *FIRST est indiqué, le nom du membre créé est identique à celui du fichier.

nom

Indiquez le nom du membre du fichier indiqué pour le paramètre OUTFILE, destiné à recevoir la sortie de trace.

Elément 2 : Remplacement ou ajout enregs

*REPLACE

Les nouvelles données remplacent les données existantes.

*ADD

Le système ajoute les nouveaux enregistrements à la suite des enregistrements existants.

Exemples

Exemple 1 : démarrage de l'opération de traçage

TRCICF   MAXSTG(350)  DTALEN(256)

Cette commande trace les opérations d'entrée/sortie ICF du travail en cours. Le fichier trace dispose de 350 K de stockage et boucle si l'espace de stockage est saturé par des enregistrements de trace. De plus, cette commande trace jusqu'à 256 octets de données utilisateur sur chaque opération d'entrée/sortie.

Exemple 2 : arrêt de l'opération de traçage

TRCICF   SET(*OFF)  OUTPUT(*OUTFILE)  OUTFILE(TRACELIB/ICFTRACE)
         OUTMBR(TRACEMBR)

Cette commande arrête le traçage et dirige la sortie sur le fichier base de données ICFTRACE dans la bibliothèque TRACELIB. La sortie est dirigée vers le membre TRACEMBR.

Messages d'erreur

Messages *ESCAPE

CPF2C90

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

CPF2C93

Aucun enregistrement de trace n'a été consigné.

CPF2C94

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

CPF2C95

La trace est déjà active.

CPF2C96

La trace est déjà arrêtée.

CPF3B34

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

CPF3205

Fichier non créé.

CPF3501

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

CPF3530

Entrées en conflit dans l'index QSERVICE. Conflicting entries in index QSERVICE.

CPF3548

Serviced job completed running.

CPF3925

Cannot open file &1.

CPF3936

Job being serviced ended before trace started.

CPF3950

Le message d'erreur &2 a été reçu pour le fichier &1. La demande a pris fin. Error message &2 received for file &1. Request ended.

CPF3951

Le fichier &1 ne peut pas être remplacé temporairement par le nom de fichier &2. File &1 cannot be overridden by file name &2.

CPF3969

Erreur lors de la fermeture du fichier &1. La sortie peut être incomplète. Error during close of file &1. Output may not be complete.

CPF5004

Ligne de fin de page détectée pour fichier &1.

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.