Using and Administering

llhold - Hold or Release a Submitted Job

Purpose

Places jobs in user hold or system hold and releases jobs from both types of hold. Users can only move their own jobs into and out of user hold. Only LoadLeveler administrators can move jobs into and release them from system hold.

Syntax

llhold [-?] [-H] [-v] [-q] [-s] [-r] [-u userlist] [-h hostlist] [joblist]

Flags

-?

Provides a short usage message.

-H

Provides extended help information.

-v

Outputs the name of the command, release number, service level, service level date, and operating system used to build the command.

-q

Specifies quiet mode: print no messages other than error messages.

-s

Puts job(s) in system hold. Only a LoadLeveler administrator can use this option.

If neither -s nor -r is specified, LoadLeveler puts the job(s) in user hold.

-r

Releases a job from hold. A job in user hold is released unless it is also in system hold, where it remains. A job in system hold is released unless it is also in user hold, where it remains.

Only a LoadLeveler administrator can release jobs from system hold. Only an administrator or the owner of a job can release it from user hold.

If neither -s nor -r is specified, LoadLeveler puts the job(s) in user hold.

-u userlist

Is a blank-delimited list of users. When used with the -h option, only the user's jobs monitored on the machines in the hostlist are held or released. When used alone, only the user's jobs monitored on the schedd machine are held or released.

-h hostlist

Is a blank-delimited list of machine names. All jobs monitored on machines in this list are held or released. When issued with the -u option, the userlist is used to further select jobs for holding or releasing.

When issued by a non-administrator, this option only acts upon jobs that user has submitted to the machines in hostlist.

When issued by an administrator, all jobs monitored on the machines are acted upon unless the -u option is also used. In that case, the userlist is also part of the selection process, and only jobs both submitted by users in userlist and monitored on the machines in the hostlist are acted upon.

joblist

Is a blank-delimited list of jobs of the form host.jobid.stepid where:

• host is the name of the machine to which the job was submitted (delimited by dot). The default is the local machine.

  If the job was submitted from a submit-only machine, this is the name of the schedd machine that sent the job to the negotiator.

• jobid is the job ID assigned to the job when it was submitted using the llsubmit command. jobid is required.
• stepid (delimited by dot) is the step ID assigned to the job by LoadLeveler when it was submitted using the llsubmit command. The default is to include all steps of the job.

Description

This command does not affect a job step that is running unless the job step attempts to enter the Idle state. At this point, the job step is placed in the Hold state.

To ensure a job is released from both system hold and user hold, the administrator must issue the command with -r specified to release it from system hold. The administrator or the submitting user can reissue the command to release the job from user hold.

This command will fail if:

• a non-administrator attempts to move a job into or out of system hold.
• a non-administrator attempts to move a job submitted by someone else into or out of user hold.

Examples

This example places job 23, job step 0 and job 19, job step 1 on hold:

llhold 23.0 19.1

This example releases job 23, job step 0, job 19, job step 1, and job 20, job step 3 fron a hold state:

llhold -r 23.0 19.1 20.3

This example places all jobs from users abe, barbara, and carol2 in system hold:

llhold -s -u abe barbara carol2

This example releases from a hold state all jobs on machines bronze, iron, and steel:

llhold -r -h bronze iron steel

This example releases from a hold state all jobs on machines bronze, iron, and steel that smith submitted:

llhold -r -u smith -h bronze iron steel

Results

The following shows a sample system response for the llhold -r -h bronze command:

llhold: Hold command has been sent to the central manager.