Tivoli Storage Manager for Windows: Administrator's Reference

QUERY RPFILE (Query Recovery Plan File Information Stored on a Target Server)

Use this command to display information about recovery plan files stored on a target server. You can issue this command from either the server that created the file (the source server) or the server that stores the recovery plan file (the target server).

Privilege Class

Any administrator can issue this command.

Syntax

>>-Query RPFile--+-DEVclass--=--device_class_name-+------------->
                 '-NODEName--=--node_name---------'
 
   .-Source--=--DBBackup-------.  .-Format--=--Standard-----.
>--+---------------------------+--+-------------------------+--><
   '-Source--=--+-DBBackup---+-'  '-Format--=--+-Standard-+-'
                '-DBSnapshot-'                 '-Detailed-'
 
 

Parameters

DEVclass
Specifies the name of the device class that was used to create the recovery plan files. Use this parameter when logged on to the server that created the recovery plan file. You can use wildcard characters in the device class name. All recovery plan files that are created with the device class specified are included in the query.

NODEName
Specifies the node name, registered on the target server, of the source server that created the recovery plan files. Use this parameter when logged on to the target server. You can use this parameter when the source server is not available. You can use wildcard characters to specify the node name. All file objects that are stored with the node name specified are included in this query.

Source
Specifies the type of database backup that was specified when the recovery plan file was prepared. This parameter is optional. The default is DBBACKUP. Possible values are:

DBBackup
The recovery plan file was prepared with full and incremental database backups specified.

DBSnapshot
The recovery plan file was prepared with snapshot database backups specified.

Format
Specifies how the information is displayed. This parameter is optional. The default is STANDARD. Possible values are:

Standard
TSM displays partial information for the recovery plan file.

Detailed
TSM displays all information for the recovery plan file.

Examples

Task 1

Display a list of recovery plan files that were created for this server using the specified device class.

Command:
query rpfile devclass=* format=detailed

Output:
 
+--------------------------------------------------------------------------------+
|    Recovery Plan File Name: ALASKA.20000406.170423                             |
|                  Node Name: BRANCH1                                            |
|          Device Class Name: REMOTE                                             |
|    Recovery Plan File Type: RPFILE                                             |
|            Mgmt Class Name: STANDARD                                           |
|    Recovery Plan File Size: 16,255 Bytes                                       |
|        Marked for Deletion: Yes                                                |
|              Deletion Date: 06/12/2000 13:05:31                                |
|                                                                                |
|    Recovery Plan File Name: ALASKA.20000407.170845                             |
|                  Node Name: BRANCH1                                            |
|          Device Class Name: REMOTE                                             |
|    Recovery Plan File Type: RPFSNAPSHOT                                        |
|            Mgmt Class Name: STANDARD                                           |
|    Recovery Plan File Size: 16,425 Bytes                                       |
|        Marked for Deletion: No                                                 |
|              Deletion Date:                                                    |
+--------------------------------------------------------------------------------+

Task 2

Display a list of all recovery plan file objects that are stored with the specified node name (TYPE=SERVER).

Command:
query rpfile nodename=branch1

Output:
 
+--------------------------------------------------------------------------------+
|    Recovery Plan File Name       Node Name       Device Class Name             |
|    -----------------------       ---------       -----------------             |
|     ALASKA.19980406.170423         BRANCH1         REMOTE                      |
|     ALASKA.19980407.170845         BRANCH1         REMOTE                      |
+--------------------------------------------------------------------------------+

where:

Recovery Plan File Name
The recovery plan file name.

Node Name
The node name that is registered with the target server and used to store the recovery plan file objects

Device Class Name
The device class name that is defined in the source server and used to create the recovery plan files

Recovery Plan File Type
The type of recovery plan file:

RPFILE
The plan assumes full plus incremental database backups.

RPFSNAPSHOT
The plan assumes snapshot database backups.

Mgmt Class Name
The management class name that the recovery plan file is associated with in the target server.

Recovery Plan File Size
Estimated size of the recovery plan file object on the target server.

Marked For Deletion
Whether the object that contains the recovery plan file has been deleted from the source server and marked for deletion on the target server if the grace period has not expired. Possible values are:

Yes
The object is marked for deletion.

No
The object is not marked for deletion.

Deletion Date
Date that the object has been deleted from the source server and marked for deletion on the target server. This field is blank if the object has not been marked for deletion.

Related Commands

Table 207. Commands Related to QUERY RPFILE

Command Description
PREPARE Creates a recovery plan file.
QUERY VOLHISTORY Displays sequential volume history information that has been collected by the server.
QUERY RPFCONTENT Displays the contents of a recovery plan file.


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