SET TRACEFLAG

Description

The SET TRACEFLAG command allows you to change the flags that control the creation of trace entries in CICS®. (See Using traces in problem determination for more information about tracing facilities and control.)

Changes made with this command are not recorded in the CICS catalog, and therefore do not persist beyond CICS shutdown.

Options

SINGLESTATUS(cvda)

specifies whether tracing is to be turned on or suppressed for the task issuing this SET TRACEFLAG command. No nonexception trace entries are made for a task when this flag is off (exception trace entries are always recorded).

When tracing is allowed, the type of tracing is standard unless special tracing has been requested (in an earlier use of the CETR transaction) for the transaction being executed or the terminal that is the principal facility. CVDA values are:

SINGLEOFF

Tracing is suppressed.

SINGLEON

Tracing is allowed.

SYSTEMSTATUS(cvda)

specifies how the system master trace flag is to be set. This flag determines whether CICS makes or suppresses standard trace entries (it does not govern special or exception trace entries). It applies to all tasks and all system activity; however, for standard trace entries to be recorded for any particular task, both the system master flag and the SINGLESTATUS flag for the task must be on. CVDA values are:

SYSTEMOFF

Standard tracing is to be suppressed.

SYSTEMON

Standard tracing is to be active.

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

specifies which invocations of the CICS z/OS Communications Server exits are to be 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). You can trace both types or nonterminal-specific activity only.

CVDA values are:

TCEXITALL

All exit activity is to be traced.

TCEXITALLOFF

Terminal-specific activity is not to be traced. The status of nonterminal-specific tracing is to remain unchanged.

TCEXITNONE

No exit activity is to be traced.

TCEXITSYSTEM

Nonterminal-specific activity is to be traced, but terminal-specific activity is not.

USERSTATUS(cvda)

specifies whether the user master trace flag is to be set on or off. 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 user 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

INVREQ

RESP2 values:

1

SYSTEMSTATUS has an invalid CVDA value.

2

USERSTATUS has an invalid CVDA value.

3

SINGLESTATUS has an invalid CVDA value.

4

TCEXITSTATUS has an invalid CVDA value.

5

TCEXITSTATUS is specified but z/OS Communications Server is not installed.

NOTAUTH

RESP2 values:

100

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