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-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 = 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).