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-


                           Copyright 1994 Novell, Inc.               Page 1

      ursstatus(1M)                                          ursstatus(1M)


                      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.

      DIAGNOSTICS
            The exit codes for ursstatus are the following:

            0     The task completed successfully.

            1     One or more parameters to ursstatus are invalid.

            2     An error has occurred, causing ursstatus to fail to
                  complete all portions of its task.

      EXAMPLES
                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

      REFERENCES
            restore(1M), rsstatus(1M), urestore(1M)















                          Copyright 1994 Novell, Inc.               Page 2