CL Command Reference - TRCINT
CL Command List > TRCINT Reference
Description:
The Trace Internal (TRCINT) command is the command interface to the Trace Licensed Internal Code service tool and is used for problem analysis. Specific types of traces are started and stopped by using this command. While previously started internal traces are being performed, additional internal traces can be started through this command. The output created by the trace is placed in a trace table. The records from the trace table can be written to a spooled printer file, to a database file, or to tape or optical media.
Restrictions:
1. To use this command, you must have service (*SERVICE) special authority, or be authorized to the Service Trace function of Operating System through iSeries Navigator¡¯s Application Administration support. The Change Function Usage (CHGFCNUSG) command, with a function ID of QIBM_SERVICE_TRACE, can also be used to change the list of users that are allowed to perform trace operations.
2. The following user profiles have private authorities to use the command:
. QSRV
3. When the Watched job (WCHJOB) parameter is specified, the issuer of the command must be running under a user profile which is the same as the job user identity of the job being watched, or the issuer of the command must be running under a user profile which has job control (*JOBCTL) special authority. Job control (*JOBCTL) special authority is also required if a generic user name is specified for the WCHJOB parameter.
4. If you specify a generic user name in the WCHJOB parameter, you must have all object (*ALLOBJ) special authority, or be authorized to the Watch Any Job function of Operating System through iSeries 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.
5. 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.
6. 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.
Examples:
Example 1: Starting Component Data Traces and Call Traces
TRCINT SET(*ON) TRCTYPE(010100 010400 050500 051200)
This command starts component data traces and call traces for resource management and database. Database operations associated with database files are used to collect component data trace records.
Example 2: Tracing Lines and Controllers
TRCINT SET(*ON) TRCTYPE(*SRCSINK) TRCTBL(*SYSDFT)
DEV(WS1 WS2 WS3) CTL((C1) (C2)) LIN((L1) (L2))
This command starts component data traces for source/sink management (device support) operations involving the devices WS1, WS2, and WS3, lines L1 and L2, and controllers C1 and C2.
Example 3: Stopping Traces and Clearing Trace Table
TRCINT SET(*END) TRCTBL(*SYSDFT)
This command stops all traces and deletes the trace records from the system default trace table.
Example 4: Tracing Communications Trace Service Function
TRCINT SET(*ON) TRCTYPE(*CMNTRC)
This command starts component data traces for the communications trace service function.
Example 5: Using Job Filtering Capability
TRCINT SET(*ON) TRCTBL(MYFTPTRACE) TRCTYPE(*TCPIP) JOB(QTCP/QTFTP*)
This command starts a TCP/IP trace and will only collect trace records for trace points collected in jobs with user name QTCP and job names that begin with the prefix QTFTP. Trace records will be stored in trace table MYFTPTRACE.
Example 6: Start a Trace and Watch for a Message to End the Trace
TRCINT SET(*ON) TRCTYPE(*CMNTRC) WCHMSG((MCH2804))
WCHMSGQ((*SYSOPR) (*JOBLOG)) WCHJOB((*ALL/MYUSER/MYJOBNAME))
TRCPGM(MYLIB/TRCEXTPGM)
This command starts component data traces for the communications trace service function. The trace will be ended when MCH2804 message is found on the System Operator message queue or within the *ALL/MYUSER/MYJOBNAME job log. Also, MYLIB/TRCEXTPGM is specified as a trace exit program.
Example 7: Start a Trace and Watch for a LIC Log Entry to End the Trace
TRCINT SET(*ON) TRCTYPE(*CMNTRC) WCHLICLOG((¡¯99??¡¯ 9932 MYJOBNAME))
WCHTIMO(*NOMAX)
This command starts component data traces for the communications trace service function. The trace will be ended when a Licensed Internal Code (LIC) log entry that has a major code starting with 99 and a minor code of 9932 is generated on the system. Also, the LIC log information should contain the text ¡åMYJOBNAME¡å. *NOMAX on WCHTIMO parameter indicates that the trace will be active until the event occurs or TRCINT command is issued manually to stop the trace.
Example 8: Sending the Trace Output to an Outfile
TRCINT SET(*OFF) OUTPUT(*OUTFILE) OUTFILE(MYOUTFILE) OUTMBR(MYOUTMBR)
This command generates the outfile MYOUTFILE with member MYOUTMBR with the data traces.