Optional parameters
The following are the optional parameters of the ARCHMIG macro:
- CLOUD
- specifies the address of a 30-byte area containing the name of an SMS network connection construct. The data is migrated to the cloud storage defined in the SMS network connection construct, and overrides any other specification in the management class of the data set, other than eligibility for migration. Non-SMS managed data sets are not eligible for migration to cloud storage. The name must be left-aligned and padded with blanks. The CLOUD keyword cannot be specified with MIGLVL.
- FORCML1
- specifies whether to override the management class parameter of ML1DAYS(0) and force this data set to migrate to ML1. If YES is specified, the data set is migrated to ML1 without compaction. If NO is specified, the management class criteria are used to determine whether the data set is to migrate to ML1 or ML2. The default is NO.
- MIGLVL
- specifies the migration level, ML1 or ML2, to which you want to migrate the data set. The default is ML1. This parameter applies to both SMS-managed and non-SMS-managed data sets.
- MOVE
- specifies that the data set is to go through moving processing. MOVE is mutually exclusive with the migration-related parameters (FORCML1, MIGLVL, and TRANSITION) and processed only for the SMS-managed data sets. The default value is NO.
- SMSAREA
- specifies
the address of data area containing the optional SMS parameters for
class transition processing. If at least one SMS parameter is specified,
then the specified value or values are used and the ACS routines are not called
during class transition processing. The omitted values of management
class, storage class, or storage group are taken from the data set's SMS network connection construct. The format of SMS area:
MCLENGTH DS H MGMT Class name length MCNAME DS CL30 MGMT Class name SCLENGTH DS H STRG Class name length SCNAME DS CL30 STRG Class name STGLCNT DS AL1 Number of storage group list DS CL3 Reserved SGDEF DS 0H Storage group definition SGLENGTH DS H Length of storage group name SGNAME DS CL30 Name of storage groupNotes:- If the management class or storage class is not specified, the name length must be zero.
- If the storage group list is not specified, the number of storage group lists must be zero.
- SNAPDCB
- specifies the address of an open DCB that can be used for SNAP macro processing. This feature is intended for problem determination. If you specify this parameter, review Usage notes. For dcbaddr, specify the address of an open DCB.
- TEST
- specifies whether to refrain from sending a request for service to DFSMShsm. If YES is specified, the service request is not sent. If NO is specified, a service request is sent to DFSMShsm. In both cases, the parameters that are specified on the macro are checked for correctness. A 4xx return code results for invalid parameters. The default is NO.
- TRANSITION
- specifies whether the data set is to go through transition processing. TRANSITION is mutually exclusive with the migration-related parameters (FORCML1=YES and MIGLVL=ML2) and is valid only for SMS-managed data sets. The default value is NO.
- WAIT
- specifies whether you want the application to wait until DFSMShsm has processed this request. If YES is specified, the application waits until DFSMShsm completes processing of the request. The default is NO. This parameter applies to both SMS-managed and non-SMS-managed data sets.