RECALL
The RECALL command recalls an archived data set. The data set is re-allocated to the disk.
Only one data set can be recalled per request. By default, the target volume is determined according to:
- 1.For non-SMS data sets, the command searches for the original disk of the data set.
- 2.For SMS-managed data sets, the volume is determined using the ACS routines and the current SMS definitions that are assigned to the data set.
The recalled data set will always be recataloged, except in one situation: when recalling a non SMS-managed rolled-off GDS, it will be recalled but not cataloged. An SMS-managed rolled off GDS will be cataloged and marked as rolled off. In some cases, the command is unable to re-allocate the data set, for example, when the original disk no longer exists, or if the storage group does not have enough space. In these cases, it is useful to use the NEWVOL parameter.
M9CLI RECALL <dsname>
[NEWVol(<volume>)]
[NEWMClass(<managementClass>)|NULLMC]
[NEWSClass(<storageClass>)|NULLSC]
[BYPASSACS]
Parameter | Description |
dsname | A specific data set name. |
Option [Short option] | Description | Format | Examples |
NEWVOL [NEWV] | Recalls the data set to the specified volume. For SMS-managed data sets, the decision whether to fulfill the request is made by the ACS routines. For non-SMS managed data sets, the decision whether to fulfill the request is made by the operating system. | <volume>
6 characters | PROD01 |
NEWMCLASS [NEWMC] | Recalls the data set with the specified management class as input to the ACS routines, instead of the management class originally associated with the data set when it was archived. NEWMCLASS and NULLMC are mutually exclusive. | <management-class>
8 characters | M9APPLMC |
NULLMC | Recalls the data set with a null management class as input to the ACS routines, instead of the management class originally associated with the data set when it was archived. NEWMCLASS and NULLMC are mutually exclusive. | - | - |
NEWSCLASS [NEWSC] | Recalls the data set with the specified storage class as input to the ACS routines, instead of the storage class originally associated with the data set when it was archived. NEWSCLASS and NULLSC are mutually exclusive. | <storage-class>
8 characters | M9APPLSC |
NULLSC | Recall the data set with a null storage class as input to the ACS routines, instead of the storage class originally associated with the data set when it was archived. NEWSCLASS and NULLSC are mutually exclusive. | - | - |
BYPASSACS | Recalls the data set while bypassing the ACS routines option. The user will be verified for having READ access to the Model9 Resource M9.CLI.RESTDSN.BYPASSACS | - | - |
The output displays the given RECALL command and parameters, followed by the requested information:
Data set <dsname> was recalled
The following examples demonstrate use of the command.
Recalling a data set to a different volume
TSO M9CLI RECALL M9.USER.LOAD NEWV(M9TST1)
Recalling to a new volume can be useful when the original volume is no longer available in the system, or, for example, does not have enough space to accommodate the recalled data set.
Recalling an SMS-managed data set with specific management class and storage class as input to the ACS routines
TSO M9CLI RECALL M9.USER.LOAD NEWMC(M9APPLMC)NEWSC(M9APPLSC)
Recall can be used to change the original SMS parameters of the data set. The decision whether to fulfill the request is made by ACS routines.
Last modified 4mo ago