CAICCI Component Trace › Command Format

Previous Topic: CAICCI Component Trace Details

Next Topic: CAIENF Control Options

Command Format

In addition to using the CCICT CCI parm to start the component trace, you may also start the External Writer and trace manually. You can also restart a trace when a previous trace was stopped. Use the z/OS TRACE CT command for this.

These examples assume that the Component Trace name for CCI 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,ON,COMP=CACCI

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

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

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

WTR=CCIXWTR:

This parameter requests that the CAICCI Trace Component be connected to its External Writer CCIXWTR.

WTR=DISCONNECT:

This parameter requests that the CAICCI Trace Component be disconnected from its External Writer.

OPTIONS=():

The CAICCI Start/Stop routine accepts the following for 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 that specify one of these EIDs will now 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 either #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.

TRACE CT,,COMP=CACCI,PARM=PARMLIB_member

This command, when entered reads and runs PARMLIB_member from SYS1.PARMLIB. This is the same PARMLIB member that you specify with the CAICCI CCICT. Again, a sample member, CTECCI00, is shipped in CAI.CAW0OPTN.

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

TRACE CT,WTRSTOP=CCIXWTR

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

TRACE CT,OFF,COMP=CACCI