INTERRUPT JOB (Interrupt a job for copying a retention set to tape)

Use this command to interrupt a job to copy a retention set to tape storage. You can interrupt jobs that are in RUNNING or SLEEPING states. Under certain error conditions, the server can automatically change the status of a job to INTERRUPTED also.

When an INTERRUPT JOB command is issued while a job is running, the job status changes to INTERRUPTING. The job remains in this state until all associated copy-to-tape processes stop. At this point, the state of the job changes to INTERRUPTED.
Tip: To view all copy-to-tape jobs that are in the INTERRUPTED state, you can issue the QUERY JOB command and specify STATUS=INTERRUPTED.
Restrictions:
  • While a job is in an INTERRUPTING state, you cannot issue the INTERRUPT JOB command (or the TERMINATE JOB command) for the same job. These commands will not be processed and an error message is issued to indicate that the job is already being interrupted.
  • To view the status of copy-to-tape jobs, you can issue the QUERY JOB command and specify the STATUS parameter. To view jobs that are in an INTERRUPTING state, you must specify STATUS=RUNNING. By specifying the STATUS=RUNNING parameter setting, all jobs that are in RUNNING, INTERRUPTING, and TERMINATING states are displayed.

Privilege class

Any administrator can issue this command.

Syntax

Read syntax diagramSkip visual syntax diagram INTERRupt JOb job_id

Parameters

job_id (Required)
Specifies the ID of the running or sleeping job that you want to interrupt. The job ID is a unique number that is automatically assigned when the job starts. To obtain the job ID, use the QUERY JOB command.

Example: Interrupt a retention job

JOB 82 was started to copy a retention set to tape storage. You want to interrupt the job to address a recoverable error.
interrupt job 82

Related commands

Table 1. Commands related to INTERRUPT JOB
Command Description
QUERY JOB Displays information about a retention job.
RESUME JOB Resumes an interrupted job.
TERMINATE JOB Terminates a job in an interrupted or sleeping state.