>>-TRACE CT,----------------------------------------------------> .-,WRAP---. >----+-WTRSTART=parmlibmem-+---------+-----------------+------->< | '-,NOWRAP-' | +-WTRSTOP=jobname---------------------------------+ +-ON,--COMP=irlmnm--+---------------------------+-+ | | .---------. | | | | V | (1) | | | '-,SUB=(---+-DBM-+-+-)------' | | +-EXP-+ | | +-INT-+ | | +-SLM-+ | | +-XCF-+ | | '-XIT-' | '-OFF---------------------------------------------'
Use the z/OS TRACE CT command to start, stop, or modify an IRLM diagnostic trace. IRLM does not support all the options available on the TRACE CT command described in OS/390 MVS System Commands (GC28-1781).
The impact of setting TRACE CT ON is that each active subname type requires up to .7 MB of ECSA. Because IRLM initializes its own traces when it starts, the DISPLAY TRACE command shows that all traces are off. After you issue the TRACE ON command, the reports are accurate except for the two subname types, INT and EXT, which cannot be turned off.
This command can be entered only from the master console. The command requires an appropriate level of z/OS authority, as described in OS/390 MVS System Commands (GC28-1781).
After you enter a TRACE CT,WTRSTART command, turn the trace on and connect the writer using the WTR parameter in the reply for a TRACE CT command, as shown in Examples
The job name is either:
In the case of the EXP and INT sublevel traces, the OFF parameter stops the traces from writing to the external writer. However they continue to write to buffers. These traces are used by IMS for debugging purposes.
Because this command uses z/OS component trace services, make sure that the IRLM start and stop load module, DXRRL183, is in the z/OS link list.
Here is a sample procedure for the IRLM external writer:
//CTWTR PROC // EXEC PGM=ITTTRCWR //TRCOUT01 DD DSNAME=SYS1.WTR1,DISP=OLD //TRCOUT02 DD DSNAME=SYS1.WTR2,DISP=OLD
To display a trace, use the z/OS DISPLAY command:
D TRACE,COMP=IRLM
Here is an example sequence of commands to start and stop an IRLM DBM trace. In this example, the trace data is written to an external writer data set identified in procedure CTWTR:
TRACE CT,WTRSTART=CTWTR TRACE CT,ON,COMP=IRLM,SUB=(DBM)
·
·
·
(z/OS asks for a reply.)
·
·
·
R 15,WTR=CTWTR,END TRACE CT,OFF,COMP=IRLM,SUB=(DBM)
·
·
·
(Wait a while to make sure trace buffers are externalized.) TRACE CT,WTRSTOP=CTWTR
Here is a sample procedure to start and stop traces in wrap-around mode. The traces captured in this procedure are saved in a limited number of buffers that are provided by IRLM. Each buffer is reused when the previous buffer is filled.
TRACE CT,ON,COMP=IRLM
·
·
·
(z/OS asks for a reply.)
·
·
·
R 15,END TRACE CT,OFF,COMP=IRLM