SPACE

The following information is displayed:

• device address
• VOLSER
• mount attribute
• EAV volume flag

You can also specify that you want information for the track-managed area (TRACK), cylinder-managed area (CYLINDER), or the two areas combined (COMBINED). The default is TRACK. The following information is displayed for the specified area as follows:

• total area size in bytes
• free space in bytes
• largest extent in bytes
• percentage of free space
• fragmentation index

Other filters are available to limit the displayed information.

Syntax

Operands

The first operand must be one of the following choices:

• device number
• esoteric (or generic) name
• volume serial number
• partial volume serial number

A partial volume serial number is specified by appending an asterisk (*) to the desired characters. For example, ABC* indicates that all devices with a volume serial number beginning with ABC are to be selected. Specifying only an asterisk indicates that all DASD volumes are desired and is equivalent to using the esoteric name SYSALLDA. The default is the generic name SYSDA.

The following operands are not positional and can be specified in any sequence. The last operand controls the sort order.

Subsequent operands allows you to limit the display to the desired information and to control how that information is sorted. You can specify as many operands as needed to obtain the desired result. Several keywords control the sort order, in which case the last keyword specified prevails. All keywords can be abbreviated to their first three characters. Keywords that accept an operator permit you to reject volumes that are not within the specified range. For example, you could specify LARGEST>2T to restrict the display to volumes that have at least two terabytes of contiguous free space, or you could specify SPACE * CYLINDER PCT<10 to locate all EAV volumes with free space of 10% or less.

The syntax diagram has two additional columns of logically grouped options as follows:

• TRACK, CYLINDER, and COMBINED are mutually exclusive options that select the management area to be processed.
  • TRACK (the default) indicates that you want data for the traditional track-managed area that is applicable to all volumes.
  • CYLINDER indicates that you want only information for the cylinder-managed area on Extended Addressability Volumes (EAV) devices.
  • COMBINED indicates that you want the information for both areas combined.

• ALLATR, PUBLIC, PRIVATE, and STORAGE filters (limits) the display to volumes with the requested mount attributes. The default is ALLATR, which indicates that you want all three. You can specify more than one value. For example, specifying PUBLIC, STORAGE causes PRIVATE volumes to be omitted.

The variable, exp, is an expression that provides additional filtering options and controls how the data is sorted. The following two forms for exp are provided:

label

label operator value

• label is one of the following column header labels: EV, TOTAL, FREE, LARGEST, PCT, and FRAG.
• operator is one for the following operands: <, =, or >.
• value is the desired limit value.

The variable value can be N or Y for keyword EAV. You can choose

• EAV=N to reject all EAV volumes
• EAV=Y to reject all non-EAV volume
• EAV to sort by the EAV column

For all other keywords value is any numeric value and, to simplify working with large values, you can append the numeric value with one of the following multipliers: K, M, G, T, or P, each of which increases by 1,000.

The following table lists all of the supported keywords and indicates which ones affect sort order, the direction of the sort, and if you can append operator/value pairs to the keyword.