Dataset Services Interface › $DSCALL OPT=UNALL

$DSCALL OPT=UNALL

Deallocates a data set from your product region.

&CONTROL SHRVARS=($DS)
EXEC $DSCALL 
OPT={ UNALL | FREE } 
DD=DD_name [ DISP={ KEEP | DELETE } ]

Use this option to deallocate a data set.

Operands:

• OPT=UNALL | FREE

  Specifies that a data set is to be deallocated.

• DD=DD_name

  Specifies the name of the DD to be deallocated.

• DISP={ KEEP | DELETE }

  Specifies an override of the Normal Disposition which was specified when the data set was allocated to your product region.

Return Codes:

Note: For more information about &SYSMSG, &$DSRC, and &$DSFDBK, see Return Codes and Feedback Codes.

Return Variables:

• &$DSDYNEC

  DYNALLOC error code

• &$DSDYNIC

  DYNALLOC information code

Example: OPT=UNALL

EXEC $DSCALL OPT=UNALL DD=DD1

Notes:

If a concatenated data set is freed, the first data set in the concatenation is deallocated and the other ddnames in the concatenation return to their original allocation state. The net effect is the same as a deconcatenation followed by a deallocation of the first ddname in the concatenation.

A temporary data set whose name was generated at allocation is deleted when deallocated, regardless of the disposition value specified.