TRCTCPAPP
Tracer application TCP/IP
Trace TCP/IP Application
En bref
La commande Tracer une application TCP/IP (TRCTCPAPP) est utilisée par le personnel de maintenance lorsque des informations de trace doivent être capturées pour l'une des applications TCP/IP suivantes : protocole FTP (File Transfer Protocol), serveur SMTP, client SMTP, API SMTP, REXEC,… The Trace TCP/IP Application (TRCTCPAPP) command is used by service personnel when trace information needs to be captured for one of the following TCP/IP applications: File Transfer Protocol (FTP), SMTP server, SMTP client, SMTP APIs, REXEC, TELNET/VTAPI, host servers, Distributed Data…
TRCTCPAPP se lit TRC
(Tracer) + TCPAPP.
Sur IBM i, le nom d'une commande associe presque toujours un verbe et un objet.
Syntaxe minimale
TRCTCPAPP APP(…)
Paramètres
-
APPApplication TCP/IP TCP/IP application obligatoire -
SETParamètre d'option de trace Trace option setting -
MAXSTGMémoire maximale pour la trace Maximum storage for trace -
TRCFULLAction en cas de trace pleine Trace full action -
ADLTRCTraces supplémentaires Additional traces -
TRCPGMProgramme de trace Trace program -
TITLETitre de la trace Trace title -
USERProfil utilisateur User profile -
MAILADRAdresse électronique du destinataire Recipient mail address -
HOSTNom d'hôte du destinataire Recipient host name -
RMTNETADRAdresse réseau distante Remote network address -
LCLNETADRAdresse réseau locale Local network address -
DEVDDescription d'unité Device description -
DEVTYPEType d'unité Device type -
TRCPNTPoint de trace Trace point -
ARGLISTListe d'arguments Argument list -
VPNSVRServeur de réseau privé virtuel Virtual private network server -
CERTTYPEType de services de certificats Certificate services type -
DNSService de noms de domaine Domain name service -
PPPCNNPRFProfil de connexion PPP PPP connection profile -
TCPTRCDTADonnées TCP/IP à tracer TCP/IP data to trace -
QOSTRCTYPEType de trace QOS QOS trace type -
HTTPSVRInstance de serveur HTTP HTTP server instance -
INSTANCEInstance -
TRCLVLNiveau de trace Trace level -
PKTTRCPNTPoints de trace des règles de paquets Packet rules trace points -
CFGOBJObjet de configuration Configuration object -
CFGTYPEType -
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 -
TRCPGMITVIntervalle -
RUNPTYPriorité d'exécution -
JOBTravaux Jobs
Astuce : dans une session 5250, tapez TRCTCPAPP 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 Tracer une application TCP/IP (TRCTCPAPP) est utilisée par le personnel de maintenance lorsque des informations de trace doivent être capturées pour l'une des applications TCP/IP suivantes : protocole FTP (File Transfer Protocol), serveur SMTP, client SMTP, API SMTP, REXEC, TELNET/VTAPI, serveurs hôtes, DDM (Distributed Data Management), réseau privé virtuel (VPN), protocole L2TP (Layer Two Tunneling Protocol), services de certificats, protocole PPP (Point-to-Point Protocol), qualité de service (QOS), protocole NTP simple (Network Time Protocol), services d'annuaire, serveur HTTP basé sur Apache ou règles de paquets. The Trace TCP/IP Application (TRCTCPAPP) command is used by service personnel when trace information needs to be captured for one of the following TCP/IP applications: File Transfer Protocol (FTP), SMTP server, SMTP client, SMTP APIs, REXEC, TELNET/VTAPI, host servers, Distributed Data Management (DDM), Virtual Private Network (VPN), Layer Two Tunneling Protocol (L2TP), certificate services, Point-to-Point Protocol (PPP), Quality Of Service (QOS), simple Network Time Protocol (NTP), directory services, HTTP server powered by Apache or packet rules.
Restrictions : Pour utiliser cette commande, vous devez posséder le droit spécial *SERVICE ou être autorisé à la fonction Service Trace via la prise en charge de l'administration des applications de Systems Director Navigator. Pour une application donnée, une seule trace peut être active à la fois sur le système. L'utilisateur doit posséder le droit *USE sur la ligne, l'interface réseau ou le serveur réseau à tracer. Restrictions: To use this command, you must have either *SERVICE special authority or be authorized to the Service Trace function through the Systems Director Navigator Application Administration support. For a given application, there could be only one trace active at a time on the system. The user must have *USE authority to the line, network interface, or network server to be traced.
Lorsque le paramètre Traces supplémentaires (ADLTRC) est indiqué, vous devez posséder le droit spécial sur tous les objets (*ALLOBJ) ou être autorisé à la fonction Trace Any User de la prise en charge de l'administration des applications de Systems Director Navigator. La commande Modifier l'utilisation d'une fonction (CHGFCNUSG), avec l'ID de fonction QIBM_ALLOBJ_TRACE_ANY_USER, peut également servir à modifier la liste des utilisateurs autorisés à effectuer des opérations de trace. When the Additional traces (ADLTRC) parameter is specified, you must have all object (*ALLOBJ) special authority or be authorized to the Trace Any User function of Systems Director Navigator Application Administration support. The Change Function Usage (CHGFCNUSG) command, with a function ID of QIBM_ALLOBJ_TRACE_ANY_USER, 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 de contrôle des travaux (*JOBCTL). Le droit spécial de contrôle des travaux (*JOBCTL) est également requis si un nom d'utilisateur générique est indiqué pour le paramètre Travail surveillé (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 Watched job (WCHJOB) parameter.
Si vous indiquez un nom d'utilisateur générique dans le paramètre Travail surveillé (WCHJOB), vous devez posséder le droit spécial sur tous les objets (*ALLOBJ) ou être autorisé à la fonction Watch any job du système d'exploitation 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, peut également servir à 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 Watched job (WCHJOB) parameter, you must have all object (*ALLOBJ) special authority, or be authorized to the Watch any job function of Operating System 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.
Une trace ne peut pas être définie pour tracer tous les noms de travaux et tous les utilisateurs. A trace cannot be defined to trace all job names and all users.
Remarque : Chaque fois que le terme serveur hôte apparaît dans ce texte d'aide, il désigne l'un des serveurs hôtes d'application : *CENTRAL, *DTAQ, *RMTCMD, *SIGNON, *NETPRT, *SVRMAP ou *DATABASE. Note: Whenever the term host server is seen within this help text, it refers to one of the application host servers: *CENTRAL, *DTAQ, *RMTCMD, *SIGNON, *NETPRT, *SVRMAP or *DATABASE.
Paramètres
| Mot-clé | Description | Valeurs possibles | Remarques |
|---|---|---|---|
| APP | Application TCP/IPTCP/IP application | *FTP, *SMTPSVR, *SMTPCLT, *TELNET, *VTAPI, *CENTRAL, *DTAQ, *RMTCMD, *SIGNON, *NETPRT, *SVRMAP, *DDM, *VPN, *CERTSRV, *L2TP, *PPP, *QOS, *NTP, *HTTP, *DIRSRV, *DATABASE, *PKTRULES, *POP, *MSF, *SMTPAPI, *REXEC, *DIRCLT | Obligatoire, positionnel 1 |
| SET | Paramètre d'option de traceTrace option setting | *ON, *OFF, *END, *CHK | Facultatif, positionnel 2 |
| MAXSTG | Mémoire maximale pour la traceMaximum storage for trace | 1-16000, *APP | Facultatif, positionnel 3 |
| TRCFULL | Action en cas de trace pleineTrace full action | *WRAP, *STOPTRC | Facultatif, positionnel 4 |
| ADLTRC | Traces supplémentairesAdditional traces | Valeurs uniques: *NONE Autres valeurs (jusqu'à 11 répétitions): *CMNARB, *CMNTRC, *DEVD, *DEVMGR, *JOB, *SOCKETS, *SRCSINK, *SYSARB, *TCPIP, *USER, *USERDEVD |
Facultatif, positionnel 5 |
| TRCPGM | Programme de traceTrace program | Valeurs uniques: *NONE Autres valeurs: Nom d'objet qualifié |
Facultatif, positionnel 6 |
| Qualificatif 1 : Programme de traceQualificatif 1: Trace program | Nom | ||
| Qualificatif 2: BibliothèqueQualificatif 2: Library | Nom, *LIBL, *CURLIB | ||
| TITLE | Titre de la traceTrace title | Valeur caractère, *DFT | Facultatif, positionnel 7 |
| USER | Profil utilisateurUser profile | Nom simple | Facultatif, positionnel 8 |
| MAILADR | Adresse électronique du destinataireRecipient mail address | Valeur caractère | Facultatif, positionnel 9 |
| HOST | Nom d'hôte du destinataireRecipient host name | Valeur caractère | Facultatif, positionnel 10 |
| RMTNETADR | Adresse réseau distanteRemote network address | Liste d'éléments | Facultatif, positionnel 11 |
| Élément 1: Address family | *CALC | ||
| Élément 2: IP address | Valeur caractère | ||
| Élément 3: Subnet mask or Prefix length | Valeur caractère, *HOST | ||
| Élément 4: Port number | 1-65535, *ANY | ||
| LCLNETADR | Adresse réseau localeLocal network address | Liste d'éléments | Facultatif, positionnel 12 |
| Élément 1: Address family | *CALC, *UNIX | ||
| Élément 2: IP address or UNIX path | Valeur caractère | ||
| Élément 3: Subnet mask or Prefix length | *HOST | ||
| Élément 4: Port number | 1-65535, *ANY | ||
| DEVD | Description d'unitéDevice description | Nom générique, nom | Facultatif, positionnel 13 |
| DEVTYPE | Type d'unitéDevice type | Valeurs uniques: *DSP, *PRT Autres valeurs (jusqu'à 6 répétitions): 5251, 5291, 5292, 3196, 3488, 3487, 3179, 3180, 5555, 3477, 3277, 3278, 3279, V100, 3812, 5553 |
Facultatif, positionnel 14 |
| TRCPNT | Point de traceTrace point | Values (jusqu'à 12 répétitions): Valeur caractère | Facultatif, positionnel 15 |
| ARGLIST | Liste d'argumentsArgument list | Valeur caractère | Facultatif, positionnel 16 |
| VPNSVR | Serveur de réseau privé virtuelVirtual private network server | Values (jusqu'à 2 répétitions): *KEYMGR, *CNNMGR | Facultatif, positionnel 17 |
| CERTTYPE | Type de services de certificatsCertificate services type | *ALL, *DCM, *KEYMGR, *SSL, *OBJSIGN, *OTHER | Facultatif, positionnel 18 |
| DNS | Service de noms de domaineDomain name service | *NO, *YES | Facultatif, positionnel 19 |
| PPPCNNPRF | Profil de connexion PPPPPP connection profile | Valeur caractère | Facultatif, positionnel 20 |
| TCPTRCDTA | Données TCP/IP à tracerTCP/IP data to trace | *PPPALL, *LCPNCP | Facultatif, positionnel 21 |
| QOSTRCTYPE | Type de trace QOSQOS trace type | *ALL, *POLICYD, *RSVPD | Facultatif, positionnel 22 |
| HTTPSVR | Instance de serveur HTTPHTTP server instance | Valeur caractère | Facultatif, positionnel 23 |
| INSTANCE | Instance | Valeur caractère, *DFT, *ALL | Facultatif, positionnel 24 |
| TRCLVL | Niveau de traceTrace level | *ERROR, *INFO, *VERBOSE | Facultatif, positionnel 25 |
| PKTTRCPNT | Points de trace des règles de paquetsPacket rules trace points | *TRAFFIC, *LOAD | Facultatif, positionnel 26 |
| CFGOBJ | Objet de configurationConfiguration object | Nom | Facultatif, positionnel 27 |
| CFGTYPE | Type | *LIN, *NWI, *NWS | Facultatif, positionnel 28 |
| WCHMSG | Surveiller un messageWatch for message | Valeurs uniques: *NONE Autres valeurs (jusqu'à 5 répétitions): Liste d'éléments |
Facultatif, positionnel 29 |
| É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, positionnel 30 |
| É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, positionnel 31 |
| É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, positionnel 32 |
| É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, positionnel 33 |
| É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, positionnel 34 |
| TRCPGMITV | Intervalle | 1-9999, *NONE | Facultatif, positionnel 35 |
| RUNPTY | Priorité d'exécution | 1-99, 25 | Facultatif, positionnel 36 |
| JOB | TravauxJobs | Valeurs uniques: * Autres valeurs (jusqu'à 16 répétitions): Liste d'éléments |
Facultatif, positionnel 37 |
| Élément 1: Travail | Nom de travail qualifié | ||
| Qualificatif 1: Travail | Nom générique, nom, *ALL | ||
| Qualificatif 2: Utilisat | Nom générique, nom, *ALL | ||
| Qualificatif 3: Numéro | 000001-999999, *ALL |
Application TCP/IP (APP)TCP/IP application (APP)
Indique l'application TCP/IP. Ce paramètre est obligatoire. Specifies the TCP/IP application. This is a required parameter.
- *CENTRAL
- Indique la trace du serveur hôte central. Specifies tracing for the central host server.
- *CERTSRV
- Indique la trace des services de certificats. Specifies tracing for certificate services.
- *DATABASE
- Indique la trace du serveur hôte de base de données. Specifies tracing for the database host server.
- *DDM
- Indique la trace du serveur DDM (Distributed Data Management). Specifies tracing for the Distributed Data Management (DDM) server.
- *DIRSRV
- Indique la trace des services d'annuaire. Specifies tracing for directory services.
- *DTAQ
- Indique la trace du serveur hôte de file d'attente de données. Specifies tracing for the data queue host server.
- *FTP
- Indique la trace du serveur FTP (File Transfer Protocol). Specifies tracing for the File Transfer Protocol (FTP) server.
- *HTTP
- Indique la trace du serveur HTTP basé sur Apache. Specifies tracing for the HTTP server powered by Apache.
- *L2TP
- Indique la trace du protocole L2TP (Layer Two Tunneling Protocol). Specifies tracing for Layer Two Tunneling Protocol (L2TP).
- *MSF
- Indique la trace des programmes d'exit MSF (Mail Server Framework) du protocole SMTP (Simple Mail Transport Protocol). Specifies tracing for the Simple Mail Transport Protocol (SMTP) Mail Server Framework (MSF) exit programs.
- *NETPRT
- Indique la trace du serveur hôte d'impression réseau. Specifies tracing for the network print host server.
- *NTP
- Indique la trace du client SNTP (Simple Network Time Protocol). Specifies tracing for the Simple Network Time Protocol (SNTP) client.
- *PKTRULES
- Indique la trace des règles de paquets (PKTRULES). Specifies tracing for packet rules (PKTRULES).
- *POP
- Indique la trace du serveur POP (Post Office Protocol). Specifies tracing for the Post Office Protocol (POP) server.
- *PPP
- Indique la trace du protocole PPP (Point-to-point protocol). Specifies tracing for the Point-to-point protocol (PPP).
- *QOS
- Indique la trace du serveur QOS (Quality Of Service). Specifies tracing for the Quality Of Service (QOS) server.
- *RMTCMD
- Indique la trace du serveur hôte de commandes distantes. Specifies tracing for the remote command host server.
- *SIGNON
- Indique la trace du serveur hôte de connexion. Specifies tracing for the signon host server.
- *SMTPCLT
- Indique la trace des travaux client SMTP qui gèrent les connexions de traitement du courrier sortant. Specifies tracing for the SMTP client job(s) handling outbound mail processing connections.
- *SMTPSVR
- Indique la trace des travaux serveur SMTP (Simple Mail Transfer Protocol) qui gèrent les connexions de traitement du courrier entrant. Specifies tracing for the Simple Mail Transfer Protocol (SMTP) server job(s) handling inbound mail processing connections.
- *SVRMAP
- Indique la trace du serveur hôte de mappage de ports. Specifies tracing for the port mapper host server.
- *TELNET
- Indique la trace du serveur TELNET. Specifies tracing for the TELNET server.
- *VPN
- Indique la trace du serveur de réseau privé virtuel (VPN). Specifies tracing for the Virtual Private Network (VPN) server.
- *VTAPI
- Indique la trace des interfaces de programmation d'application de terminal virtuel. Specifies tracing for the virtual terminal application programming interfaces.
- *SMTPAPI
- Indique la trace des travaux qui appellent les API SMTP. Specifies tracing for job(s) that invoke SMTP APIs.
- *REXEC
- Indique la trace des travaux qui appellent l'application REXEC. Specifies tracing for job(s) that invoke the REXEC application.
Paramètre d'option de trace (SET)Trace option setting (SET)
Indique si la collecte des informations de trace démarre, s'arrête ou si l'état est présenté. Specifies whether the collection of trace information starts, stops, or status is presented.
- *ON
- La collecte des informations de trace est démarrée. The collection of trace information is started.
- *OFF
- La collecte des informations de trace est arrêtée et les informations de trace sont écrites dans des fichiers d'imprimante spoule de l'utilisateur. Pour les traces PPP, les fichiers de trace sont également placés dans la file d'attente en sortie (OUTQ) du profil PPP désigné. The collection of trace information is stopped and the trace information is written to spooled printer files of the user. For PPP traces, the trace files are also included in the OUTQ for the designated PPP profile.
- *END
- La trace est terminée et toutes les informations de trace sont supprimées. Aucune sortie d'informations de trace n'est créée. Tracing is ended and all trace information is deleted. No trace information output is created.
- *CHK
- L'état de la trace pour l'application indiquée est vérifié. Des messages sont renvoyés pour indiquer si la trace est active ou non pour l'application TCP/IP indiquée, quels sont les paramètres de commande indiqués lors du dernier démarrage de TRCTCPAPP pour cette application, ainsi que d'autres informations relatives à la collecte des informations de trace. The status of tracing for the specified application is checked. Messages are returned indicating whether or not tracing is active for the specified TCP/IP application, the command parameters specified from the last time that TRCTCPAPP was started for this application and other information related to the collection of trace information.
Mémoire maximale pour la trace (MAXSTG)Maximum storage for trace (MAXSTG)
Indique la quantité maximale de mémoire, en kilo-octets (Ko), utilisée pour les informations de trace collectées. Specifies the maximum amount of storage in kilobytes (K) used for collected trace information.
- *APP
- Each application type defines a default buffer size.
- *FTP - 4096 Ko par travail *FTP - 4096K bytes per job
- *SMTPCLT - 16000 Ko par travail *SMTPCLT - 16000K bytes per job
- *SMTPSVR - 16000 Ko par travail *SMTPSVR - 16000K bytes per job
- *TELNET - 16000 Ko par travail *TELNET - 16000K bytes per job
- *VTAPI - 16000 Ko par travail *VTAPI - 16000K bytes per job
- *CENTRAL - 16000 Ko par travail *CENTRAL - 16000K bytes per job
- *RMTCMD - 16000 Ko par travail *RMTCMD - 16000K bytes per job
- *SIGNON - 16000 Ko par travail *SIGNON - 16000K bytes per job
- *DTAQ - 16000 Ko par travail *DTAQ - 16000K bytes per job
- *NETPRT - 16000 Ko par travail *NETPRT - 16000K bytes per job
- *SVRMAP - 16000 Ko par travail *SVRMAP - 16000K bytes per job
- *DATABASE - 16000 Ko par travail *DATABASE - 16000K bytes per job
- *DDM - 16000 Ko par travail *DDM - 16000K bytes per job
- *VPN - 16000 Ko par travail *VPN - 16000K bytes per job
- *PKTRULES - 16000 Ko par travail *PKTRULES - 16000K bytes per job
- *L2TP - 4096 Ko par travail *L2TP - 4096K bytes per job
- *CERTSRV - 16000 Ko par travail *CERTSRV - 16000K bytes per job
- *PPP - 4096 Ko par travail *PPP - 4096K bytes per job
- *QOS - 4096 Ko par travail *QOS - 4096K bytes per job
- *NTP - 4096 Ko par travail *NTP - 4096K bytes per job
- *HTTP - 16000 Ko par travail *HTTP - 16000K bytes per job
- *DIRSRV - 16000 Ko par travail *DIRSRV - 16000K bytes per job
- *POP - 16000 Ko par travail *POP - 16000K bytes per job
- *MSF - 16000 Ko par travail *MSF - 16000K bytes per job
- *SMTPAPI - 16000 Ko par travail *SMTPAPI - 16000K bytes per job
- *REXEC - 16000 Ko par travail *REXEC - 16000K bytes per job
- 1-300000
- Indiquez la quantité maximale de mémoire, en kilo-octets, utilisée pour stocker les enregistrements de trace (un kilo-octet équivaut à 1024 octets). Specify the maximum amount of storage, in kilobytes, used to store trace records (one kilobyte 1024 bytes).
Action en cas de trace pleine (TRCFULL)Trace full action (TRCFULL)
Indique si les enregistrements de trace se rebouclent (les enregistrements les plus anciens sont remplacés par les nouveaux) ou si la trace s'arrête lorsque tout le stockage indiqué par le paramètre MAXSTG a été utilisé. Specifies whether the trace records wrap (replace oldest records with new records) or whether the trace stops when all of the storage specified by the MAXSTG parameter has been used.
- *WRAP
- Lorsque la mémoire tampon 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 buffer 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 mémoire tampon de trace est pleine d'enregistrements de trace. Tracing stops when the trace buffer is full of trace records.
Traces supplémentaires (ADLTRC)Additional traces (ADLTRC)
Indique la ou les traces supplémentaires à démarrer. Lorsque la commande TRCTCPAPP est appelée en mode interactif, l'utilisateur est invité à indiquer les options à modifier pour chacune des traces sélectionnées. Ce paramètre est valide pour toutes les applications. Specifies additional trace(s) to be started. When the TRCTCPAPP command is invoked interactively, the user will be prompted for any options to change on each of the selected traces. This parameter is valid for all applications.
Remarque : Indiquer *CMNARB, *DEVD, *DEVMGR, *JOB, *SYSARB, *USER ou *USERDEVD n'est valide que lors de la trace de l'application *TELNET. Remarque :Specifying *CMNARB, *DEVD, *DEVMGR, *JOB, *SYSARB, *USER or *USERDEVD is only valid when tracing the *TELNET application.
Valeurs uniques
- *NONE
- Aucune trace supplémentaire ne sera incluse. No additional trace will be included.
Autres valeurs (jusqu'à 11 répétitions)
- *CMNARB
- Une trace au niveau des travaux de tous les travaux d'arbitre de communications sera démarrée. Pour plus d'informations sur les arbitres de communications, utilisez la fonction de recherche du centre de documentation IBM i. A job-level trace of all communication arbiter jobs will be started. For more information about communication arbiters, use the Search function in the IBM i Information Center.
- *CMNTRC
- A communications trace will be included in the trace information for the specified application.
Remarque : En raison des limitations de ressources du matériel d'E/S, les profils PPP à connexions multiples peuvent ne pas produire de données de trace pour chaque connexion démarrée par le profil PPP. Remarque :Due to resource limitations of the I/O hardware, multi-connection PPP profiles may not produce trace data for every connection started by the PPP profile.
- *DEVD
- Tous les travaux associés à l'unité indiquée dans le paramètre Description d'unité (DEVD) seront tracés. All jobs associated with the device specified for the Device description (DEVD) parameter will be traced.
- *DEVMGR
- Toutes les informations relatives aux fonctions de gestion des unités Telnet seront tracées. All information related with Telnet device management functions will be traced.
- *JOB
- Tous les travaux indiqués dans le paramètre travail (JOB) seront tracés. All jobs specified in job parameter (JOB) will be traced.
- *SOCKETS
- Une seule trace de composant Sockets sera incluse dans les informations de trace de l'application indiquée. A single Sockets component trace will be included in the trace information for the specified application.
- *SRCSINK
- Une trace de composant source/récepteur sera incluse dans les informations de trace de l'application indiquée. A source/sink component trace will be included in the trace information for the specified application.
- *SYSARB
- Une trace au niveau des travaux de tous les travaux d'arbitre système sera démarrée. Pour plus d'informations sur les arbitres système, utilisez la fonction de recherche du centre de documentation IBM i. A job-level trace of all system arbiter jobs will be started. For more information about system arbiters, use the Search function in the IBM i Information Center.
- *TCPIP
- Une seule trace de composant TCP/IP sera incluse dans les informations de trace de l'application indiquée. A single TCP/IP component trace will be included in the trace information for the specified application.
- *USER
- Toutes les informations relatives au paramètre profil utilisateur (USER) seront tracées. All information related with the user profile parameter (USER) will be traced.
- *USERDEVD
- Tous les travaux utilisateur associés à l'unité indiquée dans le paramètre Description d'unité (DEVD) seront tracés. All user jobs associated with the device specified for the Device description (DEVD) parameter will be traced.
Programme de trace (TRCPGM)Trace program (TRCPGM)
Indique le nom d'un programme à appeler pour les commandes et procédures de trace définies par l'utilisateur. Ce paramètre est valide pour toutes les applications. Specifies the name of a program to call for user defined trace commands and procedures. This parameter is valid for all applications.
Pour SET(*ON), le programme de trace sera appelé : For SET(*ON), the trace program will be called:
- Avant le démarrage de la trace d'application. Before the application trace starts.
- Après le démarrage des traces des communications et du code interne sous licence (LIC), si elles sont demandées. After the communications and Licensed Internal Code (LIC) traces, if requested, start.
- If WCHMSG, WCHLICLOG or WCHPAL parameter is specified, the trace program will be called:
- Après une correspondance avec un identificateur de message indiqué dans le paramètre WCHMSG, avec un journal LIC indiqué dans le paramètre WCHLICLOG, ou avec une entrée du journal d'activité des produits (PAL) indiquée dans le paramètre WCHPAL. After a match of a message identifier specified on WCHMSG parameter, or LIC log specified on WCHLICLOG parameter, or a match of a Product Activity Log (PAL) entry specified on WCHPAL parameter occurred.
- 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.
Pour SET(*OFF), le programme de trace sera appelé : For SET(*OFF), the trace program will be called:
- Avant l'arrêt des traces LIC, si elles sont demandées. Before the LIC traces, if requested, end.
- Après l'arrêt de la trace des communications, si elle est demandée. After the communications trace, if requested, ends.
- Après l'arrêt de la trace de l'application. After the application trace ends.
Pour SET(*END), le programme de trace sera appelé : For SET(*END), the trace program will be called:
- Après l'arrêt des traces LIC et des communications, si elles sont demandées. After the LIC and communications traces, if requested, end.
- Après l'arrêt de la trace de l'application. After the application trace ends.
Lorsque le programme de traitement principal (CPP) de TRCTCPAPP détecte une erreur avec le programme de trace, il affiche le message de diagnostic TCP4537. Si la fonction de surveillance des événements de trace est active, la trace et la fonction de surveillance des événements de trace sont arrêtées, et le message CPI3999 est envoyé à la file d'attente de messages de l'opérateur système avec le code anomalie 04. When the TRCTCPAPP CPP detects an error with the trace program, it will display the TCP4537 diagnostic message. If watch for trace event facility is active, the trace and the watch for trace event facility will be ended, and CPI3999 message will be sent to the system operator message queue with reason code 04.
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 Option de trace Entrée Car(10) 1 Trace option setting Input Char(10)
- 2 Application Entrée Car(10) 2 Application Input Char(10)
- 3 Erreur détectée Sortie Car(10) 3 Error detected Output Char(10)
- 4 Données de comparaison Entrée Car(*) 4 Comparison data Input Char(*)
Les valeurs possibles du paramètre Paramètre d'option de trace (SET) sont : The possible values for the Trace option setting (SET) parameter are:
- *ON, La collecte des informations de trace est démarrée. *ON, The collection of trace information is started.
- *OFF, La collecte des informations de trace est arrêtée et les informations de trace sont écrites dans des fichiers d'imprimante spoule de l'utilisateur. *OFF, The collection of trace information is stopped and the trace information is written to spooled printer files of the user.
- *END, La trace est terminée et toutes les informations de trace sont supprimées. Aucune sortie d'informations de trace n'est créée. *END, Tracing is ended and all trace information is deleted. No trace information output is created.
- *MSGID, Une correspondance avec un ID de message indiqué dans le paramètre WCHMSG s'est produite. *MSGID, A match on a message ID specified on WCHMSG parameter occurred.
- *LICLOG, Une correspondance avec un journal LIC indiqué dans le paramètre WCHLICLOG s'est produite. *LICLOG, A match on a LIC log specified on the WCHLICLOG parameter occurred.
- *CMPDATA, Le code majeur et le code mineur d'un journal LIC correspondent, mais pas les données de comparaison. *CMPDATA, 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é. *INTVAL, 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. *WCHTIMO, The length of time to watch specified on WCHTIMO parameter is elapsed.
- *PAL, Une correspondance avec une entrée PAL et les éventuelles données de comparaison associées indiquées dans le paramètre WCHPAL s'est produite. *PAL, A match on a PAL and any associated comparison data specified on the WCHPAL parameter occurred.
Les valeurs possibles du paramètre « Application » sont les mêmes que celles du paramètre APP de la commande TRCTCPAPP. The possible values for the "Application" parameter are the same as the values for the APP parameter on the TRCTCPAPP command.
Les valeurs possibles du paramètre « Erreur détectée » sont : The possible values for the "Error detected" parameter are:
- *ERROR, Erreur détectée par le programme de trace du client. *ERROR, Error detected by customer trace program.
- *CONTINUE, La trace et la fonction de surveillance des événements de trace continuent de s'exécuter. *CONTINUE, The trace and the watch for trace event facility will continue running.
- *STOP, La trace et la fonction de surveillance des événements de trace seront arrêtées. *STOP, The trace and the watch for trace event facility will be ended.
Les valeurs possibles du paramètre « Données de comparaison » lorsque *MSGID est indiqué dans le paramètre « Option de trace » ont la structure suivante : The possible values for the "Comparison data" parameter when *MSGID is specified on "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 ID 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 possibles du paramètre « Données de comparaison » lorsque *LICLOG ou *CMPDATA est indiqué dans le paramètre « Option de trace » ont la structure suivante : The possible values for the "Comparison data" parameter when *LICLOG or *CMPDATA is specified on "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 possibles du paramètre « Données de comparaison » lorsque *ON, *OFF, *END, *INTVAL ou *WCHTIMO est indiqué dans le paramètre « Option de trace » ont la structure suivante : The possible values for the "Comparison data" parameter when *ON, *OFF, *END, *INTVAL or *WCHTIMO is specified on "Trace option setting" parameter will be the following structure:
Offset Type Field Dec Hex 0 0 BINARY(4) Length of trace information (always 4 at this time).
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 de trace fourni par l'utilisateur ne sera appelé. Si un message surveillé, une entrée du journal du code interne sous licence (LIC) ou une entrée du journal d'activité des produits (PAL) est ajouté, ou si la limite de temps de surveillance indiquée est dépassée, la fonction de trace se termine. No user supplied trace program will be called. 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 de trace à appeler. Specify the name of the trace program to be called.
Qualificatif 2 : Bibliothèque Qualificatif 2: Library
- *LIBL
- La liste de bibliothèques est utilisée pour localiser le programme. The library list is used to locate the program.
- *CURLIB
- La bibliothèque en cours est utilisée pour rechercher le programme. Si aucune bibliothèque en cours n'est indiquée, la bibliothèque QGPL est utilisée. The current library is used to locate the program. If no library is specified as the current library, the QGPL library is used.
- trace-program-library
- Indiquez le nom de la bibliothèque où se trouve le programme. Specify the name of the library where the program is located.
Titre de la trace (TITLE)Trace title (TITLE)
Indique le titre imprimé sur chaque page du fichier spoule contenant les informations de trace collectées. Ce paramètre n'est valide que si SET(*OFF) est indiqué. Specifies the title that is printed on each page of the spooled file which contains the collected trace information. This parameter is only valid when SET(*OFF) is specified.
- *DFT
- Le titre de description de trace par défaut « TRCTCPAPP Output » est utilisé. The default trace description title "TRCTCPAPP Output" is used.
- valeur-caractère
- Indiquez jusqu'à 50 caractères à utiliser comme titre sur chaque page du fichier spoule de sortie de trace. Specify up to 50 characters to be used as the title on each page of the trace output spooled file.
Profil utilisateur (USER)User profile (USER)
Seules les informations de trace associées à un profil utilisateur donné seront collectées. Ce paramètre n'est valide que si APP(*FTP) est indiqué, ou si APP(*TELNET) et ADLTRC(*USER) sont indiqués. Only trace information associated with a specific user profile will be collected. This parameter is only valid when APP(*FTP) is specified, or when APP(*TELNET) and ADLTRC(*USER) are specified.
- nom
- Indiquez le nom du profil utilisateur pour lequel les informations de trace doivent être collectées. Specify the name of the user profile for which trace information is to be collected.
Adresse électronique du destinataire (MAILADR)Recipient mail address (MAILADR)
Seules les informations de trace associées à une adresse électronique de destinataire donnée seront collectées. Ce paramètre n'est valide que si APP(*SMTPSVR) ou APP(*SMTPCLT) est indiqué. Only trace information associated with a specific recipient mail address will be collected. This parameter is only valid when APP(*SMTPSVR) or APP(*SMTPCLT) is specified.
- valeur-caractère
- L'adresse électronique du destinataire (255 caractères au maximum) doit avoir le format suivant : 'userid@abc.def.com' The recipient mail address (up to 255 characters) must have the following format: 'useridàabc.def.com'
Nom d'hôte du destinataire (HOST)Recipient host name (HOST)
Seules les informations de trace associées à un nom d'hôte de destinataire donné seront collectées. Ce paramètre n'est valide que si APP(*SMTPCLT) est indiqué. Only trace information associated with a specific recipient host name will be collected. This parameter is only valid when APP(*SMTPCLT) is specified.
- valeur-caractère
- Indiquez le nom d'hôte du destinataire (255 caractères au maximum). Le nom doit avoir le format suivant : 'abc.def.com' Specify the recipient host name (up to 255 characters). The name must have the following format: 'abc.def.com'
Adresse réseau distante (RMTNETADR)Remote network address (RMTNETADR)
L'utilisateur peut limiter la quantité d'informations collectées en entrant une famille d'adresses, une adresse TCP/IP distante, un masque de sous-réseau et un numéro de port. Ce paramètre n'est valide que si APP(*FTP), APP(*SMTPSVR), APP(*DDM), APP(serveur hôte), APP(*TELNET), APP(*VTAPI) ou APP(*L2TP) est indiqué. Remarque : le seul filtre valide pour L2TP est l'élément adresse IP. The user may limit the amount of information collected by entering an address family, remote TCP/IP address, subnet mask and port number. This parameter is only valid when APP(*FTP), APP(*SMTPSVR), APP(*DDM), APP(host server), APP(*TELNET), APP(*VTAPI) or APP(*L2TP) is specified. Note: The only valid filter for L2TP is the IP address element.
Élément 1: Address family
- *CALC
- Le filtre est AF_INET pour les adresses IPv4. Le filtre est AF_INET6 pour les adresses IPv6. The filter is AF_INET for IPv4 addresses. The filter is AF_INET6 for IPv6 addresses.
Élément 2: IP address
- valeur-caractère
- Indiquez l'adresse TCP/IP distante pour laquelle les informations de trace doivent être collectées. Indiquez une adresse IPv4 ou IPv6. Specify the remote TCP/IP address for which trace information is to be collected. Specify either an IPv4 or an IPv6 address.
Élément 3: Subnet mask or Prefix length
- *HOST
- La trace ne sera effectuée que pour l'adresse IP indiquée comme deuxième élément de ce paramètre. Pour IPv4, cela indiquera un masque de sous-réseau 255.255.255.255. Pour IPv6, cela indiquera une longueur de préfixe de /128. Tracing will be done for only the IP address specified as the second element of this parameter. For IPv4, this will specify a subnet mask of 255.255.255.255. For IPv6 this will specify a prefix length of /128.
- valeur-caractère
- Indiquez le masque de sous-réseau IPv4 ou la longueur de préfixe IPv6 pour lesquels les informations de trace doivent être collectées. Specify the IPv4 subnet mask or IPv6 prefix length for which trace information is to be collected.
Élément 4: Port number
- *ANY
- Le numéro de port TCP/IP prend par défaut la valeur *ANY, ce qui signifie que le trafic associé à n'importe quel port du système distant (et qualifié par l'adresse IP et le masque de sous-réseau) sera tracé. The TCP/IP port number defaults to *ANY which implies traffic associated with any port on the remote system (and qualified by the IP address and subnet mask) will be traced.
- 1-65535
- Indiquez le numéro de port à utiliser. Si un numéro est indiqué, une valeur de masque de sous-réseau doit également être indiquée. Specify the port number to be used. If a number is specified, a subnet mask value must also be specified.
Adresse réseau locale (LCLNETADR)Local network address (LCLNETADR)
L'utilisateur peut limiter la quantité d'informations collectées en entrant une famille d'adresses, une adresse TCP/IP locale, un masque de sous-réseau et un numéro de port. Ce paramètre n'est valide que si APP(*DDM), APP(serveur hôte), APP(*TELNET) ou APP(*VTAPI) est indiqué. The user may limit the amount of information collected by entering an address family, local TCP/IP address, subnet mask and port number. This parameter is only valid when APP(*DDM), APP(host server), APP(*TELNET) or APP(*VTAPI) is specified.
Élément 1: Address family
- *CALC
- Le filtre est AF_INET pour les adresses IPv4. Le filtre est AF_INET6 pour les adresses IPv6. The filter is AF_INET for IPv4 addresses. The filter is AF_INET6 for IPv6 addresses.
- *UNIX
- Le filtre pour la famille d'adresses AF_UNIX. Notez que *UNIX n'est un choix valide que pour APP(*DDM) ou APP(serveur hôte). The filter for AF_UNIX address family. Note that *UNIX is a valid choice for only APP(*DDM) or APP(host server).
Élément 2: IP address or UNIX path
- valeur-caractère
- When *CALC is specified for element 1 of this parameter, specify the local TCP/IP address for which trace information is to be collected. Specify either an IPv4 or an IPv6 address.
Lorsque *UNIX est indiqué pour l'élément 1 de ce paramètre, indiquez le chemin UNIX pour lequel les informations de trace doivent être collectées. Notez qu'un chemin UNIX ne peut être entré que pour APP(*DDM) ou APP(serveur hôte). When *UNIX is specified for element 1 of this parameter, specify the UNIX path for which trace information is to be collected. Note that an UNIX-path can be entered for only APP(*DDM) or APP(host server).
Élément 3: Subnet mask or Prefix length
- *HOST
- La trace ne sera effectuée que pour l'adresse IP indiquée comme deuxième élément de ce paramètre. Pour IPv4, cela indiquera un masque de sous-réseau 255.255.255.255. Pour IPv6, cela indiquera une longueur de préfixe de /128. Tracing will be done for only the IP address specified as the second element of this parameter. For IPv4, this will specify a subnet mask of 255.255.255.255. For IPv6 this will specify a prefix length of /128.
- valeur-caractère
- Indiquez le masque de sous-réseau IPv4 ou la longueur de préfixe IPv6 pour lesquels les informations de trace doivent être collectées. Specify the IPv4 subnet mask or IPv6 prefix length for which trace information is to be collected.
Élément 4: Port number
- *ANY
- Le numéro de port TCP/IP prend par défaut la valeur *ANY, ce qui signifie que le trafic associé à n'importe quel port du système local (et qualifié par l'adresse IP et le masque de sous-réseau) sera tracé. The TCP/IP port number defaults to *ANY which implies traffic associated with any port on the local system (and qualified by the IP address and subnet mask) will be traced.
- 1-65535
- Indiquez le numéro de port à utiliser. Si un numéro est indiqué, une valeur de masque de sous-réseau doit également être indiquée. Specify the port number to be used. If a number is specified, a subnet mask value must also be specified.
Description d'unité (DEVD)Device description (DEVD)
L'utilisateur peut limiter la quantité d'informations collectées en entrant un nom de description d'unité. Une fois la description d'unité associée à une session TELNET ou VTAPI donnée, toutes les informations de trace qui lui sont associées sont collectées. Ce paramètre n'est valide que si APP(*TELNET) ou APP(*VTAPI) est indiqué. The user may limit the amount of information collected by entering a device description name. Once the device description is associated with a given TELNET or VTAPI session, all trace information associated with it will be collected. This parameter is only valid when APP(*TELNET) or APP(*VTAPI) is specified.
- nom
- Indiquez le nom d'une description d'unité pour laquelle les informations de trace doivent être collectées. Specify the name of a device description for which trace information is to be collected.
- nom-générique
- Indiquez un nom générique de descriptions d'unité pour lesquelles les informations de trace doivent être collectées. Un nom générique est une chaîne d'un ou plusieurs caractères suivie d'un astérisque (*) ; par exemple, CMN*. Si un nom générique est indiqué, les informations de trace sont collectées pour toutes les descriptions d'unité dont le nom commence par le nom générique et pour lesquelles l'utilisateur possède des droits. Specify a generic name for device descriptions for which trace information is to be collected. A generic name is a character string of one or more characters followed by an asterisk (*); for example, CMN*. If a generic name is specified, then all device descriptions with names that begin with the generic name, and for which the user has authority, will have trace information collected.
Type d'unité (DEVTYPE)Device type (DEVTYPE)
Un ou plusieurs types d'unité valides peuvent être indiqués. Seules les informations de trace associées à l'activité de ces unités seront tracées. Si *DSP ou *PRT est indiqué, aucune autre valeur ne peut être entrée pour ce paramètre. Ce paramètre n'est valide que si APP(*TELNET) ou APP(*VTAPI) est indiqué. One or more valid device types may be specified. Only the trace information associated with activity for those devices will be traced. If *DSP or *PRT is specified, no other values may be entered for this parameter. This parameter is only valid when APP(*TELNET) or APP(*VTAPI) is specified.
- *DSP
- Les informations collectées ne concernent que les types d'unité écran. The information collected is only for display device types.
- *PRT
- Les informations collectées ne concernent que les types d'unité imprimante. The information collected is only for printer device types.
- device-type
- Les informations collectées ne concernent que les types d'unité indiqués. Il est possible d'indiquer jusqu'à six types. Les types valides sont : 5251, 5291, 5292, 3196, 3488, 3487, 3179, 3180, 5555, 3477, 3277, 3278, 3279, V100, 3812 et 5553. The information collected is only for the specified device types. Up to six types may be specified. The valid types include: 5251, 5291, 5292, 3196, 3488, 3487, 3179, 3180, 5555, 3477, 3277, 3278, 3279, V100, 3812 and 5553.
Point de trace (TRCPNT)Trace point (TRCPNT)
Vous pouvez limiter les points de trace placés dans la mémoire tampon de trace en entrant dans ce paramètre la liste de ces points de trace. Il est possible d'indiquer jusqu'à 12 points de trace. Ce paramètre n'est valide que si APP(*TELNET), APP(*VTAPI), APP(*DDM) ou APP(serveur hôte) est indiqué. You can limit the trace points that are placed in the trace buffer by entering the list of those trace points for this parameter. Up to 12 trace points may be specified. This parameter is only valid when APP(*TELNET), APP(*VTAPI), APP(*DDM) or APP(host server) is specified.
- valeur-caractère
- Specify the trace point identifier. Each trace point identifier may be up to 8 characters.
Pour les points de trace TELNET/VTAPI, indiquez 'TG#xxxxx', 'TG+xxxxx' ou 'TG-xxxxx', où 'xxxxx' définit le point de trace spécifique. Les points de trace TELNET/VTAPI suivants peuvent également être indiqués : TGTELM, TGTELO, TGEXCP, TGREQPO, TGRIO, TGRPO, TGUTIL, TGVTERM, TGVTIN, TGVTINI, TGVTM ou TGVTOUT. For TELNET/VTAPI trace points, specify 'TG#xxxxx', 'TG+xxxxx' or 'TG-xxxxx' where 'xxxxx' defines the specific trace point. The following TELNET/VTAPI trace points can also be specified: TGTELM, TGTELO, TGEXCP, TGREQPO, TGRIO, TGRPO, TGUTIL, TGVTERM, TGVTIN, TGVTINI, TGVTM or TGVTOUT.
Pour les points de trace du serveur hôte/DDM, indiquez 'Qcccxxxx', où 'ccc' est l'ID de composant du serveur hôte/DDM et 'xxxx' définit le point de trace spécifique. For host/DDM server trace points, specify 'Qcccxxxx' where 'ccc' is the component ID of the host/DDM server and 'xxxx' defines the specific trace point.
Liste d'arguments (ARGLIST)Argument list (ARGLIST)
Seules les informations de trace associées à cette liste d'arguments seront incluses dans les informations de trace collectées. La liste d'arguments contient des données telles que le niveau de débogage et les demandes de trace spéciales. Ce paramètre n'est valide que si APP(*VPN), APP(*QOS), APP(*PKTRULES), APP(*PPP) ou APP(*DIRSRV) est indiqué. Only trace information associated with this specific argument list will be included in the trace information collected. The argument list contains data like the debug level and special trace requests. This parameter is only valid when APP(*VPN), APP(*QOS), APP(*PKTRULES), APP(*PPP) or APP(*DIRSRV) is specified.
- valeur-caractère
- Indiquez la liste d'arguments (255 caractères au maximum). Specify the argument list (up to 255 characters).
QOS accepte les valeurs de liste d'arguments suivantes : QOS allows the following argument list values:
- lvl=1
- L'argument lvl=1 journalise les erreurs associées aux opérations système. Par exemple, le système peut manquer de mémoire. Ces types d'erreur empêchent le serveur QoS de s'exécuter. The lvl=1 argument logs errors that are associated with system operations. One example might be that the system is out of memory. The result of these types of errors is that the QoS server will not be able to run.
- lvl=2
- L'argument lvl=2 inclut toutes les informations de lvl=1. En outre, l'argument lvl=2 journalise les erreurs internes identifiées lors du fonctionnement du serveur QOS. Ces types d'erreur sont généralement dus à des erreurs inattendues survenues lors d'une opération du serveur. Une erreur lvl=2 est considérée comme une condition justifiant un APAR. The lvl=2 argument includes all lvl=1 information. In addition, the lvl=2 argument logs internal errors identified with the operation of the QOS server. The usual cause of these types of errors is that unexpected errors have been encountered in a server operation. A lvl=2 error is considered a condition for an APAR.
- lvl=3
- L'argument lvl=3 inclut toutes les informations de lvl=1 et lvl=2. En outre, l'argument lvl=3 journalise les activités opérationnelles de base du serveur QoS. Il peut s'agir, par exemple, du chargement de règles ou de l'envoi d'une commande STRTCPSVR SERVER(*QOS) RESTART(*QOS). The lvl=3 argument includes all lvl=1 and lvl=2 information. In addition, the lvl=3 argument logs the basic operational activities of the QoS server. Examples might be the loading of rules or the sending of a STRTCPSVR SERVER(*QOS) RESTART(*QOS) command.
- lvl=4
- L'argument lvl=4 inclut toutes les informations de lvl=1, lvl=2 et lvl=3. En outre, l'argument lvl=4 journalise toutes les activités tracées du serveur QoS. The lvl=4 argument includes all lvl=1, lvl=2 and lvl=3 information. In addition, the lvl=4 argument logs all traced activities of the QoS server.
Serveur de réseau privé virtuel (VPNSVR)Virtual private network server (VPNSVR)
Indique si les informations de trace doivent être collectées pour le gestionnaire de clés VPN ou pour le gestionnaire de connexions VPN. Si aucune valeur n'est indiquée pour ce paramètre, les informations de trace sont collectées à la fois pour le gestionnaire de clés VPN et pour le gestionnaire de connexions VPN. Ce paramètre n'est valide que si APP(*VPN) est indiqué. Specifies whether the trace information is to be collected for the VPN key manager or the VPN connection manager. If no value is specified for this parameter, trace information is to be collected for both the VPN key manager and the VPN connection manager. This parameter is only valid when APP(*VPN) is specified.
- *KEYMGR
- Le filtrage des informations de trace est effectué pour inclure le gestionnaire de clés VPN. Filtering of trace information is done to include the VPN key manager.
- *CNNMGR
- Le filtrage des informations de trace est effectué pour inclure le gestionnaire de connexions VPN. Filtering of trace information is done to include the VPN connection manager.
Type de services de certificats (CERTTYPE)Certificate services type (CERTTYPE)
Seules les informations de trace associées à un type de services de certificats donné seront incluses dans les informations de trace capturées. Ce paramètre n'est valide que si APP(*CERTSRV) est indiqué. Only trace information associated with a specific certificate services type will be included in the captured trace information. This parameter is only valid when APP(*CERTSRV) is specified.
- *ALL
- Aucun filtrage des informations de trace n'est effectué pour le type de services de certificats. No filtering of trace information is done for certificate services type.
- *DCM
- Le filtrage des informations de trace est effectué pour inclure uniquement le type de services de certificats DCM. Filtering of trace information is done to include only the DCM certificate services type.
- *KEYMGR
- Le filtrage des informations de trace est effectué pour inclure uniquement le type de services de certificats du gestionnaire de clés VPN. Filtering of trace information is done to include only the VPN key manager certificate services type.
- *SSL
- Le filtrage des informations de trace est effectué pour inclure uniquement le type de services de certificats SSL. Filtering of trace information is done to include only the SSL certificate services type.
- *OBJSIGN
- Le filtrage des informations de trace est effectué pour inclure uniquement le type de services de certificats OBJSIGN. Filtering of trace information is done to include only the OBJSIGN certificate services type.
- *OTHER
- Le filtrage des informations de trace est effectué pour inclure uniquement un type de services de certificats ne figurant pas dans la liste ci-dessus. Filtering of trace information is done to include only a certificate services type not listed above.
Service de noms de domaine (DNS)Domain name service (DNS)
Indique si seules les informations de trace associées à la résolution du service de noms de domaine (DNS) seront collectées. Ce paramètre n'est valide que si APP(*SMTPCLT) est indiqué. Specifies whether only trace information associated with domain name service (DNS) resolution will be collected. This parameter is only valid when APP(*SMTPCLT) is specified.
- *NO
- Aucun filtrage des informations de trace n'est effectué pour la résolution DNS. No filtering of trace information is done for DNS resolution.
- *YES
- Les informations de trace incluent uniquement les points de trace associés à la résolution DNS. Trace information includes only trace points associated with DNS resolution.
Profil de connexion PPP (PPPCNNPRF)PPP connection profile (PPPCNNPRF)
Les informations de trace associées à un profil de connexion PPP donné seront collectées. Les informations de trace fournies par défaut sont un historique du travail et un fichier spoule de dialogue de connexion (contenant la trace du dialogue PPP) pour chaque connexion démarrée par le profil de connexion PPP, une copie des paramètres du profil PPP et une copie de la description de ligne utilisée par le profil. Si l'utilisateur les sélectionne, il peut également y avoir une trace de composant SRCSINK par connexion, une trace des communications par connexion et une seule trace de composant TCPIP. Ce paramètre est obligatoire lorsque APP(*PPP) est indiqué. Trace information associated with a specific PPP connection profile will be collected. The default trace information provided is one joblog and one connection dialog spooled file (containing the PPP dialog trace) for each connection started by the PPP connection profile, one copy of the PPP profile settings, and one copy of the line description used by the profile. When selected by the user there could also be one SRCSINK component trace per connection, one Communications trace per connection and a single TCPIP component trace. This parameter is required when APP(*PPP) is specified.
- valeur-caractère
- Indiquez le profil de connexion PPP pour lequel les informations de trace doivent être collectées. Specify the PPP connection profile for which trace information is to be collected.
Données TCP/IP à tracer (TCPTRCDTA)TCP/IP data to trace (TCPTRCDTA)
Indique les données supplémentaires qui seront collectées lorsque ADLTRC(*TCPIP) est sélectionné. Ce paramètre n'est valide que si APP(*PPP) est indiqué. Si APP(*PPP) est indiqué et que ADLTRC(*TCPIP) n'est pas indiqué, ce paramètre est ignoré. Specifies what additional data will be collected when ADLTRC(*TCPIP) is selected. This parameter is only valid when APP(*PPP) is specified. If APP(*PPP) is specified and ADLTRC(*TCPIP) is not specified, this parameter will be ignored.
- *PPPALL
- Toutes les données de la connexion PPP seront tracées. All data on the PPP connection will be traced.
- *LCPNCP
- Seules les données LCP et NCP de la connexion PPP seront tracées. Only LCP and NCP data on the PPP connection will be traced.
Type de trace QOS (QOSTRCTYPE)QOS trace type (QOSTRCTYPE)
Seules les informations de trace associées à un type de trace QOS donné seront incluses dans les informations de trace collectées. Ce paramètre n'est valide que si APP(*QOS) est indiqué. Only trace information associated with a specific QOS trace type will be included in the trace information collected. This parameter is only valid when APP(*QOS) is specified.
- *ALL
- Le filtrage des informations de trace est effectué pour inclure les deux serveurs. Filtering of trace information is done to include both servers.
- *POLICYD
- Le filtrage des informations de trace est effectué pour inclure le serveur de politiques QOS. Filtering of trace information is done to include the QOS policy server.
- *RSVPD
- Le filtrage des informations de trace est effectué pour inclure le serveur RSVP (Resource reSerVation Protocol). Filtering of trace information is done to include the RSVP (Resource reSerVation Protocol) server.
Instance de serveur HTTP (HTTPSVR)HTTP server instance (HTTPSVR)
Ce paramètre détermine l'instance de serveur HTTP à tracer. Il n'est valide et obligatoire que si APP(*HTTP) est indiqué. This parameter will determine which HTTP server instance to trace. It is only valid and required when APP(*HTTP) is specified.
Instance (INSTANCE)
Indique le nom de l'instance de serveur à tracer. Ce paramètre n'est valide que si APP(*DIRSVR) est indiqué. Specifies the name of the server instance to trace. This parameter is only valid when APP(*DIRSVR) is specified.
- *DFT
- L'instance de serveur par défaut est tracée. Lorsque APP(*DIRSVR) est indiqué, l'instance de serveur QUSRDIR est tracée. The default server instance is traced. When APP(*DIRSVR) is specified, the QUSRDIR server instance will be traced.
- *ALL
- Toutes les instances du serveur actuellement en cours d'exécution sont tracées. All instances of the server that are currently running are traced.
- valeur-caractère
- Indiquez le nom de l'instance de serveur à tracer. Il est possible d'indiquer jusqu'à 32 caractères. Specify the name of the server instance to be traced. Up to 32 characters may be specified.
Niveau de trace (TRCLVL)Trace level (TRCLVL)
Indique le niveau de granularité de la trace de service. Ce paramètre n'est valide que si APP(*HTTP), APP(*SMTPAPI) ou APP(*REXEC) est indiqué. Specifies the level of granularity of the service trace. This parameter is only valid when APP(*HTTP), APP(*SMTPAPI) or APP(*REXEC) is specified.
- *ERROR
- La trace de service contiendra les enregistrements de trace de tous les codes retour d'erreur ou conditions d'exception. The service trace will contain trace records for all error return codes or exception conditions.
- *INFO
- La trace de service contiendra les enregistrements de trace de niveau *ERROR ainsi que les enregistrements de trace des points d'entrée et de sortie des API de niveau application et des paramètres d'API. The service trace will contain *ERROR level trace records as well as trace records for entry and exit points from application level APIs and API parameters.
- *VERBOSE
- La trace de service contiendra les enregistrements de trace de niveau *INFO ainsi que les enregistrements de trace destinés au débogage du flux de contrôle ou de l'altération de données. The service trace will contain *INFO level trace records as well as trace records for debugging control flow or data corruption.
Points de trace des règles de paquets (PKTTRCPNT)Packet rules trace points (PKTTRCPNT)
Indique un mot-clé qui représente les valeurs de points de trace qui seront affichées lorsque l'écran Trace interne (TRCINT) est affiché. Ce paramètre n'est valide que si APP(*PKTRULES) et ADLTRC(*TCPIP) sont indiqués. Specifies a keyword that represents trace point values which will be displayed when the Trace Internal (TRCINT) panel is displayed. This parameter is only valid when APP(*PKTRULES) and ADLTRC(*TCPIP) are specified.
- *TRAFFIC
- Les points de trace suivants pour l'évaluation du filtre de paquets seront affichés sur l'écran Trace interne : 8110-8111, 8120-8123 et 8420. The following trace points for packet filter evaluation will be displayed on the Trace Internal panel: 8110-8111, 8120-8123 and 8420.
- *LOAD
- Les points de trace suivants pour l'audit et le chargement des règles seront affichés sur l'écran Trace interne : 8100-8105 et 8430-8438. The following trace points for the audit and load of rules will be displayed on the Trace Internal panel: 8100-8105 and 8430-8438.
Objet de configuration (CFGOBJ)Configuration object (CFGOBJ)
Indique l'objet de configuration à tracer. L'objet peut être une description de ligne, une description d'interface réseau ou une description de serveur réseau. Ce paramètre n'est valide que si ADLTRC(*CMNTRC) est indiqué. Specifies the configuration object to trace. The object can be either a line description, a network interface description, or a network server description. This parameter is only valid when ADLTRC(*CMNTRC) is specified.
- nom
- Indiquez le nom de l'objet de configuration à tracer. Specify the name of the configuration object to be traced.
Type (CFGTYPE)
Indique le type de description de configuration à tracer. Ce paramètre n'est valide que si ADLTRC(*CMNTRC) est indiqué. Specifies the type of configuration description to trace. This parameter is only valid when ADLTRC(*CMNTRC) is specified.
- *LIN
- Le type d'objet de configuration est une description de ligne. The type of configuration object is a line description.
- *NWI
- Le type d'objet de configuration est une description d'interface réseau. The type of configuration object is a network interface description.
- *NWS
- Le type d'objet de configuration est une description de serveur réseau. The type of configuration object is a network server description.
Surveiller un message (WCHMSG)Watch for message (WCHMSG)
Indique jusqu'à cinq identificateurs de message à surveiller. Si une valeur autre que *NONE est indiquée, vous devez indiquer dans le paramètre WCHMSGQ 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 message identifiers which are to be watched for. 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: Identificateur de message
- *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 identificateurs de message indiqués dans le paramètre Message à surveiller (WCHMSG). Vous pouvez indiquer de surveiller l'ajout du message à la file d'attente de messages de l'opérateur système, à l'historique, à d'autres files d'attente de messages et aux historiques des travaux. Il est possible d'indiquer jusqu'à trois files d'attente de messages ou valeurs spéciales. Specifies where to watch for the message identifiers specified for the Watch for message (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).
- *HSTLOG
- Surveille les messages ajoutés à l'historique QHST. Watch messages added to the history log QHST.
- *JOBLOG
- Surveille les messages ajoutés aux historiques des travaux indiqués dans le paramètre WCHJOB. Watch messages added to the job logs of jobs specified by the WCHJOB parameter.
-
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 de l'utilisateur du travail à surveiller. Specify the name of the user 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.
- 000001-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 est 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 (000001-999999) afin de qualifier 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 (X'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 (000001-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 la limite de temps, 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é des produits (PAL). Lorsque la durée indiquée s'est écoulée, le programme d'exit de trace est appelé (si un programme a été indiqué dans le paramètre TRCPGM), la trace est terminée et le message CPI3999 est envoyé à la file d'attente de messages de l'opérateur système. 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 system operator message queue.
- *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 sera active tant qu'aucune des conditions surveillées n'a été remplie. Vous pouvez indiquer jusqu'à 43200 minutes (30 jours). Specify the number of minutes that the trace will be active while none of the watched for conditions have been met. You can specify up to 43200 minutes (30 days).
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/
Travail (JOB)
Indique les travaux à tracer. Ce paramètre n'est valide que si APP(*SMPTAPI) ou APP(*REXEC) est indiqué, ou si APP(*TELNET) et ADLTRC(*JOB) sont indiqués. Specifies which jobs are to be traced. This parameter is only valid when APP(*SMPTAPI) or APP(*REXEC) is specified, or when APP(*TELNET) and ADLTRC(*JOB) are specified.
Valeurs uniques
- *
- Seul le travail qui émet la commande TRCTCPAPP (Tracer une application TCP/IP) est tracé. Only the job that issues the TRCTCPAPP (Trace TCP/IP application) command is to be traced.
Element : Travail
-
Qualificatif 1: Travail
- nom-générique
- Indiquez le nom générique des travaux à tracer. 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 jobs to be traced. 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.
- *ALL
- Tous les noms de travaux associés au nom d'utilisateur de travail indiqué sont tracés. *ALL pour le nom 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 d'utilisateur de travail que vous avez indiqués. All jobs names with the specified job user name are traced. *ALL for the job name is considered to be a generic job specification because it will trace all jobs that meet the job user name qualifiers that you specified.
- nom
- Indiquez le nom du travail à tracer. Il est possible d'indiquer jusqu'à seize noms de travail. Specify the name of the job to be traced. Up to sixteen job names may be specified.
-
Qualificatif 2: Utilisat
- nom-générique
- Indiquez le nom d'utilisateur générique des travaux 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 jobs 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.
- *ALL
- Tous les noms d'utilisateur de travail associés au nom de travail indiqué sont tracés. *ALL pour le nom d'utilisateur du 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 que vous avez indiqués. All job user name with the specified job name are traced. *ALL for the job user name is considered to be a generic job specification because it will trace all jobs that meet the job name qualifiers that you specified.
- nom
- Indiquez le nom d'utilisateur du travail à tracer. Specify the user name of the job to be traced.
-
Qualificatif 3: Numéro
- *ALL
- Tous les travaux portant le nom de travail et le nom d'utilisateur indiqués sont tracés. *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 jobs with the specified job name and user name are traced. *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.
- 000001-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 qualifier or generic user name qualifier is specified.
Exemples
Exemple 1 : Démarrage de la trace pour la base de données Example 1: Starting Trace for Database
TRCTCPAPP APP(*DATABASE) SET(*ON) TRCPNT(QZDA1050 QZDA1060)
LCLNETADR(*CALC
'9.130.69.22'
'255.255.255.255' 8471)
ADLTRC(*CMNTRC) TRCPGM(PGMLIB/PROG1)
CFGOBJ(TESTLIN) CFGTYPE(*LIN)
Cette commande démarre la trace du serveur hôte de base de données. Les informations de trace associées à la famille d'adresses AF_INET, à une adresse TCP/IP locale 9.130.69.22, à un masque de sous-réseau 255.255.255.255, au numéro de port 8471 et aux points de trace QZDA1050 et QZDA1060 seront collectées. Une trace des communications sera incluse dans les informations de trace. TESTLIN est le nom de l'objet de configuration à tracer. Cet objet est une description de ligne (*LIN). Le programme de trace PROG1 de la bibliothèque PGMLIB, avec ses commandes et procédures de trace définies par l'utilisateur, sera appelé. La trace des autres applications TCP n'est pas affectée. This command will start tracing for the database host server. Tracing information associated with the AF_INET address family, a local TCP/IP address of 9.130.69.22, a subnet mask of 255.255.255.255, port number of 8471 and trace points of QZDA1050 and QZDA1060 will be collected. A communication trace will be included in the trace information. TESTLIN is the name of the configuration object to trace. This object is a line (*LIN) description. Trace program PROG1 in library PGMLIB, with its user-defined trace commands and procedures, will be called. Tracing for the other TCP applications is not affected.
Exemple 2 : Démarrage de la trace pour la base de données avec une adresse IPv6 Example 2: Starting Trace for Database using IPv6 Address
TRCTCPAPP APP(*DATABASE) SET(*ON)
LCLNETADR(*CALC
'1080:8:800:417A:1::'
*HOST)
Cette commande démarre la trace du serveur hôte de base de données avec le filtre *INET6, une adresse locale 1080:8:800:417A:1:: et une longueur de préfixe de /128. This command will start tracing for the database host server using *INET6 filter, a local address of 1080:8:800:417A:1:: and prefix length of /128.
Exemple 3 : Vérification de l'état de la trace de la base de données Example 3: Check Status of Database Tracing
TRCTCPAPP APP(*DATABASE) SET(*CHK)
Cette commande sert à vérifier l'état de la trace du travail du serveur hôte de base de données. Supposons que la dernière commande entrée soit celle de l'« Exemple 1 » ci-dessus. Le format de la réponse à cette commande serait un ensemble de messages semblables aux suivants : This command is used to check the status of the tracing for the database host server job. Assume that the last command entered was from "Example 1" above. The format of the response to this command would be a set of messages that would look similar to the following:
TCP45B7 TRCTCPAPP APP(*DATABASE) SET(*ON)
TRCPNT(QZDA1050 QZDA1060)
LCLNETADR(*CALC '9.130.69.22'
'255.255.255.255' 8471)
MAXSTG(*DFT) TRCFULL(*WRAP) ADLTRC(*CMNTRC)
TRCPGM(PGMLIB/PROG1) CFGOBJ(TESTLIN)
CFGTYPE(*LIN)
TCP45B1 Tracing active for *DATABASE at 20:15:14 on 03/15/01 by
043432/TRCUSER/QPADEV000B.
TCP45B2 Data capture begun for *DATABASE.
TCP45B3 Data buffer wrapped for *DATABASE.
Exemple 4 : Arrêt de la trace des connexions à la base de données Example 4: Ending Database Connection Tracing
TRCTCPAPP APP(*DATABASE) SET(*OFF)
Cette commande arrête d'abord toute trace d'application actuellement active pour le serveur hôte de base de données, puis arrête la trace du composant TCP/IP. Si la trace était active, les enregistrements de trace de sortie sont formatés et placés dans un fichier spoule. Un message similaire figure dans l'historique du travail de l'utilisateur : This command first ends any currently active application trace for the database host server, followed by ending the TCP/IP component trace. If tracing was active, output trace records are formatted and placed into a spool file. A similar message will be found in the user's joblog:
TCP45B8 Trace data for application DATABASE formatted: QZDA001915.
Si la trace n'est pas active, le message suivant est renvoyé à l'utilisateur : If tracing is not active, then the following message will be returned to the user:
TCP4580 Tracing off, SET(*OFF) not valid.
Exemple 5 : Démarrage de la trace pour les règles de paquets Example 5: Starting Trace for Packet Rules
TRCTCPAPP APP(*PKTRULES) SET(*ON)
ARGLIST('DebugLvl=1 TraceLvl=2')
ADLTRC(*TCPIP) PKTTRCPNT(*LOAD)
Cette commande démarre la trace des règles de paquets. Les informations de trace associées à la liste d'arguments indiquée seront collectées. Une trace de composant sera incluse dans les informations de trace, avec les points de trace 8100-8105 et 8430-8438. La trace des autres applications TCP n'est pas affectée. This command will start tracing for packet rules. Tracing information associated with the specific argument list will be collected. A component trace will be included in the trace information, using trace points of 8100-8105 and 8430-8438. Tracing for the other TCP applications is not affected.
Exemple 6 : Démarrage de la trace pour FTP Example 6: Starting Trace for FTP
TRCTCPAPP APP(*FTP) SET(*ON)
RMTNETADR(*CALC '9.130.69.16'
'255.255.255.255' 5000)
Cette commande démarre la trace du serveur FTP. Les informations de trace associées à la famille d'adresses AF_INET, à une adresse TCP/IP distante 9.130.69.16, à un masque de sous-réseau 255.255.255.255 et au numéro de port 5 seront collectées. La trace des autres applications TCP n'est pas affectée. This command will start tracing for the FTP server. Tracing information associated with the AF_INET address family, a remote TCP/IP address of 9.130.69.16, a subnet mask of 255.255.255.255 and port number of 5 will be collected. Tracing for the other TCP applications is not affected.
Exemple 7 : Démarrage de la trace pour FTP avec une adresse IPv6 Example 7: Starting Trace for FTP using IPv6 Address
TRCTCPAPP APP(*FTP) SET(*ON)
RMTNETADR(*CALC
'2001:0DB8:0::0:1428:57AB')
Cette commande démarre la trace du serveur FTP avec le filtre AF_INET6 et l'adresse réseau distante IPv6 2001:0DB8:0::0:1428:57AB. This command starts tracing the FTP server using AF_INET6 filter and IPv6 remote network address 2001:0DB8:0::0:1428:57AB.
Exemple 8 : Démarrage de la trace pour TELNET Example 8: Starting Trace for TELNET
TRCTCPAPP APP(*TELNET) SET(*ON) DEVD(QPADEV*)
Cette commande démarre la trace du serveur TELNET. Les informations de trace seront collectées pour toutes les descriptions d'unité dont le nom commence par « QPADEV ». L'utilisateur doit posséder des droits sur ces descriptions d'unité. La trace des autres applications TCP n'est pas affectée. This command will start tracing for the TELNET server. Trace information will be collected for all device descriptions with names that begin with "QPADEV". The user must have authority to these specific device descriptions. Tracing for the other TCP applications is not affected.
Exemple 9 : Démarrage de la trace pour TELNET avec une adresse IPv6 Example 9: Starting Trace for TELNET using IPv6 Address
TRCTCPAPP APP(*TELNET) SET(*ON)
RMTNETADR(*CALC
'FE80::210:11FF:FE76:7800)
Cette commande démarre la trace du serveur TELNET avec le filtre AF_INET6 et l'adresse réseau distante IPv6 FE80::210:11FF:FE76:7800. This command will start tracing for the TELNET server using AF_INET6 filter and IPv6 remote network address FE80::210:11FF:FE76:7800.
Exemple 10 : Démarrage de la trace pour analyser un problème d'unité Example 10: Starting Trace for Analyzing a Device Problem
TRCTCPAPP APP(*TELNET) SET(*ON)
ADLTRC(*DEVD *JOB *CMNARB *SYSARB)
DEVD(MYDEVICE)
JOB((*ALL/*ALL/MYSBS1) (*ALL/*ALL/MYSBS2))
Cette commande trace tous les travaux associés à la description d'unité MYDEVICE, qui rencontre un problème d'unité. La commande démarre la trace du serveur TELNET. Les informations de trace sont collectées pour tous les travaux utilisateur associés à la description d'unité MYDEVICE. Les informations de trace sont collectées pour les travaux du gestionnaire d'unités TELNET. Les informations de trace sont collectées pour tous les travaux indiqués dans le paramètre JOB. Dans cet exemple, tous les travaux nommés MYSBS1 et MYSBS2 seront tracés, où MYSBS1 est le sous-système qui affiche l'écran de connexion pour les sessions d'unité interactives et MYSBS2 est le sous-système vers lequel les travaux sont transférés lorsqu'un utilisateur se connecte. Les informations de trace sont également collectées pour les travaux système qui interagissent avec les unités d'affichage, c'est-à-dire tous les travaux système QCMNARB et QSYSARB. This command will trace all the jobs that will be associated with the device description MYDEVICE, which is encountering a device problem. The command will start tracing for the TELNET server. Trace information is collected for all user jobs associated with device description MYDEVICE. Trace information is collected for the TELNET device manager jobs. Trace information is collected for all jobs that were supplied in the JOB parameter. In this example, all jobs with the name MYSBS1 and MYSBS2 will be traced, where MYSBS1 is the subsystem that displays the sign on screen for interactive device sessions and MYSBS2 is the subsystem jobs transfer to when a user signs on. Trace information is also collected for the system jobs that interact with display devices, which are all the QCMNARB and QSYSARB system jobs.
Exemple 11 : Démarrage de la trace pour une instance de serveur HTTP Example 11: Starting Trace for a HTTP Server Instance
TRCTCPAPP APP(*HTTP) SET(*ON) INSTANCE(HTTP1)
Cette commande trace l'instance de serveur HTTP nommée HTTP1. This command traces the HTTP server instance named HTTP1.
Exemple 12 : Démarrage de la trace pour une instance de serveur de services d'annuaire Example 12: Starting Trace for a Directory Services Server Instance
TRCTCPAPP APP(*DIRSRV) SET(*ON) INSTANCE(DIRSRV1)
Cette commande trace l'instance de serveur de services d'annuaire nommée 'DIRSRV1'. This command traces the Directory Services server instance named 'DIRSRV1'.
Exemple 13 : Démarrage de la trace pour l'instance de serveur de services d'annuaire par défaut Example 13: Starting Trace for Default Directory Services Server Instance
TRCTCPAPP APP(*DIRSRV) SET(*ON) INSTANCE(*DFT)
L'instance de serveur par défaut (QUSRDIR) est tracée. The default server instance (QUSRDIR) is traced.
Exemple 14 : Démarrage de la trace pour l'une des API SMTP Example 14: Starting Trace for one of the SMTP APIs
TRCTCPAPP APP(*SMTPAPI) SET(*ON) TRCLVL(*VERBOSE)
JOB(044235/TOCUSR/QPADEV000G)
Cette commande trace l'une des applications API SMTP avec un niveau de trace détaillé (verbose) et en indiquant le travail qualifié 044235/TOCUSR/QPADEV00G. This command traces one of the SMTP API applications using a trace level of verbose and specifying the qualified job 044235/TOCUSR/QPADEV00G.
© Copyright IBM Corp. Texte d'aide reproduit à des fins de formation.