RECALL examples

You can use the CLI to recall data sets by using the RECALL command. RECALL is allowed for cataloged data sets only. Therefore, the command accepts only a specific data set name as input. For example, an SMS-managed data set is recalled with its original SMS attributes as input to the ACS routines. For a non-SMS managed data set, the recall is performed on the original volume that accommodated the data set.

Related topic

CLI-Getting-started

Scenario A: Recalling a data set when there is not enough space on its original volume

A data set needs to be recalled, but the disk that originally accommodated the data set does not have enough free space. A manual recall operation is needed to recall the data set with a new volume parameter. The RECALL command will be as follows:

TSO M9CLI RECALL M9.APPL.SOURCE NEWV(M9AP01)

Scenario B: Ensuring valid execution of a job with archived data sets as input

A batch job requires several archived non-SMS data sets as input. Normally, automatic recall will be used during execution to recall the data sets to their original volumes transparently. But, since the data sets were archived a long time ago, their original volumes no longer exist. To prevent failures during the batch job execution, the system programmer uses the RECALL command in a preliminary job to recall the data sets to new volumes.

//M9CLISMF JOB ACCT#,TIME=NOLIMIT,REGION=0M
//*
//* RECALLING FILES PRIOR TO EXECUTION
//*
//M9CLI EXEC PGM=IKJEFT01
//STEPLIB DD DISP=SHR,DSN=SYS2.MODEL9.LOADLIB
//SYSEXEC DD DISP=SHR,DSN=M9.ALL.EXEC
//SYSTSPRT DD SYSOUT=*
//SYSPRINT DD SYSOUT=*
//SYSTSIN DD *
M9CLI RECALL M9.APPL.Y2015 NEWV(M9APL4)
M9CLI RECALL M9.APPL.Y2016 NEWV(M9APL3)
M9CLI RECALL M9.APPL.Y2017 NEWV(M9APL2)
M9CLI RECALL M9.APPL.Y2018 NEWV(M9APL1)
M9CLI RECALL M9.APPL.Y2019 NEWV(M9APL0)
/*
//

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*