ursstatus(1M) ursstatus(1M)
NAME
ursstatus - report the status of posted user restore requests
SYNOPSIS
ursstatus [-h ] [-j jobids] [-f field_separator] [-d ddev] [-u users]
DESCRIPTION
With no options, ursstatus reports the status of all pending user
restore requests that are posted in the restore status table.
This command can request a status report for only those restore
requests that the user has initiated.
Options
-h Suppresses header for the report.
-j jobids Restricts the report to the specified jobs. jobids is a
list of restore job IDs (either comma-separated or blank-
separated and surrounded by quotes). jobids must be valid
for the user invoking the command.
-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. A null field_separator will use a tab character
as a separator.
-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.
-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.
8/91 Page 1
ursstatus(1M) ursstatus(1M)
DIAGNOSTICS
The exit codes for ursstatus are the following:
0 = successful completion of the task
1 = one or more parameters to ursstatus are invalid.
2 = an error has occurred which caused ursstatus to fail to
complete all portions of its task.
EXAMPLE
ursstatus -j rest-354a,rest-429b
reports the status of only the two posted restore requests with the
specified job IDs.
FILES
/etc/bkup/rsstatus.tab
contains status report information for all restore
requests from users
SEE ALSO
restore(1M), rsstatus(1M), urestore(1M).
Page 2 8/91