DISP
Use
DISP is an optional keyword for the following subcommands:
- ACTIVITY_FILECTL
- DISCARD_FILECTL
- IC
- IX
- OFILECTL
- PLAN_FILECTL
Related keyword
DSNAME
Syntax
Parameters
Specify one of the following values for the status parameter:
Value | Description |
|---|---|
NEW | Create a new data set. |
OLD | Use an existing data set exclusively. |
USE | Use conditional allocation. If the data set does not exist, it is created (as if NEW had been specified). If the data set already exists, it is re-allocated (as if OLD had been specified). The normal and conditional parameters are also changed from CATLG (if specified) to KEEP. |
Specify one of the following values for the normal parameter to request the action to occur if the data set is created successfully:
Value | Description |
|---|---|
DELETE | Release the space allocated for the data set. |
KEEP | Keep the data set on the volume. |
CATLG | Place an entry pointing to the data set in the catalog. |
UNCATLG | Remove the catalog entry to the data set, but retain the data set. |
Specify one of the following values for the conditional parameter to request the action to occur if any errors occur while creating the data set:
Value | Description |
|---|---|
DELETE | Release the space allocated for the data set. |
KEEP | Keep the data set on the volume. |
CATLG | Place an entry pointing to the data set in the catalog. |
UNCATLG | Remove the catalog entry to the data set, but retain the data set. |
Default
Default settings for the DISP keyword are as follows:
Setting | Value |
|---|---|
status | DISP=NEW |
normal | If status is NEW, then DISP=(, DELETE). If status is OLD, then DISP=(, KEEP). |
conditional | If status is NEW, then DISP=(, DELETE). If status is OLD, then DISP=(, KEEP). |
Alias
None