Previous Topic: CAICCI Component TraceNext Topic: CAIENF Control Options

CAICCI Component Trace › Component Trace Command Format for CAICCI

Component Trace Command Format for CAICCI

In addition to using the CCICT CAICCI parameter to start the component trace, you can also start the External Writer and trace manually. You can also restart a trace when a previous trace was stopped with the z/OS TRACE CT command.

These examples assume that the Component Trace name for CAICCI is defined to be CACCI.

To start an External Writer that is using the CCIXWTR task, issue this z/OS command:

TRACE CT,WTRSTART=CCIXWTR

To start a trace, use one of the following two commands:

TRACE CT,,COMP=CACCI,PARM=PARMLIB_member

Reads and runs PARMLIB_member from SYS1.PARMLIB. The same PARMLIB member that you specify with the CAICCI CCICT. Again, a sample member, CTECCI00, is shipped in CAI.CAW0OPTN.

TRACE CT,ON,COMP=CACCI

This command generates a WTOR which must be responded to as such:

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

Specifies which applications are traced. If no ASIDs or JOBNAMEs are specified, all CAICCI applications are traced. If any ASID or JOBNAME is specified, only these applications are traced. Up to 16 ASIDs and JOBNAMES can be specified.

WTR=CCIXWTR:

Requests that the CAICCI Trace Component is connected to its External Writer CCIXWTR.

WTR=DISCONNECT:

Requests that the CAICCI Trace Component is disconnected from its External Writer.

OPTIONS=():

The CAICCI Start/Stop routine accepts these OPTIONS:

  • eid1,eid2,…
  • EXTEND(#buffers)
  • RESET(#buffers,buffer_size)
  • DUMPON
  • DUMPOFF
  • PAUSE
  • RESUME
eid1, eid2, …

Enables one or more Event IDs (EIDs). #CCICT macro calls specifying one of these EIDs commence capturing trace data. Currently implemented EIDs are:

APIE – Traces entry into the API

APIF – Traces API call failures

APIX – Traces API exit to the caller

SRBR – Traces execution through the Receiver SRB

SRBS – Traces execution through the Sender SRB

EXTEND(#buffers)

Extends the current trace data space by the specified number of buffers. Trace data within the existing buffers is unaffected. Tracing must have been previously set ON before this option can be used.

RESET(#buffers,buffer_size)

Resets the current trace data space to have the specified buffer_size (in Kilobytes) and #buffers. Trace data within the existing buffers is lost. If #buffers or buffer_size is omitted, the current value is used. Omitting both values causes the existing trace buffers to be cleared. This option can be used at any time.

PAUSE and RESUME

PAUSE internally pauses tracing. RESUME resumes tracing. The current tracing criteria (#buffers, buffer_size, JOBNAMEs, ASIDs, EIDs) is not affected.

This command can be re-entered to modify the existing trace settings. However if ASIDs, JOBNAMEs or EIDs are specified, their previous settings are lost. The new values overwrite the existing values.

To stop an External Writer that is using the CCIXWTR task, issue this z/OS command:

TRACE CT,WTRSTOP=CCIXWTR

To stop an active CAICCI trace, issue this z/OS command:

TRACE CT,OFF,COMP=CACCI