Change the status of the transaction dump data sets.
SET DUMPDS >>-SET DUMPDS--+------------------------+-----------------------> '-INITIALDDS(data-value)-' >--+------------------+--+--------------------+---------------->< +-OPENSTATUS(cvda)-+ +-SWITCHSTATUS(cvda)-+ +-CLOSED-----------+ +-NOSWITCH-----------+ +-OPEN-------------+ '-SWITCHNEXT---------' '-SWITCH-----------'
Conditions: INVREQ, IOERR, NOTAUTH
For more information about the use of CVDAs, see CICS-value data areas (CVDAs).
The SET DUMPDS command allows you to change the status of CICS transaction dump data sets. Normally, either there is one of these, known as the ‘A’ dump data set, or there are two, ‘A’ and ‘B’. One is "active" (receiving dumps) and the other, if there are two, is "inactive" (standby). Specifically, you can:
Control does not return to the task issuing the command until the requested change has been made.
The values permitted are A, B, and X. X means that CICS is to use the data set that was not active when CICS last terminated (normally or abnormally); it corresponds to the AUTO setting for the DUMPDS option. (See the CICS® System Definition Guide for a description of this option.)
If you attempt to change the open status of a data set that does not exist, an IOERR exception condition occurs. This can happen if you specify SWITCH when there is only one dump data set, or if you specify any OPENSTATUS value when there are no dump data sets.
EXEC CICS SET DUMPDS
INITIALDDS('A')
SWITCH
NOSWITCH
This example tells CICS that the A dump data set is to be active first on subsequent warm and emergency restarts. The OPENSTATUS setting of SWITCH makes the currently active dump data set inactive, and the currently inactive dump data set active. The NOSWITCH option tells CICS that when the (new) active dump data set is full, there is to be no automatic switch to the inactive dump data set.