rsstatus(1M)      MISC. REFERENCE MANUAL PAGES       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  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]

               dtype is a device type  (such  as  diskette,  car-
               tridge tape, or 9-track tape).  If specified, res-
               trict 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 speci-
               fied 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 separa-
               tor  if  the display will contain dates in which a
               colon is used to separate hours from minutes.

     -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



          Last change: System Administration Utilities          1

rsstatus(1M)      MISC. REFERENCE MANUAL PAGES       rsstatus(1M)



               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 = 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
     restore(1M), urestore(1M), ursstatus(1M).
     dgroup.tab(4), device.tab(4) in the  Programmer's  Reference
     Manual.






















          Last change: System Administration Utilities          2