NAME

backup_kill - Terminates a pending or running operation

SYNOPSIS

backup kill -id <job ID or dump set name> [-help]

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 <job ID or dump set name>

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.

SEE ALSO

backup(8), backup_interactive(8), backup_jobs(8)

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.

ACKNOWLEDGEMENTS

"AFS" is a registered mark of International Business Machines Corporation, used under license. (USPTO Registration 1598389)

"OpenAFS" is a registered mark of International Business Machines Corporation. (USPTO Registration 4577045)

The "AuriStor" name, log 'S' brand mark, and icon are registered marks of AuriStor, Inc. (USPTO Registrations 4849419, 4849421, and 4928460) (EUIPO Registration 015539653).

"Your File System" is a registered mark of AuriStor, Inc. (USPTO Registrations 4801402 and 4849418).

"YFS" and "AuriStor File System" are trademarks of AuriStor, Inc.