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
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