Change tracing options.
SET TRACEDEST >>-SET TRACEDEST--+-----------------+--+-----------------+------> +-AUXSTATUS(cvda)-+ +-GTFSTATUS(cvda)-+ +-AUXPAUSE--------+ +-GTFSTART--------+ +-AUXSTART--------+ '-GTFSTOP---------' '-AUXSTOP---------' >--+-----------------+--+--------------------+------------------> +-INTSTATUS(cvda)-+ +-SWITCHACTION(cvda)-+ +-INTSTART--------+ '-SWITCH-------------' '-INTSTOP---------' >--+--------------------+--+-----------------------+----------->< +-SWITCHSTATUS(cvda)-+ '-TABLESIZE(data-value)-' +-NOSWITCH-----------+ +-SWITCHALL----------+ '-SWITCHNEXT---------'
Conditions: INVREQ, IOERR, NOSPACE, NOSTG, NOTAUTH
For more information about the use of CVDAs, see CICS-value data areas (CVDAs).
CICS can write trace entries to three possible destinations: the CICS internal trace table, the auxiliary trace data set, and the MVS Generalized Trace Facility (GTF). The SET TRACEDEST command allows you to specify which destinations are to receive the entries. You also can use it to change the size of the trace table and to switch auxiliary trace data sets.
Two other commands, SET TRACEFLAG and SET TRACETYPE, and a CICS-supplied transaction, CETR, can be used to control the number and type of trace entries.
Changes made with this command are not recorded in the CICS catalog. Therefore the options affected are always reset to the corresponding system initialization values at CICS startup. These are: INTSTATUS and TRTABSZ (for internal tracing), AUXTR and AUXTRSW (auxiliary tracing), and GTFSTATUS (GTF tracing). See the CICS® System Definition Guide for more information about these values.
If your system supports auxiliary tracing, it has either one or two auxiliary trace data sets. One is "active", which means it receives trace entries when auxiliary tracing is turned on, and the other, if there are two, is a standby.
When there are two, you can reverse their roles by specifying SWITCH. This causes CICS to close the current active data set, open the standby, and reverse the designation of which is active and which standby.
If there is only one (or none), SWITCH causes an exception condition, because CICS attempts to open a data set that is not defined.
The CVDA value is:
The table is allocated in multiples of 4KB,
with a minimum size of 16KB. Consequently, the value you specify is increased
to the next multiple of 4, and to 16 if you specify less than 16. The maximum
size is 1048576.
Use caution when setting
TABLESIZE to a very high value because there must be enough MVS page storage
to satisfy both the request and DSA sizes. The system command DISPLAY ASM MVS can be used to display current information about status
and utilization of all MVS page data sets.
EXEC CICS SET TRACEDEST
SWITCH
NOSWITCH
The SWITCH option tells CICS to switch now from the active auxiliary trace data set (which is not necessarily full) to the alternate. The NOSWITCH option tells CICS not to switch when the new active data set fills.