Tivoli Header

Administrator's Reference

PREPARE (Create a Recovery Plan File)

Use this command to generate a recovery plan file. You can store a recovery plan file on a file system that is accessible to the source TSM server or on a target TSM server.

You can use the QUERY ACTLOG command to view whether the PREPARE command was successful. You can also view this information on either the MVS system console or the server's Job Log.

Privilege Class

To issue this command, you must have system privilege.

Syntax

            .-Source--=--DBBackup-------.
>>-PREPARE--+---------------------------+----------------------->
            '-Source--=--+-DBBackup---+-'
                         '-DBSnapshot-'
 
>--+---------------------------+--+-----------------------+----->
   '-DEVclass--=--devclassname-'  '-PLANPrefix--=--prefix-'
 
>--+------------------------+----------------------------------->
   '-INSTRPrefix--=--prefix-'
 
>--+------------------------------+----------------------------->
   |                 .-,--------. |
   |                 V          | |
   '-COPYstgpool--=----poolname-+-'
 
                                     .-Wait--=--No------.
>--+------------------------------+--+------------------+------><
   |                 .-,--------. |  '-Wait--=--+-No--+-'
   |                 V          | |             '-Yes-'
   '-PRIMstgpool--=----poolname-+-'
 
 

Parameters

Source
Specifies the type of database backup series that TSM assumes when generating the recovery plan file. This parameter is optional. The default is DBBACKUP. The choices are:

DBBackup
Specifies that TSM assumes the latest full with incremental database backup series.

DBSnapshot
Specifies that TSM assumes the latest database snapshot backup series.

DEVclass
Specifies the device class name that is used to create a recovery plan file object on a target server. The device class must have a device type of SERVER.
Note:
The maximum capacity for the device class must be larger than the size of the recovery plan file. If the size of the recovery plan file exceeds the maximum capacity, the command fails.
The naming convention for the recovery plan file object is:

The recovery plan file virtual volume name as recorded in the volume history table on the source server is in the format servername.yyyymmdd.hhmmss

If the DEVCLASS parameter is not specified, the recovery plan file will be written to a file according to the plan prefix.

If SOURCE=DBBACKUP is specified or is defaulted to, the volume history entry for the recovery plan file object specifies a volume type of RPFILE. If SOURCE=DBSNAPSHOT is specified, the volume history entry specifies a volume type of RPFSNAPSHOT.

PLANPrefix
Specifies the high-level qualifier used to generate a recovery plan filename. This parameter is optional. The maximum length is 27 characters.

Tivoli Storage Manager appends to the prefix the sortable Julian date and time format Jyyyyddd.Thhmmss (for example, J1997115.T051421). PREPARE allocates the file generated as a physical sequential file. For example, you specify the following parameter:

    PLANPREFIX=TSMSRV.RECPLANS

The resulting file name would look like this:

   TSMSRV.RECPLANS.J1997115.T051421

If you do not include the PLANPREFIX parameter, Tivoli Storage Manager uses the high-level qualifier set by the SET DRMPLANPREFIX command.

INSTRPrefix
Specifies the high-level qualifier that Tivoli Storage Manager uses to locate the files that contain the recovery instructions. This parameter is optional. The maximum length is 27 characters. These files must be physical sequential files.

For example, issue a PREPARE command with the following parameter:

    INSTRPREFIX=TSMSRV.RECINSTR

Tivoli Storage Manager appends the appropriate recovery plan file stanza name. For the INSTR.GENERAL file (general recovery instructions) the resulting file name would be:

    TSMSRV.RECINSTR.INSTR.GENERAL     

If the INSTRPREFIX parameter is not specified, the prefix Tivoli Storage Manager uses the prefix defined by the SET DRMINSTRPREFIX command.

PRIMstgpool
Specifies the names of the primary storage pools that you want to be able to restore. Separate the storage pool names with commas and no intervening spaces. You can use wild-card characters. If this parameter is not specified, Tivoli Storage Manager selects the storage pools as follows:

COPYstgpool
Specifies the names of the copy storage pools used to back up the primary storage pools that you want to be able to restore (see the PRIMSTGPOOL parameter). Separate storage pool names with commas and no intervening spaces. You can use wild-card characters. If this parameter is not specified, Tivoli Storage Manager selects the storage pools as follows:

Wait
Specifies whether this command is processed in the background or foreground.

No
Specifies background processing. This is the default.

Yes
Specifies foreground processing.

Examples

Task

Issue the PREPARE command and query the activity log to check the results.

Command:
prepare

Output:
+--------------------------------------------------------------------------------+
|ANS8003I Process number 12 started.                                             |
+--------------------------------------------------------------------------------+

Command:
query actlog search=PREPARE

Output:
+--------------------------------------------------------------------------------+
|05/03/1998 12:01:13  ANR0984I Process 3 for PREPARE started in the              |
|                      BACKGROUND at 12:01:13.                                   |
|05/03/1998 12:01:13  ANR6918W PREPARE: Recovery instructions file               |
|                      TSM.INSTR.DATABASE not found.                             |
|05/03/1998 12:01:13  ANR6918W PREPARE: Recovery instructions file               |
|                      TSM.INSTR.STGPOOL not found.                              |
|05/03/1998 12:01:13  ANR6913W PREPARE: No volumes with backup data              |
|                      exist in copy storage pool CSTORAGEP.                     |
|05/03/1998 12:01:13  ANR6913W PREPARE: No volumes with backup data              |
|                      exist in copy storage pool CSTORAGEPSM.                   |
|05/03/1998 12:01:14  ANR6920W PREPARE: Generated replacement volume             |
|                      name BACK4X@ is not valid for device                      |
|                      class DEV3490.                                            |
|                      Original volume name: BACK4X. Stanza is                   |
|                      PRIMVOL.REPLACE macro.                                    |
|05/03/1998 12:01:14  ANR6900I PREPARE: The recovery plan file                   |
|                      TSM.J1998123.T120113 was created.                         |
|05/03/1998 12:01:14  ANR0985I Process 3 for PREPARE running in the              |
|                      BACKGROUND completed with completion state                |
|                      SUCCESS at 12:01:14.                                      |
|                                                                                |
+--------------------------------------------------------------------------------+

Related Commands

Table 134. Commands Related to PREPARE

Command Description
BACKUP DB Backs up the Tivoli Storage Manager database to sequential access volumes.
BACKUP STGPOOL Backs up a primary storage pool to a copy storage pool.
CANCEL PROCESS Cancels a background server process.
DELETE VOLHISTORY Removes sequential volume history information from the volume history file.
MOVE DRMEDIA Moves DRM media onsite and offsite.
QUERY ACTLOG Displays messages from the server activity log.
QUERY DEVCLASS Displays information about device classes.
QUERY DRMSTATUS Displays DRM system parameters.
QUERY PROCESS Displays information about background processes.
QUERY RPFCONTENT Displays the contents of a recovery plan file.
QUERY RPFILE Displays information about recovery plan files.
QUERY SERVER Displays information about servers.
QUERY VOLHISTORY Displays sequential volume history information that has been collected by the server.
SET DRMCOPYSTGPOOL Specifies that copy storage pools are managed by DRM.
SET DRMINSTRPREFIX Specifies the prefix portion of the path name for the recovery plan instructions.
SET DRMPLANPREFIX Specifies the prefix portion of the path name for the recovery plan.
SET DRMPLANVPOSTFIX Specifies the replacement volume names in the recovery plan file.
SET DRMPRIMSTGPOOL Specifies that primary storage pools are managed by DRM.
QUERY RPFCONTENT Displays the contents of a recovery plan file.
UPDATE VOLHISTORY Adds or changes location information for a volume in the volume history file.


[ Top of Page | Previous Page | Next Page | Table of Contents | Index ]