CAIENF Component Trace › Command Format

Command Format

In addition to using the ENFCT ENF parm to start the component trace, you may also start the trace manually. You can also start a trace when a previous trace was stopped. Use the z/OS TRACE CT command for this.

This command has the following syntax:

TRACE CT,ON,COMP=component

The following code generates a WTOR:

R nn,[,OPTIONS=()][,ASID=()] [,JOBNAME=()] [,WTR=writer|DISCONNECT]

The Start/Stop routine accepts the following as options:

PAUSE
RESUME
ENAble|ENAble(trcid) option 1
DISable|DISable(trcid) option 1
MODify(trcid)  option 1
LIST|LIST(trcid)
STATUS

Option 1:

EIDG(eidg, eidg, ...eidg)
XEIDG(eidg, eidg, ...eidg)
XAJ
LIMIT(max)

Where trcid is the trace set id and eidg is the event ID group.

PAUSE and RESUME

PAUSE will internally pause tracing. RESUME will resume tracing. This allows TRACE CT commands to be issued to update trace sets while not internally collecting trace data.

ENABLE and DISABLE

If a trace set ID is specified and if it exists, it is updated and the status changed to enabled or disabled. If the trace set ID does not exist, a new trace set is created and its status is set to enabled or disabled. If the trace set ID is not specified, a trace set ID is generated, a new trace set created, and its status set to enabled or disabled. Specifying ASID= or JOBNAME= will rebuild the filtering criteria.

Modify

The trace set ID must exist. The specified trace set is updated. Specifying ASID= or JOBNAME= will rebuild the filtering criteria.

LIST

If the trace set ID is not specified, all defined trace sets are displayed.

STATUS

Displays the status as to whether tracing is active or inactive, paused or not paused, and the events being traced.

EIDG (eidg, eidg, ...eidg)

For ENABLE, DISABLE, and MODIFY, this will designate the Event ID Groups (for instance, E1 and P1 are groups) to be traced.

XEIDG(eidg, eidg,...eidg)

For MODIFY, this will designate the Event ID Groups to be removed from the list of Event ID Groups to be traced.

XAJ

For ENABLE, DISABLE and MODIFY this indicates that the ASID= and JOBNAME= specifications are excluded ASIDs and JOBNAMEs. Specifying XAJ without ASID= or JOBNAME= resets any filtering based on address space.

LIMIT(max)

For ENABLE, DISABLE, and MODIFY, this will indicate the maximum number of times the data will be collected for that trace set. A value of zero indicates no limit is in effect (can undo a previous specification). The maximum value is 16,000,000. By default, no limit is in effect.

This command syntax can also be used to start the trace manually if you wish to use the options in the CTEENF00 parms member:

   TRACE CT,ON,COMP=CAIENF,PARM=CTEENF00

Event ID Groups

To stop an active trace that is using the ENFXWTR task, issue these z/OS commands:

TRACE CT,OFF,COMP=CAIENF
TRACE CT,WTRSTOP=ENFXWTR