跳到主要内容

qrsh

介绍​

qrsh 是 FSCHED 系统中替代 SGE 的交互式作业启动命令，用于提交并行或资源受限的任务。它支持核心参数配置环境、资源及作业行为。

参数说明​

支持的参数​

参数类型/取值范围描述
-A账户名称（字符串）指定作业使用的账户。
-by/n（不区分大小写）控制是否直接执行二进制命令，默认值为 yes。
-cwd无使用当前工作目录作为作业运行路径。
-hard无后续的 -l/-q 参数为硬约束，必须满足资源或队列条件。
-M邮箱地址（字符串）设置接收邮件通知的目标邮箱。
-mb/e/a（字符组合）指定邮件触发时机：b(开始)、e(结束)、a(始终)。需与 -M 配合使用。
-N作业名称（字符串）自定义作业标识名，不可含空格或特殊字符。
-now默认启用立即启动作业，默认行为无需显式指定。
-pempi/smp +槽数量定义并行环境及槽数（如：-pe smp 4）。有效类型仅支持 mpi 和 smp。
-soft无后续的 -l/-q 参数为软约束，允许资源调整或降级。
-v"VAR=value" 格式设置环境变量（需单独指定多个参数）。例如：-v "PATH=/new/path"。
-wd路径字符串强制设置作业的工作目录，覆盖 -cwd 的默认行为。

不支持或受限的参数​

无效参数​

以下选项在 FSCHED 中无法工作：

  • -notify, -noshell, -nostdin: 系统忽略这些选项。

功能受限参数​

参数限制说明
-h/-hold_jid/-pty尚未实现作业保留或依赖关系功能。
-l支持 num_proc, mem_free, hostname，但资源分配逻辑可能不完整。
-q仅支持单个队列名称，且实际调度行为与 SGE 不完全一致。

使用示例​

示例1：设置并行环境和邮件通知​

qrsh -pe smp 4 -M user@example.com -m e my_script.sh

启动使用 smp 并行环境的作业，结束后向指定邮箱发送通知。

示例2：强制硬约束资源​

qrsh -hard -l "num_proc=8,mem_free=16G" my_program --arg1

要求 8 核 CPU 和 16GB 内存（必须满足）。

示例3：设置环境变量​

qrsh -v "DEBUG=1" python my_script.py

执行脚本前启用 DEBUG 环境变量。

注意事项​

  1. 默认行为：
    • -b 默认为 yes，直接运行二进制文件。
    • -now 自动触发作业立即启动。
  2. 资源限制：
    • 使用 -l/-q 时，需确认 FSCHED 配置与参数兼容性。
  3. 环境导出：
    • 所有环境变量默认继承（无需 -V 参数）。