2005-12-08 12:14:33 +00:00
|
|
|
=head1 NAME
|
|
|
|
|
2007-11-11 22:54:56 +00:00
|
|
|
backup_jobs - Lists pending and running operations in interactive mode
|
2005-12-08 12:14:33 +00:00
|
|
|
|
|
|
|
=head1 SYNOPSIS
|
|
|
|
|
2006-03-01 05:02:29 +00:00
|
|
|
=for html
|
|
|
|
<div class="synopsis">
|
|
|
|
|
2005-12-13 19:21:13 +00:00
|
|
|
B<jobs> [B<-help>]
|
2005-12-08 12:14:33 +00:00
|
|
|
|
2005-12-13 19:21:13 +00:00
|
|
|
B<j> [B<-h>]
|
2005-12-08 12:14:33 +00:00
|
|
|
|
2006-03-01 05:02:29 +00:00
|
|
|
=for html
|
|
|
|
</div>
|
|
|
|
|
2005-12-08 12:14:33 +00:00
|
|
|
=head1 DESCRIPTION
|
|
|
|
|
2005-12-13 19:21:13 +00:00
|
|
|
The B<backup jobs> command lists the job ID number and status of each
|
|
|
|
B<backup> operation running or pending in the current interactive session.
|
2005-12-08 12:14:33 +00:00
|
|
|
|
2005-12-13 19:21:13 +00:00
|
|
|
This command can be issued in interactive mode only. If the issuer of the
|
|
|
|
B<backup interactive> command included the B<-localauth> flag, the
|
|
|
|
B<-cell> argument, or both, those settings apply to this command also.
|
2005-12-08 12:14:33 +00:00
|
|
|
|
2005-12-13 19:21:13 +00:00
|
|
|
To terminate operations that appear in the output, issue the B<backup
|
|
|
|
kill> command and identify the operation to cancel with the job ID number
|
2005-12-08 12:14:33 +00:00
|
|
|
from this command's output.
|
|
|
|
|
|
|
|
To check the status of a Tape Coordinator, rather than of a certain
|
|
|
|
operation, use the B<backup status> command.
|
|
|
|
|
|
|
|
=head1 OPTIONS
|
|
|
|
|
|
|
|
=over 4
|
|
|
|
|
2005-12-13 19:21:13 +00:00
|
|
|
=item B<-help>
|
2005-12-08 12:14:33 +00:00
|
|
|
|
2005-12-13 19:21:13 +00:00
|
|
|
Prints the online help for this command. All other valid options are
|
|
|
|
ignored.
|
2005-12-08 12:14:33 +00:00
|
|
|
|
|
|
|
=back
|
|
|
|
|
|
|
|
=head1 OUTPUT
|
|
|
|
|
|
|
|
The output always includes the expiration date and time of the tokens that
|
2005-12-13 19:21:13 +00:00
|
|
|
the B<backup> command interpreter is using during the current interactive
|
|
|
|
session, in the following format:
|
2005-12-08 12:14:33 +00:00
|
|
|
|
2005-12-13 19:21:13 +00:00
|
|
|
<date> <time>: TOKEN EXPIRATION
|
2005-12-08 12:14:33 +00:00
|
|
|
|
|
|
|
If the execution date and time specified for a scheduled dump operation is
|
2005-12-13 19:21:13 +00:00
|
|
|
later than <date time>, then its individual line (as described in the
|
2005-12-08 12:14:33 +00:00
|
|
|
following paragraphs) appears below this line to indicate that the current
|
|
|
|
tokens will not be available to it.
|
|
|
|
|
2005-12-13 19:21:13 +00:00
|
|
|
If the issuer of the backup command included the B<-localauth> flag when
|
|
|
|
entering interactive mode, the line instead reads as follows:
|
2005-12-08 12:14:33 +00:00
|
|
|
|
|
|
|
: TOKEN NEVER EXPIRES
|
|
|
|
|
|
|
|
The entry for a scheduled dump operation has the following format:
|
|
|
|
|
2005-12-13 19:21:13 +00:00
|
|
|
Job <job_ID>: <timestamp>: dump <volume_set> <dump_level>
|
2005-12-08 12:14:33 +00:00
|
|
|
|
|
|
|
where
|
|
|
|
|
|
|
|
=over 4
|
|
|
|
|
2005-12-13 19:21:13 +00:00
|
|
|
=item <job_ID>
|
2005-12-08 12:14:33 +00:00
|
|
|
|
|
|
|
Is a job identification number assigned by the Backup System.
|
|
|
|
|
2005-12-13 19:21:13 +00:00
|
|
|
=item <timestamp>
|
2005-12-08 12:14:33 +00:00
|
|
|
|
|
|
|
Indicates the date and time the dump operation is to begin, in the format
|
2005-12-13 19:21:13 +00:00
|
|
|
I<month>/I<date>/I<year> I<hours>:I<minutes> (in 24-hour format)
|
2005-12-08 12:14:33 +00:00
|
|
|
|
2005-12-13 19:21:13 +00:00
|
|
|
=item <volume_set>
|
2005-12-08 12:14:33 +00:00
|
|
|
|
|
|
|
Indicates the volume set to dump.
|
|
|
|
|
2005-12-13 19:21:13 +00:00
|
|
|
=item <dump_level>
|
2005-12-08 12:14:33 +00:00
|
|
|
|
|
|
|
Indicates the dump level at which to perform the dump operation.
|
|
|
|
|
|
|
|
=back
|
|
|
|
|
|
|
|
The line for a pending or running operation of any other type has the
|
|
|
|
following format:
|
|
|
|
|
2005-12-13 19:21:13 +00:00
|
|
|
Job <job_ID>: <operation> <status>
|
2005-12-08 12:14:33 +00:00
|
|
|
|
|
|
|
where
|
|
|
|
|
|
|
|
=over 4
|
|
|
|
|
2005-12-13 19:21:13 +00:00
|
|
|
=item <job_ID>
|
2005-12-08 12:14:33 +00:00
|
|
|
|
|
|
|
Is a job identification number assigned by the Backup System.
|
|
|
|
|
2005-12-13 19:21:13 +00:00
|
|
|
=item <operation>
|
2005-12-08 12:14:33 +00:00
|
|
|
|
|
|
|
Identifies the operation the Tape Coordinator is performing, which is
|
|
|
|
initiated by the indicated command:
|
|
|
|
|
|
|
|
=over 4
|
|
|
|
|
2005-12-13 19:21:13 +00:00
|
|
|
=item Dump (I<dump name>)
|
2005-12-08 12:14:33 +00:00
|
|
|
|
2005-12-13 19:21:13 +00:00
|
|
|
Initiated by the backup dump command. The I<dump name> has the following
|
|
|
|
format:
|
2005-12-08 12:14:33 +00:00
|
|
|
|
2005-12-13 19:21:13 +00:00
|
|
|
<volume_set_name>.<dump_level_name>
|
2005-12-08 12:14:33 +00:00
|
|
|
|
2005-12-13 19:21:13 +00:00
|
|
|
=item Restore
|
2005-12-08 12:14:33 +00:00
|
|
|
|
2005-12-13 19:21:13 +00:00
|
|
|
Initiated by the B<backup diskrestore>, B<backup volrestore>, or B<backup
|
|
|
|
volsetrestore> command.
|
2005-12-08 12:14:33 +00:00
|
|
|
|
2005-12-13 19:21:13 +00:00
|
|
|
=item Labeltape (I<tape_label>)
|
2005-12-08 12:14:33 +00:00
|
|
|
|
2005-12-13 19:21:13 +00:00
|
|
|
Initiated by the B<backup labeltape>n command. The I<tape_label> is the
|
|
|
|
name specified by the B<backup labeltape> command's B<-name> or B<-pname>
|
|
|
|
argument.
|
2005-12-08 12:14:33 +00:00
|
|
|
|
2005-12-13 19:21:13 +00:00
|
|
|
=item Scantape
|
2005-12-08 12:14:33 +00:00
|
|
|
|
2005-12-13 19:21:13 +00:00
|
|
|
Initiated by the B<backup scantape> command.
|
2005-12-08 12:14:33 +00:00
|
|
|
|
2005-12-13 19:21:13 +00:00
|
|
|
=item SaveDb
|
2005-12-08 12:14:33 +00:00
|
|
|
|
2005-12-13 19:21:13 +00:00
|
|
|
Initiated by the B<backup savedb> command.
|
2005-12-08 12:14:33 +00:00
|
|
|
|
2005-12-13 19:21:13 +00:00
|
|
|
=item RestoreDb
|
2005-12-08 12:14:33 +00:00
|
|
|
|
2005-12-13 19:21:13 +00:00
|
|
|
Initiated by the B<backup restoredb> command.
|
2005-12-08 12:14:33 +00:00
|
|
|
|
|
|
|
=back
|
|
|
|
|
2005-12-13 19:21:13 +00:00
|
|
|
=item <status>
|
2005-12-08 12:14:33 +00:00
|
|
|
|
2005-12-13 19:21:13 +00:00
|
|
|
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.
|
2005-12-08 12:14:33 +00:00
|
|
|
|
|
|
|
=over 4
|
|
|
|
|
2005-12-13 19:21:13 +00:00
|
|
|
=item I<number> Kbytes, volume I<volume_name>
|
2005-12-08 12:14:33 +00:00
|
|
|
|
|
|
|
For a running dump operation, indicates the number of kilobytes copied to
|
2005-12-13 19:21:13 +00:00
|
|
|
tape or a backup data file so far, and the volume currently being dumped.
|
2005-12-08 12:14:33 +00:00
|
|
|
|
2005-12-13 19:21:13 +00:00
|
|
|
=item I<number> Kbytes, restore.volume
|
2005-12-08 12:14:33 +00:00
|
|
|
|
|
|
|
For a running restore operation, indicates the number of kilobytes copied
|
|
|
|
into AFS from a tape or a backup data file so far.
|
|
|
|
|
2005-12-13 19:21:13 +00:00
|
|
|
=item [abort requested]
|
2005-12-08 12:14:33 +00:00
|
|
|
|
2005-12-13 19:21:13 +00:00
|
|
|
The B<backup kill> command was issued, but the termination signal has yet
|
|
|
|
to reach the Tape Coordinator.
|
2005-12-08 12:14:33 +00:00
|
|
|
|
2005-12-13 19:21:13 +00:00
|
|
|
=item [abort sent]
|
2005-12-08 12:14:33 +00:00
|
|
|
|
2005-12-13 19:21:13 +00:00
|
|
|
The operation is canceled by the B<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.
|
2005-12-08 12:14:33 +00:00
|
|
|
|
2005-12-13 19:21:13 +00:00
|
|
|
=item [butc contact lost]
|
2005-12-08 12:14:33 +00:00
|
|
|
|
2005-12-13 19:21:13 +00:00
|
|
|
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.
|
2005-12-08 12:14:33 +00:00
|
|
|
|
2005-12-13 19:21:13 +00:00
|
|
|
=item [done]
|
2005-12-08 12:14:33 +00:00
|
|
|
|
|
|
|
The Tape Coordinator has finished the operation.
|
|
|
|
|
2005-12-13 19:21:13 +00:00
|
|
|
=item [drive wait]
|
2005-12-08 12:14:33 +00:00
|
|
|
|
2005-12-13 19:21:13 +00:00
|
|
|
The operation is waiting for the specified tape drive to become free.
|
2005-12-08 12:14:33 +00:00
|
|
|
|
2005-12-13 19:21:13 +00:00
|
|
|
=item [operator wait]
|
2005-12-08 12:14:33 +00:00
|
|
|
|
|
|
|
The Tape Coordinator is waiting for the backup operator to insert a tape
|
|
|
|
in the drive.
|
|
|
|
|
|
|
|
=back
|
|
|
|
|
|
|
|
=back
|
|
|
|
|
|
|
|
=head1 EXAMPLES
|
|
|
|
|
|
|
|
The following example shows that two restore operations and one dump
|
2005-12-13 19:21:13 +00:00
|
|
|
operation are running (presumably on different Tape Coordinators) and that
|
|
|
|
the B<backup> command interpreter's tokens expire on 22 April 1999 at
|
2005-12-08 12:14:33 +00:00
|
|
|
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
|
|
|
|
|
|
|
|
=head1 PRIVILEGE REQUIRED
|
|
|
|
|
|
|
|
None. However, queuing any operation requires privilege, and it is
|
2005-12-13 19:21:13 +00:00
|
|
|
possible to issue this command only within the interactive session in
|
|
|
|
which the jobs are queued.
|
2005-12-08 12:14:33 +00:00
|
|
|
|
|
|
|
=head1 SEE ALSO
|
|
|
|
|
2005-12-13 19:21:13 +00:00
|
|
|
L<backup(8)>,
|
|
|
|
L<backup_interactive(8)>,
|
|
|
|
L<backup_kill(8)>,
|
|
|
|
L<backup_quit(8)>
|
2005-12-08 12:14:33 +00:00
|
|
|
|
|
|
|
=head1 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.
|