跳到主要内容

qhold

介绍​

qhold 命令用于暂停指定作业或任务。可通过作业标识符、用户名或持保留类型选择目标。

参数说明​

可选参数​

参数名称是否必填类型用途
-h <hold_list>否字符串指定持保留类型（如 u, o, s）。
-u <user_list>否字符串根据用户名筛选作业。输入 "*" 表示所有用户，或指定具体用户名（如 userA）。

位置参数​

参数名称是否必填类型用途
job_task_list是（当未使用 -u）列表需要暂停的作业或任务标识符列表。例如：123, task456, userA.789

使用示例​

示例 1: 按作业 ID 暂停​

qhold 123 task456

作用: 暂停作业 123 和任务 task456。

示例 2: 按用户名暂停​

qhold -u userA

作用: 暂停用户 userA 的所有作业。

示例 3: 使用持保留类型（需确认兼容性）​

qhold -h u job101

作用: 尝试按类型 "u" 暂停作业 job101。该功能可能因 FSCHED/SGE 差异受限。

注意事项​

参数约束​

  1. 互斥规则：

    • -u <user_list> 和 job_task_list 不能同时使用。 
      qhold -u userA job101  # 报错！参数冲突 ❌

  2. 必填条件：

    • 必须指定 -u 或 job_task_list 中的至少一项。

  3. 用户筛选限制：

    • 若指定用户名不存在且未输入 "*", 将报错提示作业不存在。

功能差异说明​

SGE 特性当前状态说明
-h <hold_list>部分支持（WIP）映射逻辑可能不完整，需参考 SGE 文档
通知类参数不支持如邮件通知等特性未实现

其他说明​

  • 作业标识符格式：job_task_list 需符合 SGE 的语法规范（如支持通配符或范围表达式）。
  • 若需更详细的持保留类型定义，请参考 SGE 官方文档。