Cloud Data Manager

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:

  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.

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

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

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

-

-

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.