Optional Parameters

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.