.if n .pH g1a.ursstatus @(#)ursstatus @(#)ursstatus	40.13 of 1/17/90
.\" Copyright 1989 AT&T
.nr X
.if \nX=0 .ds x} ursstatus 1M "System Administration Utilities" "\&"
.if \nX=1 .ds x} ursstatus 1M "System Administration Utilities"
.if \nX=2 .ds x} ursstatus 1M "" "\&"
.if \nX=3 .ds x} ursstatus "" "" "\&"
.TH \*(x}
.SH NAME
\f4ursstatus\f1 \- report the status of posted user restore requests
.SH SYNOPSIS
\f4ursstatus\f1 
[\f4\-h \f1] 
[\f4\-j \f2jobids\f1]
[\f4\-f \f2field_separator\f1] 
[\f4\-d \f2ddev\f1]
[\f4\-u \f2users\f1]
.SH DESCRIPTION
With no options,
\f4ursstatus\fP
reports the status of all pending 
user restore requests
that are posted in the restore status table.
.P
This command can request a status report 
for only those restore requests
that the user has initiated.
.SS Options
.TP 10
\f4\-h\f1
Suppresses header for the report.
.TP 10
\f4\-j\f2 jobids\f1
Restricts the report to the specified jobs.
.I jobids
is a list of
restore job \s-1ID\s+1s
(either comma-separated 
or blank-separated and surrounded by quotes).
\f2jobids\f1 must be valid for the 
user invoking the command.
.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.
A null \f2field_separator\f1 
will use a tab character as a separator.
.TP 10
\f4\-d \f2ddev\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\-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 \f4ursstatus\fP are the following:
.PP
\f40\fP = successful completion of the task
.br
\f41\fP = one or more parameters to \f4ursstatus\fP are invalid.
.br
\f42\fP = an error has occurred which caused \f4ursstatus\fP to fail to
      complete \f2all\f1 portions of its task.
.br
.ne 1i
.SH EXAMPLE
.in 1.0i
\f4ursstatus -j rest-354a,rest-429b\fP
.in 0
.P
reports the status of only
the two posted restore requests with
the specified job \s-1ID\s+1s.
.SH FILES
.TP 1.75i
\f4/etc/bkup/rsstatus.tab\fP
contains status report information for 
all restore requests from users
.SH SEE ALSO
\f4restore\fP(1M),
\f4rsstatus\fP(1M),
\f4urestore\fP(1M).
