# Administration Reference

## backup jobs

Purpose

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 labeltape 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.

Related Information

backup

backup interactive

backup kill

backup quit

© IBM Corporation 2000. All Rights Reserved