Syntax and options of the RESTORE SYSTEM control statement

The RESTORE SYSTEM utility control statement, with its multiple options, defines the function that the utility job performs.

Use the ISPF/PDF edit function to create a control statement and to save it in a sequential or partitioned data set. When you create the JCL for running the job, use the SYSIN DD statement to specify the name of the data set that contains the utility control statement.

When you specify RESTORE SYSTEM, you can specify only the following statements in the same step:

  • DIAGNOSE
  • OPTIONS PREVIEW
  • OPTIONS OFF
  • OPTIONS KEY
  • OPTIONS EVENT WARNING

In addition, RESTORE SYSTEM must be the last statement in SYSIN.

Syntax diagram

>>-RESTORE SYSTEM----------------------------------------------->

>--+-------------------------------------------------------------------------------------------------+-><
   +-LOGONLY-----------------------------------------------------------------------------------------+   
   '-FROMDUMP--+----------------------+--+--------------------+--+---------------------------------+-'   
               '-DUMPCLASS--(--dcl--)-'  '-RSA--('key-label')-'  '-TAPEUNITS--+------------------+-'     
                                                                              '-(num-tape-units)-'       

Option descriptions

LOGONLY
Specifies that the database volumes have already been restored, so the RESTORE phase is skipped. Use this option when the database volumes have already been restored outside of DB2®. If the subsystem is at a tracker site, you must specify the LOGONLY option.
FROMDUMP
Indicates that you want to dump only the database copy pool to tape during the restore.
DUMPCLASS (dcl)
Indicates what DFSMShsm dump class to use for the restore.
RSA ('key-label')
Start of changeSpecifies that the key-label value in the utility control statement is passed to DFSMShsm to override the key-label value that would normally be used to read dump tapes. key-label can be up to 64 characters, and must start with an alphabetic or national character (for example: @, $, or #). key-label must be enclosed in single quotation marks.End of change
The FROMDUMP and DUMPCLASS options that you specify for the RESTORE SYSTEM utility override the RESTORE_ RECOVER_FROMDUMP and UTILS_DUMP_CLASS_NAME subsystem parameter values.
TAPEUNITS
Specifies the limit on the number of tape drives that the utility dynamically allocates during the restore of the database copy pool from dumps on tape.

The default is the option that you specified for subsystem parameter RESTORE_TAPEUNITS. If no default is specified, then the RESTORE SYSTEM utility tries to use all of the tape drives in your system.

Start of changeThe TAPEUNITS option does not apply and is ignored when the z/OS® level is Version 1 Release 12 or later.End of change

(num-tape-units)
Specifies the maximum number of tape drives to allocate. If you specify zero, or you do not specify a value, the utility determines the optimal number of tape units to use. RESTORE SYSTEM TAPEUNITS has a maximum value of 255.