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




          Last change: System Administration Utilities          1

ursstatus(1M)     MISC. REFERENCE MANUAL PAGES      ursstatus(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 ursstatus are the following:

     0 = successful completion of the task
     1 = one or more parameters to ursstatus are invalid.
     2 = an error has occurred which caused ursstatus to fail to
           complete all portions of its task.

EXAMPLE
          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

SEE ALSO
     restore(1M), rsstatus(1M), urestore(1M).






























          Last change: System Administration Utilities          2