Specifying TRACE CT options

In response to a TRACE CT,ON command without the PARM parameter, the system prompts you to specify the component trace options you want with message ITT006A. Use the REPLY command to respond to that message. You can specify each option, ASID, JOBNAME, OPTIONS, or WTR only if the component or application supports it. You can enter the DISPLAY TRACE command before entering a TRACE CT command to verify which options are supported.

The REPLY command syntax for specifying TRACE CT options is:

 
R id[,ASID=(nnnn[,nnnn]...)]
         [,JOBNAME=(name[,name]...)]
    [,OPTIONS=(name[,name]...)]
         [,WTR={membername|DISCONNECT}]
    [,CONT|,END ]

Note: When you specify CONT or END, it must be the last parameter on the input line.

id

The identification number (0-9999), as specified on the prompting message.

ASID=(nnnn[,nnnn]...)

Specifies the address space identifiers (ASIDs) of address spaces to be used as a filter for tracing. Events in these ASIDs are to be recorded by the component trace.

The parameter contains a list of 0 to 16 hexadecimal ASIDs separated by commas. An empty ASID list, ASID=(), turns off filtering by address spaces. In the ASID parameter, list all address spaces to be traced; address spaces specified for previous traces will not be traced unless listed.

JOBNAME=(name[,name]...)

Specifies the names of jobs to be used as a filter for tracing. Events in these jobs are to be recorded by the component trace.

The parameter contains a list of 0 to 16 job names separated by commas. An empty job list, JOBNAME=(), turns off filtering by jobs. In the JOBNAME parameter, list all jobs to be traced; jobs specified for previous traces will not be traced unless listed.

OPTIONS=(option[,option]...)

Specifies component-specific options for tracing. See z/OS MVS Diagnosis: Tools and Service Aids for the options for an IBM-supplied component that supports component tracing. Refer to the installation-supplied application for the options for the application.

The options for some IBM-supplied component traces can be changed while the trace is running; to change the options for others, stop the trace and restart it with the new options. An installation-supplied application trace defined with MOD=YES in the CTRACE DEFINE macro can be changed while running.

The options for a head level defined with HEADOPTS=NO cannot be changed. When you change a head level that was defined with HEADOPTS=YES, all of the sublevel traces currently in LIKEHEAD status will also be changed. Therefore, a change may cascade down a number of levels.

Omit OPTIONS to allow the component to use its default options.

WTR=membername

WTR=DISCONNECT

Connects or disconnects the component trace external writer and the trace. membername identifies the name of the member that contains the source JCL that invokes the external writer. The member can be a SYS1.PROCLIB cataloged procedure or a job. The membername in the WTR parameter must match the membername in a previous TRACE CT,WTRSTART command.

WTR=DISCONNECT disconnects the writer and the trace. The component continues tracing and placing the trace records in the address-space buffer, but stops passing trace records to the external writer.

You must also specify a TRACE CT,WTRSTART or TRACE CT,WTRSTOP command to start or stop the writer.

CONT or END

Specifies that the reply continues on another line. The system reissues the same prompting message. You then can continue the reply. You can repeat any parameters on the continuation line, except END. Repeated parameters are strung together. They do not overlay each other. You must specify END to complete the response. END identifies the end of the REPLY.

Example 1:

To turn off system trace, enter:

TRACE ST,OFF

Example 2:

System trace is off. The last time system trace was on, 16K of storage was set aside for system trace table entries for each processor. To turn on system trace, turn on the branch tracing function of system trace, and increase the space for system trace table entries to 250K for each processor, enter:

TRACE ST,250k,BR=ON

Example 3:

To turn on master trace, if it is not already on, and to define a master trace table of 100K, enter:

TRACE MT,100k

Example 4:

To modify component trace for the GRS component by specifying a different parmlib member, enter:

TRACE CT,ON,COMP=SYSGRS,PARM=CTYGRS02