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: Tivoli® Storage Manager displays partial information for the recovery plan file.
Detailed: Tivoli Storage Manager displays all information for the recovery plan file.

Example: Display detailed information about the recovery plans

Display recovery plan files that were created for this server using the specified device class. See Field descriptions for field descriptions.

query rpfile devclass=* format=detailed

    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:

Example: Display a list of recovery plans for a specific node name

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

query rpfile nodename=branch1

    Recovery Plan File Name       Node Name       Device Class Name
    -----------------------       ---------       -----------------
     ALASKA.19980406.170423         BRANCH1         REMOTE
     ALASKA.19980407.170845         BRANCH1         REMOTE

Field descriptions

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 1. 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.