作业取消
取消指定的正在运行或挂起的作业。
有关如何使用此命令的示例，请参阅 示例。
语法
job cancel <jobID> [/force] [/graceful] [/message:<message>] [/scheduler:<name>]
job cancel {/? | /help}
参数设置
| 参数 | 说明 |
|---|---|
| <jobID> | 指定要取消的作业的标识符。 |
| /力 | 如果作业包含该作业，则立即停止作业，而不对任务取消使用宽限期，并且不运行节点发布任务。 此参数是在 Microsoft HPC Pack 2008 R2 中引入的，在以前的版本中不受支持。 |
| /优美 | 通过让运行任务完成来正常停止作业。 此参数是在 HPC Pack 2012 R2 Update 1 中引入的，在以前的版本中不受支持。 |
| /message：<消息> | 指定一条错误消息，向用户提供该错误消息，说明取消作业的原因。 消息的最大长度为 128 个字符。 |
| /scheduler：<名称> | 为提交作业的群集指定头节点的主机名或 IP 地址。 该值必须是有效的计算机名称或 IP 地址。 如果未指定 /scheduler 参数，此命令将使用CCP_SCHEDULER环境变量指定的头节点上的计划程序。 |
| /? | 在命令提示符处显示帮助。 |
| /帮助 | 在命令提示符处显示帮助。 |
注解
若要取消作业，作业的状态必须是配置、提交、验证、排队或正在运行。
取消作业时，如果作业正在等待运行，HPC 作业计划程序服务将从作业队列中删除作业。
如果作业正在运行，HPC 作业计划程序服务将停止正在运行的任务，并释放他们正在使用的资源，以便将其分配给另一个作业。 HPC 作业计划程序服务还会将正在运行的任务的状态设置为“失败”。
如果再次对作业进行排队，则处理作业中的任务的方式取决于可以取消作业时任务的状态。 取消作业后完成的任务保持完成状态。 在运行之前显式取消且当前处于已取消状态的任务将保持取消状态。 所有其他任务都排队，包括失败的任务。
使用 作业取消 命令取消作业时，作业的状态将更改为“已取消”。 从 HPC Pack 2008 R2 开始，还可以停止作业，并通过调用 作业完成 命令将作业的状态更改为“已完成”。
示例
若要取消作业标识符为 45 的作业，并向用户提供一条取消消息，说明你取消了作业以腾出空间以让其他作业运行，请使用以下命令：
job cancel 45 /message:"Clearing space for job 51, which needs to run immediately."
若要立即取消作业标识符为 469 的作业，而不对任务取消使用宽限期且不运行节点发布任务，请使用以下命令：
job cancel 469 /force
若要正常取消作业标识符为 12，以便运行任务完成，请使用以下命令：
job cancel 12 /graceful