$DSCALL OPT=VOLSPACE

Finds the number of free tracks on a volume (disk pack).

&CONTROL SHRVARS=($DS)
EXEC $DSCALL OPT=VOLSPACE
             VOL=volume_name

Use this function to find how much space is available on a volume.

Operands:

OPT=VOLSPACE

Specifies that free space on a volume be found.

VOL=volume_name

The name of the volume on which free space is to be found.

Return Codes:

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

Return Variables:

&$DSFREETRKS

The number of free tracks on the volume

&$DSUNIT

Unit of volume disk pack

Example: OPT=VOLSPACE

EXEC $DSCALL OPT=VOLSPACE VOL=MOS001