rsstatus(1M) rsstatus(1M)
NAME
rsstatus - report the status of posted restore requests
SYNOPSIS
rsstatus [-h] [-d ddev] [-f field_separator] [-j jobids] [-u users]
DESCRIPTION
With no options, rsstatus reports the status of all pending
restore requests that are posted in the restore status table.
rsstatus may be executed only by a privileged user.
Volume labels marked with an asterisk in the output of this
command are table of contents volumes.
Options
-d ddev Restricts the report to pending restore jobs that
could be satisfied by the specified device type or
volumes. ddev describes the device or volumes used
to select requests to be restored. ddev is of the
form:
[dtype][:dlabels]
dtype is a device type (such as diskette, cartridge
tape, or 9-track tape). If specified, restrict the
report to posted requests that could be satisfied by
volumes of the type specified.
dlabels is a list of volume names corresponding to
the volumename displayed by the labelit command.
dlabels may be either comma-separated or blank-
separated and surrounded by quotes. If specified,
restrict the report to posted requests that could be
satisfied by an archive residing on the specified
volumes.
-f field_separator
Suppresses field wrap and specifies an output field
separator to be used. field_separator is the
character that will appear as the field separator in
the output displayed. To make sure the output is
clear, avoid using a character (for a separator)
that is likely to appear in a field. For example,
do not use a colon as a field separator if the
display will contain dates in which a colon is used
to separate hours from minutes.
Copyright 1994 Novell, Inc. Page 1
rsstatus(1M) rsstatus(1M)
-h Suppresses the header for the report.
-j jobids Restricts the report to the jobs specified. jobids
is a list of restore job IDs (either comma-separated
or blank-separated and surrounded by quotes).
-u users Restricts the report to requests submitted by the
specified users (either comma-separated or blank-
separated and surrounded by quotes). users must be
listed in the passwd file.
DIAGNOSTICS
The exit codes for rsstatus are the following:
0 The task completed successfully.
1 One or more parameters to rsstatus are invalid.
2 An error caused rsstatus to fail to complete its task.
EXAMPLES
Example 1:
rsstatus -d diskette
reports the status of those posted restore requests that can
be satisfied by inserting diskettes into a diskette drive.
Example 2:
rsstatus -j rest-354a,rest-429b
reports the status of only the two posted restore requests for
which job IDs are specified.
FILES
/etc/bkup/rsstatus.tab tracks the status of all restore
requests from users.
REFERENCES
restore(1M), urestore(1M), ursstatus(1M), volcopy(1M)
Copyright 1994 Novell, Inc. Page 2