Use this command to create a recovery plan file, which contains the information needed to recover an 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
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. |
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.
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:
PLANPREFIX=c:\adsmsrv\recplans\
The resulting file name would look like this:
c:\adsmsrv\recplans\19971115.051421
Note: | If you issue the PREPARE command from the TSM administrative command line
client and the last character in the command line is a backslash, it is
interpreted as a continuation character. To avoid this, place the
prefix value in quotes. For example:
PLANPREFIX="c:\adsmsrv\recplans\" |
PLANPREFIX=c:\adsmsrv\recplans\accounting
The resulting file name would look like this:
c:\adsmsrv\recplans\accounting.19971115.051421
Note the period before the date and time.
PLANPREFIX=shipping
The resulting recovery plan filename is:
c:\win32app\ibm\adsm\server2\shipping.19971115.051421
If the PLANPREFIX parameter is not specified, TSM selects the prefix in one of these ways:
TSM uses the prefix specified in that command.
c:\win32app\ibm\adsm\server2
The resulting recovery plan file name is the following:
c:\win32app\ibm\adsm\server2\1997115.051421
The prefix can be one of the following:
INSTRPREFIX=c:\adsmsrv\recinstr\
TSM appends the appropriate recovery plan file stanza name. For the RECOVERY.INSTRUCTIONS.GENERAL file, the resulting file name would be:
c:\adsmsrv\recinstr\RECOVERY.INSTRUCTIONS.GENERAL
Note: | If you issue the PREPARE command from the TSM administrative command line
client and the last character in the command line is a backslash, it is
interpreted as a continuation character. To avoid this, place the
prefix value in quotes. For example:
INSTRPREFIX="c:\adsmserv\recinstr\" |
INSTRPREFIX=c:\adsmsrv\recinstr\accounts
TSM appends the appropriate recovery plan file stanza name. For the RECOVERY.INSTRUCTIONS.GENERAL file, the resulting file name would be:
c:\adsmsrv\recinstr\accounts.RECOVERY.INSTRUCTIONS.GENERAL
INSTRPREFIX=dock
The resulting recovery plan filename is:
c:\win32app\ibm\adsm\server2\shipping.19971115.051421
If you do not specify the INSTRPREFIX parameter, TSM selects the prefix in one of these ways:
c:\win32app\ibm\adsm\server2
The resulting recovery plan file name is the following:
c:\win32app\ibm\adsm\server2\RECOVERY.INSTRUCTIONS.GENERAL
Examples
Task
Issue the PREPARE command and query the activity log to check the results.
prepare query actlog search=prepare
+--------------------------------------------------------------------------------+ |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 148. 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. |