INQUIRE TRACEFLAG

Description

The INQUIRE TRACEFLAG command returns the current settings of the flags that control tracing in CICS® generally, and for the task that issued the command specifically.

Tracing facilities and control are discussed in detail in ../../com.ibm.cics.ts.doc/dfhs1/topics/dfhs13o.html#dfhs13o.

Options

SINGLESTATUS(cvda)

returns a CVDA value indicating whether tracing is turned on or is suppressed for the task that issued this INQUIRE TRACEFLAG command. No non-exception trace entries are made for a task when this flag is off, regardless of the settings of the master trace flags (exception trace entries are always recorded).

The SINGLESTATUS value comes from the TRACE option in the definition of the TRANSACTION the task is executing, unless a different value has been specified, either for the transaction or for the terminal that is the principal facility, by means of the CICS-supplied CETR transaction. When a task is in progress, its SINGLESTATUS value can also be changed with a SET TRACEFLAG command.

CVDA values are:

SINGLEOFF

Tracing is suppressed.

SINGLEON

Tracing is allowed.

SYSTEMSTATUS(cvda)

returns a CVDA value indicating the status of the system master trace flag. This flag governs whether CICS makes or suppresses standard trace entries (it does not affect special or exception trace entries). It applies to all tasks and all system activity; however, for such trace entries to be recorded for any particular task, both the system master flag and the SINGLESTATUS flag for that task must be on.

CVDA values are:

SYSTEMOFF

Standard tracing is suppressed.

SYSTEMON

Standard tracing is active.

TCEXITSTATUS(cvda) (z/OS® Communications Server only)

returns a CVDA value indicating which invocations of the CICS z/OS Communications Server exits are being traced.

Two types of exit activity can be traced: invocations associated with particular terminals that have been designated for z/OS Communications Server exit tracing (“terminal-specific” activity) and invocations not related to any particular terminal (“nonterminal-specific” activity).

CVDA values are:

NOTAPPLIC

z/OS Communications Server is not installed in the system.

TCEXITALL

All exit activity is being traced.

TCEXITNONE

No exit activity is being traced.

TCEXITSYSTEM

Nonterminal-specific activity is being traced, but terminal-specific activity is not.

USERSTATUS(cvda)

returns a CVDA value indicating the status of the user master trace flag. This flag governs whether non-exception user trace entries are recorded or suppressed (entries that specify the EXCEPTION option are never suppressed). It applies to all tasks; however, for such entries to be recorded for any particular task, both the user master trace flag and the SINGLESTATUS flag for that task must be on. CVDA values are:

USEROFF

User tracing is suppressed.

USERON

User tracing is allowed.

Conditions

NOTAUTH

RESP2 values:

100

The user associated with the issuing task is not authorized to use this command.