Tivoli Storage Manager for Windows Administrator's Reference

PREPARE (Create a Recovery Plan File)

Use this command to create a recovery plan file, which contains the information needed to recover a TSM server. 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 from the server console or, if the WAIT parameter equals YES, an administrative client session.

Privilege Class

To issue this command, you must have system privilege.

Syntax

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

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 plus 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 archive object that contains the recovery plan file on the target server is:

Filespace name: ADSM.SERVER

High-level qualifier: devclassprefix\servername.yyyymmdd.hhmmss

Low-level qualifier: RPF.OBJ.1

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 is written to a file based on 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 path name prefix that is used in the recovery plan file name. The maximum length is 200 characters. This parameter is optional.

TSM appends to the prefix the sortable date and time format yyyymmdd.hhmmss. For example: 19971115.051421.

The prefix can be one of the following:

If the PLANPREFIX parameter is not specified, TSM selects the prefix in one of these ways:

INSTRPrefix
Specifies the prefix of the path name used by TSM to locate the files that contain the recovery instructions. The maximum length is 200 characters.

The prefix can be one of the following:

If you do not specify the INSTRPREFIX parameter, TSM selects the prefix in one of these ways:

PRIMstgpool
Specifies the names of the primary storage pools that you want to restore. Separate the storage pool names with commas and no intervening spaces. You can use wildcard characters. If this parameter is not specified, TSM 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 restore (see the PRIMSTGPOOL parameter). Separate storage pool names with commas and no intervening spaces. You can use wildcard characters. If this parameter is not specified, TSM 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.

Commands:
prepare
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               |
|                      c:\drmtest\prepare\RECOVERY.INSTRUCTIONS.DATABASE         |
|                      not found.                                                |
|05/03/1998 12:01:13  ANR6918W PREPARE: Recovery instructions file               |
|                      c:\drmtest\prepare\RECOVERY.INSTRUCTIONS.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 8MM.           |
|                      Original volume name: BACK4X. Stanza is                   |
|                      PRIMARY.VOLUMES.REPLACEMENT macro.                        |
|05/03/1998 12:01:14  ANR6900I PREPARE: The recovery plan file                   |
|                      c:\drmtest\prepare\r.p.19980503.120113                    |
|                      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 151. Commands Related to PREPARE

Command Description
DELETE VOLHISTORY Removes sequential volume history information from the volume history file.
QUERY DRMSTATUS Displays DRM system parameters.
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 DRMPLANVPOSTFIX Specifies the replacement volume names in the recovery plan file.
SET DRMPLANPREFIX Specifies the prefix portion of the path name for the recovery plan.
SET DRMPRIMSTGPOOL Specifies that primary storage pools are managed by DRM.
SET DRMRPFEXPIREDAYS Set criteria for recovery plan file expiration.
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 ]