INQUIRE DUMPDS
Retrieve information about the CICS® transaction dump data sets.
Conditions: NOTAUTH
For more information about the use of CVDAs, see CICS-value data areas (CVDAs).
Description
The INQUIRE DUMPDS command allows you to retrieve information about CICS transaction dump data sets. There can either be one of these, known as the ‘A’ data set, or two: ‘A’ and ‘B’. One is active (receiving dumps) and the other, if there are two, is inactive (standby).
Options
- CURRENTDDS(data-area)
- returns the 1-character designator of the active dump data set (A or B). The active dump data set is not necessarily open.
- INITIALDDS(data-area)
- returns
a 1-character value indicating which dump data set CICS designates as active at startup.
- A
- Dump data set A is active initially.
- B
- Dump data set B is active initially.
- X
- The dump data set that was not active when CICS last terminated (normally or abnormally) is active initially.
- OPENSTATUS(cvda)
- returns
a CVDA value identifying the status of the active CICS dump data set. CVDA values are:
- CLOSED
- The active CICS dump data set is closed.
- OPEN
- The active CICS dump data set is open.
- SWITCHSTATUS(cvda)
- returns
a CVDA value indicating whether CICS should
switch active data sets when the current one fills. CVDA values are:
- NOSWITCH
- No automatic switching occurs.
- SWITCHNEXT
- When the data set designated as active at startup fills, CICS closes it, opens the other, and makes that one active. This automatic switch occurs only once, when the first active data set fills; thereafter, switching is under manual or program control.
- SWITCHALL
- Every time the active data set fills, CICS closes it, opens the other, and makes that one active.
Conditions
- NOTAUTH
- RESP2 values:
- 100
- The user associated with the issuing task is not authorized to use this command.