rsstatus(1M)                                                   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 cartridge 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.

         -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
                   separator 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 by quotes).




   8/91                                                                 Page 1

   rsstatus(1M)                                                   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 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 ctape1

         reports the status of those posted restore requests that can be
         satisfied by inserting a cartridge tape into a cartridge tape 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.


















   Page 2                                                                 8/91