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 option.
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 DUMPDS for a description of this option.)
- OPENSTATUS(cvda)
- specifies
actions to be taken on the transaction dump data sets. CVDA values are:
- 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 option, described
in DUMPSW.)
An automatic switch occurs only once; another SET DUMPDS SWITCHNEXT command
is required after each switch to maintain automatic switching. CVDA values
are:
- NOSWITCH
- The data sets are not be switched.
- SWITCHNEXT
- The data sets are to be switched. (SWITCHNEXT 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.
Examples
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.