Required Parameters

PAGESPACE
specifies that a page space is to be defined.

Recommendation: Use the KILOBYTES or MEGABYTES option to specify the amount of space for the DEFINE PAGESPACE command.

Abbreviation: PGSPC

NAME(entryname)
specifies the name of the page space being defined.
CYLINDERS(primary)|
KILOBYTES(primary)|
MEGABYTES(primary)|
RECORDS(primary)|
TRACKS(primary)
specifies the amount of space that is to be allocated. This parameter is optional if the volume is managed by SMS. If it is specified, it overrides the DATACLASS space specification. If it is not specified, it must be modeled or defaulted by SMS. If it cannot be determined, the DEFINE is unsuccessful.

If you specify KILOBYTES or MEGABYTES the amount of space allocated is the minimum number of tracks or cylinders required to contain the specified number of kilobytes or megabytes. The maximum space can be specified with unit of KILOBYTES or MEGABYTES is 16,777,215. If the amount requested exceeds this value, you should specify a larger allocation unit.

If RECORDS or TRACKS is specified, the quantity specified is rounded up to the nearest cylinder and the space is allocated in cylinders.

To maintain device independence, do not specify the TRACKS or CYLINDERS parameters. If TRACKS or CYLINDERS is specified for an SMS-managed pagespace, space is allocated on the volume selected by SMS in units equivalent to the device default geometry.

The amount of space need not be specified if the RECATALOG parameter is specified.

To determine the exact amount of space allocated, list the page space's catalog entry, using the LISTCAT command.

If you do not specify the MODEL parameter, you must specify one, and only one, of the following parameters: CYLINDERS, KILOBYTES, MEGABYTES, RECORDS, or TRACKS.
Note: Page data sets cannot be defined in cylinder-managed space.
primary
Specifies the amount of space that is to be allocated to the page space. After the primary extent is full, the page space is full. The page space cannot extend onto secondary extents. The maximum number of paging slots for each page space is 16M. Page spaces regardless of their size have the extended format and extended addressable attributes assigned to them whether they are on an SMS managed volume or a non-SMS managed volume.

Abbreviations: CYL, KB, MB, REC, and TRK

VOLUME(volser)
specifies the volume that contains the page space. If you do not specify the MODEL parameter, or if the page space is not SMS-managed, VOLUME must be specified as a parameter of PAGESPACE.

VOLUME can be specified or modeled for a data set that is to be SMS-managed, but be aware that the volume specified might not be used and, in some cases, can result in an error. If VOLUME is not specified for an SMS-managed data set, SMS selects the volume. See z/OS DFSMSdfp Storage Administration for information about SMS volume selection.

Nonspecific volumes are indicated for an SMS-managed data set by coding an * for each volume serial. SMS then determines the volume serial.

The VOLUME parameter interacts with other DEFINE PAGESPACE parameters. Ensure that the volumes you specify for the page space are consistent with the page space's other attributes:
  • The volume must contain enough unallocated space to satisfy the page space's space requirement.
  • The volume information supplied with the DD statement pointed to by FILE must be consistent with the information specified for the page space.

Abbreviation: VOL

Parent topic: DEFINE PAGESPACE Parameters