Dataset Services Interface › $DSCALL OPT=VOLSPACE

$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