doc/html/AdminReference/auarf078.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="auarf077.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="auarf079.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_KILL" HREF="auarf002.htm#ToC_92">backup kill</A></H2>
  19 <A NAME="IDX4339"></A>
  20 <A NAME="IDX4340"></A>
  21 <A NAME="IDX4341"></A>
  22 <A NAME="IDX4342"></A>
  23 <A NAME="IDX4343"></A>
  24 <A NAME="IDX4344"></A>
  25 <P><STRONG>Purpose</STRONG>
  26 <P>Terminates a pending or running operation
  27 <P><STRONG>Synopsis</STRONG>
  28 <PRE><B>kill -id</B> &lt;<VAR>job&nbsp;ID&nbsp;or&nbsp;dump&nbsp;set&nbsp;name</VAR>> [<B>-help</B>]
  29
  30 <B>k -i</B> &lt;<VAR>job&nbsp;ID&nbsp;or&nbsp;dump&nbsp;set&nbsp;name</VAR>>  [<B>-h</B>]
  31 </PRE>
  32 <P><STRONG>Description</STRONG>
  33 <P>The <B>(backup) kill</B> command dequeues a Backup System operation
  34 that is pending, or terminates an operation that is running, in the current
  35 interactive session. It is available only in interactive mode.
  36 If the issuer of the <B>backup (interactive)</B> command included the
  37 <B>-localauth</B> flag, the <B>-cell</B> argument, or both, then those
  38 settings apply to this command also.
  39 <P>To terminate a dump operation, specify either the dump name
  40 (<VAR>volume_set_name</VAR>.<VAR>dump_level_name</VAR>) or its job ID
  41 number, which appears in the output from the <B>(backup) jobs</B>
  42 command. To terminate any other type of operation, provide the job ID
  43 number.
  44 <P>The effect of terminating an operation depends on the type and current
  45 state of the operation:
  46 <UL>
  47 <P><LI>If an operation is still pending, the Tape Coordinator removes it from the
  48 queue with no other lasting effects.
  49 <P><LI>If the Tape Coordinator is unable to process the termination signal before
  50 an operation completes, it simply confirms the operation's
  51 completion. The operator must take the action necessary to undo the
  52 effects of the incorrect operation.
  53 <P><LI>If a tape labeling operation is running, the effect depends on when the
  54 Tape Coordinator receives the termination signal. The labeling
  55 operation is atomic, so it either completes or does not begin at all.
  56 Use the <B>backup readlabel</B> command to determine if the labeling
  57 operation completed, and reissue the <B>backup labeltape</B> command to
  58 overwrite the incorrect label if necessary.
  59 <P><LI>If a tape scanning operation is running, it terminates with no other
  60 effects unless the <B>-dbadd</B> flag was included on the
  61 <B>backup</B> command. In that case, the Backup System possibly has
  62 already written new Backup Database records to represent dumps on the scanned
  63 tape. If planning to restart the scanning operation, first locate and
  64 remove the records created during the terminated operation: a repeated
  65 <B>backup scantape</B> operation exits automatically when it finds that a
  66 record that it needs to create already exists.
  67 <P><LI>If a dump operation is running, all of the volumes written to the tape or
  68 backup data file before the termination signal is received are complete and
  69 usable. If the operation is restarted, the Backup System performs all
  70 the dumps again from scratch, and assigns a new dump ID number. If
  71 writing the new dumps to the same tape or file, the operator must relabel it
  72 first if the interrupted dump is not expired. If writing the new dump
  73 to a different tape or file, the operator can remove the dump record
  74 associated with the interrupted dump to free up space in the database.
  75 <P><LI>If a restore operation is running, completely restored volumes are online
  76 and usable. However, it is unlikely that many volumes are completely
  77 restored, given that complete restoration usually requires data from multiple
  78 tapes. If the termination signal comes before the Backup System has
  79 accessed all of the necessary tapes, each volume is only partially written and
  80 is never brought online. It is best to restart the restore operation
  81 from scratch to avoid possible inconsistencies. See also the
  82 <B>Cautions</B> section.
  83 </UL>
  84 <P><STRONG>Cautions</STRONG>
  85 <P>It is best not to issue the <B>(backup) kill</B> command against
  86 restore operations. If the termination signal interrupts a restore
  87 operation as the Backup System is overwriting an existing volume, it is
  88 possible to lose the volume entirely (that is, to lose both the contents of
  89 the volume as it was before the restore and any data that was restored before
  90 the termination signal arrived). The data being restored still exists
  91 on the tape, but some data can be lost permanently.
  92 <P><STRONG>Options</STRONG>
  93 <DL>
  94 <P><DT><B>-id
  95 </B><DD>Identifies the backup operation to terminate. Provide one of two
  96 types of values:
  97 <UL>
  98 <P><LI>The operation's job ID number, as displayed in the output of the
  99 <B>(backup) jobs</B> command.
 100 <P><LI>For a dump operation, either the job ID number or a dump name of the form
 101 <VAR>volume_set_name</VAR>.<VAR>dump_level_name</VAR>, where
 102 <VAR>volume_set_name</VAR> is the name of the volume set being dumped and
 103 <VAR>dump_level_name</VAR> is the last element in the dump level pathname at
 104 which the volume set is being dumped. The dump name appears in the
 105 output of the <B>(backup) jobs</B> command along with the job ID
 106 number.
 107 </UL>
 108 <P><DT><B>-help
 109 </B><DD>Prints the online help for this command. All other valid options
 110 are ignored.
 111 </DL>
 112 <P><STRONG>Examples</STRONG>
 113 <P>The following command terminates the operation with job ID 5:
 114 <PRE>   backup> <B>kill 5</B>
 115
 116 </PRE>
 117 <P>The following command terminates the dump operation called
 118 <B>user.sunday1</B>:
 119 <PRE>   backup> <B>kill user.sunday1</B>
 120
 121 </PRE>
 122 <P><STRONG>Privilege Required</STRONG>
 123 <P>The issuer must have the privilege required to initiate the operation being
 124 cancelled. Because this command can be issued only within the
 125 interactive session during which the operation was initiated, the required
 126 privilege is essentially guaranteed.
 127 <P><STRONG>Related Information</STRONG>
 128 <P><A HREF="auarf060.htm#HDRBK_INTRO">backup</A>
 129 <P><A HREF="auarf076.htm#HDRBK_INTERACTIVE">backup interactive</A>
 130 <P><A HREF="auarf077.htm#HDRBK_JOBS">backup jobs</A>
 131 <P>
 132 <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="auarf077.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="auarf079.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>
 133 <!-- Begin Footer Records  ========================================== -->
 134 <P><HR><B>
 135 <br>&#169; <A HREF="http://www.ibm.com/">IBM Corporation 2000.</A>  All Rights Reserved
 136 </B>
 137 <!-- End Footer Records  ============================================ -->
 138 <A NAME="Bot_Of_Page"></A>
 139 </BODY></HTML>