.if n .pH g1a.rsstatus @(#)rsstatus @(#)rsstatus	40.14 of 1/3/90
.\" Copyright 1989 AT&T
.nr X
.if \nX=0 .ds x} rsstatus 1M "System Administration Utilities" "\&"
.if \nX=1 .ds x} rsstatus 1M "System Administration Utilities"
.if \nX=2 .ds x} rsstatus 1M "" "\&"
.if \nX=3 .ds x} rsstatus "" "" "\&"
.TH \*(x}
.SH NAME
\f4rsstatus\f1 \- report the status of posted restore requests
.SH SYNOPSIS
\f4rsstatus \f1[\f4\-h\f1] 
[\f4\-d \f2ddev\f1] 
[\f4\-f \f2field_separator\f1] 
[\f4\-j \f2jobids\f1] 
[\f4\-u \f2users\f1]
.SH DESCRIPTION
With no options, 
\f4rsstatus\fP
reports the status of all pending restore requests
that are posted in the restore status table.
.P
\f4rsstatus\fP
may be executed only by a user with superuser privileges.
.P
Volume labels marked with an asterisk in the output of this
command are table of contents volumes.
.SS Options
.TP 10
\f4\-d\f2 ddev\f1
Restricts the report to pending restore jobs that could
be satisfied by the specified device type or volumes.
.I ddev
describes the device or volumes used to select requests to be restored.
.I ddev
is of the form:
.IP
	[\f2dtype\f1][\f4:\f2dlabels\f1]
.IP
.I 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.
.IP
.I dlabels
is a list of volume names corresponding to the \f2volumename\f1
displayed by the \f4labelit\f1 command.
\f2dlabels\f1 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.
.in 0
.TP 10
\f4\-f \f2field_separator\f1
Suppresses field wrap and specifies an output field separator to be 
used.
\f2field_separator\f1 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.
.TP 10
\f4\-h\f1
Suppresses the header for the report.
.TP 10
\f4\-j\f2 jobids\f1
Restricts the report to the jobs specified.
.I jobids
is a list of
restore job \s-1ID\s+1s 
(either comma-separated or blank-separated and surrounded by quotes).
.TP 10
\f4\-u\f2 users\f1
Restricts the report to requests submitted by the specified
.IR users
(either comma-separated or blank-separated and surrounded by quotes).
\f2users\f1 must be listed in the \f4passwd\f1 file.
.SH DIAGNOSTICS 
The exit codes for \f4rsstatus\fP are the following:
.PP
\f40\f1 = successful completion of the task
.br
\f41\f1 = one or more parameters to \f4rsstatus\fP are invalid.
.br
\f42\f1 = an error has occurred which caused \f4rsstatus\fP to fail to
      complete all portions of its task.
.SH EXAMPLES
Example 1:
.P
.in 1.0i
\f4rsstatus \-d diskette\fP
.in 0
.P
reports the status of those posted restore requests that can
be satisfied by inserting diskettes into a diskette drive.
.P
Example 2:
.P
.in 1.0i
\f4rsstatus \-j rest-354a,rest-429b\fP
.in 0
.P
reports the status of only the two posted restore requests 
for which job \s-1ID\s+1s are specified.
.SH FILES
\f4/etc/bkup/rsstatus.tab\f1 \(em 
tracks the status of all restore requests from users
.SH SEE ALSO
\f4restore\fP(1M),
\f4urestore\fP(1M),
\f4ursstatus\fP(1M).
.br
\f4dgroup.tab\fP(4), \f4device.tab\fP(4)
in the \f2Programmer's Reference Manual\fP.
