跳到主要内容

qsh

介绍​

qsh 是用于提交作业的命令，支持指定资源、账户及执行环境等参数。它是对SGE qsub 命令的兼容实现，并基于FSCHED系统进行适配。

参数说明​

参数列表​

参数参数类型用途限制/注意事项
-A <account>需值指定作业所属的账户。必须提供有效账户名。
-cwd无参数使用当前目录作为作业工作目录。默认不启用，需显式指定。
-hard无参数后续 -l/-q 参数为硬条件（必须满足）。默认可能设为硬条件；若未指定 -hard/-soft，默认行为由系统决定。
-l <resources>需值请求资源，格式如 mem_free=2G,hostname=node01,num_proc=4。支持选项：内存（mem_free）、主机名（hostname）、处理器数（num_proc）。仅部分资源可用；多参数用逗号分隔。
-M <email>需值设置邮件通知地址。需与 -m 参数配合使用以确定触发条件。
-m <options>需值触发邮件的事件类型（如 b(开始)、e(结束)）。确保系统配置支持邮件功能。
-N <name>需值设置作业名称。默认生成随机名，建议提供有意义的名字。
-now无参数立即执行作业（默认启用）。显式指定可增强配置清晰度。
-p <priority>需值设置优先级（范围：-1023 ~ 1024）。仅管理员可用，普通用户设置无效。
-pe <type> <slots>需两个参数指定并行类型和槽位数，如 mpi 4 或 smp 8。有效类型：mpi, smp.必须同时指定类型及槽数。
-q <queue>需值绑定作业到特定队列（仅支持单个队列）。可能存在限制或不稳定行为。
-soft无参数后续 -l/-q 参数为软条件（尽量满足但可放宽）。默认可能为硬条件；与 -hard 互斥。
-S <interpreter>需值指定脚本解释器路径，如 /bin/bash。路径必须有效且支持shebang语法。
-V无参数导出所有环境变量（默认已启用，无需指定）。禁用此选项无效。
-w <level>需值设置作业验证级别。当前可能不可用或行为不稳定。
-wd <dir>需值指定作业的工作目录路径。与 -cwd 互斥，只能选其一。

使用示例​

  1. 基础提交

    qsh -N "my_analysis" analysis_script.sh

  2. 资源请求与并行任务

    # 请求8核、16GB内存，并使用MPI并行：
    qsh -l "num_proc=8,mem_free=16G" -pe mpi 4 parallel_job.py

  3. 队列绑定与立即执行

    # 绑定到 batch 队列且立即运行：
    qsh -q batch -now my_script.sh

  4. 邮件通知配置

    # 结束时发送邮件至 user@example.com：
    qsh -M user@example.com -m e report_generation.sh

注意事项​

功能限制​

  • -p 参数：仅管理员可设置优先级，普通用户输入无效。
  • -l 资源请求：当前仅支持 mem_free(内存)、hostname(主机名) 和 num_proc(处理器数)，其他资源不可用。
  • -q 队列绑定：需指定单个队列名称，功能处于开发阶段且可能不稳定。

其他说明​

  • 环境导出：-V 参数默认已启用，无需显式添加。
  • 验证级别（-w）与通知参数：当前处于开发状态或未实现，请勿依赖其行为。

不兼容特性​

参数限制说明
-p普通用户无法设置优先级。
-q仅支持单个队列名称，功能受限。
-w功能未稳定实现，请勿使用。
-l资源选项受限于 mem_free, hostname, 和 num_proc。