IPCSDDIR command — initialize a user or sysplex dump directory

Use the IPCSDDIR command to:

Initialize a user dump directory or a sysplex dump directory
Reset a directory to contain only initialization records

To initialize the directory, the IPCSDDIR command writes two records to it: one with a key of binary zeros (0) and the other with a key of binary ones (1). Once the directory is initialized, you do not need to reinitialize it.

Initialization of the directory is required before IPCS subcommands can use it.

Syntax

  IPCSDDIR    dsname
             [REUSE | NOREUSE ]
             [CONFIRM | NOCONFIRM ]
             [ENQ | NOENQ ]

Operands
dsname

The name of the data set for the dump directory.

REUSE

NOREUSE

REUSE requests that the system delete all records from the data set and write the initialization records to the data set. The directory must have the VSAM REUSE attribute to use this option.
NOREUSE requests that the system write the initialization records to the data set. When using IPCSDDIR NOREUSE, the data set should contain no records; if the initialization records are already present, the command will fail.

CONFIRM

NOCONFIRM

CONFIRM causes the IPCS user to be prompted before IPCS runs a IPCSDDIR REUSE command.
NOCONFIRM authorizes immediate processing of an IPCSDDIR REUSE command.

ENQ

NOENQ

ENQ causes IPCSDDIR to serialize access to the dump directory during its initialization. This is the default and the recommended option.
NOENQ suppresses ENQ processing that is intended to block other instances of IPCS from using the directory being prepared for use by IPCSDDIR. IPCS itself uses this option when it has already established the needed serialization. Manual use of this option is not recommended.

Return Codes

Code	Explanation
00	Successful completion.
04	Attention, command completed with a condition that might be of interest to the user.
08	Error, command encountered an error condition that might be of interest to the user.
12	Severe, an error condition or user request forced early end to the command processing.
16	Ending, an error condition from a called service routine forced an early end to the processing.