11.4.7 tboreqstat (Tape execution history display command)

NAME

tboreqstat - Display of the history of execution statuses of processing by the tape manager

SYNOPSIS

/opt/FJSVswstm/bin/tboreqstat -h Server [-l] [-v] [Device-Name]

DESCRIPTION

The command displays the execution status of the processing by the tape manager currently in progress.

The command displays the execution status of the following:

Direct tape backup from the transaction volume
Copying data from the backup volume to the tape
Restoration data from the tape
Deletion of the backup history information on the tape

This command displays information on the executed processing from the latest.

OPTIONS

-h Server: Specifies the Storage Server name.

-l: In addition to the tape execution history information, displays the command option specified when the command was executed.

-v: Displays the details of the tape execution history information.

OPERANDS

Device-Name

When the Storage Server is Solaris, Linux, HP-UX or AIX, this specifies the block device name of a transaction volume.

When the Storage Server is Windows, it specifies an AdvancedCopy Manager device name corresponding to a transaction volume. For details on the AdvancedCopy Manager device name, refer to "Managing a Device on AdvancedCopy Manager" in the "ETERNUS SF AdvancedCopy Manager Operator's Guide [For Windows]".

If this option is omitted, the tape execution history of all transaction volumes are displayed.

EXIT STATUS

=0: Completed successfully

>0: Terminated abnormally

EXAMPLES

Display the tape execution history information of all transaction volumes.

# /opt/FJSVswstm/bin/tboreqstat -h server01
Server    Transaction-Volume  Request  Execute-Date      Status
server01  /dev/dsk/c1t1d22s1  Delete   2007/02/22 09:15  Deleting
server01  /dev/dsk/c1t1d20s1  Backup   2007/02/22 09:00  Preprocessing
server01  /dev/dsk/c1t1d23s1  Restore  2007/02/22 08:00  Reading( 90%)
#

Display the tape execution history information of the transaction volume (/dev/dsk/c1t1d0s6) and the command options by specifying the -l option.

# /opt/FJSVswstm/bin/tboreqstat -h server01 -l /dev/dsk/c1t1d23s1
Server    Transaction-Volume  Request  Execute-Date      Status        CmdOptions
server01  /dev/dsk/c1t1d23s1  Restore  2007/02/22 08:00  Reading( 90%) [-v 10 -r /dev/dsk/c1t1d24s1]
#

Display the detailed tape execution history information of the transaction volume (/dev/dsk/c1t1d0s6) by specifying the -v option.

# /opt/FJSVswstm/bin/tboreqstat -h server01 -v /dev/dsk/c1t1d20s1
Server    Transaction-Volume  Request Execute-Date      End-Date          Status         Pool-Name  Message
server01  /dev/dsk/c1t1d20s1  Backup  2007/02/22 09:00  ----/--/-- --:--  Preprocessing  POOL01     ----
#

The contents displayed are as follows:

Key word	Description
Server	Displays the Storage Server name
Transaction-Volume	For Solaris, Linux, HP-UX or AIX, displays the device name For Windows, displays the AdvancedCopy Manager device name
Request	Displays the processing name with the character strings shown below: "Backup": Backup to the tape, copy to the tape "Restore": Restore from the tape "Delete": Delete the tape history information
Execute-Date	Displays the time and date when the tape manager accepted the processing Displays in the " YYYY/MM/DD hh:mm" format YYYY indicates the year, MM indicates the month, DD indicates the day, hh indicates the hour and mm indicates the minute. The system time and date of the server will be displayed as the time and date.
End-Date	Displays the time and date when the tape manager ended the processing. Displays in the " YYYY/MM/DD hh:mm" format. YYYYY indicates the year, MM indicates the month, DD indicates the day, hh indicates the hour and mm indicates the minute. The system time and date of the server will be displayed as the time and date. If the processing has not ended, displays "----/--/-- --:--" Displays only when the -v option is specified
Status	Displays the execution status of the processing or the progress rate of the write operation to the tape or the read operation from the tape with the character strings shown below: "Preprocessing": Pre-processing of backup/restore is being executed "Writing(xxx%)": Progress status of the tape write operation "Reading(xxx%)": Progress status of the tape read operation "Waiting-tape(xxx%)": Progress status of the tape write/read operation before the tape wait status is reached "Postprocessing": Post-processing of backup/restore is being executed "Cancel": Canceling of backup/restore is being executed "Deleting": Deletion of tape history information is being executed
Pool-Name	Displays the storage pool name of the tape backup destination Displays when the processing name is "Backup" Displays "----" if the processing name is "Restore" and "Delete" or "Backup" but the tape write operation has not started Displays only when the -v option is specified
CmdOptions	Displays the option and the value of the option specified and the time to processing execution Displays only when the -l option is specified
Message	Displays a warning message or an error message "::" is displayed at the end of messages. If multiple messages are output, "::" is also displayed between messages. Displays "----" if the message doest not exist Displays only when the -v option is specified