SET DUMPDS
Change the status of the transaction dump data sets.
Conditions: INVREQ, IOERR, NOTAUTH
For more information about the use of CVDAs, see CICS-value data areas (CVDAs).
Description
active(receiving dumps) and the other, if there are two, is
inactive(standby). Specifically, you can:
- Open or close the active data set.
- Switch the roles of the active and standby data sets.
- Request CICS to switch automatically when the active data set is full.
- Specify which data set is active the next time CICS is initialized.
Control does not return to the task issuing the command until the requested change has been made.
Options
- INITIALDDS(data-value)
- Specifies, as a
1-character value, which dump data set is to be active first on subsequent warm or emergency
restarts. This value is recorded in the CICS global catalog
and overrides the previous value, which is set initially by the DUMPDS system initialization parameter.
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 parameter.
- OPENSTATUS(cvda)
- Specifies
actions to be taken on the transaction dump data sets. CVDA values are as follows:
- CLOSED
- The active CICS dump data set is to be closed.
- OPEN
- The active CICS dump data set is to be opened.
- SWITCH
- The roles of the dump data sets are to be switched, if there are two. The data set that is
currently active is to become standby, and closed if it is open. The current standby is to become
the active data set, and opened if closed.
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.
- SWITCHSTATUS(cvda)
- Specifies
whether CICS is to switch active data sets automatically the
next time the current dump data set fills. The SWITCHSTATUS value is recorded in the CICS global catalog, and therefore is remembered over warm and
emergency restarts. (It is set initially by the
DUMPSW system initialization parameter.) CVDA values are as follows:
- NOSWITCH
- The data sets are not be switched.
- SWITCHNEXT
- The data sets are to be switched when the active one fills, but only once. (SWITCHNEXT has no effect unless there are two dump data sets at the time the active one fills.)
- SWITCHALL
- The data sets are to be switched every time the active one fills. (SWITCHALL has no effect unless there are two dump data sets at the time the active one fills.)
Conditions
- INVREQ
- RESP2 values:
- 1
- INITIALDDS has an invalid value.
- 2
- SWITCHSTATUS has an invalid CVDA value.
- 3
- OPENSTATUS has an invalid CVDA value.
- IOERR
- RESP2 values:
- 4
- OPEN or SWITCH caused an error opening a data set.
- NOTAUTH
- RESP2 values:
- 100
- The user associated with the issuing task is not authorized to use this command.
Example
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.