TRCINT
Tracer les internes
En bref
La commande Trace interne (TRCINT) est l'interface de commande de l'outil de service Trace du code interne sous licence et sert à l'analyse des incidents. The Trace Internal (TRCINT) command is the command interface to the Trace Licensed Internal Code service tool and is used for problem analysis.
TRCINT se lit TRC
(Tracer) + INT.
Sur IBM i, le nom d'une commande associe presque toujours un verbe et un objet.
Syntaxe minimale
TRCINT SET(…)
Paramètres
-
SETOption de trace obligatoire -
TRCTBLNom de la table de trace Trace table name -
SIZETaille de la table de trace Trace table size -
TRCFULLTrace pleine -
TRCTYPEType de trace -
JOBTravail -
SLTTHDID d'unité d'exécution à inclure Thread ID to include -
SVRTYPEType de serveur Server type -
TASKNom de tâche Task name -
TASKNBRNuméro de tâche Task number -
SLTTRCPNTSélectionner les points de trace Select trace points -
OMTTRCPNTOmettre les points de trace Omit trace points -
STOPTRCPNTArrêt sur point de trace Stop on trace point -
JOBTYPETypes de travaux -
JOBTRCITVIntervalle de trace travaux -
TCPDTADonnées TCP/IP TCP/IP data -
SCKDTADonnées de sockets Sockets data -
DEVUnité -
CTLContrôleur -
LINLigne -
NWIInterface réseau Network interface -
NWSServeur réseau -
RSRCNAMENom de ressource -
OUTDEVUnité de sortie -
TASKINFInformations sur les tâches Task information -
OUTPUTSortie -
OUTFILEFichier recevant la sortie -
OUTMBROptions pour membre de sortie -
WCHMSGSurveiller un message Watch for message -
WCHMSGQFile d'attente de messages surveillée Watched message queue -
WCHJOBTravail surveillé Watched job -
WCHLICLOGSurveiller une entrée du journal LIC Watch for LIC log entry -
WCHPALSurveiller une entrée PAL Watch for PAL entry -
WCHTIMODurée de la surveillance Length of time to watch -
TRCPGMProgramme de trace Trace program -
TRCPGMITVIntervalle -
RUNPTYPriorité d'exécution -
TOSTMFOptions de fichier STREAM Stream file options -
FROMSTMFFichier STREAM d'origine
Astuce : dans une session 5250, tapez TRCINT 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 Trace interne (TRCINT) est l'interface de commande de l'outil de service Trace du code interne sous licence et sert à l'analyse des incidents. Des types de traces spécifiques sont démarrés et arrêtés à l'aide de cette commande. Pendant l'exécution de traces internes précédemment démarrées, des traces internes supplémentaires peuvent être démarrées via cette commande. La sortie créée par la trace est placée dans une table de trace. Les enregistrements de la table de trace peuvent être écrits dans un fichier imprimante spoule, dans un fichier de base de données, dans un fichier STREAM, ou sur bande ou support optique. The Trace Internal (TRCINT) command is the command interface to the Trace Licensed Internal Code service tool and is used for problem analysis. Specific types of traces are started and stopped by using this command. While previously started internal traces are being performed, additional internal traces can be started through this command. The output created by the trace is placed in a trace table. The records from the trace table can be written to a spooled printer file, to a database file, to a stream file, or to tape or optical media.
Restrictions:
- Cette commande est livrée avec le droit public d'exclusion (*EXCLUDE), et le profil utilisateur QSRV est livré avec un droit privé d'utilisation de cette commande. This command is shipped with exclude (*EXCLUDE) public authority and the QSRV user profile is shipped with private authority to use this command.
- Pour utiliser cette commande, vous devez posséder le droit spécial de service (*SERVICE), ou être autorisé à la fonction de trace de service d'IBM i via la prise en charge de l'administration des applications de System i Navigator. La commande Modifier l'utilisation d'une fonction (CHGFCNUSG), avec l'ID de fonction QIBM_SERVICE_TRACE, peut également servir à modifier la liste des utilisateurs autorisés à effectuer des opérations de trace. To use this command, you must have service (*SERVICE) special authority, or be authorized to the Service trace function of IBM i through System i Navigator's Application Administration support. The Change Function Usage (CHGFCNUSG) command, with a function ID of QIBM_SERVICE_TRACE, can also be used to change the list of users that are allowed to perform trace operations.
- Lorsque le paramètre Travail surveillé (WCHJOB) est indiqué, l'émetteur de la commande doit s'exécuter sous un profil utilisateur identique à l'identité utilisateur du travail surveillé, ou sous un profil utilisateur possédant le droit spécial contrôle des travaux (*JOBCTL). Le droit spécial contrôle des travaux (*JOBCTL) est également requis si un nom d'utilisateur générique est indiqué pour le paramètre WCHJOB. When the Watched job (WCHJOB) parameter is specified, the issuer of the command must be running under a user profile which is the same as the job user identity of the job being watched, or the issuer of the command must be running under a user profile which has job control (*JOBCTL) special authority. Job control (*JOBCTL) special authority is also required if a generic user name is specified for the WCHJOB parameter.
- Si vous indiquez un nom d'utilisateur générique dans le paramètre WCHJOB, vous devez posséder le droit spécial tous les objets (*ALLOBJ) ou être autorisé à la fonction Watch any job d'IBM i via la prise en charge de l'administration des applications de System i Navigator. La commande Modifier l'utilisation d'une fonction (CHGFCNUSG), avec l'ID de fonction QIBM_WATCH_ANY_JOB, permet également de modifier la liste des utilisateurs autorisés à démarrer et à arrêter des opérations de surveillance. If you specify a generic user name in the WCHJOB parameter, you must have all object (*ALLOBJ) special authority, or be authorized to the Watch any job function of IBM i through System i Navigator's Application Administration support. The Change Function Usage (CHGFCNUSG) command, with a function ID of QIBM_WATCH_ANY_JOB, can also be used to change the list of users that are allowed to start and end watch operations.
- Vous devez posséder les droits d'exploitation (*OBJOPR) et d'exécution (*EXECUTE) sur le programme d'exit utilisateur s'il est indiqué dans le paramètre Programme de trace (TRCPGM), ainsi que le droit d'exécution (*EXECUTE) sur la bibliothèque dans laquelle se trouve le programme. You must have operational (*OBJOPR) and execute (*EXECUTE) authorities to the user exit program if specified in Trace program (TRCPGM) parameter, and execute (*EXECUTE) authority to the library where the program is located.
- Vous devez posséder le droit d'utilisation (*USE) sur les files d'attente de messages indiquées dans le paramètre File d'attente de messages surveillée (WCHMSGQ), ainsi que le droit d'utilisation (*USE) sur la bibliothèque dans laquelle se trouve la file d'attente de messages. You must have use (*USE) authority to the message queues specified in Watched message queue (WCHMSGQ) parameter, and use (*USE) authority to the library where the message queue is located.
- You must have the following authorities when the Stream file options (TOSTMF) or Fichier STREAM d'origine (FROMSTMF) parameters are specified:
- Droit d'exécution (*X) sur les répertoires du préfixe du chemin d'accès du fichier STREAM. Execute (*X) authority to directories in the path name prefix of the stream file.
- Droit d'écriture (*W) sur le fichier STREAM si le fichier STREAM existe déjà. Write (*W) authority to the stream file if the stream file already exists.
- Droits d'écriture et d'exécution (*WX) sur le répertoire parent du fichier STREAM si le fichier STREAM n'existe pas encore. Write and execute (*WX) authority to the stream file's parent directory if the stream file does not already exist.
- Droit de lecture (*R) sur le fichier STREAM. Read (*R) authority to the stream file.
Paramètres
| Mot-clé | Description | Valeurs possibles | Remarques |
|---|---|---|---|
| SET | Option de trace | *ON, *OFF, *END, *HOLD, *SAVE, *SIZE, *PRINT | Obligatoire, positionnel 1 |
| TRCTBL | Nom de la table de traceTrace table name | Valeur caractère, *SYSDFT | Facultatif |
| SIZE | Taille de la table de traceTrace table size | Valeurs uniques: *NOCHG, *MAX, *MIN Autres valeurs: Liste d'éléments |
Facultatif |
| Élément 1: Nombre d'unités | 1-998000 | ||
| Élément 2: Unit of measure | *KB, *MB | ||
| TRCFULL | Trace pleine | *NOCHG, *WRAP, *STOPTRC | Facultatif, positionnel 4 |
| TRCTYPE | Type de trace | Values (jusqu'à 50 répétitions): 000000-999999, *SVL, *MPL, *TNS, *TTPERF, *ACTCALL, *ALTTCP, *APPCOVRTCP, *APPCPS, *APPNALL, *APPNCPM, *APPNCPPS, *APPNDS, *APPNLM, *APPNMST, *APPNTRS, *AUTMGT, *AUXSTGALL, *AUXSTGMGT, *BSSMGT, *CCIOM, *CLUE, *CMNACCMTH, *CMNTRC, *CMTMGT, *COMMON, *CRPSRV, *CSTALL, *CSTCMN, *CTXMGT, *DBGINT, *DBMGT, *DLUR, *DSPPASTHR, *EREP, *ERRLOG, *EVTMGT, *EXCMGT, *FRCA, *HDWRSC, *HEAPMGT, *IDXMGT, *IFS, *IPCF, *ISCSI, *ISDN, *JRNMGT, *LNKTST, *LODDMP, *MCHOBS, *MITFMALL, *MITFMEVAL, *MITFMHEAP, *MITFMINT, *MITFMMI, *MITFMSTG, *MODMGT, *MOD2, *MSCP, *MSMCALL, *MSMDTL, *M36ALL, *M36ASC, *M36BSC, *M36CSP, *M36DKT, *M36DSK, *M36ILAN, *M36PRT, *M36SDLC, *M36TAP, *M36TRN, *M36WS, *M36X25, *NTBTCP, *OPC, *PASE, *PFRCOLSRV, *PGMBND, *PGMMGT, *PORTUTIL, *PRCMGT, *PRCTBL, *PSEUDOTERM, *PWRMGT, *QMGT, *QSMGT, *RCYMGT, *RMTSPT, *RSCMGT, *SCK, *SCKASCIO, *SCKNET, *SCKOTHER, *SCKOVRMPTN, *SCKOVRPEC, *SCKRSLV, *SCKSEL, *SCKSSL, *SCKSTDIO, *SIG, *SMBSVR, *SPCOBJMGT, *SRCSINK, *STGMGTALL, *STM, *SYNCMGT, *SYSCALL, *SYSJRNMGT, *TCPIP, *TLI, *TRXMGT, *VRTDEVMGT, *VRTIO | Facultatif, positionnel 2 |
| JOB | Travail | Valeurs uniques: *NOCHG Autres valeurs (jusqu'à 10 répétitions): Nom de travail qualifié |
Facultatif |
| Qualificatif 1: Travail | Nom générique, nom, *ALL | ||
| Qualificatif 2: Utilisat | Nom générique, nom, *ALL | ||
| Qualificatif 3: Numéro | 000000-999999, *ALL | ||
| SLTTHD | ID d'unité d'exécution à inclureThread ID to include | Valeurs uniques: *NOCHG, *ALL, *SELECT Autres valeurs (jusqu'à 20 répétitions): Valeur hexadécimale |
Facultatif |
| SVRTYPE | Type de serveurServer type | Valeurs uniques: *ALL, *NOCHG Autres valeurs (jusqu'à 5 répétitions): Nom générique, nom |
Facultatif |
| TASK | Nom de tâcheTask name | Valeurs uniques: *ALL, *NOCHG Autres valeurs (jusqu'à 10 répétitions): Nom générique, nom |
Facultatif |
| TASKNBR | Numéro de tâcheTask number | Valeurs uniques: *ALL, *NOCHG Autres valeurs (jusqu'à 10 répétitions): Valeur hexadécimale |
Facultatif |
| SLTTRCPNT | Sélectionner les points de traceSelect trace points | Valeurs uniques: *NOCHG Autres valeurs (jusqu'à 5 répétitions): Liste d'éléments |
Facultatif |
| Élément 1: Trace point qualifier | 0-65535 | ||
| Élément 2: To trace point qualifier | 0-65535 | ||
| OMTTRCPNT | Omettre les points de traceOmit trace points | Valeurs uniques: *NOCHG Autres valeurs (jusqu'à 5 répétitions): Liste d'éléments |
Facultatif |
| Élément 1: Trace point qualifier | 0-65535 | ||
| Élément 2: To trace point qualifier | 0-65535 | ||
| STOPTRCPNT | Arrêt sur point de traceStop on trace point | Valeurs uniques: *NOCHG Autres valeurs (jusqu'à 4 répétitions): Liste d'éléments |
Facultatif |
| Élément 1: Trace point type | Valeur caractère | ||
| Élément 2: Trace point qualifier | 0-65535 | ||
| Élément 3: Trace point entry | 1-65535 | ||
| Élément 4: Trace point entry offset | Valeur hexadécimale | ||
| Élément 5: Trace point match value | Valeur caractère | ||
| JOBTYPE | Types de travaux | Valeurs uniques: *NONE, *ALL Autres valeurs (jusqu'à 12 répétitions): *DFT, *ASJ, *BCH, *EVK, *INT, *MRT, *RDR, *SBS, *SYS, *WTR, *PDJ, *PJ, *BCI |
Facultatif |
| JOBTRCITV | Intervalle de trace travaux | 0.1-9.9, 0.5 | Facultatif |
| TCPDTA | Données TCP/IPTCP/IP data | Liste d'éléments | Facultatif |
| Élément 1: Protocol | *TCP, *UDP, *ICMP, *IGMP, *ARP, *ICMP6, *RDMA | ||
| Élément 2: Local port | Values (jusqu'à 2 répétitions): 1-65535 | ||
| Élément 3: Remote port | Values (jusqu'à 2 répétitions): 1-65535 | ||
| Élément 4: Local IP address | Valeur caractère | ||
| Élément 5: Remote IP address | Valeur caractère | ||
| Élément 6: Description de ligne | Nom | ||
| Élément 7: Type de ligne | *PPP, *OPC | ||
| SCKDTA | Données de socketsSockets data | Liste d'éléments | Facultatif |
| Élément 1: Address family | *INET, *UNIX, *INET6, *NETBIOS | ||
| Élément 2: Socket type | *STREAM, *DGRAM, *RAW, *SEQPACKET | ||
| Élément 3: Descriptor | Values (jusqu'à 2 répétitions): 0-65535 | ||
| Élément 4: Socket option | *SODEBUG | ||
| DEV | Unité | Valeurs uniques: *NONE Autres valeurs (jusqu'à 16 répétitions): Nom |
Facultatif, positionnel 3 |
| CTL | Contrôleur | Valeurs uniques: *NONE Autres valeurs (jusqu'à 16 répétitions): Liste d'éléments |
Facultatif |
| Élément 1: Contrôleur | Nom | ||
| Élément 2: Attached devices | *NODEV, *ALLDEV | ||
| LIN | Ligne | Valeurs uniques: *NONE Autres valeurs (jusqu'à 16 répétitions): Liste d'éléments |
Facultatif |
| Élément 1: Ligne | Nom | ||
| Élément 2: Attached controllers | *NOCTL, *ALLCTL | ||
| NWI | Interface réseauNetwork interface | Valeurs uniques: *NONE Autres valeurs (jusqu'à 16 répétitions): Nom |
Facultatif |
| NWS | Serveur réseau | Valeurs uniques: *NONE Autres valeurs (jusqu'à 16 répétitions): Nom |
Facultatif |
| RSRCNAME | Nom de ressource | Valeurs uniques: *NONE Autres valeurs (jusqu'à 10 répétitions): Nom |
Facultatif |
| OUTDEV | Unité de sortie | Nom | Facultatif |
| TASKINF | Informations sur les tâchesTask information | *ALL, *TRCREF | Facultatif |
| OUTPUT | Sortie | *PRINT, *OUTFILE, *STMF | Facultatif |
| OUTFILE | Fichier recevant la sortie | 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 | ||
| WCHMSG | Surveiller un messageWatch for message | Valeurs uniques: *NONE Autres valeurs (jusqu'à 5 répétitions): Liste d'éléments |
Facultatif |
| Élément 1: Message to watch | Nom générique, nom, *ALL, *IMMED | ||
| Élément 2: Donnée de comparaison | Valeur caractère, *NONE | ||
| Élément 3: Compare against | *MSGDTA, *FROMPGM, *TOPGM | ||
| Élément 4: Type de message | *ALL, *COMP, *DIAG, *ESCAPE, *INFO, *INQ, *NOTIFY, *SCOPE, *STATUS | ||
| Élément 5: Opérateur relationnel | *GE, *EQ, *GT, *LT, *LE | ||
| Élément 6: Code gravité | 0-99, 00 | ||
| WCHMSGQ | File d'attente de messages surveilléeWatched message queue | Values (jusqu'à 3 répétitions): Liste d'éléments | Facultatif |
| Élément 1: File attente messages |
Valeurs uniques: *SYSOPR, *JOBLOG, *HSTLOG Autres valeurs: Nom d'objet qualifié |
||
| Qualificatif 1: File attente messages | Nom | ||
| Qualificatif 2: Biblio | Nom, *LIBL | ||
| WCHJOB | Travail surveilléWatched job | Valeurs uniques: * Autres valeurs (jusqu'à 5 répétitions): Liste d'éléments |
Facultatif |
| Élément 1: Travail | Nom de travail qualifié | ||
| Qualificatif 1: Travail | Nom générique, nom | ||
| Qualificatif 2: Utilisat | Nom générique, nom | ||
| Qualificatif 3: Numéro | 000001-999999, *ALL | ||
| WCHLICLOG | Surveiller une entrée du journal LICWatch for LIC log entry | Valeurs uniques: *NONE Autres valeurs (jusqu'à 5 répétitions): Liste d'éléments |
Facultatif |
| Élément 1: Major code | Valeur caractère, *ALL | ||
| Élément 2: Minor code | Valeur caractère, *ALL | ||
| Élément 3: Donnée de comparaison | Valeur caractère, *NONE | ||
| Élément 4: Compare against | *ALL, *TDENBR, *TASKNAME, *SVRTYPE, *JOBNAME, *JOBUSR, *JOBNBR, *THDID, *EXCPID, *MODNAME, *MODRUNAME, *MODEPNAME, *MODOFFSET, *MODTSP | ||
| WCHPAL | Surveiller une entrée PALWatch for PAL entry | Valeurs uniques: *NONE Autres valeurs (jusqu'à 5 répétitions): Liste d'éléments |
Facultatif |
| Élément 1: Code SRC | Valeur caractère, *ALL | ||
| Élément 2: Donnée de comparaison | Valeur caractère, *NONE | ||
| Élément 3: Compare against | *RSCNAME, *RSCTYPE, *RSCMODEL | ||
| WCHTIMO | Durée de la surveillanceLength of time to watch | 1-43200, *NOMAX | Facultatif |
| TRCPGM | Programme de traceTrace program | Valeurs uniques: *NONE Autres valeurs: Nom d'objet qualifié |
Facultatif |
| Qualificatif 1 : Programme de traceQualificatif 1: Trace program | Nom | ||
| Qualificatif 2: Biblio | Nom, *LIBL | ||
| TRCPGMITV | Intervalle | 1-9999, *NONE | Facultatif |
| RUNPTY | Priorité d'exécution | 1-99, 25 | Facultatif |
| TOSTMF | Options de fichier STREAMStream file options | Liste d'éléments | Facultatif |
| Élément 1: Stream file | Chemin d'accès | ||
| Élément 2: Remplacer fichier | *NO, *YES | ||
| FROMSTMF | Fichier STREAM d'origine | Chemin d'accès | Facultatif |
Option de trace (SET)
Indique si la trace interne est démarrée, arrêtée, terminée, suspendue ou sauvegardée. Vous pouvez également indiquer si la taille de la table de trace est modifiée, ou si les enregistrements de trace interne précédemment sauvegardés dans un fichier STREAM (STMF) sont convertis en un fichier spoule ou de sortie lisible. Specifies whether internal tracing is started, stopped, ended, held, or saved. You can also specify whether the trace table size is changed, or you can specify whether previous internal trace records saved to a stream file (STMF) are converted into a readable spooled or output file.
Ce paramètre est obligatoire. This is a required parameter.
- *ON
- La collecte des enregistrements de trace interne est démarrée pour les types de trace indiqués dans le paramètre Type de trace (TRCTYPE). Si la table de trace contient déjà des enregistrements de trace, les nouveaux enregistrements y sont ajoutés. Si la table est pleine, l'action indiquée dans le paramètre Trace pleine (TRCFULL) est exécutée. Si un nom de table de trace autre que *SYSDFT est indiqué pour le paramètre TRCTBL et que la table n'existe pas, elle est créée automatiquement. The collection of internal trace records is started for the trace types specified for the Type de trace (TRCTYPE) parameter. If the trace table already contains trace records, the new trace records are added to the table. If the table is full, the action specified for the Trace pleine (TRCFULL) parameter is taken. If a trace table name other than *SYSDFT is specified for the TRCTBL parameter and the table does not exist, it will be automatically created.
- *OFF
- La collecte des enregistrements de trace interne demandée par les commandes Trace interne (TRCINT) précédentes s'arrête, et les enregistrements sont écrits dans le fichier imprimante spoule QPCSMPRT, vidés dans un fichier STREAM ou envoyés dans un fichier de base de données, comme indiqué par le paramètre Sortie (OUTPUT). Collection of internal trace records requested through previous Trace Internal (TRCINT) commands stops, and the records are written to the spooled printer file QPCSMPRT, dumped to a stream file, or sent to a database file as indicated by Sortie (OUTPUT) parameter.
- *END
- La trace interne prend fin et les enregistrements de trace interne sont supprimés. Aucune sortie spoule n'est générée. Si un nom de table de trace autre que *SYSDFT est indiqué pour le paramètre TRCTBL, elle est supprimée automatiquement. Internal tracing ends and the internal trace records are deleted. No spooled output is generated. If a trace table name other than *SYSDFT is specified for the TRCTBL parameter, it will be automatically deleted.
- *HOLD
- Les traces internes sont arrêtées et les enregistrements de trace interne collectés sont conservés dans la table de trace. Les enregistrements conservés peuvent être imprimés ultérieurement si une autre commande Trace interne (TRCINT) est entrée avec *OFF pour cette invite ; ils peuvent aussi être placés sur bande ou support optique si *SAVE est indiqué. Internal traces are stopped, and the collected internal trace records are held in the trace table. Held records can be printed later if another Trace Internal (TRCINT) command is entered that specifies *OFF for this prompt; or, the held records can be put on tape or optical media if *SAVE is specified.
- *SAVE
- Les traces internes sont arrêtées et les enregistrements de trace sont écrits sur une unité de bande ou optique indiquée par le paramètre OUTDEV. Internal traces are stopped, and the trace records are written to a tape or optical device specified by the OUTDEV parameter.
- *SIZE
- La taille de la table de trace est modifiée. La nouvelle taille est indiquée dans le paramètre Taille de la table de trace (SIZE). The size of the trace table is changed. The new size is specified on the Trace table size (SIZE) parameter.
- Les enregistrements de trace interne collectés et dirigés vers un fichier STREAM (STMF) par des commandes Trace interne (TRCINT) précédentes sont écrits dans le fichier imprimante spoule QPCSMPRT ou envoyés dans un fichier de base de données, comme indiqué par le paramètre Sortie (OUTPUT). Internal trace records collected and directed to a stream file (STMF) through previous Trace Internal (TRCINT) commands are written to the spooled printer file QPCSMPRT or sent to a database file as indicated by the Sortie (OUTPUT) parameter.
Nom de la table de trace (TRCTBL)Trace table name (TRCTBL)
Indique la table de trace qui contient les données de trace collectées. Specifies the trace table to hold the collected trace data.
- *SYSDFT
- La table de trace par défaut du système est utilisée. The system default trace table is used.
- nom
- Indiquez le nom de la table de trace à utiliser. Si SET(*ON) est indiqué et que le nom indiqué ne correspond à aucune table de trace existante, une nouvelle table de trace portant le nom indiqué est créée. Specify the name of the trace table to be used. If SET(*ON) is specified and the name specified does not match an existing trace table, a new trace table by the specified name will be created.
Taille de la table de trace (SIZE)Trace table size (SIZE)
Indique la taille de la table de trace. Ce paramètre ne peut être indiqué que si *SIZE est indiqué pour le paramètre Option de trace (SET) ou si SET(*ON) est indiqué et que la trace n'est pas actuellement active pour la table de trace indiquée (paramètre TRCTBL). Specifies the size of the trace table. This parameter can be specified only when *SIZE is specified for the Option de trace (SET) parameter or if SET(*ON) is specified and tracing is not currently active for the trace table specified (TRCTBL parameter).
Remarque : La mémoire indiquée par ce paramètre est immédiatement allouée à partir du pool de mémoire secondaire du système (ASP 1). Cette mémoire n'est pas allouée dynamiquement en fonction des besoins. Cet espace de stockage ne sera pas disponible pour le système, sauf pour enregistrer des informations de trace. Avant d'indiquer une valeur élevée pour ce paramètre, l'espace libre de l'ASP système doit être vérifié. Utilisez la commande Gérer état du système (WRKSYSSTS) pour déterminer la quantité d'espace libre disponible dans l'ASP système. Les performances du système peuvent se dégrader si la taille de l'espace libre de l'ASP système est fortement réduite du fait de la valeur indiquée. Remarque :The storage indicated on this parameter is immediately allocated from the system auxiliary storage pool (ASP 1). This storage is not dynamically allocated as it is needed. This storage space will not be available for use by the system except to record trace-related information. Before specifying a large value on this parameter, the amount of free space in the system ASP should be checked. Use the Work with System Status (WRKSYSSTS) command to determine the amount of available free space in the system ASP. System performance degradation may result if the size of the free space in the system ASP is significantly reduced as a result of the value specified.
Remarque : Si les données tracées transitent par une ligne Ethernet gigabit, la taille de la table de trace doit être supérieure à 128000 kilooctets ou 128 mégaoctets. Remarque :If tracing data over a gigabit Ethernet line the trace table size should be greater than 128000 kilobytes or 128 megabytes.
Valeurs uniques
- *NOCHG
- La taille de la table de trace n'est pas modifiée. Si une nouvelle table de trace est indiquée (paramètre TRCTBL), une taille par défaut de 128 kilooctets est utilisée. The trace table size is not changed. If a new trace table is specified (TRCTBL parameter), a default size of 128 kilobytes will be used.
- *MAX
- La table de trace est définie à sa taille maximale de 258048 mégaoctets. The trace table is set to the maximum size of 258048 megabytes.
- *MIN
- La table de trace est définie à sa taille minimale de 128 kilooctets. The trace table is set to the minimum size of 128 kilobytes.
Élément 1: Nombre d'unités
Indiquez la taille de la table de trace. Specify the size of the trace table.
- 1-998000
- Indiquez la taille de la table de trace en kilooctets ou en mégaoctets. Specify the size of the trace table in kilobytes or megabytes.
Élément 2: Unit of measure
Indique si la valeur indiquée pour le premier élément doit être traitée comme un nombre de kilooctets ou de mégaoctets. Specifies whether the value specified for the first element should be treated as number of kilobytes or number of megabytes.
- *KB
- La taille de la table de trace est indiquée en kilooctets. La plage valide va de 128 à 998000. The trace table size is specified in kilobytes. The valid range is 128 through 998000.
- *MB
- La taille de la table de trace est indiquée en mégaoctets. La plage valide va de 1 à 258048. The trace table size is specified in megabytes. The valid range is 1 through 258048.
Trace pleine (TRCFULL)
Indique si les enregistrements de trace sont écrits de manière circulaire (les plus anciens enregistrements étant remplacés par les nouveaux) ou si la trace s'arrête lorsque la table de trace est pleine. Ce paramètre peut être indiqué lorsque *ON est indiqué pour le paramètre Option de trace (SET). Specifies whether the trace records wrap (replace the oldest records with new records) or tracing stops when the trace table is full. This parameter can be specified when *ON is specified for the Option de trace (SET) parameter.
- *NOCHG
- L'action à exécuter lorsque la table de trace est pleine n'est pas modifiée. Si une nouvelle table de trace est indiquée (paramètre TRCTBL), l'action par défaut consiste à écrire les enregistrements de trace de manière circulaire lorsque la table de trace est pleine. The trace table full action is not changed. If a new trace table is specified (TRCTBL parameter), the default action is for trace records to wrap when the trace table becomes full.
- *WRAP
- Lorsque la table de trace est pleine, la trace reprend au début. Les enregistrements de trace les plus anciens sont écrasés par les nouveaux au fur et à mesure de leur collecte. When the trace table is full, the trace wraps to the beginning. The oldest trace records are written over by new ones as they are collected.
- *STOPTRC
- La trace s'arrête lorsque la table de trace est pleine d'enregistrements de trace. Tracing is stopped when the trace table is full of trace records.
Type de trace (TRCTYPE)
Indique le type de traces à démarrer. Les deux groupes de types de traces sont les suivants : Specifies the type of traces to start. The two groups of trace types are:
- Les codes de trace de données de composant provoquent la trace des procédures actives dans le système. Component data trace codes cause active procedures to be traced within the system.
- Les codes de trace généraux provoquent la trace des fonctions de liaison du superviseur d'instructions, de multiprogrammation, de transaction ou de performances des tâches et des unités d'exécution. General trace codes cause the instruction supervisor linkage, multiprogramming, transaction, or task and thread performance functions to be traced.
Si des types de codes de trace sont indiqués, *ON doit être indiqué pour le paramètre Option de trace (SET). Si une valeur autre que *ON est indiquée pour le paramètre SET, TRCTYPE est ignoré. Chaque type de trace est identifié par une valeur spéciale ou un code à 6 chiffres ; les 6 chiffres doivent être indiqués. Pour obtenir la liste complète des codes de trace et des valeurs spéciales, placez le curseur sur ce paramètre lors de l'invite de cette commande et appuyez sur F4. Indiquez jusqu'à 50 types parmi le tableau de codes suivant : If trace code types are specified, *ON must be specified for the Option de trace (SET) parameter. If a value other than *ON is specified for the SET parameter, TRCTYPE is ignored. Each trace type is identified by a special value or 6-digit code; all 6 digits must be specified. For a complete list of trace codes and special values, position the cursor on this parameter while prompting this command and press F4. Specify up to 50 types from the following code table:
COMPONENT
OR GENERAL SPECIAL
TYPE OF TRACE TRACE CODE VALUE
MI instruction supervisor 030000 *SVL
linkage (SVL)
Multiprogramming level (MPL) 040000 *MPL
Transaction 080000 *TNS
Task/thread performance 090000 *TTPERF
Activation/Call 014400 *ACTCALL
Alternate TCP/IP stack 016900 *ALTTCP
MPTN - APPC over TCP/IP MPTN 014203 *APPCOVRTCP
APPC presentation services 014301 *APPCPS
APPN -- (all) 012506 *APPNALL
APPN control point management 012501 *APPNCPM
APPN control point 012504 *APPNCPPS
presentation services
APPN directory services 012502 *APPNDS
APPN location management 012505 *APPNLM
APPN management services 012507 *APPNMST
transport
APPN topology and routing 012503 *APPNTRS
services
Authority management 010900 *AUTMGT
Auxiliary storage management 011104 *AUXSTGALL
-- detailedd
Auxiliary storage management 011101 *AUXSTGMGT
Byte string space management 012600 *BSSMGT
Common class input/output 011900 *CCIOM
management (CCIOM)
Cluster engine 016402 *CLUE
Communications access method 015900 *CMNACCMTH
Commit management 011700 *CMTMGT
Communications trace service 012300 *CMNTRC
function
Common functions 011200 *COMMON
Cryptographic services 013600 *CRPSRV
Cluster -- (all) 016400 *CSTALL
Cluster communications 016401 *CSTCMN
Context management 011000 *CTXMGT
Debugger interpreter 014500 *DBGINT
Database management (events 010400 *DBMGT
for all database files are
traced)
Dependent LU Requester 015400 *DLUR
(DLUR) Communication
Display station pass-through 010804 *DSPPASTHR
Environmental recording, 012200 *EREP
editing and printing (EREP)
Error log 012100 *ERRLOG Event management 010600 *EVTMGT Exception management 010200 *EXCMGT Fast Response Cache Accelerator 016600 *FRCA Hardware resources 014700 *HDWRSC Heap management 013400 *HEAPMGT Independent index management 011400 *IDXMGT Integrated File System (IFS) 014800 *IFS Inter-process communications 012000 *IPCF facility (IPCF) Internet SCSI host adapter 017000 *ISCSI Communications answer 012700 *ISDN management (ISDN) Journal management 011600 *JRNMGT Link test service function 012400 *LNKTST Load/dump (save/restore) 010801 *LODDMP Machine observation 011300 *MCHOBS Machine Interface (MI) Transformer 015100 *MITFMALL MI Transformer - expression 015101 *MITFMEVAL evaluation MI Transformer - heap operations 015102 *MITFMHEAP MI Transformer - interpreter 015103 *MITFMINT instructions MI Transformer - MI Instructions 015104 *MITFMMI MI Transformer - storage 015105 *MITFMSTG management operations Module management 013100 *MODMGT Modula-2 run time support 012800 *MOD2 Machine services control 010802 *MSCP point Main storage management 011102 *MSMCALL -- calls Main storage management 011103 *MSMDTL -- details NetBios on TCP/IP 015700 *NTBTCP OptiConnect 015500 *OPC Portable Application Solutions 016100 *PASE Environment Performance collection services 016200 *PFRCOLSRV Program binder 013200 *PGMBND Program management 010300 *PGMMGT Portability utilities 015200 *PORTUTIL Process management 010500 *PRCMGT Process table 015300 *PRCTBL Pseudo terminal component 016500 *PSEUDOTERM Power management 012900 *PWRMGT Queue management 010700 *QMGT Queue space management 013300 *QSMGT Recovery management 013500 *RCYMGT Remote Support 016300 *RMTSPT Resource management 010100 *RSCMGT Sockets -- (all APIs) 014000 *SCK Sockets Asynchronous and Overlapped 014002 *SCKASCIO Input/Output APIs Sockets Network APIs 014004 *SCKNET Other Socket APIs 014007 *SCKOTHER MPTN AF_INET Sockets over 014201 *SCKOVRMPTN SNA MPTN MPTN AF_INET Sockets over 014202 *SCKOVRPEC SNA PEC Sockets Berkeley Resolver APIs 014005 *SCKRSLV Sockets Select API 014003 *SCKSEL Secure Sockets Layer (SSL) APIs 014006 *SCKSSL Sockets Standard Input/Output APIs 014001 *SCKSTDIO Signals 015600 *SIG SMB server 015800 *SMBSVR Space object management 011500 *SPCOBJMGT Source/sink (device support) 010803 *SRCSINK management Storage management -- (all) 011105 *STGMGTALL Streams 013900 *STM Synchronization management 013700 *SYNCMGT MI system call 015200 *SYSCALL System journal management 014100 *SYSJRNMGT Transmission Control Protocol/ 013800 *TCPIP Internet Protocol (TCP/IP) Transport Layer Interface 016000 *TLI Transaction Management 016800 *TRXMGT Virtual I/O 016700 *VRTIO Virtual terminal management 013000 *VRTDEVMGT
Remarque : Si le code de trace *TTPERF est indiqué, il doit être le premier de la liste du paramètre TRCTYPE. Remarque :If *TTPERF trace code is specified, it must be the first one in the TRCTYPE parameter list.
Travail (JOB)
Indique les travaux dont les enregistrements de trace doivent être collectés. Seuls les enregistrements de trace générés dans les travaux indiqués sont collectés. Une liste de dix noms de travaux qualifiés au plus peut être indiquée. Les enregistrements de trace sont collectés s'ils ont été générés par un travail correspondant à l'une des valeurs de nom de travail qualifié. Specifies the jobs from which trace records are to be collected. Only trace records which are generated in the specified job(s) are collected. A list of up to ten qualified job names can be specified. The trace records will be collected if they were generated from a job that matches any of the qualified job name values.
Ce paramètre peut être indiqué lorsque *ON est indiqué pour le paramètre Option de trace (SET). Si une valeur autre que *ON est indiquée pour le paramètre SET, JOB est ignoré. This parameter can be specified when *ON is specified for the Option de trace (SET) parameter. If a value other than *ON is specified on the SET parameter, JOB is ignored.
Valeurs uniques
- *NOCHG
- Si des noms de travaux qualifiés avaient été indiqués pour le paramètre JOB dans une commande TRCINT précédente pour une trace active, les informations de filtrage des noms de travaux ne sont pas modifiées. Si aucune valeur n'avait été indiquée dans une commande TRCINT précédente pour une trace active, *NOCHG se comporte comme *ALL/*ALL/*ALL pour le paramètre JOB. If any qualified job names had been specified for the JOB parameter on a previous TRCINT command for an active trace, the job name filtering information is not changed. If no value was specified on a previous TRCINT command for an active trace, *NOCHG will behave the same as *ALL/*ALL/*ALL for the JOB parameter.
Qualificatif 1: Travail
- *ALL
- Tous les enregistrements de trace générés par la trace définie sont collectés, quel que soit le nom du travail dont ils proviennent. All trace records generated by the defined trace are collected, regardless of what job name the trace record was generated from.
- nom-générique
- Indiquez le nom générique du travail dont les enregistrements de trace doivent être collectés. Un nom générique est une chaîne de caractères d'un ou plusieurs caractères suivis d'un astérisque (*) ; par exemple, ABC*. L'astérisque remplace tous les caractères valides. Un nom de travail générique désigne tous les travaux dont le nom commence par le préfixe générique. Specify the generic name of the job from which trace records are to be collected. A generic name is a character string of one or more characters followed by an asterisk (*); for example, ABC*. The asterisk substitutes for any valid characters. A generic job name specifies all jobs with job name that begin with the generic prefix.
- nom
- Indiquez le nom du travail dont les enregistrements de trace doivent être collectés. Specify the name of the job from which trace records are to be collected.
Qualificatif 2: Utilisat
- *ALL
- Tous les enregistrements de trace générés par la trace définie sont collectés, quel que soit le nom d'utilisateur du travail dont ils proviennent. All trace records generated by the defined trace are collected, regardless of what job user name the trace record was generated from.
- nom-générique
- Indiquez le nom d'utilisateur générique du travail dont les enregistrements de trace doivent être collectés. Un nom générique est une chaîne de caractères d'un ou plusieurs caractères suivis d'un astérisque (*) ; par exemple, ABC*. L'astérisque remplace tous les caractères valides. Un nom d'utilisateur générique désigne tous les travaux dont le nom d'utilisateur commence par le préfixe générique. Specify the generic user name of the job from which trace records are to be collected. A generic name is a character string of one or more characters followed by an asterisk (*); for example, ABC*. The asterisk substitutes for any valid characters. A generic user name specifies all jobs with user names that begin with the generic prefix.
- nom
- Indiquez le nom de l'utilisateur du travail dont les enregistrements de trace doivent être collectés. Specify the name of the user of the job from which trace records are to be collected.
Qualificatif 3: Numéro
- *ALL
- Tous les enregistrements de trace générés par la trace définie sont collectés, quel que soit le numéro du travail dont ils proviennent. *ALL pour le numéro de travail est considéré comme une spécification de travail générique car il trace tous les travaux qui répondent aux qualificatifs de nom de travail et de nom d'utilisateur de travail que vous avez indiqués. All trace records generated by the defined trace are collected, regardless of what job number the trace record was generated from. *ALL for the job number is considered to be a generic job specification because it will trace all jobs that meet the job name and job user name qualifiers that you specified.
- 000000-999999
- Indiquez le numéro de travail pour qualifier plus précisément le nom de travail et le nom d'utilisateur. Vous ne pouvez pas indiquer de numéro de travail si un nom de travail générique ou un nom d'utilisateur générique est indiqué. Specify the job number to further qualify the job name and user name. You cannot specify a job number if a generic job name or generic user name is specified.
ID d'unité d'exécution à inclure (SLTTHD)Thread ID to include (SLTTHD)
Indique les unités d'exécution du travail dont les enregistrements de trace doivent être collectés. Seuls les enregistrements de trace générés dans les unités d'exécution indiquées sont collectés. Un seul travail peut avoir des ID d'unité d'exécution associés. Il doit s'agir du premier nom de travail qualifié indiqué pour le paramètre JOB, et le travail doit être actif. Specifies the job threads from which trace records are to be collected. Only trace records which are generated in the specified thread(s) are collected. There can be only one job that has thread IDs associated with it. It must be the first qualified job name specified for the JOB parameter, and the job must be active.
Valeurs uniques
- *NOCHG
- Si des identificateurs d'unité d'exécution avaient été indiqués pour le paramètre SLTTHD dans une commande TRCINT précédente pour une trace active, les informations de filtrage des ID d'unité d'exécution ne sont pas modifiées. Si aucune valeur n'avait été indiquée dans une commande TRCINT précédente pour une trace active, *NOCHG se comporte comme *ALL pour ce paramètre. If any thread identifiers had been specified for the SLTTHD parameter on a previous TRCINT command for an active trace, the thread ID filtering information is not changed. If no value was specified on a previous TRCINT command for an active trace, *NOCHG will behave the same as *ALL for this parameter.
- *ALL
- Tous les enregistrements de trace générés par la trace définie sont collectés, quel que soit l'ID d'unité d'exécution dont ils proviennent. All trace records generated by the defined trace are collected, regardless of what thread ID the trace record was generated from.
- *SELECT
- Une liste d'identificateurs d'unités d'exécution est affichée ; vous pouvez en sélectionner jusqu'à vingt. Les enregistrements de trace de l'un quelconque des identificateurs d'unités d'exécution sélectionnés sont collectés. *SELECT n'est valide que si la commande TRCINT est exécutée dans un travail interactif. A list of thread identifiers is shown from which you can select up to twenty threads. Trace records from any of the selected thread identifiers are to be collected. *SELECT is only valid if the TRCINT command is run in an interactive job.
Autres valeurs
- hexadecimal-value
- Indiquez l'identificateur de l'unité d'exécution dont les enregistrements de trace doivent être collectés. Jusqu'à vingt identificateurs d'unités d'exécution peuvent être indiqués. Specify the identifier of the thread from which trace records are to be collected. Up to twenty thread identifiers can be specified.
Type de serveur (SVRTYPE)Server type (SVRTYPE)
Indique l'attribut de type de serveur d'un travail ou d'une tâche, utilisé pour déterminer si l'enregistrement de trace est collecté. Seuls les enregistrements de trace générés dans un travail ou une tâche du type de serveur indiqué sont collectés. Pour obtenir la liste des types de serveur possibles, voir Ensemble de rubriques Gestion des travaux de l'IBM i Information Center, à l'adresse http://www.ibm.com/systems/i/infocenter/ Specifies the server type attribute for a job or task which is used to determine whether the trace record is collected. Only trace records which are generated in a job or task with the specified server type are collected. For a list of possible server types, see Ensemble de rubriques Gestion des travaux de l'IBM i Information Center, à l'adresse http://www.ibm.com/systems/i/infocenter/
Valeurs uniques
- *NOCHG
- Si une valeur avait été indiquée pour le type de serveur dans une commande TRCINT précédente pour une trace active, la valeur n'est pas modifiée. Si aucune valeur n'avait été indiquée dans une commande TRCINT précédente, *NOCHG se comporte comme *ALL pour ce paramètre. If a value was specified for the server type on a previous TRCINT command for an active trace, the value is not changed. If no value was specified on a previous TRCINT command, *NOCHG will behave the same as *ALL for this parameter.
- *ALL
- Tous les enregistrements de trace générés par la trace définie sont collectés, quel que soit l'attribut de type de serveur du travail ou de la tâche dont ils proviennent. All trace records generated by the defined trace are collected, regardless of the server type attribute of the job or task the trace record was generated from.
Autres valeurs
- nom-générique
- Indique le type de serveur générique pour lequel les enregistrements de trace doivent être collectés. Un nom générique est une chaîne de caractères d'un ou plusieurs caractères suivis d'un astérisque (*) ; par exemple, ABC*. L'astérisque remplace tous les caractères valides. Un type de serveur générique désigne tous les travaux dont le type de serveur commence par le préfixe générique. Specifies the generic server type for which trace records are to be collected. A generic name is a character string of one or more characters followed by an asterisk (*); for example, ABC*. The asterisk substitutes for any valid characters. A generic server type specifies all jobs with a server type that begins with the generic prefix.
- nom
- Indiquez le type de serveur pour lequel les enregistrements de trace doivent être collectés. Une liste de cinq types de serveur au plus peut être indiquée. Specify the server type for which trace records are to be collected. A list of up to five server types can be specified.
Nom de tâche (TASK)Task name (TASK)
Indique les tâches du code interne sous licence (LIC) dont les enregistrements de trace doivent être collectés. Seuls les enregistrements de trace générés par les tâches LIC indiquées sont collectés. Specifies the Licensed Internal Code (LIC) tasks from which trace records are to be collected. Only trace records which are generated from the specified LIC tasks are collected.
Valeurs uniques
- *NOCHG
- Si une valeur avait été indiquée pour le nom de tâche (paramètre TASK) dans une commande TRCINT précédente pour une trace active, la valeur n'est pas modifiée. Si aucune valeur n'avait été indiquée dans une commande TRCINT précédente, *NOCHG se comporte comme *ALL pour le nom de tâche. If a value was specified for the task name (TASK parameter) on a previous TRCINT command for an active trace, the value is not changed. If no value was specified on a previous TRCINT command, *NOCHG will behave the same as *ALL for the task name.
- *ALL
- Tous les enregistrements de trace générés par la trace définie sont collectés, quelle que soit la tâche LIC dont ils proviennent. All trace records generated by the defined trace are collected, regardless of what LIC task the trace record was generated from.
Autres valeurs
- nom-générique
- Indiquez le nom générique des tâches LIC dont les enregistrements de trace doivent être collectés. Un nom générique est une chaîne de caractères d'un ou plusieurs caractères suivis d'un astérisque (*) ; par exemple, ABC*. L'astérisque remplace tous les caractères valides. Un nom de tâche générique désigne toutes les tâches dont le nom commence par le préfixe générique. Specify the generic name of the LIC tasks for which trace records are to be collected. A generic name is a character string of one or more characters followed by an asterisk (*); for example, ABC*. The asterisk substitutes for any valid characters. A generic task name specifies all tasks with task names that begin with the generic prefix.
- nom
- Indiquez le nom de la tâche LIC dont les enregistrements de trace doivent être collectés. Jusqu'à dix noms de tâches LIC peuvent être indiqués. Specify the name of the LIC task for which trace records are to be collected. Up to ten LIC task names can be specified.
Numéro de tâche (TASKNBR)Task number (TASKNBR)
Indique les numéros de tâches du code interne sous licence (LIC) dont les enregistrements de trace doivent être collectés. Seuls les enregistrements de trace générés dans les tâches LIC indiquées sont collectés. Specifies the Licensed Internal Code (LIC) task numbers from which trace records are to be collected. Only trace records which are generated in the specified LIC tasks are collected.
Valeurs uniques
- *NOCHG
- Si une valeur avait été indiquée pour le numéro de tâche dans une commande TRCINT précédente pour une trace active, la valeur n'est pas modifiée. Si aucune valeur n'avait été indiquée dans une commande TRCINT précédente, *NOCHG se comporte comme *ALL pour ce paramètre. If a value was specified for the task number on a previous TRCINT command for an active trace, the value is not changed. If no value was specified on a previous TRCINT command, *NOCHG will behave the same as *ALL for this parameter.
- *ALL
- Tous les enregistrements de trace générés par la trace définie sont collectés, quel que soit le numéro de la tâche LIC dont ils proviennent. All trace records generated by the defined trace are collected, regardless of the task number of the LIC task the trace record was generated from.
Autres valeurs
- hexadecimal-value
- Indiquez un numéro de tâche LIC pour lequel les enregistrements de trace doivent être collectés. Une liste de dix numéros de tâches au plus peut être indiquée. Specify a LIC task number for which trace records are to be collected. A list of up to ten task numbers can be specified.
Sélectionner les points de trace (SLTTRCPNT)Select trace points (SLTTRCPNT)
Indique une liste d'au plus cinq points de trace individuels ou plages de points de trace dont les enregistrements de trace doivent être inclus. Les enregistrements de trace des points de trace non indiqués dans SLTTRCPNT ne sont pas collectés. Si SLTTRCPNT est indiqué pour une table de trace actuellement active, les points de trace indiqués sont ajoutés à l'ensemble des points de trace dont les enregistrements de trace sont collectés. Specifies a list of up to five individual trace points or trace point ranges whose trace records are to be included. Trace records for trace points not specified on SLTTRCPNT will not be collected. If SLTTRCPNT is specified for a trace table that is currently active, the specified trace points will be added to the set of trace points for which trace records are being collected.
Remarque : Ce paramètre et le paramètre OMTTRCPNT s'excluent mutuellement. SLTTRCPNT ne peut pas être indiqué pour une table de trace active qui utilise OMTTRCPNT pour exclure des points de trace spécifiques. Remarque :This parameter and the OMTTRCPNT parameter are mutually exclusive. SLTTRCPNT cannot be specified for an active trace table that is using OMTTRCPNT to exclude specific trace points.
Valeurs uniques
- *NOCHG
- La liste des points de trace dont les enregistrements de trace sont collectés n'est pas modifiée. The list of trace points for which trace records are being collected does not change.
Élément 1: Trace point qualifier
- 0-65535
- Indiquez un qualificatif de point de trace unique ou le début d'une plage de qualificatifs de points de trace dont les enregistrements de trace doivent être inclus. Jusqu'à cinq qualificatifs de points de trace individuels ou plages de qualificatifs de points de trace peuvent être indiqués. Specify a single trace point qualifier or the start of a range of trace point qualifiers whose trace records are to be included. Up to five individual trace point qualifiers or trace point qualifier ranges may be specified.
Élément 2: To trace point qualifier
- 0-65535
- Indiquez la fin d'une plage de qualificatifs de points de trace dont les enregistrements de trace doivent être inclus. Aucune valeur ne doit être indiquée pour cet élément du paramètre si un seul point de trace doit être inclus. Specify the end of a range of trace point qualifiers whose trace records are to be included. A value should not be specified for this parameter element if only a single trace point is to be included.
Omettre les points de trace (OMTTRCPNT)Omit trace points (OMTTRCPNT)
Indique une liste d'au plus cinq points de trace individuels ou plages de points de trace dont les enregistrements de trace doivent être exclus. Les enregistrements de trace de tous les points de trace non indiqués dans OMTTRCPNT sont collectés. Si OMTTRCPNT est indiqué pour une table de trace actuellement active, les points de trace indiqués sont ajoutés à l'ensemble des points de trace dont les enregistrements de trace ne sont pas collectés. Specifies a list of up to five individual trace points or trace point ranges whose trace records are to be excluded. Trace records for all trace points not specified on OMTTRCPNT will be collected. If OMTTRCPNT is specified for a trace table that is currently active, the specified trace points will be added to the set of trace points for which trace records are not being collected.
Remarque : Ce paramètre et le paramètre SLTTRCPNT s'excluent mutuellement. OMTTRCPNT ne peut pas être indiqué pour une table de trace active qui utilise SLTTRCPNT pour n'inclure que des points de trace spécifiques. Remarque :This parameter and the SLTTRCPNT parameter are mutually exclusive. OMTTRCPNT cannot be specified for an active trace table that is using SLTTRCPNT to include only specific trace points.
Valeurs uniques
- *NOCHG
- La liste des points de trace dont les enregistrements de trace sont exclus n'est pas modifiée. The list of trace points for which trace records are being excluded does not change.
Élément 1: Trace point qualifier
- 0-65535
- Indiquez un qualificatif de point de trace unique ou le début d'une plage de qualificatifs de points de trace dont les enregistrements de trace doivent être exclus. Jusqu'à cinq qualificatifs de points de trace individuels ou plages de qualificatifs de points de trace peuvent être indiqués. Specify a single trace point qualifier or the start of a range of trace point qualifiers whose trace records are to be excluded. Up to five individual trace point qualifiers or trace point qualifier ranges may be specified.
Élément 2: To trace point qualifier
- 0-65535
- Indiquez la fin d'une plage de qualificatifs de points de trace dont les enregistrements de trace doivent être exclus. Aucune valeur ne doit être indiquée pour cet élément du paramètre si un seul point de trace doit être exclu. Specify the end of a range of trace point qualifiers whose trace records are to be excluded. A value should not be specified for this parameter element if only a single trace point is to be excluded.
Points de trace d'arrêt (STOPTRCPNT)Stop trace points (STOPTRCPNT)
Indique un ou plusieurs points de trace qui, s'ils sont rencontrés, provoquent l'arrêt de la collecte des enregistrements de trace. Les enregistrements de la table de trace ne sont pas supprimés et peuvent ensuite être écrits dans un fichier spoule ou sur une unité de sortie en appelant TRCINT avec SET(*OFF) ou SET(*SAVE). Specifies one or more trace points which, if they are encountered, will cause collection of trace records to stop. The trace table records are not deleted and can later be written to a spooled file or an output device by invoking TRCINT with SET(*OFF) or SET(*SAVE).
Jusqu'à quatre points de trace peuvent être indiqués. La trace est arrêtée si l'un des points de trace indiqués correspond à un enregistrement de trace ajouté à la table de trace indiquée. Up to four trace points may be specified. Tracing will be stopped if any of the specified trace points match a trace record being added to the specified trace table.
Un point de trace indiqué peut comporter soit deux parties (type de point de trace et qualificatif de point de trace), soit cinq parties (type de point de trace, qualificatif de point de trace, numéro d'entrée du point de trace, décalage d'entrée du point de trace et valeur de correspondance du point de trace). Une condition à deux parties arrête la collecte des données de trace si un enregistrement de trace est collecté pour le point de trace indiqué. Une condition à cinq parties n'arrête la collecte des données de trace que si la valeur de correspondance du point de trace indiquée correspond exactement aux données situées au décalage d'entrée du point de trace indiqué. A specified trace point can have either two parts (trace point type and trace point qualifier) or five parts (trace point type, trace point qualifier, trace point entry number, trace point entry offset, and trace point match value). A two-part condition will stop trace data collection if any trace record is collected for the specified trace point. A five-part condition will stop trace data collection only if the specified trace point match value exactly matches the data at the specified trace point entry offset.
Valeurs uniques
- *NOCHG
- La liste des points de trace d'arrêt associés à la table de trace n'est pas modifiée. The list of stop trace points associated with the trace table does not change.
Élément 1: Trace point type
- valeur-caractère
- Indiquez le type de point de trace à deux caractères. Specify the two-character trace point type.
Élément 2: Trace point qualifier
- 0-65535
- Indiquez le numéro du qualificatif de point de trace. Specify the trace point qualifier number.
Élément 3: Trace point entry
- 1-65535
- Indiquez le numéro d'entrée du point de trace. Specify the trace point entry number.
Élément 4: Trace point entry offset
- hexadecimal-value
- Indiquez le décalage (en hexadécimal) dans l'entrée du point de trace. Specify the offset (in hexadecimal) in the trace point entry.
Élément 5: Trace point match value
- valeur-caractère
- Indiquez la valeur de correspondance à comparer aux données de l'enregistrement de trace. La valeur de correspondance peut être indiquée en caractères ou en hexadécimal. Les chaînes de caractères sont converties en chaînes hexadécimales équivalentes. Specify the match value to be compared to the trace record data. The match value may be specified in character or hexadecimal. Character strings will be converted to the equivalent hexadecimal strings.
Types de travaux (JOBTYPE)
Indique les types de travaux pour lesquels des données de trace doivent être collectées en vue du rapport de trace de travaux par lots. Un maximum de 11 types de travaux peut être indiqué. Ce paramètre ne peut être indiqué que si TRCTYPE(*MPL) ou TRCTYPE(040000) est indiqué. Specifies the types of jobs for which trace data is to be collected for use in the batch job trace report. A maximum of 11 job types can be specified. This parameter can be specified only if TRCTYPE(*MPL) or TRCTYPE(040000) is specified.
Remarque : La valeur *DFT inclut les valeurs *ASJ, *BCH, *EVK, *MRT, *PDJ, *PJ et *BCI. La valeur *BCH inclut les valeurs *EVK, *MRT, *PDJ, *PJ et *BCI. Remarque :The value *DFT includes the values *ASJ, *BCH, *EVK, *MRT, *PDJ, *PJ and *BCI. The value *BCH includes the values *EVK, *MRT, *PDJ, *PJ, and *BCI.
Valeurs uniques
- *NONE
- Aucun travail n'est tracé. No jobs are traced.
- *ALL
- Tous les types de travaux sont tracés. All of the job types are traced.
Autres valeurs
- *DFT
- Les travaux par lots et de démarrage automatique sont tracés. Batch and autostart jobs are traced.
- *ASJ
- Les travaux de démarrage automatique sont tracés. Autostart jobs are traced.
- *BCH
- Les travaux par lots sont tracés. Travail batchs are traced.
- *EVK
- Les travaux démarrés par une demande de démarrage de procédure sont tracés. Jobs started by a procedure start request are traced.
- *INT
- Les travaux interactifs sont tracés. Travail interactifs are traced.
- *MRT
- Les travaux de terminal à demandeurs multiples sont tracés. Multiple requester terminal jobs are traced.
- *RDR
- Les travaux de lecteur sont tracés. Reader jobs are traced.
- *SBS
- Les travaux de moniteur de sous-système sont tracés. Subsystem monitor jobs are traced.
- *SYS
- Les travaux système sont tracés. System jobs are traced.
- *WRT
- Les travaux d'éditeur sont tracés. Writer jobs are traced.
- *PDJ
- Les travaux de pilote d'impression sont tracés. Print driver jobs are traced.
- *PJ
- Les travaux prédémarrés sont tracés. Prestart jobs are traced.
- *BCI
- Les travaux par lots immédiats sont tracés. Batch Immediate jobs are traced.
Intervalle de trace travaux (JOBTRCITV)
Indique l'intervalle de temps (en secondes UC) entre chaque collecte des données de trace de travail. Ce paramètre ne peut être indiqué que si TRCTYPE(*MPL) ou TRCTYPE(040000) est indiqué. Specifies the time (in CPU seconds) between each collection of the job trace data. This parameter can be specified only if TRCTYPE(*MPL) or TRCTYPE(040000) is specified.
- 0.5
- Une valeur d'intervalle de tranche de temps de 0,5 seconde UC est utilisée. A time slice interval value of 0.5 CPU seconds is used.
- 0.1-9.9
- Indiquez le nombre de secondes UC à utiliser comme valeur d'intervalle de trace. Specify the number of CPU seconds to be used as the trace interval value.
Données TCP/IP (TCPDTA)TCP/IP data (TCPDTA)
Indique si un sous-ensemble des données de trace TCP/IP et/ou de sockets doit être collecté. Ce paramètre ne peut être indiqué que si TRCTYPE(*TCPIP), TRCTYPE(013800), TRCTYPE(*SMBSVR), TRCTYPE(015800), TRCTYPE(*FRCA) ou TRCTYPE(016600) est indiqué, ou si un ou plusieurs des types de trace de sockets sont indiqués (*SCK, *SCKSTDIO, *SCKASCIO, *SCKSEL, *SCKNET, *SCKRSLV, *SCKSSL, *SCKOTHER ou 014000, 014001, 014002, 014003, 014004, 014005, 014006, 014007). Chaque élément du paramètre est facultatif ; si aucune valeur n'est indiquée pour un élément, aucun filtrage des données de trace TCP/IP et/ou de sockets n'est effectué pour cet élément. Par exemple, si *UDP est indiqué pour l'élément 1, seuls les enregistrements de trace dans lesquels le protocole UDP est utilisé sont collectés. Si aucune valeur n'est indiquée pour l'élément 1, les enregistrements de trace utilisant tous les protocoles TCP/IP sont collectés. Specifies whether a subset of TCP/IP and/or Sockets trace data should be collected. This parameter can be specified only if TRCTYPE(*TCPIP) or TRCTYPE(013800) or TRCTYPE(*SMBSVR) or TRCTYPE(015800) or TRCTYPE(*FRCA) or TRCTYPE(016600) is specified, or if one or more of the socket trace types is specified (*SCK, *SCKSTDIO, *SCKASCIO, *SCKSEL, *SCKNET, *SCKRSLV, *SCKSSL, *SCKOTHER or 014000, 014001, 014002, 014003, 014004, 014005, 014006, 014007). Each parameter element is optional; if no element value is specified, no filtering of TCP/IP and/or Sockets trace data is done for that element. For example, if *UDP is specified for element 1, only trace records where the UDP protocol is used are collected. If no value is specified for element 1, trace records using all TCP/IP protocols are collected.
Si aucune valeur n'est indiquée pour aucun élément de TCPDTA et que la trace des données TCP/IP ou de sockets n'était pas déjà active, aucun filtrage des données de trace TCP/IP ou de sockets n'est effectué. Si la trace des données TCP/IP ou de sockets était déjà active et qu'aucune valeur TCPDTA n'est indiquée, les valeurs de filtrage des données précédentes restent en vigueur. If no values are specified for any element of TCPDTA and tracing of TCP/IP or Sockets data was not already active, no filtering of TCP/IP or Sockets trace data is done. If tracing of TCP/IP or Sockets data was already active and no TCPDTA values are specified, previous data filtering values will remain in effect.
Élément 1: Protocol
Indiquez un protocole TCP/IP à tracer. Specify a TCP/IP protocol to be traced.
- *TCP
- Active la trace pour le protocole TCP (Transmission Control Protocol). Enable trace for transmission control protocol.
- *UDP
- Active la trace pour le protocole UDP (User Datagram Protocol). Enable trace for user datagram protocol.
- *ICMP
- Active la trace pour le protocole ICMP (Internet Control Message Protocol). Enable trace for internet control message protocol.
- *IGMP
- Active la trace pour le protocole IGMP (Internet Group Management Protocol). Enable trace for internet group management protocol.
- *ARP
- Active la trace pour le protocole ARP (Address Resolution Protocol). Cela ne s'applique qu'à TCP/IP. Enable trace for address resolution protocol. This will only apply for TCP/IP.
- *ICMP6
- Active la trace pour le protocole ICMP version 6 (Internet Control Message Protocol version 6). Enable trace for internet control message protocol version 6.
- *RDMA
- Active la trace pour le protocole RDMA (Remote Direct Memory Access). Enable trace for remote direct memory access protocol.
Élément 2: Local port
Indiquez un ou deux numéros de port local pour lesquels les données de trace sont collectées. Specify one or two local port numbers for which trace data is collected.
Élément 3: Remote port
Indiquez un ou deux numéros de port distant pour lesquels les données de trace sont collectées. Specify one or two remote port numbers for which trace data is collected.
Élément 4: Local IP address
Indiquez une adresse IP (Internet Protocol) locale. Specify a local internet protocol address.
Élément 5: Remote IP address
Indiquez une adresse IP (Internet Protocol) distante. Specify a remote internet protocol address.
Élément 6: Description de ligne
Indiquez le nom d'une description de ligne pour laquelle les données de trace TCP/IP doivent être collectées. Specify the name of a line description for which TCP/IP trace data is to be collected.
Élément 7: Type de ligne
Indiquez si la collecte des informations de trace doit être limitée au type de ligne indiqué. Specify whether the collection of trace information should be restricted to the specified line type.
- *PPP
- La collecte des informations de trace est limitée aux lignes point à point. The collection of trace information is restricted to Point-to-point lines.
- *OPC
- La collecte des informations de trace est limitée à Opticonnect. The collection of trace information is restricted to Opticonnect.
Données de sockets (SCKDTA)Sockets data (SCKDTA)
Indique si un sous-ensemble des données de trace de sockets doit être collecté. Ce paramètre ne peut être indiqué que si un ou plusieurs des types de trace de sockets sont indiqués (*SCK, *SCKSTDIO, *SCKASCIO, *SCKSEL, *SCKNET, *SCKRSLV, *SCKSSL, *SCKOTHER ou 014000, 014001, 014002, 014003, 014004, 014005, 014006, 014007). Chaque élément du paramètre est facultatif ; si aucune valeur n'est indiquée pour un élément, aucun filtrage des données de trace de sockets n'est effectué pour cet élément. Par exemple, si *INET est indiqué pour l'élément 1, seuls les enregistrements de trace dans lesquels la famille d'adresses AF_INET est utilisée sont collectés. Si aucune valeur n'est indiquée pour l'élément 1, les enregistrements de trace utilisant toutes les familles d'adresses de sockets sont collectés. Specifies whether a subset of Sockets trace data should be collected. This parameter can be specified only if one or more of the socket trace types is specified (*SCK, *SCKSTDIO, *SCKASCIO, *SCKSEL, *SCKNET, *SCKRSLV, *SCKSSL, *SCKOTHER or 014000, 014001, 014002, 014003, 014004, 014005, 014006, 014007). Each parameter element is optional; if no element value is specified, no filtering of Sockets trace data is done for that element. For example, if *INET is specified for element 1, only trace records where the AF_INET address family is used are collected. If no value is specified for element 1, trace records using all socket address families are collected.
Si aucune valeur n'est indiquée pour aucun élément de SCKDTA et que la trace des données de sockets n'était pas déjà active, aucun filtrage des données de trace de sockets n'est effectué. Si la trace des données de sockets était déjà active et qu'aucune valeur SCKDTA n'est indiquée, les valeurs de filtrage des données précédentes restent en vigueur. If no values are specified for any element of SCKDTA and tracing of Sockets data was not already active, no filtering of Sockets trace data is done. If tracing of Sockets data was already active and no SCKDTA values are specified, previous data filtering values will remain in effect.
Les valeurs de sous-ensemble indiquées dans le paramètre SCKDTA sont utilisées en combinaison avec les valeurs de sous-ensemble indiquées dans le paramètre TCPDTA pour générer les critères complets de sélection d'un sous-ensemble. The subset values specified on the SCKDTA parameter are used in combination with any subset values specified on the TCPDTA parameter to generate the complete subsetting criteria.
Élément 1: Address family
Indiquez une famille d'adresses de sockets pour laquelle les données de trace sont collectées. Specify a sockets address family for which trace data is collected.
- *INET
- Active la trace pour la famille d'adresses AF_INET. Enable trace for AF_INET address family.
- *UNIX
- Active la trace pour les familles d'adresses AF_UNIX et AF_UNIX_CCSID. Enable trace for AF_UNIX and AF_UNIX_CCSID address families.
- *INET6
- Active la trace pour la famille d'adresses AF_INET6. Enable trace for AF_INET6 address family.
- *NETBIOS
- Active la trace pour la famille d'adresses AF_NETBIOS. Enable trace for AF_NETBIOS address family.
Élément 2: Socket type
Indiquez un type de socket pour lequel les données de trace sont collectées. Specify a socket type for which trace data is collected.
- *STREAM
- Active la trace pour le type de socket SOCK_STREAM (flux bidirectionnel simultané). Enable trace for SOCK_STREAM (full-duplex stream) socket type.
- *DGRAM
- Active la trace pour le type de socket SOCK_DGRAM (datagramme). Enable trace for SOCK_DGRAM (datagram) socket type.
- *RAW
- Active la trace pour le type de socket SOCK_RAW (accès direct au protocole réseau). Enable trace for SOCK_RAW (direct to network protocol) socket type.
- *SEQPACKET
- Active la trace pour le type de socket SOCK_SEQPACKET (paquets séquencés bidirectionnels simultanés). Enable trace for SOCK_SEQPACKET (full-duplex sequenced packet) socket type.
Élément 3: Descriptor
Indiquez un ou deux numéros de descripteur de socket pour lesquels les données de trace sont collectées. Specify one or two socket descriptor numbers for which trace data is collected.
Élément 4: Socket option
Indiquez une option de socket pour laquelle les données de trace sont collectées. Specify a socket option for which trace data is collected.
- *SODEBUG
- Les données de trace sont collectées pour les applications dont l'option de socket SO_DEBUG est activée. Applications with the SO_DEBUG Socket Option set on will have trace data collected.
Unité (DEV)
Indique les noms des unités dont les événements internes associés sont tracés. Ce paramètre ne peut être indiqué que si 010803 ou *SRCSINK est indiqué pour le paramètre Type de trace (TRCTYPE). Jusqu'à 16 noms d'unités peuvent être indiqués. Specifies the names of the devices for which the associated internal events are traced. This parameter can be specified only if 010803 or *SRCSINK is specified on the Type de trace (TRCTYPE) parameter. Up to 16 device names may be specified.
Le nombre total d'objets source/récepteur pouvant être nommés dans les paramètres unité (DEV), contrôleur (CTL), ligne (LIN), interface réseau (NWI) et serveur réseau (NWS) est de 16. Par exemple, si vous entrez 16 valeurs pour le paramètre DEV, vous ne pouvez pas entrer de valeurs pour les autres paramètres. The total number of source/sink objects that can be named on the device(DEV), controller(CTL), line(LIN), network interface(NWI) and network server(NWS) parameters is 16. For example, if you enter 16 values for the DEV parameter, you cannot enter values for the other parameters.
Le nombre maximal d'objets source/récepteur pouvant être tracés dans une même table de trace est de 256. Même si vous restez dans la limite de 16 objets source/récepteur nommés dans une commande TRCINT, vous pouvez dépasser la limite de 256 objets source/récepteur. Voici des exemples de façons de dépasser la limite : The maximum number of source/sink objects that can be traced in a single trace table is 256. Even if you stay within the limit of 16 named source/sink objects on one TRCINT command, you may exceed the 256 source/sink object limit. Examples of ways to exceed the limit are:
- indiquer SET(*ON) plusieurs fois pour la même table de trace specifying SET(*ON) multiple times for the same trace table
- indiquer *ALLDEV dans le paramètre CTL specifying *ALLDEV on the CTL parameter
- indiquer *ALLCTL dans le paramètre LIN specifying *ALLCTL on the LIN parameter
- *NONE
- Aucune unité n'est tracée par cette commande. No devices are traced by this command.
- nom
- Indiquez le nom de l'unité pour laquelle la trace interne est démarrée. Le nom de l'unité doit être identique au nom indiqué dans la description d'unité associée. Specify the name of the device for which the internal trace is started. The device name must be the same as the name specified in the associated device description.
Contrôleur (CTL)
Indique les noms des contrôleurs dont les événements internes associés doivent être tracés. Ce paramètre ne peut être indiqué que si 010803 ou *SRCSINK est indiqué pour le paramètre Type de trace (TRCTYPE). Jusqu'à 16 noms de contrôleurs peuvent être indiqués. Specifies the names of the controllers for which the associated internal events are to be traced. This parameter can be specified only if 010803 or *SRCSINK is specified on the Type de trace (TRCTYPE) parameter. Up to 16 controller names may be specified.
Le nombre total d'objets source/récepteur pouvant être nommés dans les paramètres unité (DEV), contrôleur (CTL), ligne (LIN), interface réseau (NWI) et serveur réseau (NWS) est de 16. Par exemple, si vous entrez 16 valeurs pour le paramètre CTL, vous ne pouvez pas entrer de valeurs pour les autres paramètres. The total number of source/sink objects that can be named on the device(DEV), controller(CTL), line(LIN), network interface(NWI) and network server(NWS) parameters is 16. For example, if you enter 16 values for the CTL parameter, you cannot enter values for the other parameters.
Le nombre maximal d'objets source/récepteur pouvant être tracés dans une même table de trace est de 256. Même si vous restez dans la limite de 16 objets source/récepteur nommés dans une commande TRCINT, vous pouvez dépasser la limite de 256 objets source/récepteur. Voici des exemples de façons de dépasser la limite : The maximum number of source/sink objects that can be traced in a single trace table is 256. Even if you stay within the limit of 16 named source/sink objects on one TRCINT command, you may exceed the 256 source/sink object limit. Examples of ways to exceed the limit are:
- indiquer SET(*ON) plusieurs fois pour la même table de trace specifying SET(*ON) multiple times for the same trace table
- indiquer *ALLDEV dans le paramètre CTL specifying *ALLDEV on the CTL parameter
- indiquer *ALLCTL dans le paramètre LIN specifying *ALLCTL on the LIN parameter
Valeurs uniques
- *NONE
- Aucun contrôleur n'est tracé par cette commande. No controllers are traced by this command.
Élément 1: Contrôleur
- nom
- Indiquez le nom du contrôleur pour lequel la trace interne est démarrée. Les noms de contrôleur doivent être identiques à ceux indiqués dans la description de contrôleur associée. Specify the name of the controller for which the internal trace is started. The controller names must be the same as the names specified in the associated controller description.
Élément 2: Attached devices
Indique si les unités d'un contrôleur sont tracées. Specifies if the devices on a controller are traced.
- *NODEV
- Aucune unité rattachée au contrôleur indiqué n'est tracée. No attached devices for the specified controller are traced.
- *ALLDEV
- Toutes les unités rattachées au contrôleur indiqué sont tracées. Les unités rattachées ne sont pas comptées dans le maximum de 16 objets source/récepteur pouvant être nommés dans les paramètres DEV, CTL, LIN, NWI et NWS. En revanche, elles sont comptées dans le maximum de 256 objets source/récepteur pouvant être tracés dans une même table de trace. All attached devices for the specified controller are traced. The attached devices do not count toward the maximum of 16 source/sink objects that can be named on the DEV,CTL,LIN,NWI and NWS parameters. However, the attached devices do count toward the maximum of 256 source/sink objects that can be traced in a single trace table.
Ligne (LIN)
Indique les noms des lignes pour lesquelles les événements internes associés doivent être tracés. Ce paramètre ne peut être indiqué que si 010803 est indiqué dans le paramètre Type de trace (TRCTYPE). Il est possible d'indiquer jusqu'à 16 noms de ligne. Specifies the names of the lines for which the associated internal events are to be traced. This parameter can be specified only if 010803 is specified on the Type de trace (TRCTYPE) parameter. Up to 16 line names may be specified.
Le nombre total d'objets source/récepteur pouvant être nommés dans les paramètres unité (DEV), contrôleur (CTL), ligne (LIN), interface réseau (NWI) et serveur réseau (NWS) est de 16. Par exemple, si vous entrez 16 valeurs pour le paramètre LIN, vous ne pouvez pas entrer de valeurs pour les autres paramètres. The total number of source/sink objects that can be named on the device(DEV), controller(CTL), line(LIN), network interface(NWI) and network server(NWS) parameters is 16. For example, if you enter 16 values for the LIN parameter, you cannot enter values for the other parameters.
Le nombre maximal d'objets source/récepteur pouvant être tracés dans une même table de trace est de 256. Même si vous restez dans la limite de 16 objets source/récepteur nommés dans une commande TRCINT, vous pouvez dépasser la limite de 256 objets source/récepteur. Voici des exemples de façons de dépasser la limite : The maximum number of source/sink objects that can be traced in a single trace table is 256. Even if you stay within the limit of 16 named source/sink objects on one TRCINT command, you may exceed the 256 source/sink object limit. Examples of ways to exceed the limit are:
- indiquer SET(*ON) plusieurs fois pour la même table de trace specifying SET(*ON) multiple times for the same trace table
- indiquer *ALLDEV dans le paramètre CTL specifying *ALLDEV on the CTL parameter
- indiquer *ALLCTL dans le paramètre LIN specifying *ALLCTL on the LIN parameter
Valeurs uniques
- *NONE
- Aucune ligne n'est tracée par cette commande. No lines are traced by this command.
Élément 1: Ligne
- nom
- Indiquez le nom de la ligne pour laquelle la trace interne est démarrée. Le nom de la ligne doit être identique à celui indiqué dans la description de ligne associée. Specify the name of the line for which the internal trace is started. The line name must be the same as the name specified in the associated line description.
Élément 2: Attached controllers
Indique si les contrôleurs d'une ligne sont tracés. Specifies if the controllers on a line are traced.
- *NOCTL
- Aucun contrôleur rattaché à la ligne indiquée n'est tracé. No attached controllers for the specified line are traced.
- *ALLCTL
- Tous les contrôleurs rattachés à la ligne indiquée sont tracés. Les contrôleurs rattachés ne sont pas comptés dans le maximum de 16 objets source/récepteur pouvant être nommés dans les paramètres DEV, CTL, LIN, NWI et NWS. En revanche, ils sont comptés dans le maximum de 256 objets source/récepteur pouvant être tracés dans une même table de trace. All attached controllers for the specified line are traced. The attached controllers do not count toward the maximum of 16 source/sink objects that can be named on the DEV,CTL,LIN,NWI and NWS parameters. However, the attached controllers do count toward the maximum of 256 source/sink objects that can be traced in a single trace table.
Interface réseau (NWI)Network interface (NWI)
Indique les noms des interfaces réseau pour lesquelles les événements internes associés doivent être tracés. Ce paramètre ne peut être indiqué que si 010803 ou *SRCSINK est indiqué pour le paramètre Type de trace (TRCTYPE). Il est possible d'indiquer jusqu'à 16 noms d'interface réseau. Specifies the names of the network interfaces for which the associated internal events are to be traced. This parameter can be specified only if 010803 or *SRCSINK is specified for the Type de trace (TRCTYPE) parameter. Up to 16 network interface names may be specified.
Le nombre total d'objets source/récepteur pouvant être nommés dans les paramètres unité (DEV), contrôleur (CTL), ligne (LIN), interface réseau (NWI) et serveur réseau (NWS) est de 16. Par exemple, si vous entrez 16 valeurs pour le paramètre LIN, vous ne pouvez pas entrer de valeurs pour les autres paramètres. The total number of source/sink objects that can be named on the device(DEV), controller(CTL), line(LIN), network interface(NWI) and network server(NWS) parameters is 16. For example, if you enter 16 values for the LIN parameter, you cannot enter values for the other parameters.
Le nombre maximal d'objets source/récepteur pouvant être tracés dans une même table de trace est de 256. Même si vous restez dans la limite de 16 objets source/récepteur nommés dans une commande TRCINT, vous pouvez dépasser la limite de 256 objets source/récepteur. Voici des exemples de façons de dépasser la limite : The maximum number of source/sink objects that can be traced in a single trace table is 256. Even if you stay within the limit of 16 named source/sink objects on one TRCINT command, you may exceed the 256 source/sink object limit. Examples of ways to exceed the limit are:
- indiquer SET(*ON) plusieurs fois pour la même table de trace specifying SET(*ON) multiple times for the same trace table
- indiquer *ALLDEV dans le paramètre CTL specifying *ALLDEV on the CTL parameter
- indiquer *ALLCTL dans le paramètre LIN specifying *ALLCTL on the LIN parameter
Valeurs uniques
- *NONE
- Aucune interface réseau n'est tracée par cette commande. No network interfaces are traced by this command.
Autres valeurs
- nom
- Indiquez le nom de l'interface réseau pour laquelle la trace interne est démarrée. Le nom de l'interface réseau doit être identique à celui indiqué dans la description d'interface réseau associée. Specify the name of the network interface for which the internal trace is started. The network interface name must be the same as the name specified in the associated network interface description.
Serveur réseau (NWS)Network Server (NWS)
Indique les noms des serveurs réseau pour lesquels les événements internes associés sont tracés. Ce paramètre ne peut être indiqué que si 010803 ou *SRCSINK est indiqué dans le paramètre Type de trace (TRCTYPE). Il est possible d'indiquer jusqu'à 16 noms de serveur réseau. Specifies the names of the network servers for which the associated internal events are traced. This parameter can be specified only if 010803 or *SRCSINK is specified on the Type de trace (TRCTYPE) parameter. Up to 16 network server names may be specified.
Le nombre total d'objets source/récepteur pouvant être nommés dans les paramètres unité (DEV), contrôleur (CTL), ligne (LIN), interface réseau (NWI) et serveur réseau (NWS) est de 16. Par exemple, si vous entrez 16 valeurs pour le paramètre LIN, vous ne pouvez pas entrer de valeurs pour les autres paramètres. The total number of source/sink objects that can be named on the device(DEV), controller(CTL), line(LIN), network interface(NWI) and network server(NWS) parameters is 16. For example, if you enter 16 values for the LIN parameter, you cannot enter values for the other parameters.
Le nombre maximal d'objets source/récepteur pouvant être tracés dans une même table de trace est de 256. Même si vous restez dans la limite de 16 objets source/récepteur nommés dans une commande TRCINT, vous pouvez dépasser la limite de 256 objets source/récepteur. Voici des exemples de façons de dépasser la limite : The maximum number of source/sink objects that can be traced in a single trace table is 256. Even if you stay within the limit of 16 named source/sink objects on one TRCINT command, you may exceed the 256 source/sink object limit. Examples of ways to exceed the limit are:
- indiquer SET(*ON) plusieurs fois pour la même table de trace specifying SET(*ON) multiple times for the same trace table
- indiquer *ALLDEV dans le paramètre CTL specifying *ALLDEV on the CTL parameter
- indiquer *ALLCTL dans le paramètre LIN specifying *ALLCTL on the LIN parameter
Valeurs uniques
- *NONE
- Aucun serveur réseau n'est tracé par cette commande. No network servers are traced by this command.
Autres valeurs
- nom
- Indiquez le nom du serveur réseau pour lequel la trace interne est démarrée. Le nom du serveur réseau doit être identique à celui indiqué dans la description de serveur réseau associée. Specify the name of the network server for which the internal trace is started. The network server name must be the same as the name specified in the associated network server description.
Ressource matérielle (RSRCNAME)Hardware Resource (RSRCNAME)
Indique les noms des ressources matérielles pour lesquelles les événements internes associés sont tracés. Ce paramètre ne peut être indiqué que si 014700 ou 011900 est indiqué dans le paramètre Type de trace (TRCTYPE). Specifies the names of the hardware resources for which the associated internal events are traced. This parameter can be specified only if 014700 or 011900 is specified on the Type de trace (TRCTYPE) parameter.
Remarque : Un total combiné de 10 ressources matérielles (RSRCNAME) est autorisé. Remarque :A combined total of 10 hardware resources (RSRCNAME) are allowed.
Valeurs uniques
- *NONE
- Aucune ressource matérielle n'est tracée par cette commande. No hardware resources are traced by this command.
Autres valeurs
- nom
- Indiquez les noms de 10 ressources matérielles au maximum pour lesquelles la trace interne est démarrée. Specify the names of up to 10 hardware resources for which the internal trace is started.
Unité (OUTDEV)
Indique l'unité de bande ou l'unité optique sur laquelle les enregistrements de trace conservés sont écrits. Ce paramètre doit être indiqué si *SAVE est indiqué pour le paramètre Option de trace (SET). Specifies the tape device or optical device on which the held trace records are written. This parameter must be specified if *SAVE is specified for the Option de trace (SET) parameter.
- nom
- Indiquez le nom de la description d'unité de l'unité de bande ou de l'unité optique. Specify the name of the device description of the tape or optical device.
Informations sur les tâches (TASKINF)Task information (TASKINF)
Indique si les informations relatives à toutes les tâches du code interne sous licence (LIC) sont écrites dans un fichier spoule ou sur une unité de sortie. Ce paramètre peut être indiqué si SET(*OFF) ou SET(*SAVE) est indiqué. Specifies whether information for all licensed internal code (LIC) tasks is written to a spooled file or output device. This parameter can be specified if SET(*OFF) or SET(*SAVE) is specified.
- *TRCREF
- Écrit les informations uniquement pour les tâches LIC référencées par des enregistrements de trace de la table de trace indiquée. Write information only for LIC tasks that were referenced by trace records in the specified trace table.
- *ALL
- Écrit les informations pour toutes les tâches LIC qui existaient pendant que la trace était active. Write information for all LIC tasks that were in existence while the trace was active.
Indique si la sortie de la commande est imprimée avec la sortie spoule du travail, envoyée dans un fichier de base de données ou envoyée dans un fichier STREAM. Specifies whether the output from the command is printed with the job's spooled output, sent to a database file, or sent to a stream file.
- 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.
- *STMF
- La sortie est dirigée vers le fichier STREAM indiqué dans le paramètre Options de fichier STREAM (TOSTMF). Vous devrez utiliser TRCINT SET(*PRINT) pour convertir les informations binaires en un fichier spoule ou un fichier de sortie lisible. The output is directed to the stream file specified on the Stream file options (TOSTMF) parameter. You will have to use TRCINT SET(*PRINT) to convert the binary information into a readable spooled file or output file.
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 QASCTRCI de la bibliothèque système QSYS est utilisé comme modèle. Remarque :If a new file is created, system file QASCTRCI in system library QSYS is used as a model.
Options pour membre de sortie (OUTMBR)
Indique le nom du membre de fichier de base de données vers lequel la sortie est dirigée lorsque *OUTFILE est indiqué pour le paramètre Sortie (OUTPUT). Specifies the name of the database file member to which the output is directed when *OUTFILE is specified for the Output (OUTPUT) parameter.
É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 devant recevoir la sortie (OUTFILE). 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.
- nom
- Specify the name of the file member that receives the output. If OUTMBR(member-name) is specified and the member does not exist, the system creates it.
Si le membre existe, vous pouvez ajouter des enregistrements à la fin du membre existant ou effacer le membre existant et y ajouter les enregistrements. If the member exists, you can add records to the end of the existing member or clear the existing member and add the records.
Élément 2: Replace or add records
- *REPLACE
- Les enregistrements existants du membre de fichier de base de données indiqué sont remplacés par les nouveaux enregistrements. The existing records in the specified database file member are replaced by the new records.
- *ADD
- Les nouveaux enregistrements sont ajoutés aux informations existantes du membre de fichier de base de données indiqué. The new records are added to the existing information in the specified database file member.
Surveiller un message (WCHMSG)Watch for message (WCHMSG)
Indique jusqu'à cinq messages à surveiller. Si une valeur autre que *NONE est indiquée, vous devez indiquer dans le paramètre WCHMSGQ l'endroit où surveiller le message. Lorsque le message surveillé est ajouté à la file d'attente de messages ou au journal indiqué, le programme d'exit de trace est appelé ; si aucun programme d'exit de trace n'est défini, la trace s'arrête. Specifies up to five messages which are to be watched. If a value other than *NONE is specified, you must specify where to watch for the message on the WCHMSGQ parameter. When the watched for message is added to the specified message queue or log, the trace exit program is called; if no trace exit program is defined, the trace stops.
Remarque : Les messages déplacés et renvoyés ne seront pas surveillés. Seule l'occurrence d'origine du message peut être surveillée. Note: Moved and resent messages will not be watched. Only the original instance of the message can be watched.
Remarque : La surveillance des ID de message CPF1124 ou CPF1164 sera ignorée dans le travail QSCWCHPS (qui gère le traitement de la surveillance). Un programme d'exit utilisateur ne sera pas déclenché lorsque CPF1124 ou CPF1164 est émis dans le travail QSCWCHPS. Note: Watching for message id CPF1124 or CPF1164 will be ignored in job QSCWCHPS (which handles watch processing). A user exit program will not be triggered when CPF1124 or CPF1164 is issued in job QSCWCHPS.
Valeurs uniques
- *NONE
- Aucun message ne sera surveillé. No messages will be watched.
Élément 1: Message to watch
- *ALL
- Tous les messages doivent être surveillés. Cela comprend les messages stockés et les messages immédiats. Sachez que la surveillance de tous les messages peut dégrader les performances de votre système. Utilisez-la avec précaution. All messages are to be watched. This includes stored messages and immediate messages. Be aware that watching for all messages might cause performance degradation on your system. Use it cautiously.
- *IMMED
- Tous les messages immédiats ou impromptus seront surveillés. All immediate or impromptu messages will be watched.
- nom-générique
- Indiquez l'identificateur de message générique à surveiller. Un nom générique est une chaîne de caractères composée d'un ou plusieurs caractères suivis d'un astérisque (*) ; par exemple, ABC*. L'astérisque remplace tout caractère valide. Un nom de message générique désigne tous les messages dont l'identificateur commence par le préfixe générique. Specify the generic message identifier to be watched. A generic name is a character string of one or more characters followed by an asterisk (*); for example, ABC*. The asterisk substitutes for any valid characters. A generic message name specifies all messages with message identifiers that begin with the generic prefix.
- nom
- Indiquez l'identificateur de message de 7 caractères à surveiller. Specify the 7-character message identifier to be watched.
Élément 2: Donnée de comparaison
Indiquez les données de comparaison à utiliser si un message correspondant au message indiqué est ajouté à la file d'attente de messages ou au journal indiqué. Si les données du message, le « programme émetteur » ou le « programme destinataire » incluent le texte indiqué, la condition surveillée est vraie. Si les données du message, le « programme émetteur » ou le « programme destinataire » ne contiennent pas le texte indiqué, la fonction de trace se poursuit. Specify comparison data to be used if a message matching the specified message is added to the specified message queue or log. If the message data, the "From program" or the "To program" includes the specified text, the watched for condition is true. If the message data, the "From program" or the "To program" does not contain the specified text, the trace function continues.
- *NONE
- Aucune donnée de comparaison n'est indiquée. Si un message correspondant au message indiqué est ajouté à la file d'attente de messages ou au journal indiqué, la condition surveillée est vraie. No comparison data is specified. If a message matching the specified message is added to the specified message queue or log, the watched for condition is true.
- valeur-caractère
- Indiquez la chaîne de texte utilisée pour la comparaison avec les données du message, le « programme émetteur » ou le « programme destinataire » du message surveillé. Ce texte est sensible à la casse et peut être placé entre guillemets pour indiquer des blancs intégrés ou de fin. Specify the text string used to compare against the message data, the "From program" or the "To program" of the watched for message. This text is case sensitive and can be quoted in order to specify imbedded or trailing blanks.
Élément 3: Compare against
Indiquez la partie du message avec laquelle les données de comparaison indiquées pour l'élément 2 doivent être comparées. Specify which part of the message the comparison data specified for element 2 is to be compared against.
- *MSGDATA
- Les données de comparaison seront comparées aux données de remplacement du message. The comparison data will be compared against the message replacement data.
- *FROMPGM
- Les données de comparaison seront comparées au nom du programme qui envoie le message, ou au nom du programme ILE qui contient la procédure qui envoie le message. The comparison data will be compared against the name of the program sending the message, or the name of the ILE program that contains the procedure sending the message.
- *TOPGM
- Les données de comparaison seront comparées au nom du programme auquel le message a été envoyé, ou au nom du programme ILE qui contient la procédure à laquelle le message a été envoyé. The comparison data will be compared against the name of the program the message was sent to, or the name of the ILE program that contains the procedure the message was sent to.
Élément 4: Type de message
Indiquez le type de message attribué au message à surveiller. Specify the message type assigned to the message to be watched.
- *ALL
- Tous les types de message doivent être surveillés. Cela comprend les types de message fin, commande, diagnostic, *ESCAPE, information, demande d'information, notification, réponse, demande, copie de l'expéditeur, portée et état. All the message types are to be watched. This includes completion, command, diagnostic, escape, informational, inquiry, notify, reply, request, sender's copy, scope and status message types.
- *COMP
- Un message de fin doit être surveillé. A completion message is to be watched.
- *DIAG
- Un message de diagnostic doit être surveillé. A diagnostic message is to be watched.
- *ESCAPE
- Un message *ESCAPE doit être surveillé. An escape message is to be watched.
- *INFO
- Un message d'information doit être surveillé. An informational message is to be watched.
- *INQ
- Un message de demande d'information doit être surveillé. An inquiry message is to be watched.
- *NOTIFY
- Un message de notification doit être surveillé. A notify message is to be watched.
- *SCOPE
- Un message de portée doit être surveillé. A scope message is to be watched.
- *STATUS
- Un message d'état doit être surveillé. A status message is to be watched.
Élément 5: Opérateur relationnel
Indiquez un opérateur relationnel avec lequel le code de gravité du message est comparé. Specify one relational operator against which the message severity code is compared.
- *GE
- Supérieur ou égal. Greater than or equal.
- *EQ
- Égal. Equal.
- *GT
- Supérieur. Greater than.
- *LT
- Inférieur. Less than.
- *LE
- Inférieur ou égal. Less than or equal.
Élément 6: Code gravité
Indique le code de gravité du message à surveiller. Specifies the severity code of the message to be watched.
- 00
- Le code de gravité attribué au message surveillé est 00. The severity code assigned to the message to be watched for is 00.
- Severity-code
- Indiquez une valeur, comprise entre 00 et 99, comme niveau de gravité associé au message à surveiller. Specify a value, ranging from 00 through 99, as the severity level associated with the message to be watched.
File d'attente de messages surveillée (WCHMSGQ)Watched message queue (WCHMSGQ)
Indique où surveiller les messages indiqués dans le paramètre WCHMSG. Vous pouvez demander la surveillance de l'ajout du message dans la file d'attente de messages de l'opérateur système, dans l'historique, dans d'autres files d'attente de messages et dans des historiques de travail. Jusqu'à trois files d'attente de messages ou valeurs spéciales peuvent être indiquées. Specifies where to watch for the messages specified on the WCHMSG parameter. You can specify to watch the message being added to the system operator message queue, the history log, other message queues, and job logs. Up to three message queues or special values can be specified.
Élément 1: File attente messages
Valeurs uniques
- *SYSOPR
- Surveiller les messages ajoutés à la file d'attente de messages de l'opérateur système (file d'attente de messages QSYSOPR de la bibliothèque QSYS). Watch messages added to the system operator message queue (QSYSOPR message queue in library QSYS).
- *JOBLOG
- Surveiller les messages ajoutés aux historiques des travaux indiqués dans le paramètre Travail surveillé (WCHJOB). Watch messages added to the job logs of the jobs specified for the Watched job (WCHJOB) parameter.
- *HSTLOG
- Surveiller les messages ajoutés à l'historique (file d'attente de messages QHST de la bibliothèque QSYS). Watch messages added to the history log (QHST message queue in library QSYS).
-
Qualificatif 1: File attente messages
- nom
- Indiquez le nom de la file d'attente de messages à surveiller. Specify the name of the message queue to watch.
-
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.
- nom
- Indiquez le nom de la bibliothèque dans laquelle se trouve la file d'attente de messages. Specify the name of the library where the message queue is located.
Travail surveillé (WCHJOB)Watched job (WCHJOB)
Indique le travail dont l'historique est surveillé pour les messages indiqués dans le paramètre WCHMSG. Le travail indiqué n'est surveillé que si *JOBLOG est indiqué dans le paramètre WCHMSGQ. Jusqu'à cinq noms de travail peuvent être indiqués. Specifies the job whose job log is watched for the messages specified on the WCHMSG parameter. The specified job will only be watched if *JOBLOG is specified on the WCHMSGQ parameter. Up to five job names may be specified.
Valeurs uniques
- *
- Seul l'historique du travail qui a émis cette commande de trace est surveillé. Only the job log of the job that issued this trace command is watched.
Élément 1: Travail
-
Qualificatif 1: Travail
- nom-générique
- Indiquez le nom générique du travail à surveiller. Un nom générique est une chaîne de caractères composée d'un ou plusieurs caractères suivis d'un astérisque (*) ; par exemple, ABC*. L'astérisque remplace tout caractère valide. Un nom de travail générique désigne tous les travaux dont le nom commence par le préfixe générique. Specify the generic name of the job to be watched. A generic name is a character string of one or more characters followed by an asterisk (*); for example, ABC*. The asterisk substitutes for any valid characters. A generic job name specifies all jobs with job names that begin with the generic prefix.
- nom
- Indiquez le nom du travail à surveiller. Specify the name of the job to be watched.
-
Qualificatif 2: Utilisat
- nom-générique
- Indiquez le nom générique du nom d'utilisateur du travail à surveiller. Un nom générique est une chaîne de caractères composée d'un ou plusieurs caractères suivis d'un astérisque (*) ; par exemple, ABC*. L'astérisque remplace tout caractère valide. Un nom d'utilisateur générique désigne tous les travaux portant le nom de travail indiqué et dont le nom d'utilisateur commence par le préfixe générique. Specify the generic name of the user name of the job to be watched. A generic name is a character string of one or more characters followed by an asterisk (*); for example, ABC*. The asterisk substitutes for any valid characters. A generic user name specifies all jobs with the specified job name and with user names that begin with the generic prefix.
- nom
- Indiquez le nom d'utilisateur du travail à surveiller. Specify the user name of the job to be watched.
-
Qualificatif 3: Numéro
- *ALL
- Tous les travaux portant le nom de travail et le nom d'utilisateur indiqués sont surveillés. All jobs with the specified job name and user name are watched.
- 000000-999999
- Indiquez le numéro de travail pour qualifier plus précisément le nom de travail et le nom d'utilisateur. Vous ne pouvez pas indiquer de numéro de travail si un qualificatif de nom de travail générique ou de nom d'utilisateur générique est indiqué. Specify the job number to further qualify the job name and user name. You cannot specify a job number if a generic job name or a generic user name qualifier is specified.
Surveiller une entrée du journal LIC (WCHLICLOG)Watch for LIC log entry (WCHLICLOG)
Indique jusqu'à cinq identificateurs d'entrée du journal du code interne sous licence (LIC) à surveiller. Chaque entrée du journal LIC contient un code majeur et un code mineur. La condition surveillée sera remplie si une entrée du journal LIC correspondant aux codes majeur et mineur indiqués et aux éventuelles données de comparaison indiquées est ajoutée. Lorsque l'entrée de journal surveillée est ajoutée au journal LIC, le programme d'exit de trace est appelé, même si les données de comparaison indiquées ne correspondent pas ; si aucun programme d'exit de trace n'est défini, la trace s'arrête. Specifies up to five licensed internal code (LIC) log entry identifiers which are to be watched for. Each LIC log entry contains a major and a minor code. The watched for condition will be met if a LIC log entry is added that matches the specified major and minor codes and any comparison data specified. When the watched for log entry is added to the LIC log, the trace exit program is called, even when the comparison data specified does not match; if no trace exit program is defined, the trace stops.
Valeurs uniques
- *NONE
- Aucune entrée du journal LIC ne sera surveillée. No LIC log entries will be watched for.
Élément 1: Major code
- *ALL
- Tout code majeur d'entrée du journal LIC sera considéré comme une correspondance. Si *ALL est indiqué pour le code majeur, vous ne pouvez pas indiquer *ALL pour le code mineur de l'entrée du journal LIC. Any LIC log entry major code will be considered to be a match. If *ALL is specified for the major code, you cannot specify *ALL for the LIC log entry minor code.
- valeur-caractère
- Indiquez le code majeur du journal LIC à surveiller. Vous pouvez indiquer soit un chiffre hexadécimal, soit un point d'interrogation pour chaque caractère du code à quatre chiffres. Un point d'interrogation est un caractère générique qui correspond à n'importe quel chiffre à cette position. Jusqu'à trois caractères génériques peuvent être indiqués. Specify the LIC log major code to be watched for. You can specify either a hexadecimal digit or a question mark for each character in the four-digit code. A question mark is a wildcard character that will match any digit in that position. Up to three wildcard characters can be specified.
Élément 2: Minor code
- *ALL
- Tout code mineur d'entrée du journal LIC sera considéré comme une correspondance. Si *ALL est indiqué pour le code mineur, vous ne pouvez pas indiquer *ALL pour le code majeur de l'entrée du journal LIC. Any LIC log entry minor code will be considered to be a match. If *ALL is specified for the minor code, you cannot specify *ALL for the LIC log entry major code.
- valeur-caractère
- Indiquez le code mineur du journal LIC à surveiller. Vous pouvez indiquer soit un chiffre hexadécimal, soit un point d'interrogation pour chaque caractère du code à quatre chiffres. Un point d'interrogation est un caractère générique qui correspond à n'importe quel chiffre à cette position. Jusqu'à trois caractères génériques peuvent être indiqués. Specify the LIC log minor code to be watched for. You can specify either a hexadecimal digit or a question mark for each character in the four-digit code. A question mark is a wildcard character that will match any digit in that position. Up to three wildcard characters can be specified.
Élément 3: Donnée de comparaison
Indiquez les données de comparaison à utiliser si une entrée de journal correspondant aux codes majeur et mineur indiqués est ajoutée au journal du code interne sous licence (LIC). Si ce texte est trouvé dans les zones de données de l'entrée du journal LIC surveillée, la condition surveillée est vraie. Si ce texte n'est pas trouvé dans les zones de données de l'entrée du journal LIC surveillée et qu'aucun programme d'exit n'est indiqué dans le paramètre TRCPGM, la fonction de trace se poursuit. Si l'entrée de journal correspond aux codes majeur et mineur indiqués et qu'un programme d'exit est indiqué dans le paramètre TRCPGM, mais que les données de l'entrée ne contiennent pas le texte indiqué, le programme d'exit est appelé pour déterminer si la trace doit se poursuivre ou s'arrêter. Specify comparison data to be used if a log entry matching the specified major and minor codes is added to the licensed internal code (LIC) log. If this text is found in the LIC log entry data fields of the watched for log entry, the watched for condition is true. If this text is not found in the LIC log entry data fields of the watched for log entry and no exit program is specified on the TRCPGM parameter, the trace function continues. If the log entry matches the specified major and minor codes and an exit program is specified on the TRCPGM parameter, but the entry data does not contain the specified text, the exit program is called to determine if the trace should continue or stop.
- *NONE
- Aucune donnée de comparaison n'est indiquée. Si une entrée du journal LIC correspondant aux codes majeur et mineur indiqués est ajoutée au journal LIC, la condition surveillée est vraie. No comparison data is specified. If a LIC log entry matching the specified major and minor codes is added to the LIC log, the watched for condition is true.
- valeur-caractère
- Specify the text string used to compare against the entry data of the watched for log entry. If this text is found in the LIC log entry data field specified for element 4, the watch condition is considered to be true. This text is case sensitive. If *ALL is specified in the LIC log compare against field, the LIC log fields which will be compared are TDE number, task name, server type, job name, user ID, job number, thread ID, exception ID, LIC module compile timestamp, LIC module offset, LIC module RU name, LIC module name, LIC module entry point name. The comparison data cannot be used to match across two fields, and can match an entire field or a substring of any field.
Lors de la surveillance d'un ID d'exception, les quatre chiffres hexadécimaux de l'ID d'exception doivent être indiqués. Le préfixe MCH peut également être indiqué si vous souhaitez comparer uniquement avec la zone d'ID d'exception et éviter d'éventuelles correspondances de sous-chaîne avec les autres zones. When watching for an exception ID, all four hexadecimal digits of the exception ID must be specified. Also, the prefix MCH may be specified if you want to compare only against the exception ID field and avoid possible substring matches with the other fields.
Élément 4: Compare against
Indiquez la partie du journal LIC avec laquelle les données de comparaison indiquées pour l'élément 3 doivent être comparées. Specify which part of the LIC log the comparison data specified for element 3 is to be compared against.
- *ALL
- Les données de comparaison du journal LIC seront comparées à toutes les zones décrites ci-dessous. The LIC log comparison data will be compared against all the fields described below.
- *TDENBR
- Les données de comparaison du journal LIC seront comparées au numéro de l'élément de répartition de tâche (TDE) qui a demandé l'entrée du journal LIC. The LIC log comparison data will be compared against the number of the task dispatching element (TDE) which requested the LIC log entry.
- *TASKNAME
- Les données de comparaison du journal LIC seront comparées au nom de la tâche qui a demandé l'entrée du journal LIC. Le nom de tâche est à blanc (hex 40) si l'entrée du journal LIC n'est pas demandée par une tâche. The LIC log comparison data will be compared against the name of the task which requested the LIC log entry. Task name is blank (hex 40s) if the LIC log entry is not requested by a task.
- *SVRTYPE
- Les données de comparaison du journal LIC seront comparées au type de serveur qui a demandé l'entrée du journal LIC. Le type de serveur est à blanc (hex 40) si l'entrée du journal LIC n'est pas demandée par un serveur. The LIC log comparison data will be compared against the type of server that requested the LIC log entry. Server type is blank (hex 40s) if the LIC log entry is not requested by a server.
- *JOBNAME
- Les données de comparaison du journal LIC seront comparées au nom du travail qui a demandé l'entrée du journal LIC. Le nom de travail LIC est à blanc (hex 40) si l'entrée du journal LIC n'est pas demandée par un travail. The LIC log comparison data will be compared against the name of the job which requested the LIC log entry. LIC job name is blank (hex 40s) if the LIC log entry is not requested by a job.
- *JOBUSR
- Les données de comparaison du journal LIC seront comparées au nom d'utilisateur du travail qui a demandé l'entrée du journal LIC. Le nom d'utilisateur LIC est à blanc (hex 40) si l'entrée du journal LIC n'est pas demandée par un travail. The LIC log comparison data will be compared against the user name of the job which requested the LIC log entry. LIC user name is blank (hex 40s) if the LIC log entry is not requested by a job.
- *JOBNBR
- Les données de comparaison du journal LIC seront comparées au numéro de travail (000000-999999) qui qualifie plus précisément le nom de travail et le nom d'utilisateur du travail qui a demandé l'entrée du journal LIC. Le numéro de travail LIC est à blanc (hex 40) si l'entrée du journal LIC n'est pas demandée par un travail. The LIC log comparison data will be compared against the job number (000000-999999) to further qualify the job name and user name of the job which requested the LIC log entry. LIC job number is blank (hex 40s) if the LIC log entry is not requested by a job.
- *THDID
- Les données de comparaison du journal LIC seront comparées à l'unité d'exécution qui a demandé l'entrée du journal LIC. L'identificateur d'unité d'exécution est à zéros binaires si l'entrée du journal LIC n'est pas demandée par une unité d'exécution. The LIC log comparison data will be compared against the thread which requested the LIC log entry. Thread identifier is binary zeros if the LIC log entry is not requested by a thread.
- *EXCPID
- Les données de comparaison du journal LIC seront comparées à l'exception qui a provoqué la demande de l'entrée du journal LIC. Il s'agit d'une zone hexadécimale de 2 octets formée en concaténant, au numéro de groupe d'exceptions de 1 octet de poids fort, un numéro de sous-type d'exception de 1 octet de poids faible. L'identificateur d'exception est à zéros binaires si l'entrée du journal LIC n'est pas demandée à la suite d'une exception. The LIC log comparison data will be compared against the exception that caused the LIC log entry to be requested. This is a 2-byte hexadecimal field formed by concatenating to the high-order 1-byte exception group number a low-order 1-byte exception subtype number. Exception identifier is binary zeros if the LIC log entry is not requested as a result of an exception.
- *MODNAME
- Les données de comparaison du journal LIC seront comparées au nom du module LIC qui a demandé l'entrée du journal LIC. Si le nom du module dépasse 64 caractères, le nom du module LIC est tronqué à 64 caractères. The LIC log comparison data will be compared against the LIC module name which requested the LIC log entry. If the module name is greater than 64 characters, the LIC module name is truncated to 64 characters.
- *MODRUNAME
- Les données de comparaison du journal LIC seront comparées au nom de l'unité de remplacement du module LIC. Le nom de l'unité de remplacement du module LIC est toujours en EBCDIC majuscules. The LIC log comparison data will be compared against the LIC module replacement unit name. LIC module RU name is always in upper case EBCDIC.
- *MODEPNAME
- Les données de comparaison du journal LIC seront comparées au nom du point d'entrée qui a demandé l'entrée du journal LIC. Si le nom du point d'entrée dépasse 128 caractères, le nom du point d'entrée du module LIC est tronqué à 128 caractères. The LIC log comparison data will be compared against the name of the entry point which requested the LIC log entry. If the entry point name is greater than 128 characters, the LIC module entry point name is truncated to 128 characters.
- *MODOFFSET
- Les données de comparaison du journal LIC seront comparées au déplacement en octets dans le texte du module LIC qui a demandé l'entrée du journal LIC. The LIC log comparison data will be compared against the byte offset into the LIC module text which requested the LIC log entry.
- *MODTSP
- Les données de comparaison du journal LIC seront comparées à l'horodatage de compilation du module LIC. Le format de cette zone est le format d'horodatage du système. The LIC log comparison data will be compared against the timestamp of when the LIC module was compiled. The format for this field is the system time-stamp format.
Surveiller une entrée PAL (WCHPAL)Watch for PAL entry (WCHPAL)
Indique jusqu'à cinq entrées du journal d'activité du produit (PAL) à surveiller. Lorsque le PAL surveillé se produit, le programme d'exit de trace est appelé ; si aucun programme d'exit de trace n'est défini, la trace s'arrête. Specifies up to five Product Activity Log (PAL) entries which are to be watched for. When the watched for PAL occurs, the trace exit program is called; if no trace exit program is defined, the trace stops.
Valeurs uniques
- *NONE
- Aucune entrée PAL ne sera surveillée. No PAL entries will be watched for.
Autres valeurs (jusqu'à 5 répétitions)
Élément 1: Code SRC
- *ALL
- Tout code de référence système sera considéré comme une correspondance. Any system reference code will be considered to be a match.
- valeur-caractère
- Indiquez le code de référence système (SRC) à surveiller. Vous pouvez indiquer soit un chiffre hexadécimal, soit un point d'interrogation pour chaque caractère du code à huit chiffres. Un point d'interrogation est un caractère générique qui correspond à n'importe quel chiffre à cette position. Jusqu'à sept caractères génériques peuvent être indiqués. Vous pouvez également indiquer un SRC générique, c'est-à-dire une chaîne de caractères composée d'un ou plusieurs caractères suivis d'un astérisque (*) ; par exemple, ABC*. L'astérisque remplace tout caractère valide. Un SRC générique désigne toutes les entrées PAL dont le code de référence système commence par le préfixe générique. Specify the system reference code (SRC) to be watched for. You can specify either a hexadecimal digit or a question mark for each character in the eight-digit code. A question mark is a wildcard character that will match any digit in that position. Up to seven wildcard characters can be specified. You can also specify a generic SRC that is a character string of one or more characters followed by an asterisk (*); for example, ABC*. The asterisk substitutes for any valid characters. A generic SRC specifies all PAL entries with system reference codes that begin with the generic prefix.
Élément 2: Donnée de comparaison
- *NONE
- Aucune donnée de comparaison n'est indiquée. Si une entrée PAL correspondant au code de référence système indiqué se produit, la condition surveillée est vraie. No comparison data is specified. If a PAL entry matching the specified system reference code occurs, the watched for condition is true.
- valeur-caractère
- Specify the text string used to compare against the field specified in element 3 of the watched for PAL entry. This text is case sensitive.
Vous pouvez indiquer les caractères génériques point d'interrogation (?) et astérisque (*) dans la chaîne de texte. Un point d'interrogation est un caractère générique d'un seul caractère et correspond à n'importe quel caractère à la même position. Par exemple, '??123' correspond à toute valeur de cinq caractères se terminant par '123'. Plusieurs caractères génériques point d'interrogation peuvent être indiqués pour la valeur des données de comparaison. You can specify question mark (?) and asterisk (*) wildcard characters in the text string. A question mark is a single-character wildcard and will match any character in the same position. For example, '??123' will match any value that is five characters long and ends with '123'. Multiple question mark wildcard characters can be specified for the comparison data value.
Un astérisque est un caractère générique de plusieurs caractères. Vous pouvez indiquer un seul caractère générique astérisque à la fin de la valeur des données de comparaison. Par exemple, 'ABC*' correspond à toute valeur commençant par les lettres 'ABC'. An asterisk is a multiple-character wildcard character. You can specify a single asterisk wildcard character at the end of the comparison data value. For example, 'ABC*' will match any value that begins with the letters 'ABC'.
Indiquez les données de comparaison à utiliser si une entrée PAL correspondant au code de référence système indiqué se produit. Si la zone indiquée à l'élément 3 correspond au texte indiqué, la condition surveillée est vraie. Si la zone indiquée à l'élément 3 ne correspond pas au texte indiqué, la fonction de surveillance se poursuit simplement. Specify comparison data to be used if a PAL entry matching the specified system reference code occurs. If the field specified in element 3 matches the specified text, the watched for condition is true. If the field specified in element 3 does not match the specified text, the watch function just continues.
Élément 3: Compare against
- *RSCNAME
- Les données de comparaison seront comparées au nom de l'unité physique dont l'entrée figure dans le journal. Un nom de ressource est d'abord attribué par le système, mais il a pu être remplacé par une nouvelle valeur par un utilisateur. The comparison data will be compared against the name of the physical device that has the entry in the log. A resource name is assigned at first by the system, but may have been changed to a new value by a user.
- *RSCTYPE
- Les données de comparaison seront comparées au numéro ou au mot servant à identifier un produit. The comparison data will be compared against the number or word used to identify a product.
- *RSCMODEL
- Les données de comparaison seront comparées aux numéros ou aux lettres servant à identifier le niveau de fonction d'un produit d'un type donné. The comparison data will be compared against the numbers or letters used to identify the feature level of a product with a given type.
Indiquez la partie de l'entrée PAL avec laquelle les données de comparaison indiquées pour l'élément 2 doivent être comparées. Specify which part of the PAL entry the comparison data specified for element 2 is to be compared against.
Durée de la surveillance (WCHTIMO)Length of time to watch (WCHTIMO)
Indique le délai maximal, en minutes, de surveillance d'un message, d'une entrée du journal du code interne sous licence (LIC) ou d'une entrée du journal d'activité du produit (PAL). Lorsque le délai indiqué s'est écoulé, le programme d'exit de trace est appelé (si un tel programme a été indiqué dans le paramètre TRCPGM), la trace prend fin et le message CPI3999 est envoyé à l'historique. Specifies the time limit, in minutes, for watching for a message or a licensed internal code (LIC) log entry or a Product Activity Log (PAL) entry. When the specified amount of time has elapsed, the trace exit program is called (if one was specified on the TRCPGM parameter), the trace is ended, and message CPI3999 is sent to the history log.
- *NOMAX
- Il n'y a pas de délai maximal de surveillance d'un message, d'une entrée du journal LIC ou d'une entrée PAL particulière. There is no time limit for watching for a particular message or LIC log entry or PAL entry.
- 1-43200
- Indiquez le nombre de minutes pendant lesquelles la trace restera active tant qu'aucune des conditions surveillées n'a été remplie. Specify the number of minutes that the trace will remain active while none of the watched for conditions have been met.
Programme de trace (TRCPGM)Trace program (TRCPGM)
Indique le programme à appeler pour les commandes et procédures de trace définies par l'utilisateur. Specifies the program to be called for user-defined trace commands and procedures.
Le programme de trace sera appelé : The trace program will be called:
- Avant le démarrage de la trace d'application. Before the application trace starts.
- Après une correspondance avec un message indiqué dans le paramètre WCHMSG, une correspondance avec une entrée du journal du code interne sous licence (LIC) indiquée dans le paramètre WCHLICLOG, ou une correspondance avec une entrée du journal d'activité du produit (PAL) indiquée dans le paramètre WCHPAL. After a match of a message specified for the WCHMSG parameter, or a match of a Licensed Internal Code (LIC) log entry specified for the WCHLICLOG parameter, or a match of a Product Activity Log (PAL) entry specified for the WCHPAL parameter occurs.
- Lorsque l'intervalle de temps indiqué dans le paramètre TRCPGMITV est atteint. When the time interval specified on the TRCPGMITV parameter is reached.
- Lorsque la durée de surveillance indiquée dans le paramètre WCHTIMO est atteinte. When the length of time to watch specified on WCHTIMO parameter is reached.
Trois paramètres d'entrée et un paramètre de sortie sont associés au programme de trace. Les quatre paramètres sont obligatoires : There are three input parameters and one output parameter associated with the trace program. The four parameters are required:
1 Trace option setting Input Char(10) 2 Reserved Input Char(10) 3 Error detected Output Char(10) 4 Comparison data Input Char(*)
Les valeurs autorisées pour le paramètre « Trace option setting » sont : Allowed values for the "Trace option setting" parameter are:
- *ON
- La fonction de surveillance de trace démarre lorsque la collecte des informations de trace est lancée. The watch for trace facility is starting when the collection of trace information is started.
- *MSGID
- Une correspondance avec un message indiqué dans le paramètre WCHMSG s'est produite. A match on a message specified on WCHMSG parameter occurred.
- *LICLOG
- Une correspondance avec un journal LIC indiqué dans le paramètre WCHLICLOG s'est produite. A match on a LIC log specified on the WCHLICLOG parameter occurred.
- *CMPDATA
- Les codes majeur et mineur d'un journal LIC correspondaient, mais pas les données de comparaison. The major and minor code of a LIC log matched, but the comparison data did not.
- *INTVAL
- L'intervalle de temps indiqué dans le paramètre TRCPGMITV s'est écoulé. The time interval specified on TRCPGMITV parameter is elapsed.
- *WCHTIMO
- La durée de surveillance indiquée dans le paramètre WCHTIMO s'est écoulée. The length of time to watch specified on WCHTIMO parameter is elapsed.
- *PAL
- Une correspondance avec un PAL et avec les éventuelles données de comparaison associées indiquées dans le paramètre WCHPAL s'est produite. A match on a PAL and any associated comparison data specified on the WCHPAL parameter occurred.
Le paramètre « Reserved » doit être défini à blanc. The "Reserved" parameter must be set to blanks.
Les valeurs autorisées pour le paramètre « Error detected » sont : Allowed values for the "Error detected" parameter are:
- *CONTINUE
- La trace et la fonction de surveillance d'événement de trace continueront de s'exécuter. The trace and the watch for trace event facility will continue running.
- *STOP
- La trace et la fonction de surveillance d'événement de trace prendront fin. The trace and the watch for trace event facility will be ended.
- *ERROR
- Erreur détectée par le programme de trace du client. Error detected by customer trace program.
Les valeurs autorisées pour le paramètre « Comparison data » lorsque *MSGID est indiqué pour le paramètre « Trace option setting » correspondent à la structure suivante : Allowed values for the "Comparison data" parameter when *MSGID is specified for the "Trace option setting" parameter will be the following structure:
OFFSET TYPE FIELD Dec Hex 0 0 BINARY(4) Length of trace information 4 4 CHAR(7) Message watched 11 B CHAR(9) Reserved 20 14 BINARY(4) Offset to comparison data 24 18 BINARY(4) Length of comparison data * * CHAR(*) Message comparison data
Les valeurs autorisées pour le paramètre « Comparison data » lorsque *LICLOG ou *CMPDATA est indiqué pour le paramètre « Trace option setting » correspondent à la structure suivante : Allowed values for the "Comparison data" parameter when *LICLOG or *CMPDATA is specified for the "Trace option setting" parameter will be the following structure:
OFFSET TYPE FIELD Dec Hex 0 0 BINARY(4) Length of trace information 4 4 CHAR(4) LIC Log major code 8 8 CHAR(4) LIC Log minor code 12 C CHAR(8) LIC Log id (keyword DMPID on PRTINTDTA) 20 14 BINARY(4) Offset to comparison data 24 18 BINARY(4) Length of comparison data * * CHAR(*) LIC log comparison data
Les valeurs autorisées pour le paramètre « Comparison data » lorsque *ON, *INTVAL ou *WCHTIMO est indiqué pour le paramètre « Trace option setting » correspondent à la structure suivante : Allowed values for the "Comparison data" parameter when *ON, *INTVAL or *WCHTIMO is specified for the "Trace option setting" parameter will be the following structure:
OFFSET TYPE FIELD Dec Hex 0 0 BINARY(4) Length of trace information (always 4).
Les valeurs autorisées pour le paramètre « Comparison data » lorsque *PAL est indiqué pour le paramètre « Trace option setting » correspondent à la structure suivante : Allowed values for the "Comparison data" parameter when *PAL is specified for the "Trace option setting" parameter will be the following structure:
OFFSET TYPE FIELD Dec Hex 0 0 BINARY(4) Length of watch information 4 4 CHAR(8) System reference code 12 C CHAR(10) Device name 22 16 CHAR(4) Device type 26 1A CHAR(4) Model 30 1E CHAR(15) Serial number 45 2D CHAR(10) Resource name 55 37 CHAR(8) Error Log id (keyword ERRLOGID on PRTERRLOG) 63 3F CHAR(8) PAL timestamp 71 47 CHAR(4) Reference code 75 4B CHAR(8) Secondary code 83 53 CHAR(8) Table identifier 91 5B CHAR(1) Reserved 92 5C BINARY(4) Sequence 96 60 BINARY(4) Offset to comparison data 100 64 BINARY(4) Length of comparison data 104 68 CHAR(10) PAL compare against * * CHAR(*) PAL comparison data
For more information on the trace exit program interface, refer to the Ensemble de rubriques API de la catégorie Programmation de l'IBM i Information Center (http://www.ibm.com/systems/i/infocenter/)
Valeurs uniques
- *NONE
- Aucun programme d'exit de trace n'est défini. Si un message, une entrée du journal du code interne sous licence (LIC) ou une entrée du journal d'activité du produit (PAL) surveillé est ajouté, ou si le délai de surveillance indiqué est dépassé, la fonction de trace prend fin. No trace exit program is defined. If a watched for message or licensed internal code (LIC) log entry or Product Activity Log (PAL) entry is added, or if the specified watch time limit is exceeded, the trace function ends.
Qualificatif 1 : Programme de trace Qualificatif 1: Trace program
- nom
- Indiquez le nom du programme d'exit de trace. Specify the name of the trace exit program.
Qualificatif 2: Biblio
- *LIBL
- Toutes les bibliothèques de la liste de bibliothèques du travail sont parcourues jusqu'à la première correspondance. All libraries in the job's library list are searched until the first match is found.
- nom
- Indiquez le nom de la bibliothèque dans laquelle se trouve le programme d'exit utilisateur. Specify the name of the library where the user exit program is located.
Intervalle (TRCPGMITV)
Indique la fréquence d'appel du programme d'exit de trace. Specifies how often the trace exit program will be called.
- *NONE
- Aucun intervalle de temps n'est indiqué. Le programme d'exit de trace ne sera pas appelé du fait de l'écoulement d'un intervalle de temps. No time interval is specified. The trace exit program will not be called because a time interval has elapsed.
- 1-9999
- Indiquez l'intervalle de temps, en secondes, qui détermine la fréquence d'appel du programme d'exit de trace. Il doit être inférieur à la durée indiquée pour le paramètre Durée de la surveillance (WCHTIMO). Specify the interval of time, in seconds, of how often the trace exit program will be called. This must be less than the amount of time specified for the Length of time to watch (WCHTIMO) parameter.
Priorité d'exécution (RUNPTY)
Indique la priorité du travail dans lequel le travail de la session de surveillance sera exécuté. Specifies the priority of the job where the watch session work will be run.
- 25
- Une priorité de travail de 25 sera utilisée. A job priority of 25 will be used.
- 1-99
- Indiquez la priorité d'exécution du travail. Pour plus d'informations sur la priorité d'exécution d'un travail, voir Ensemble de rubriques Gestion des travaux de l'IBM i Information Center, à l'adresse http://www.ibm.com/systems/i/infocenter/ Specify the run priority of the job. For more information on job run priority, refer to the Ensemble de rubriques Gestion des travaux de l'IBM i Information Center, à l'adresse http://www.ibm.com/systems/i/infocenter/
Options de fichier STREAM (TOSTMF)Stream file options (TOSTMF)
Indique le fichier STREAM vers lequel les données sont dirigées et si le fichier doit être remplacé s'il existe. Specifies the stream file to which data is directed and whether the file should be replaced if it exists.
Élément 1: Stream file
- chemin-d'accès
- Indiquez le chemin d'accès du fichier STREAM à utiliser. Tous les répertoires du chemin d'accès doivent exister. Les nouveaux répertoires ne sont pas créés. Si le fichier STREAM n'existe pas, il est créé. Pour plus d'informations sur la façon d'indiquer les chemins d'accès, reportez-vous à « Règles de dénomination des objets » dans la collection de rubriques CL de la catégorie Programmation du centre de documentation IBM i à l'adresse http://www.ibm.com/systems/i/infocenter/. Specify the path name for the stream file to be used. All directories in the path name must exist. New directories are not created. If the stream file does not exist, it is created. For more information on specifying path names, refer to "Object naming rules" in the CL topic collection in the Programming category in the IBM i Information Center at http://www.ibm.com/systems/i/infocenter/.
Élément 2: Remplacer fichier
- *NO
- Aucun enregistrement n'est copié et un message d'erreur est signalé si le fichier existe déjà. No records are copied and an error message is signaled if the file already exists.
- *YES
- Les enregistrements de données de trace remplacent les enregistrements du fichier STREAM existant. The trace data records replace the existing stream file records.
Fichier STREAM d'origine (FROMSTMF)
Indique le fichier STREAM à partir duquel les données sont imprimées. Specifies the stream file from which data is printed.
- chemin-d'accès
- Indiquez le chemin d'accès du fichier STREAM à utiliser. Pour plus d'informations sur la façon d'indiquer les chemins d'accès, reportez-vous à « Règles de dénomination des objets » dans la collection de rubriques CL de la catégorie Programmation du centre de documentation IBM i à l'adresse http://www.ibm.com/systems/i/infocenter/. Specify the path name for the stream file to be used. For more information on specifying path names, refer to "Object naming rules" in the CL topic collection in the Programming category in the IBM i Information Center at http://www.ibm.com/systems/i/infocenter/.
Exemples
Exemple 1 : Démarrage des traces de données de composant et des traces d'appels Example 1: Starting Component Data Traces and Call Traces
TRCINT SET(*ON) TRCTYPE(010100 010400 050500 051200)
Cette commande démarre les traces de données de composant et les traces d'appels pour la gestion des ressources et la base de données. Les opérations de base de données associées aux fichiers de base de données servent à collecter les enregistrements de trace de données de composant. This command starts component data traces and call traces for resource management and database. Database operations associated with database files are used to collect component data trace records.
Exemple 2 : Trace de lignes et de contrôleurs Example 2: Tracing Lines and Controllers
TRCINT SET(*ON) TRCTYPE(*SRCSINK) TRCTBL(*SYSDFT)
DEV(WS1 WS2 WS3) CTL((C1) (C2)) LIN((L1) (L2))
Cette commande démarre les traces de données de composant pour les opérations de gestion source/récepteur (prise en charge des unités) impliquant les unités WS1, WS2 et WS3, les lignes L1 et L2, et les contrôleurs C1 et C2. This command starts component data traces for source/sink management (device support) operations involving the devices WS1, WS2, and WS3, lines L1 and L2, and controllers C1 and C2.
Exemple 3 : Arrêt des traces et effacement de la table de trace Example 3: Stopping Traces and Clearing Trace Table
TRCINT SET(*END) TRCTBL(*SYSDFT)
Cette commande arrête toutes les traces et supprime les enregistrements de trace de la table de trace par défaut du système. This command stops all traces and deletes the trace records from the system default trace table.
Exemple 4 : Trace de la fonction de service de trace des communications Example 4: Tracing Communications Trace Service Function
TRCINT SET(*ON) TRCTYPE(*CMNTRC)
Cette commande démarre les traces de données de composant pour la fonction de service de trace des communications. This command starts component data traces for the communications trace service function.
Exemple 5 : Utilisation de la fonction de filtrage des travaux Example 5: Using Job Filtering Capability
TRCINT SET(*ON) TRCTBL(MYFTPTRACE)
TRCTYPE(*TCPIP) JOB(QTCP/QTFTP*)
Cette commande démarre une trace TCP/IP et ne collecte que les enregistrements de trace des points de trace collectés dans les travaux dont le nom d'utilisateur est QTCP et dont le nom commence par le préfixe QTFTP. Les enregistrements de trace seront stockés dans la table de trace MYFTPTRACE. This command starts a TCP/IP trace and will only collect trace records for trace points collected in jobs with user name QTCP and job names that begin with the prefix QTFTP. Trace records will be stored in trace table MYFTPTRACE.
Exemple 6 : Démarrage d'une trace et surveillance d'un message pour arrêter la trace Example 6: Start a Trace and Watch for a Message to End the Trace
TRCINT SET(*ON) TRCTYPE(*CMNTRC) WCHMSG((MCH2804))
WCHMSGQ((*SYSOPR) (*JOBLOG))
WCHJOB((*ALL/MYUSER/MYJOBNAME))
TRCPGM(MYLIB/TRCEXTPGM)
Cette commande démarre les traces de données de composant pour la fonction de service de trace des communications. La trace sera arrêtée lorsque le message MCH2804 sera trouvé dans la file d'attente de messages de l'opérateur système ou dans l'historique du travail *ALL/MYUSER/MYJOBNAME. En outre, MYLIB/TRCEXTPGM est indiqué comme programme d'exit de trace. This command starts component data traces for the communications trace service function. The trace will be ended when MCH2804 message is found on the System Operator message queue or within the *ALL/MYUSER/MYJOBNAME job log. Also, MYLIB/TRCEXTPGM is specified as a trace exit program.
Exemple 7 : Démarrage d'une trace et surveillance d'une entrée du journal LIC pour arrêter la trace Example 7: Start a Trace and Watch for a LIC Log Entry to End the Trace
TRCINT SET(*ON) TRCTYPE(*CMNTRC)
WCHLICLOG(('99??' 9932 MYJOBNAME))
WCHTIMO(*NOMAX)
Cette commande démarre les traces de données de composant pour la fonction de service de trace des communications. La trace sera arrêtée lorsqu'une entrée du journal du code interne sous licence (LIC) dont le code majeur commence par 99 et le code mineur est 9932 sera générée sur le système. En outre, les informations du journal LIC doivent contenir le texte « MYJOBNAME ». *NOMAX pour le paramètre WCHTIMO indique que la trace restera active jusqu'à ce que l'événement se produise ou que la commande TRCINT soit lancée manuellement pour arrêter la trace. This command starts component data traces for the communications trace service function. The trace will be ended when a Licensed Internal Code (LIC) log entry that has a major code starting with 99 and a minor code of 9932 is generated on the system. Also, the LIC log information should contain the text "MYJOBNAME". *NOMAX on WCHTIMO parameter indicates that the trace will be active until the event occurs or TRCINT command is issued manually to stop the trace.
Exemple 8 : Envoi de la sortie de trace dans un fichier de sortie Example 8: Sending the Trace Output to an Outfile
TRCINT SET(*OFF) OUTPUT(*OUTFILE)
OUTFILE(MYOUTFILE) OUTMBR(MYOUTMBR)
Cette commande génère le fichier de sortie MYOUTFILE avec le membre MYOUTMBR contenant les traces de données. This command generates the outfile MYOUTFILE with member MYOUTMBR with the data traces.
Exemple 9 : Envoi de la sortie de trace dans un fichier STREAM Example 9: Sending the Trace Output to a Stream File
TRCINT SET(*OFF) OUTPUT(*STMF)
TOSTMF('/MyTrace/TestTrace' *NO)
Cette commande décharge les informations dans le fichier STREAM /MyTrace/TestTrace. Si le fichier STREAM existe, il ne sera pas remplacé. This command dumps the information to stream file /MyTrace/TestTrace. If the stream file exists, it will not be replaced.
Exemple 10 : Conversion de la sortie de trace du fichier STREAM en fichier spoule lisible Example 10: Converting the Stream File Trace Output into a Readable Spooled File
TRCINT SET(*PRINT) OUTPUT(*PRINT)
FROMSTMF('/MyTrace/TestTrace')
Cette commande convertit la sortie de trace du fichier STREAM /MyTrace/TestTrace en un fichier spoule lisible. This command converts the /MyTrace/TestTrace stream file trace output into a readable spooled file.
Exemple 11 : Conversion de la sortie de trace du fichier STREAM en fichier de sortie lisible Example 11: Converting the Stream File Trace Output into a Readable Output File
TRCINT SET(*PRINT) OUTPUT(*OUTFILE)
OUTFILE(MYOUTFILE) OUTMBR(MYOUTMBR)
FROMSTMF('/MyTrace/TestTrace')
Cette commande convertit la sortie de trace du fichier STREAM /MyTrace/TestTrace en fichier de sortie lisible MYOUTFILE avec le membre MYOUTMBR. This command converts the /MyTrace/TestTrace stream file trace output into the readable output file MYOUTFILE with member MYOUTMBR.
Messages d'erreur
Messages *ESCAPE *ESCAPE Messages
- CPD3683
- Le paramètre TRCFULL n'est valide qu'avec SET(*ON). TRCFULL parameter only valid with SET(*ON).
- CPD3684
- Les paramètres indiqués ne sont valides que si SET(*ON) est indiqué. Specified parameters only valid when SET(*ON) is specified.
- CPD3685
- Les paramètres SLTTRCPNT et OMTTRCPNT sont mutuellement exclusifs. SLTTRCPNT or OMTTRCPNT parameters are mutually exclusive.
- CPD3686
- TCPDTA n'est valide que si *TCPIP, *SMBSVR, *FRCA ou une ou plusieurs valeurs TRCTYPE de socket sont indiquées. TCPDTA only valid if *TCPIP or *SMBSVR or *FRCA or one or more of the socket TRCTYPE is specified.
- CPD3687
- SCKDTA n'est valide que si une ou plusieurs valeurs TRCTYPE de socket sont indiquées. SCKDTA only valid if one or more of the socket TRCTYPE values is specified.
- CPD3688
- Le paramètre types de travail (JOBTYPE) n'est valide qu'avec TRCTYPE(*MPL). Job types (JOBTYPE) parameter only valid with TRCTYPE(*MPL).
- CPD3689
- Le paramètre intervalle de trace des travaux (JOBTRCITV) n'est valide qu'avec TRCTYPE(*MPL) Job trace interval (JOBTRCITV) parameter only valid with TRCTYPE(*MPL)
- CPD368A
- Impossible de modifier les critères de sélection des points de trace pour une table de trace active. Cannot change trace point selection criteria for active trace table.
- CPD36C0
- Le paramètre OUTDEV n'est valide qu'avec SET(*SAVE). OUTDEV parameter only valid with SET(*SAVE).
- CPD36C1
- Le paramètre SIZE n'est valide qu'avec SET(*ON) ou SET(*SIZE). SIZE parameter only valid with SET(*ON) or SET(*SIZE).
- CPD36CD
- Le paramètre TASKINF n'est valide qu'avec SET(*OFF) ou SET(*SAVE). TASKINF parameter only valid with SET(*OFF) or SET(*SAVE).
- CPD3983
- La plage du paramètre SIZE n'est pas valide. Range of parameter SIZE not valid.
- CPD3990
- Le qualificatif de numéro d'utilisateur n'est pas valide. User number qualifier not valid.
- CPD3991
- Travail, identificateur d'unité d'exécution ou tâche non actif. Job, thread identifier or task not active.
- CPF3515
- Trop de demandes de trace ou d'objets. Too many trace requests or objects.
- CPF3516
- La table de trace est pleine. Trace table is full.
- CPF3517
- Impossible d'indiquer *SELECT pour l'ID d'unité d'exécution à inclure. Cannot specify *SELECT for the thread ID to include.
- CPF3518
- La date et l'heure de fin sont antérieures à la date et à l'heure de début. End time and date earlier than start time and date.
- CPF3659
- Le total des paramètres CTL, DEV, LIN, NWI et NWS indiqués est supérieur au maximum autorisé. Total of specified CTL, DEV, LIN, NWI, and NWS greater than allowed.
- CPF3679
- La fonction de service a renvoyé le code de fin &1 qualificatif &2. Service function returned completion code &1 qualifier &2.
- CPF3683
- Une erreur s'est produite lors de l'ouverture du fichier d'imprimante. Error occurred trying to open printer file.
- CPF3684
- Une erreur s'est produite lors de la fermeture d'un fichier d'impression. Error occurred while trying to close a print file.
- CPF3685
- Une erreur s'est produite lors de l'écriture des données dans le fichier d'impression. Error occurred while data being put to print file.
- CPF3686
- La fonction de service s'est terminée avec un message d'erreur. Service function ended with error message.
- CPF3687
- Une erreur s'est produite lors de l'ouverture du fichier. Error occurred while trying to open file.
- CPF3688
- Une erreur s'est produite lors de la fermeture du fichier sur bande ou optique. Error occurred while tape or optical file being closed.
- CPF3689
- Une erreur s'est produite lors de l'écriture des données sur l'unité de bande ou optique. Error occurred while writing data to tape or optical device.
- CPF368A
- La taille de la table de trace n'a pas été modifiée. Trace table size not changed.
- CPF3692
- Une erreur s'est produite lors de la tentative d'écriture des données sur l'unité de bande ou optique. Error occurred while trying to write data to tape or optical device.
- CPF3693
- Fonction de service terminée en raison d'une erreur. Service function ended because error occurred.
- CPF3694
- Impossible de démarrer la fonction de service. Cannot start service function.
- CPF3695
- Il n'existe aucune table de trace. No trace tables exist.
- CPF3696
- Aucune trace enregistrée. No traces recorded.
- CPF3697
- Valeur du paramètre type de trace manquante. Trace type parameter value missing.
- CPF6614
- Une erreur s'est produite lors de l'écriture des données de trace dans le fichier. Error occurred while writing trace data to file.
- CPF6615
- Erreur lors de la création du fichier STREAM. Error during creation of stream file.
- CPF6616
- Une erreur s'est produite lors de la lecture des données du fichier STREAM. Error occurred while reading data from stream file.
- CPF7A11
- Table de trace &1 introuvable. Trace table &1 not found.
- CPF7A13
- Impossible de créer la table de trace. Trace table cannot be created.
- CPF7A15
- La mémoire tampon de trace doit être effacée. Trace buffer must be cleared.
- CPF7A17
- La trace est déjà active. Trace already is active.
- CPF7A1A
- Impossible de modifier les critères de sélection des points de trace pour une table de trace active. Cannot change trace point selection criteria for active trace table.
- CPF7A1C
- Adresse IP non valide. IP address not valid.
- CPF98A2
- Vous n'avez pas les droits sur la commande ou l'API &1. Not authorized to &1 command or API.
- CPFA0D4
- Une erreur s'est produite dans le système de fichiers. Code erreur &1.
© Copyright IBM Corp. Texte d'aide reproduit à des fins de formation.