SET TRACEFLAG
Change settings of trace flags.
Syntax
Activate security checks on commands by specifying the XCMD system initialization parameter and by ensuring that command security checking is active for the transaction (either by specifying CMDSEC(YES) on the TRANSACTION resource definition or by specifying ALWAYS on the CMDSEC system initialization parameter).
Conditions: INVREQ, NOTAUTH
NOHANDLE, RESP, and
RESP2 are common options that can be added to all EXEC CICS
commands to process error conditions. They are not explicitly included in the command syntax diagram
and option descriptions. For information about these common options and EXEC CICS
command syntax, see EXEC CICS command format and programming considerations. For more information
about the use of CVDAs, see CICS-value data areas (CVDAs).
This command is threadsafe.
Description
The SET TRACEFLAG command allows you to change the flags that control the creation of trace entries in CICS®. (See Using CICS trace for 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 main 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 main 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 main 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 main 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.