Provided by: openafs-client_1.4.1-2_i386 bug

NAME

       backup jobs - Lists pending and running operations in interactive mode

SYNOPSIS

       jobs [-help]

       j [-h]

DESCRIPTION

       The backup jobs command lists the job ID number and status of each
       backup operation running or pending in the current interactive session.

       This command can be issued in interactive mode only. If the issuer of
       the backup interactive command included the -localauth flag, the -cell
       argument, or both, those settings apply to this command also.

       To terminate operations that appear in the output, issue the backup
       kill command and identify the operation to cancel with the job ID
       number from this command’s output.

       To check the status of a Tape Coordinator, rather than of a certain
       operation, use the backup status command.

OPTIONS

       -help
           Prints the online help for this command. All other valid options
           are ignored.

OUTPUT

       The output always includes the expiration date and time of the tokens
       that the backup command interpreter is using during the current
       interactive session, in the following format:

          <date>   <time>: TOKEN EXPIRATION

       If the execution date and time specified for a scheduled dump operation
       is later than <date time>, then its individual line (as described in
       the following paragraphs) appears below this line to indicate that the
       current tokens will not be available to it.

       If the issuer of the backup command included the -localauth flag when
       entering interactive mode, the line instead reads as follows:

          :  TOKEN NEVER EXPIRES

       The entry for a scheduled dump operation has the following format:

          Job <job_ID>:  <timestamp>:  dump  <volume_set>  <dump_level>

       where

       <job_ID>
           Is a job identification number assigned by the Backup System.

       <timestamp>
           Indicates the date and time the dump operation is to begin, in the
           format month/date/year hours:minutes (in 24-hour format)

       <volume_set>
           Indicates the volume set to dump.

       <dump_level>
           Indicates the dump level at which to perform the dump operation.

       The line for a pending or running operation of any other type has the
       following format:

          Job <job_ID>:  <operation>  <status>

       where

       <job_ID>
           Is a job identification number assigned by the Backup System.

       <operation>
           Identifies the operation the Tape Coordinator is performing, which
           is initiated by the indicated command:

       Dump (dump name)
               Initiated by the backup dump command. The dump name has the
               following format:

                   <volume_set_name>.<dump_level_name>

       Restore Initiated by the backup diskrestore, backup volrestore, or
               backup volsetrestore command.

       Labeltape (tape_label)
               Initiated by the backup labeltapen command. The tape_label is
               the name specified by the backup labeltape command’s -name or
               -pname argument.

       Scantape
               Initiated by the backup scantape command.

       SaveDb  Initiated by the backup savedb command.

       RestoreDb
               Initiated by the backup restoredb command.

       <status>
           Indicates the job’s current status in one of the following
           messages. If no message appears, the job is either still pending or
           has finished.

       number Kbytes, volume volume_name
               For a running dump operation, indicates the number of kilobytes
               copied to tape or a backup data file so far, and the volume
               currently being dumped.

       number Kbytes, restore.volume
               For a running restore operation, indicates the number of
               kilobytes copied into AFS from a tape or a backup data file so
               far.

       [abort requested]
               The backup kill command was issued, but the termination signal
               has yet to reach the Tape Coordinator.

       [abort sent]
               The operation is canceled by the backup kill command.  Once the
               Backup System removes an operation from the queue or stops it
               from running, it no longer appears at all in the output from
               the command.

       [butc contact lost]
               The backup command interpreter cannot reach the Tape
               Coordinator. The message can mean either that the Tape
               Coordinator handling the operation was terminated or failed
               while the operation was running, or that the connection to the
               Tape Coordinator timed out.

       [done]  The Tape Coordinator has finished the operation.

       [drive wait]
               The operation is waiting for the specified tape drive to become
               free.

       [operator wait]
               The Tape Coordinator is waiting for the backup operator to
               insert a tape in the drive.

EXAMPLES

       The following example shows that two restore operations and one dump
       operation are running (presumably on different Tape Coordinators) and
       that the backup command interpreter’s tokens expire on 22 April 1999 at
       10:45 am:

          backup> jobs
          Job 1: Restore, 1306 Kbytes, restore.volume
          Job 2: Dump (user.sunday1), 34 Kbytes, volume user.pat.backup
          Job 3: Restore, 2498 Kbytes, restore.volume
                 04/22/1999 10:45: TOKEN EXPIRATION

PRIVILEGE REQUIRED

       None. However, queuing any operation requires privilege, and it is
       possible to issue this command only within the interactive session in
       which the jobs are queued.

SEE ALSO

       the backup(8) manpage, the backup_interactive(8) manpage, the
       backup_kill(8) manpage, the backup_quit(8) manpage

COPYRIGHT

       IBM Corporation 2000. <http://www.ibm.com/> All Rights Reserved.

       This documentation is covered by the IBM Public License Version 1.0.
       It was converted from HTML to POD by software written by Chas Williams
       and Russ Allbery, based on work by Alf Wachsmann and Elizabeth Cassell.