rsstatus(1M) SYSTEM ADMINISTRATION COMMANDS rsstatus(1M)
NAME
rsstatus - report the status of posted restore requests
SYNOPSIS
rsstatus [-h] [-d ddev] [-j jobids] [-u users] [-f c]
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 user with
superuser privileges. 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]
Either dtype or dlabels may be null.
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 on the labelit command. dlabels may
be either comma-separated or blank-separated and sur-
rounded by quotes. If specified, restrict the report
to posted requests that could be satisfied by an
archive residing on the specified volumes.
-f c Suppresses field wrap and specifies an output
field separator to be used. c 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. To use a tab
character as a field separator, specify a null c.
-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).
1
rsstatus(1M) SYSTEM ADMINISTRATION COMMANDS rsstatus(1M)
-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 in the passwd file.
DIAGNOSTICS
The exit codes for rsstatus are the following:
0 = successful completion of the task
1 = one or more parameters to rsstatus are invalid.
2 = an error has occurred which caused rsstatus to fail to
complete all portions of 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
SEE ALSO
devgroup.tab(4), device.tab(4), restore(1M), urestore(1M),
ursstatus(1M).
2