SET DUMPDS

Change the status of the transaction dump data sets.

SET DUMPDS

Read syntax diagramSkip visual syntax diagramSET DUMPDSINITIALDDS(data-value)OPENSTATUS(cvda)CLOSEDOPENSWITCHSWITCHSTATUS(cvda)NOSWITCHSWITCHNEXT

Conditions: INVREQ, IOERR, NOTAUTH

For more information about the use of CVDAs, see CICS-value data areas (CVDAs).

Description

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:
  • 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.
Note: If a CICS system is initialized without any transaction dump data sets, only the last two functions are available.

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.