SPACE

Use the SPACE keyword to specify the space requirements of an output data set created by dynamic allocation.

Use

SPACE is an optional keyword for the following subcommands:

ACTIVITY_FILECTL
ALLOCATE
DISCARD_FILECTL
IC
OFILECTL
PLAN_FILECTL

Related keywords

AVGREC
DSNAME

Syntax

SPACE=(units,primary,[secondary],[RLSE],[CONTIG/MXIG/ALX],
       [ROUND])

In the syntax shown above, you must include all commas that precede any optional parameters specified.

Parameters

Specify one of the following values for theunits parameter:

Value

Description

CYL

Allocation unit is in cylinders.

TRK

Allocation unit is in tracks.

numeric value from 512 to 32767

Allocation unit is either blocks or records, depending on whether the AVGREC keyword is also specified:

If the allocation unit is in blocks, the specified number indicates the average block size. Do not specify the AVGREC keyword if the unit type is in blocks.
If the allocation unit is in records the number specifies the average record size. Specify the AVGREC keyword to indicate that the allocation unit is in records.

For theprimary parameter, specify a numeric value from 1 to 16777215 for primary space for the allocated data set. The value represents the number of allocation units of to be allocated.

For thesecondary parameter, specify a numeric value from 0 to 16777215 if additional space is required for the allocated data set. The value represents the number of allocation units of to be allocated.

The RLSE positional parameter is optional. Specify RLSE to request release of unused space.

The CONTIG, MXIG, or ALX positional parameter is optional and refers to data set placement on DASD:

Parameter	Description
CONTIG	Space allocated for the data set must be contiguous on the volume. This value applies only to primary space allocation.
MXIG	Space allocated for the data set is the largest area of available contiguous space on the volume that is equal to or greater than the primary quantity.
ALX	Space allocated for the data set includes up to five separate contiguous areas on the volume and each area must be equal to or greater than the primary quantity.

The ROUND positional parameter is optional. Specify ROUND to request rounding of the space to complete the number of allocated units.

Default

The default value for the secondary parameter is 0: SPACE=(,,0). Defaults do not apply to any other parameters.

Alias

None