Job Submission in Windows HPC Server 2008 Quick Reference

Job Submission Quick Reference

Collapse All

Updated: January 7, 2009

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