![]() |
![]() |
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
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.
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.
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.
Examples
Task
Issue the PREPARE command and query the activity log to check the results.
+--------------------------------------------------------------------------------+ |ANS8003I Process number 12 started. | +--------------------------------------------------------------------------------+
+--------------------------------------------------------------------------------+ |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. |