job finish

Finishes a specified running job.

For examples of how to use this command, see Examples.

Syntax

job finish <jobID> [/graceful] [/scheduler:<name>]  
  
job finish [{/? | /help}]  

Parameters

Parameter Description
jobID Specifies the identifier for the job that you want to finish.
/graceful Stops the job gracefully, by letting running tasks complete.

This parameter was introduced in HPC Pack 2012 R2 Update 1 and is not supported in previous versions.
/message:<message> Adds a message to provide to the user about the finished job.

This parameter was introduced in HPC Pack 2012 R2 Update 1 and is not supported in previous versions.
/scheduler:<name> Specifies the host name or IP address of the head node for the cluster to which you submitted the job. The value must be a valid computer name or IP address. If you do not specify the /scheduler parameter, this command uses the scheduler on the head node that the CCP_SCHEDULER environment variable specifies.
/? Displays Help at the command prompt.
/help Displays Help at the command prompt.

Remarks

  • This command is similar to the job cancel command, except that the job has a state of Finished rather than a state of Canceled when the command finishes.

  • Use this command when you want to end a job that has the RunUntilCanceled property set to True, and you want to set the state of the job to Finished because you have an alternate way to check that the job finished.

Examples

To finish the job with a job identifier of 67, use the following command:

job finish 67  

Additional references