DISP — Specify the Disposition of a Data Set

Use this parameter to tell MVS what to do with the “to” or “from” data set when the transaction completes or when the BDT address space terminates while the transaction is active.

Rules

Optional or Required: Optional

Section: FROM, TO

DAP: SEQ, PDS

Format


>>-DISP(--+-+-CATALOG-+---+--+-+-,CATALOG-+---+--)-------------><
          | '-CATLG---'   |  | '-,CATLG---'   |      
          +-+-UNCATALOG-+-+  +-+-,UNCATALOG-+-+      
          | '-UNCATLG---' |  | '-,UNCATLG---' |      
          +-DELETE--------+  +-,DELETE--------+      
          '-KEEP----------'  '-,KEEP----------'

If you specify one disposition, it tells MVS what to do with the data set after the data transfer completes normally.

If you specify two dispositions, the first disposition tells MVS what to do with the data set after the data transfer completes normally, and the second disposition tells MVS what to do with the data set if the transaction terminates abnormally.

CATALOG or CATLG: specifies that the data set is to be kept and that an entry pointing to the data set is to be added to the system or user catalog. CATALOG is the default for new “to” data sets.
UNCATALOG or UNCATLG: specifies that the data set is to be kept but the system or user catalog entry for the data set is to be removed.
DELETE: specifies that the data set is no longer needed; its space is to be released for use by other data sets.
KEEP: specifies that the data set is to be kept. KEEP is the default for existing data sets.

Usage Notes

If you use DISP(DELETE) together with the EXPDT or RETPD parameter, MVS ignores the EXPDT or RETPD parameter and deletes the data set.
For more information on cataloging data sets, see the z/OS MVS JCL User's Guide that is appropriate for your installation.

Examples

Copy a data set to an existing data set and specify that MVS is to keep the “to” data set after the transcation completes. Use the TSO prefix (BDT).
```
BDT Q  FROM DATASET(DATAB) LOCATION(KGN01) DAP(PDS)
       TO DATASET(DATAC) LOCATION(KGN02) OLD DISP(KEEP)
```
Copy a data set to a new data set. If the transaction completes normally, MVS is to keep the “from” data set, but not catalog it, and also catalog the new “to” data set. If the transaction terminates abnormally, MVS is to delete the “from” and “to” data sets.
```
BDT Q  FROM DATASET(FILEA) LOCATION(NODEA) DAP(PDS)
       DISP(KEEP,DELETE)
       TO DATASET(FILEB) LOCATION(NODEB)
       NEW LRECL(80) BLKSIZE(800) RECFM(F) DIR(12)
       SPACE(1,2) CYL DSORG(PO) VOLUME(222222)
       DISP(CATLG,DELETE) UNIT(3380)
```