|
- CATALOG(catname)
- The CATALOG parameter is allowed on the DEFINE PAGESPACE
command only when the RECATALOG keyword is also coded. To define
a new pagespace that is located in another master catalog (for example,
a target system master catalog), create an alias in the current master
catalog related to the target master catalog. Define the pagespace
using a data set name starting with the alias that was created. Then
rename the pagespace with the ALTER command, specifying the CATALOG
parameter on the ALTER command.
To specify catalog names for
SMS-managed data sets, you must have authority from the RACF® STGADMIN.IGG.DIRCAT facility class. See Storage Management Subsystem (SMS) Considerations for more information. - catname
- is the name of the catalog or an ALIAS of the catalog
in which the entry is to be defined.
Abbreviation: CAT
- DATACLASS(class)
- specifies
the name, 1-to-8 characters, of the data class for the data set. It
provides the allocation attributes for new data sets.
Your storage
administrator defines the data class. However, you can override the
parameters defined for DATACLASS by explicitly specifying other attributes.
See Understanding the Order of Assigned Data Set Attributes for the order of precedence
(filtering) the system uses to select which attribute to assign.
DATACLASS
parameters apply to both SMS-managed and non-SMS-managed data sets.
If DATACLASS is specified and SMS is inactive, DEFINE is unsuccessful.
Abbreviation:
DATACLAS
- FILE(ddname)
- specifies
the name of the DD statement that identifies the device and volume
to be allocated to the page space. If the FILE parameter is not specified
and the volume is physically mounted, the volume identified with the
VOLUME parameter is dynamically allocated. The volume must be mounted
as permanently resident or reserved.
- MANAGEMENTCLASS(class)
- specifies,
for SMS-managed data sets only, the 1-to-8 character name of the management
class for a new data set. Your storage administrator defines the names
of the management classes you can specify. If MANAGEMENTCLASS is not
specified, but STORAGECLASS is specified or defaulted, MANAGEMENTCLASS
is derived from automatic class selection (ACS). If MANAGEMENTCLASS
is specified and STORAGECLASS is not specified or derived, the DEFINE
is unsuccessful. If SMS is inactive and MANAGEMENTCLASS is specified,
the DEFINE is unsuccessful.
Abbreviation: MGMTCLAS
- MODEL(entryname) [
catname])
- Specifies
that an existing page space entry is to be used as a model for the
entry being defined. It is possible to use an already defined page
space as a model for another page space. When one entry is used as
a model for another, its attributes are copied as the new entry is
defined.
You can use some attributes of the model and override
others by explicitly specifying them in the definition of the page
space. If you do not want to add or change any attributes, you need
specify only the entry type (page space) of the model to be used and
the name of the entry to be defined.
See Understanding the Order of Assigned Data Set Attributes for more information about the order
in which the system selects an attribute. - entryname
- Specifies the name of the page space entry to be used as a model.
- catname
- Specifies the name of the catalog in which the entry to be used
as a model is defined.
- OWNER(ownerid)
- specifies
the identification of the owner of the page space.
- RECATALOG|NORECATALOG
- Specifies whether the catalog entries for the cluster components
are to be re-created or are to be created for the first time.
- RECATALOG
- If
RECATALOG is specified, the catalog entries are re-created if valid
VVDS entries are found on the primary VVDS volume. If valid VVDS entries
are not found on the primary VVDS volume, the command ends. For information
on resolving VVDS problems, see the text on deleting VVDS records
in z/OS DFSMS Managing Catalogs .
Specification of RECATALOG requires that the NAME and VOLUMES
parameters be specified as they were when the cluster was originally
defined.
The CYLINDERS|RECORDS|TRACKS parameter is not required
if RECATALOG is specified.
If the ATTEMPTS,
AUTHORIZATION, CATALOG, MODEL or OWNER parameters were specified during
the original define, they must be respecified with RECATALOG to restore
their original values; otherwise, their default values are used.
Abbreviation:
RCTLG
- NORECATALOG
- If
NORECATALOG is specified, the catalog entries are created for the
first time.
Abbreviation: NRCTLG
- STORAGECLASS(class)
- For
SMS-managed data sets: Specifies the name, 1-to-8 characters, of the
storage class.
Your storage administrator defines the names of
the storage classes you can specify. A storage class is assigned if
you use STORAGECLASS or an ACS routine selects a storage class for
the new data set.
The storage class provides the storage attributes
that are specified on the UNIT and VOLUME operand for non-SMS-managed
data sets. Use the storage class to specify the storage service level
to be used by SMS for storage of the data set. If SMS is inactive
and STORAGECLASS is specified, the DEFINE is unsuccessful.
Abbreviation:
STORCLAS
- TO(date)|FOR(days)
- specifies
the retention period for the page space. If neither TO nor FOR is
specified, the page space can be deleted at any time.
The expiration
date in the catalog is updated and the expiration date in the format-1
DSCB is changed. Should the expiration date in the catalog not agree
with the expiration date in the VTOC, the VTOC entry overrides the
catalog entry.
The MANAGEMENTCLASS maximum retention period,
if specified, limits the retention period specified by this parameter.
- TO(date)
- Specifies
the earliest date that a command without the PURGE parameter can delete
the page space. Specify the expiration date in the form yyyyddd,
where yyyy is a four-digit year (to a maximum
of 2155) and ddd is the three-digit day
of the year from 001 through 365 (for non-leap years) or 366 (for
leap years).
The following four values are "never-expire" dates:
99365, 99366, 1999365, and 1999366. Specifying a "never-expire"
date means that the PURGE parameter will always be required to delete
the page space. For related information, see the "EXPDT Parameter"
section of z/OS MVS JCL Reference.
Note: - Any dates with two-digit years (other than 99365 or 99366) will
be treated as pre-2000 dates. (See note 2.)
- Specifying the current date or a prior date as the expiration
date will make the page space immediately eligible for deletion.
- FOR(days)
- Is
used to choose the number of days to keep the page space. The maximum
number is 93000. If the number is 0 through 92999, the page space
is retained for the number of days indicated; if the number is 93000,
the page space is retained indefinitely. There is a hardware imposed
expiration date of 2155.
|