backup_jobs - Lists pending and running operations in interactive mode

       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.

OpenAFS                                            2025-03-21                                     BACKUP_JOBS(8)

       The backupjobs 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 backupinteractive 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 backupkill 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 backupstatus
       command.

       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

       backup_jobs - Lists pending and running operations in interactive mode

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

       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/yearhours: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 (dumpname)
               Initiated by the backup dump command. The dumpname has the following format:

                   <volume_set_name>.<dump_level_name>

           Restore
               Initiated by the backupdiskrestore, backupvolrestore, or backupvolsetrestore command.

           Labeltape (tape_label)
               Initiated  by  the  backuplabeltapen command. The tape_label is the name specified by the backuplabeltape command's -name or -pname argument.

           Scantape
               Initiated by the backupscantape command.

           SaveDb
               Initiated by the backupsavedb command.

           RestoreDb
               Initiated by the backuprestoredb 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 backupkill command was issued, but  the  termination  signal  has  yet  to  reach  the  Tape
               Coordinator.

           [abort sent]
               The  operation  is  canceled  by  the  backupkill  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.

       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.

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

jobs [-help]

       j [-h]