Tivoli Storage Manager for Windows Administrator's Reference

QUERY RESTORE (Query Restartable Restore Sessions)

Use this command to display information about the restartable restore sessions.

Privilege Class

Any administrator can issue this command.

Syntax

>>-Query--RESTore--+-----------+--+-----------------+----------->
                   '-node_name-'  '-file_space_name-'
 
      .-Format--=--Standard-----.
>-----+-------------------------+------------------------------><
      '-Format--=--+-Standard-+-'
                   '-Detailed-'
 

Parameters

node_name
Specifies the client node to be queried. This parameter is optional. If you do not specify a value, all client nodes with restartable restore sessions are displayed. You must specify a value for this parameter if you specify a file space name.

file_space_name
Specifies the file space to be queried. This parameter is optional. If you do not specify a value, all file spaces are matched for the specified node.

Examples

Task

Display detailed information about client node JAMES associated with file space DRIVE_F_R.

Command:
query restore james drive_f_r format=detailed
+--------------------------------------------------------------------------------+
|    Sess Number: -1                                                             |
|  Restore State: Restartable                                                    |
|Elapsed Minutes: 2                                                              |
|      Node Name: JAMES                                                          |
| Filespace Name: DRIVE_F_R:                                                     |
|      File Spec: /RESTORE/TESTDIRF\\                                            |
|                                                                                |
+--------------------------------------------------------------------------------+

where:

Sess Number
Specifies the session number for the restartable restore session. The number for active restore sessions is the same number displayed on the QUERY SESSION command. For restore sessions in the restartable state, a negative number is displayed for the session number. Any session number displayed in the QUERY RESTORE output may be specified from the QUERY RESTORE output.

Restore State
  1. Active: Specifies the restore session is actively restoring files to the client.
  2. Restartable: Specifies the restore session failed or was cancelled and can be restarted from where it left off.

Elapsed Minutes
Specifies the number of minutes since the restore session started. Any restartable restore session with an elapsed time greater than the RESTOREINTERVAL server option can be automatically deleted from the database when needed or during expiration processing. If the elapsed time is less than the RESTOREINTERVAL, you can delete this entry (and unlock the filespace) only by issuing the CANCEL RESTORE command lowering the RESTOREINTERVAL value.

Node Name
Specifies the node associated with the restartable restore session.

Filespace Name
Specifies the file space associated with the restartable restore session.

File Spec
Specifies the file specification used on the restore operation. The same file specification must be specified if a failed restore operation is to be restarted from where it stopped.

Related Commands

Table 192. Commands Related to QUERY RESTORE

Command Description
CANCEL RESTORE Cancels a restartable restore session.


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