RECALL

The RECALL command recalls an archived data set. The data set is re-allocated to the disk.

Logic

You can recall only one data set per request. By default, the target volume is determined according to the following criteria:

For non-SMS data sets, the command searches for the original disk of the data set.
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 is always re-cataloged, except in one situation; When recalling a non SMS-managed rolled-off GDS, it is recalled but not cataloged. An SMS-managed rolled off GDS is 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, you can use the NEWVOL parameter.

Syntax

M9CLI RECALL <dataSetName>
[NEWVol(<volume>)]
[NEWMClass(<managementClass>)|NULLMC]
[NEWSClass(<storageClass>)|NULLSC]
[BYPASSACS]

Required parameters

Parameter	Description
dataSetName	A specific data set name

Optional parameters

Option (Short option)	Description	Format	Examples
NEWVol	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	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.	managementClass (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.	NA	NA
NEWSClass	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.	storageClass (8 characters)	M9APPLSC
NULLSC	Recalls 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.	NA	NA
BYPASSACS	Recalls the data set while bypassing the ACS routines option The user will be verified for having READ access to the BMC AMI Cloud resource M9.CLI.RESTDSN.BYPASSACS	NA	NA

Output

The output displays the given RECALL command and parameters, followed by the requested information:

Data set <dataSetName> was recalled

Examples

The following examples demonstrate use of the command.

Recalling a data set to a different volume

Example

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.

TSO M9CLI RECALL M9.USER.LOAD NEWV(M9TST1)

Recalling an SMS-managed data set with specific management class and storage class as input to the ACS routines