Administration Reference


[Return to Library] [Contents] [Previous Topic] [Bottom of Topic] [Next Topic] [Index]

backup kill

Purpose

Terminates a pending or running operation

Synopsis

kill -id <job ID or dump set name> [-help]
  
k -i <job ID or dump set name>  [-h]

Description

The (backup) kill command dequeues a Backup System operation that is pending, or terminates an operation that is running, in the current interactive session. It is available only in interactive mode. If the issuer of the backup (interactive) command included the -localauth flag, the -cell argument, or both, then those settings apply to this command also.

To terminate a dump operation, specify either the dump name (volume_set_name.dump_level_name) or its job ID number, which appears in the output from the (backup) jobs command. To terminate any other type of operation, provide the job ID number.

The effect of terminating an operation depends on the type and current state of the operation:

Cautions

It is best not to issue the (backup) kill command against restore operations. If the termination signal interrupts a restore operation as the Backup System is overwriting an existing volume, it is possible to lose the volume entirely (that is, to lose both the contents of the volume as it was before the restore and any data that was restored before the termination signal arrived). The data being restored still exists on the tape, but some data can be lost permanently.

Options

-id
Identifies the backup operation to terminate. Provide one of two types of values:

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

Examples

The following command terminates the operation with job ID 5:

   backup> kill 5
   

The following command terminates the dump operation called user.sunday1:

   backup> kill user.sunday1
   

Privilege Required

The issuer must have the privilege required to initiate the operation being cancelled. Because this command can be issued only within the interactive session during which the operation was initiated, the required privilege is essentially guaranteed.

Related Information

backup

backup interactive

backup jobs


[Return to Library] [Contents] [Previous Topic] [Top of Topic] [Next Topic] [Index]



© IBM Corporation 2000. All Rights Reserved