qhold

(hold job)

Synopsis

qhold [{-h <HOLD LIST>}] <JOBID>[ <JOBID>] ...

Overview

The qhold command requests holds to be placed on a job.

Format

Name	Format	Default	Description	Example
-h	<STRING> (type of hold)	USER	Defines the types of holds to be placed on jobs. The hold_list option argument is a string consisting of one or more of the letters "u", "o", and "s" in any combination. The hold type associated with each letter is u - USER, o - OTHER, s - SYSTEM	`qhold -h u 15406`

Command Details

A job that has a hold is not eligible for execution. qhold may be used by any user to place a USER hold on their own jobs. Operators may use qhold to place either USER or OTHER holds on jobs. Managers may use qhold to place any hold on any job.

If the job identified by job_identifier is in the queued, held, or waiting states, then all that occurs is that the hold type is added to the job. The job is then placed into the held state if it resides in an execution queue.

If the job is in running state, then the following additional action is taken to interrupt the execution of the job. If checkpoint / restart is supported by the host system, requesting a hold on a running job will (1) cause the job to be checkpointed, (2) the resources assigned to the job will be released, and (3) the job is placed in the held state in the execution queue.

If checkpoint / restart is not supported, qhold will only set the requested hold attribute. This will have no effect unless the job is rerun with the qrerun command.

Examples

> qhold -h u 3233     place user hold on job 3233