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')
- Specifies 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.
- 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.
The TAPEUNITS option does not apply and is ignored when the z/OS® level is Version 1 Release 12 or later.
- (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.