Syntax and options of the BACKUP SYSTEM control statement

The BACKUP 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 BACKUP SYSTEM, you can specify only the following statements in the same step:

DIAGNOSE
OPTIONS PREVIEW
OPTIONS OFF
OPTIONS KEY
OPTIONS EVENT WARNING

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

Syntax diagram

                  .-FULL -----.                                
>>-BACKUP SYSTEM--+-----------+--+-------------------------+---->
                  '-DATA ONLY-'  +-ESTABLISH FCINCREMENTAL-+   
                                 '-END FCINCREMENTAL-------'   

>--+---------------------------------------------------------------+-><
   +-FORCE---------------------------------------------------------+   
   +-DUMP--+--------------------+--+-------+-----------------------+   
   |       '-| dumpclass-spec |-'  '-FORCE-'                       |   
   '-DUMPONLY--+-------------------------+--+--------------------+-'   
               '-TOKEN--(X'byte-string')-'  '-| dumpclass-spec |-'

dumpclass-spec:


                 .-,-------.      
                 V         |      
>>-DUMPCLASS--(----+-dc1-+-+--)--------------------------------><
                   +-dc2-+        
                   +-dc3-+        
                   +-dc4-+        
                   '-dc5-'

Option descriptions

FULL

Indicates that you want to copy both the database copy pool and the log copy pool.

You must ensure that the database copy pool is set up to contain the volumes for the databases and the associated integrated catalog facility (ICF) catalogs. You must also ensure that the log copy pool is set up to contain the volumes for the BSDSs, the active logs, and the associated catalogs.

Use BACKUP SYSTEM FULL to allow for recovery of both data and logs. You can use the RESTORE SYSTEM utility to recover the data. However, RESTORE SYSTEM does not restore the logs; the utility only applies the logs. If you want to restore the logs, you must use another method to restore them.

DATA ONLY

Indicates that you want to copy only the database copy pool. You must ensure that the database copy pool is set up to contain the volumes for the databases and the associated ICF catalogs.

ESTABLISH FCINCREMENTAL

Specifies that a persistent incremental FlashCopy® relationship is to be established, if none exists, for source copy volumes in the database copy pool. Use this keyword once to establish the persistent incremental FlashCopy relationships. Subsequent invocations of BACKUP SYSTEM (without this keyword) automatically process the persistent incremental FlashCopy relationship.

END FCINCREMENTAL

Specifies that a last incremental FlashCopy is to be taken and that the persistent incremental FlashCopy relationship is to be withdrawn for all of the volumes in the database copy pool. Use this keyword only if you do not want further incremental FlashCopy backups of the database copy pool.

FORCE

Indicates that you want to overwrite the oldest DFSMShsm version of the fast replication copy of the database copy pool. You can overwrite these copy pools even if the dump to tape or the copy pool's DFSMShsm dump classes were initiated, but are only partially completed.

Use the FORCE option only if it is more important to take a new system-level backup than to save a previous system-level backup to tape.

DUMP

Indicates that you want to create a fast replication copy of the database copy pool and the log copy pool on disk and then initiate a dump to tape of the fast replication copy. The dump to tape begins after DB2® successfully establishes relationships for the fast replication copy.

The BACKUP SYSTEM utility does not wait for the dump processing to complete.

This option requires z/OS® Version 1.8.

DUMPCLASS

Indicates the DFSMShsm dump class that you want to use for the dump processing. You can specify up to five dump classes. If you do not specify a dump class, DB2 uses the default dump classes that are defined for the copy pools.

DUMPONLY

Indicates that you want to create a dump on tape of an existing fast replication copy (that resides on the disk) of the database copy pool and the log copy pool. You can also use this option to resume a dump process that failed.

The BACKUP SYSTEM utility does not wait for the dump processing to complete.

This option requires z/OS Version 1.8.

TOKEN (X'byte-string')

Specifies which fast replication copy of the database copy pool and the log copy pool to dump to tape.

The token is a 36-digit hexadecimal byte string that uniquely identifies each system-level backup and is reported in the DSNJU0004 job output. For a data sharing system, run DSNJU0004 with the MEMBER option so that the system-level backup information is displayed for all members.

If you do not specify TOKEN, the most recent fast replication copy of the copy pools is dumped to tape.