A user may place a hold upon any job the user owns. An "operator", who is a user with "operator privilege," may place ether an or an hold on any job. The batch administrator may place any hold on any job.
If no option is given, the USER hold will be applied to the jobs described by the operand list.
If the job identified by 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 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 the requested hold attribute. This will have no effect unless the job is rerun with the qrerun command.
The qhold command sends a Hold Job batch request to the server as described in the general section.
If the qhold command fails to process any operand, the command exits with a value greater than zero.