Share via


Modify a Job

 

Applies To: Microsoft HPC Pack 2008 R2, Microsoft HPC Pack 2012, Microsoft HPC Pack 2012 R2

In HPC Cluster Manager, you can add tasks and modify some Job properties of jobs in the job queue. You can add tasks to any job except for jobs that are in the Finished state. You can only edit Task properties for tasks that are in the Configuring state.

You can use the following procedure to modify a job using HPC Cluster Manager.

Note

To complete this procedure, you must be the job owner or a cluster administrator.

To modify a job

  1. In the Navigation Pane, click All Jobs.

  2. In the job list, click the job that you want to modify.

  3. Right-click your selection and click Modify Job.

  4. Change the property values as appropriate.

  5. Click Modify to apply the changes. If necessary, requeue your job.

Guidelines for modifying jobs

The following table describes the Job properties that you can modify in each job state:

Job state

Guidelines for modification

Configuring

All properties can be modified.

Queued

All properties can be modified. However, changes to most properties for jobs in this state cause the job to be reconfigured. Reconfiguring a job changes your submit time, which affects your place in the job queue (queue position is determined by priority level and submit time).

The following properties can be changed without affecting the submit time:

  • Priority

  • Notify on start

  • Notify on completion

  • Job environment variables

  • Progress

  • Progress Message

Adding tasks does not affect submit time.

Running

The following properties can be modified:

  • Name

  • Project name

  • Run time (dd:hh:mm)

  • Run until canceled

  • Priority

  • Notify on completion

  • Progress

  • Progress message

  • Excluded nodes

  • Job environment variables

Changes to the job environment variables only apply to tasks that start after the change is made. Changes to the variables do not apply to running tasks.

Canceled and Failed

All job properties can be modified. When you click Modify to apply your changes, the job and all Canceled or Failed tasks in the job move to the Configuring state.

You can submit the job, or re-open the Modify Job dialog box to edit the tasks.

Finished

You cannot modify a Finished job. To run a job again, either as-is, or with changes, see Copy a Job or Task.

Additional considerations

  • You can modify the priority level of submitted jobs to have more control over the order of the job queue. You can specify Priority in terms of a priority band, a priority number, or a combination of the two. The numerical priority can have a value between 0 (Lowest) and 4000 (Highest).

  • You can set a few additional job properties by using HPC Power Shell or at a command prompt window. For example, you can specify nodes to exclude from the job or manually set job progress or a progress message. You cannot set these properties in HPC Job Manager, but you can see their values in the job list by displaying the corresponding columns. For more information, see Set and Clear Excluded Nodes for Jobs and Set the Progress and Progress Message Job Properties.

  • When you copy a job or create a new job from an XML job description file, you can modify any of the job or task properties before submission.

  • For information about using HPC Cluster Manager, see Overview of HPC Cluster Manager.

Additional references