RECALL

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

RECALL - Logic

Only one data set can be recalled 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.

RECALL - Syntax

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

RECALL - Required parameters

Parameter	Description
dsname	A specific data set name

RECALL - Optional Parameters

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	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.	-	-
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	-	-

RECALL - Output

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

Data set <dsname> was recalled

RECALL - Examples

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.