Job Submission in Windows HPC Server 2008 Quick Reference

Applies To: Windows HPC Server 2008

This topic provides a quick reference for common job submission and job management actions. The tables below provide links to help topics for performing these actions using the three primary job submission interfaces in Windows® HPC Server 2008: HPC Job Manager, the Command Prompt window, and HPC PowerShell.

Looking for the Windows HPC 2008 R2 quick reference? See Job Submission in Windows HPC Server 2008 R2 Quick Reference.

To walk through an example job submission, with instructions for the three primary job submission interfaces, see the Submitting Jobs in Windows HPC Server 2008 Step-by-Step Guide. The guide includes steps for creating a job with a parametric sweep task, and steps for checking the status of your job.

Submit jobs

To submit a job, you must have been added as a user on the cluster, or you must be a member of a domain group that has been added as a user on the cluster. For more information, contact your cluster administrator.

Action HPC Job Manager Command-prompt window HPC PowerShell

Create and submit a job

Create a New Job

job new

job add

job submit

New-HpcJob

Add-HpcTask

Submit-HpcJob

Quickly submit a single-task job

Create a Single-Task or MPI Job

Create a Parametric Sweep Job

job submit

Include the parameter:

<command> [<arguments>]

Not available

Add an MPI task

Add an MPI Task

job add

Include the launcher mpiexec in the command line of the task.

Add-HpcTask

Include the launcher mpiexec in the -CommandLine parameter.

Add a parametric task

Add a Parametric Task

job add

Include the parameter:

/parametric:<index_specification>

Add-HpcTask

Include the parameters:

-Parametric

-Start <int>

-End <int>

-Increment <int>

Define task dependencies

Define Task Dependencies

job add

Include the parameter:

/depend:<task_name>

Add-HpcTask

Include the parameter:

-Depend <string[]>

Manage your jobs

To copy, save, cancel, requeue, or modify a job, or to view job or task details and results, you must be the submitting user (the job owner), or have administrative rights.

Actions HPC Job Manager Command-prompt window HPC PowerShell

View job properties and results

View a Job or Task

job view

Get-HpcJob

Use with fl (Format-List). For example:

get-hpcjob –id 30|fl

View task properties and results

View a Job or Task

task view

Get-HpcTask

Use with fl (Format-List). For example:

get-hpctask –jobid 30 –taskid 1|fl

Track the state of your jobs

Track Job State

job list

Get-HpcJob

Save a job to an XML description file

Save a Job or Task to a File

Not available

Export-HpcJob

Save a task to an XML description file

Save a Job or Task to a File

Not available

Export-HpcTask

Requeue a canceled or failed job

Requeue a Job or Task

job requeue

Submit-HpcJob

Include the job ID of the job to requeue.

Requeue a task

Requeue a Job or Task

task requeue

Get-HpcTask

Use the Requeue method of the HPCTask object. For example:

(get-hpctask –jobid 30 –taskid 1).requeue()

Copy a job

Copy a Job or Task

job clone

Get-HpcJob

New-HpcJob

For example:

get-hpcjob –id 27|new-hpcjob

Copy a task

Copy a Job or Task

Not available

Not available

Cancel a job

Cancel a Job or Task

job cancel

Stop-HpcJob

Cancel a task

Cancel a Job or Task

task cancel

Get-HpcTask

Use the Cancel method of the HPCTask object. For example:

(get-hpctask –jobid 30 –taskid 1).cancel()

Modify a job

Modify a Job

job modify

Set-HpcJob

Additional references