doc/html/AdminReference/auarf077.htm

   1 <!DOCTYPE HTML PUBLIC "-//IETF//DTD HTML 4//EN">
   2 <HTML><HEAD>
   3 <TITLE>Administration Reference</TITLE>
   4 <!-- Begin Header Records  ========================================== -->
   5 <!-- /tmp/idwt3672/auarf000.scr converted by idb2h R4.2 (359) ID      -->
   6 <!-- Workbench Version (AIX) on 3 Oct 2000 at 16:18:30                -->
   7 <META HTTP-EQUIV="updated" CONTENT="Tue, 03 Oct 2000 16:18:29">
   8 <META HTTP-EQUIV="review" CONTENT="Wed, 03 Oct 2001 16:18:29">
   9 <META HTTP-EQUIV="expires" CONTENT="Thu, 03 Oct 2002 16:18:29">
  10 </HEAD><BODY>
  11 <!-- (C) IBM Corporation 2000. All Rights Reserved    -->
  12 <BODY bgcolor="ffffff">
  13 <!-- End Header Records  ============================================ -->
  14 <A NAME="Top_Of_Page"></A>
  15 <H1>Administration Reference</H1>
  16 <HR><P ALIGN="center"> <A HREF="../index.htm"><IMG SRC="../books.gif" BORDER="0" ALT="[Return to Library]"></A> <A HREF="auarf002.htm#ToC"><IMG SRC="../toc.gif" BORDER="0" ALT="[Contents]"></A> <A HREF="auarf076.htm"><IMG SRC="../prev.gif" BORDER="0" ALT="[Previous Topic]"></A> <A HREF="#Bot_Of_Page"><IMG SRC="../bot.gif" BORDER="0" ALT="[Bottom of Topic]"></A> <A HREF="auarf078.htm"><IMG SRC="../next.gif" BORDER="0" ALT="[Next Topic]"></A> <A HREF="auarf284.htm#HDRINDEX"><IMG SRC="../index.gif" BORDER="0" ALT="[Index]"></A> <P>
  17 <P>
  18 <H2><A NAME="HDRBK_JOBS" HREF="auarf002.htm#ToC_91">backup jobs</A></H2>
  19 <A NAME="IDX4332"></A>
  20 <A NAME="IDX4333"></A>
  21 <A NAME="IDX4334"></A>
  22 <A NAME="IDX4335"></A>
  23 <A NAME="IDX4336"></A>
  24 <A NAME="IDX4337"></A>
  25 <A NAME="IDX4338"></A>
  26 <P><STRONG>Purpose</STRONG>
  27 <P>Lists pending and running operations in interactive mode
  28 <P><STRONG>Synopsis</STRONG>
  29 <PRE><B>jobs</B>  [<B>-help</B>]
  30
  31 <B>j</B> [<B>-h</B>]
  32 </PRE>
  33 <P><STRONG>Description</STRONG>
  34 <P>The <B>(backup) jobs</B> command lists the job ID number and status of
  35 each <B>backup</B> operation running or pending in the current interactive
  36 session.
  37 <P>This command can be issued in interactive mode only. If the issuer
  38 of the <B>backup (interactive)</B> command included the
  39 <B>-localauth</B> flag, the <B>-cell</B> argument, or both, those
  40 settings apply to this command also.
  41 <P>To terminate operations that appear in the output, issue the <B>(backup)
  42 kill</B> command and identify the operation to cancel with the job ID number
  43 from this command's output.
  44 <P>To check the status of a Tape Coordinator, rather than of a certain
  45 operation, use the <B>backup status</B> command.
  46 <P><STRONG>Options</STRONG>
  47 <DL>
  48 <P><DT><B>-help
  49 </B><DD>Prints the online help for this command. All other valid options
  50 are ignored.
  51 </DL>
  52 <P><STRONG>Output</STRONG>
  53 <P>The output always includes the expiration date and time of the tokens that
  54 the <B>backup</B> command interpreter is using during the current
  55 interactive session, in the following format:
  56 <PRE>   <VAR>date</VAR>   <VAR>time</VAR>: TOKEN EXPIRATION
  57 </PRE>
  58 <P>If the execution date and time specified for a scheduled dump operation is
  59 later than <I>date time</I>, then its individual line (as described in the
  60 following paragraphs) appears below this line to indicate that the current
  61 tokens will not be available to it.
  62 <P>If the issuer of the <B>backup</B> command included the
  63 <B>-localauth</B> flag when entering interactive mode, the line instead
  64 reads as follows:
  65 <PRE>   :  TOKEN NEVER EXPIRES
  66 </PRE>
  67 <P>The entry for a scheduled dump operation has the following format:
  68 <PRE>   Job <VAR>job_ID</VAR>:  <VAR>timestamp</VAR>:  dump  <VAR>volume_set</VAR>  <VAR>dump_level</VAR>
  69 </PRE>
  70 <P>where
  71 <DL>
  72 <P><DT><B><VAR>job_ID</VAR>
  73 </B><DD>Is a job identification number assigned by the Backup System.
  74 <P><DT><B><VAR>timestamp</VAR>
  75 </B><DD>Indicates the date and time the dump operation is to begin, in the format
  76 <I>month</I>/<I>date</I>/<I>year</I>
  77 <I>hours</I>:<I>minutes</I> (in 24-hour format)
  78 <P><DT><B><VAR>volume_set</VAR>
  79 </B><DD>Indicates the volume set to dump.
  80 <P><DT><B><VAR>dump_level</VAR>
  81 </B><DD>Indicates the dump level at which to perform the dump operation.
  82 </DL>
  83 <P>The line for a pending or running operation of any other type has the
  84 following format:
  85 <PRE>   Job <VAR>job_ID</VAR>:  <VAR>operation</VAR>  <VAR>status</VAR>
  86 </PRE>
  87 <P>where
  88 <DL>
  89 <P><DT><B><VAR>job_ID</VAR>
  90 </B><DD>Is a job identification number assigned by the Backup System.
  91 <P><DT><B><VAR>operation</VAR>
  92 </B><DD>Identifies the operation the Tape Coordinator is performing, which is
  93 initiated by the indicated command:
  94 <DL>
  95 <P><DT><B><TT>Dump</TT> <TT>(</TT><VAR>dump name</VAR><TT>)</TT>
  96 </B><DD>Initiated by the <B>backup dump</B> command. The <VAR>dump
  97 name</VAR> has the following format:
  98 <P><VAR>volume_set_name</VAR><B>.</B><VAR>dump_level_name</VAR>
  99 <P><DT><B><TT>Restore</TT>
 100 </B><DD>Initiated by the <B>backup diskrestore</B>, <B>backup
 101 volrestore</B>, or <B>backup volsetrestore</B> command.
 102 <P><DT><B><TT>Labeltape</TT> <TT>(</TT><VAR>tape_label</VAR><TT>)</TT>
 103 </B><DD>Initiated by the <B>backup labeltape</B> command. The
 104 <VAR>tape_label</VAR> is the name specified by the <B>backup labeltape</B>
 105 command's <B>-name</B> or <B>-pname</B> argument.
 106 <P><DT><B><TT>Scantape</TT>
 107 </B><DD>Initiated by the <B>backup scantape</B> command.
 108 <P><DT><B><TT>SaveDb</TT>
 109 </B><DD>Initiated by the <B>backup savedb</B> command.
 110 <P><DT><B><TT>RestoreDb</TT>
 111 </B><DD>Initiated by the <B>backup restoredb</B> command.
 112 </DL>
 113 <P><DT><B><VAR>status</VAR>
 114 </B><DD>Indicates the job's current status in one of the following
 115 messages. If no message appears, the job is either still pending or has
 116 finished.
 117 <DL>
 118 <P><DT><B><VAR>number</VAR> <TT>Kbytes, volume</TT> <VAR>volume_name</VAR>
 119 </B><DD>For a running dump operation, indicates the number of kilobytes copied to
 120 tape or a backup data file so far, and the volume currently being
 121 dumped.
 122 <P><DT><B><VAR>number</VAR> <TT>Kbytes, restore.volume</TT>
 123 </B><DD>For a running restore operation, indicates the number of kilobytes copied
 124 into AFS from a tape or a backup data file so far.
 125 <P><DT><B><TT>[abort requested]</TT>
 126 </B><DD>The <B>(backup) kill</B> command was issued, but the termination
 127 signal has yet to reach the Tape Coordinator.
 128 <P><DT><B><TT>[abort sent]</TT>
 129 </B><DD>The operation is canceled by the <B>(backup) kill</B> command.
 130 Once the Backup System removes an operation from the queue or stops it from
 131 running, it no longer appears at all in the output from the command.
 132 <P><DT><B><TT>[butc contact lost]</TT>
 133 </B><DD>The <B>backup</B> command interpreter cannot reach the Tape
 134 Coordinator. The message can mean either that the Tape Coordinator
 135 handling the operation was terminated or failed while the operation was
 136 running, or that the connection to the Tape Coordinator timed out.
 137 <P><DT><B><TT>[done]</TT>
 138 </B><DD>The Tape Coordinator has finished the operation.
 139 <P><DT><B><TT>[drive wait]</TT>
 140 </B><DD>The operation is waiting for the specified tape drive to become
 141 free.
 142 <P><DT><B><TT>[operator wait]</TT>
 143 </B><DD>The Tape Coordinator is waiting for the backup operator to insert a tape
 144 in the drive.
 145 </DL>
 146 </DL>
 147 <P><STRONG>Examples</STRONG>
 148 <P>The following example shows that two restore operations and one dump
 149 operation are running (presumably on different Tape Coordinators) and that the
 150 <B>backup</B> command interpreter's tokens expire on 22 April 1999 at
 151 10:45 am:
 152 <PRE>   backup> <B>jobs</B>
 153    Job 1: Restore, 1306 Kbytes, restore.volume
 154    Job 2: Dump (user.sunday1), 34 Kbytes, volume user.pat.backup
 155    Job 3: Restore, 2498 Kbytes, restore.volume
 156           04/22/1999 10:45: TOKEN EXPIRATION
 157
 158 </PRE>
 159 <P><STRONG>Privilege Required</STRONG>
 160 <P>None. However, queuing any operation requires privilege, and it is
 161 possible to issue this command only within the interactive session in which
 162 the jobs are queued.
 163 <P><STRONG>Related Information</STRONG>
 164 <P><A HREF="auarf060.htm#HDRBK_INTRO">backup</A>
 165 <P><A HREF="auarf076.htm#HDRBK_INTERACTIVE">backup interactive</A>
 166 <P><A HREF="auarf078.htm#HDRBK_KILL">backup kill</A>
 167 <P><A HREF="auarf083.htm#HDRBK_QUIT">backup quit</A>
 168 <P>
 169 <HR><P ALIGN="center"> <A HREF="../index.htm"><IMG SRC="../books.gif" BORDER="0" ALT="[Return to Library]"></A> <A HREF="auarf002.htm#ToC"><IMG SRC="../toc.gif" BORDER="0" ALT="[Contents]"></A> <A HREF="auarf076.htm"><IMG SRC="../prev.gif" BORDER="0" ALT="[Previous Topic]"></A> <A HREF="#Top_Of_Page"><IMG SRC="../top.gif" BORDER="0" ALT="[Top of Topic]"></A> <A HREF="auarf078.htm"><IMG SRC="../next.gif" BORDER="0" ALT="[Next Topic]"></A> <A HREF="auarf284.htm#HDRINDEX"><IMG SRC="../index.gif" BORDER="0" ALT="[Index]"></A> <P>
 170 <!-- Begin Footer Records  ========================================== -->
 171 <P><HR><B>
 172 <br>&#169; <A HREF="http://www.ibm.com/">IBM Corporation 2000.</A>  All Rights Reserved
 173 </B>
 174 <!-- End Footer Records  ============================================ -->
 175 <A NAME="Bot_Of_Page"></A>
 176 </BODY></HTML>