![]() |
![]() |
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-+-' .-Wait--=--No------. >--+-------------------------------+--+------------------+----->< | .-,---------. | '-Wait--=--+-No--+-' | V | | '-Yes-' '-PRIMstgpool--=----pool_name-+-'
Parameters
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=/adsmsrv/recplans/
The resulting file name would look like this:
/adsmsrv/recplans/19971115.051421
PLANPREFIX=/adsmsrv/recplans/accounting
The resulting file name would look like this:
/adsmsrv/recplans/accounting.19971115.051421
Note the period before the date and time.
TSM uses the directory pointed to by this environment variable. For example, the DSMSERV_DIR environment variable points to /adsmsrv/recplans and you specify the following parameter:
PLANPREFIX=shipping
The resulting file name would look like this:
/adsmsrv/recplans/shipping.19971115.051421
Note the period before the date and time.
TSM uses the name of the current working directory. For example, the current working directory is /usr/lpp/adsmserv/bin and you specify the following parameter:
PLANPREFIX=shipping
The resulting file name would look like this:
/usr/lpp/adsmserv/bin/shipping.19971115.051421
Note the period before the date and time.
If the PLANPREFIX parameter is not specified, TSM selects the prefix in one of these ways:
TSM uses the prefix specified in that command.
TSM uses the directory pointed to by the environment variable. For example, the DSMSERV_DIR environment variable points to the following:
/adsmsrv/recplans
The resulting file name would look like this:
/adsmsrv/recplans/19971115.051421
TSM uses the directory path name of the current working directory. For example, the current working directory is the following:
/usr/lpp/adsmserv/bin
The resulting file name would look like this:
/usr/lpp/adsmserv/bin/19971115.051421
The prefix can be one of the following:
INSTRPREFIX=/adsmsrv/recinstr/
/adsmsrv/recinstr/RECOVERY.INSTRUCTIONS.GENERAL
INSTRPREFIX=/adsmsrv/recinstr/accounts
TSM appends the appropriate recovery plan file stanza name. For the RECOVERY.INSTRUCTIONS.GENERAL file, the resulting file name would be:
/adsmsrv/recinstr/accounts.RECOVERY.INSTRUCTIONS.GENERAL
TSM uses the directory pointed to by this environment variable. For example, the DSMSERV_DIR environment variable points to /adsmsrv/recinstr and you specify the following parameter:
INSTRPREFIX=shipping
For the RECOVERY.INSTRUCTIONS.GENERAL file, the resulting file name would be:
/adsmsrv/recinstr/shipping.RECOVERY.INSTRUCTIONS.GENERAL
TSM uses the name of the current working directory. For example, the current working directory is /usr/lpp/adsmserv/bin and you specify the following parameter:
INSTRPREFIX=shipping
For the RECOVERY.INSTRUCTIONS.GENERAL file, the resulting file name would look like this:
/usr/lpp/adsmserv/bin/shipping.RECOVERY.INSTRUCTIONS.GENERAL
If you do not specify the INSTRPREFIX parameter, TSM selects the prefix in one of these ways:
For example, the DSMSERV_DIR environment variable points to the following: /adsmsrv/recinstr. For the RECOVERY.INSTRUCTIONS.GENERAL file, the resulting file name would be:
/adsmsrv/recinstr/RECOVERY.INSTRUCTIONS.GENERAL
For example, if the current working directory is /usr/lpp/adsmserv/bin , for the RECOVERY.INSTRUCTIONS.GENERAL file, the resulting file name would be:
/usr/lpp/adsmserv/bin/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 | | /home/guest/drmtest/prepare/tservr/DSM1509/ | | RECOVERY.INSTRUCTIONS.DATABASE not found. | |05/03/1998 12:01:13 ANR6918W PREPARE: Recovery instructions file | | /home/guest/drmtest/prepare/tservr/DSM1509/ | | 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 type | | 8MM. Original volume name: BACK4X. Stanza is | | PRIMARY.VOLUMES.REPLACEMENT macro. | |05/03/1998 12:01:14 ANR6900I PREPARE: The recovery plan file | | /home/guest/drmtest/prepare/plandir/DSM1509/ | | 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 161. 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. |