INQUIRE DUMPDS

Retrieve information about the CICS® transaction dump data sets.

Syntax

Warning: System commands are powerful as they provide information about the state of the system and allow changes to be made to it. System commands should be used only by authorized applications and users.

Activate security checks on commands by specifying the XCMD system initialization parameter and by ensuring that command security checking is active for the transaction (either by specifying CMDSEC(YES) on the TRANSACTION resource definition or by specifying ALWAYS on the CMDSEC system initialization parameter).

INQUIRE DUMPDS

Read syntax diagramSkip visual syntax diagramINQUIRE DUMPDSCURRENTDDS( data-area)INITIALDDS( data-area)OPENSTATUS( cvda)SWITCHSTATUS( cvda)

Conditions: NOTAUTH

NOHANDLE, RESP, and RESP2 are common options that can be added to all EXEC CICS commands to process error conditions. They are not explicitly included in the command syntax diagram and option descriptions. For information about these common options and EXEC CICS command syntax, see EXEC CICS command format and programming considerations. 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.