qrsh
提交交互式作业到FSCHED调度系统。
参数介绍
基础选项
| 选项 | 是否需要值 | 取值范围 | 功能描述 | 主要差异 |
|---|---|---|---|---|
-b | 是 | y/n（不区分大小写） | 将命令作为二进制可执行文件运行 | 无差异 |
-N | 是 | 字符串（不含空格） | 作业名称 | 无差异 |
-cwd | 否 | 无 | 使用当前工作目录 | 无差异 |
-verify | 否 | 无 | 验证模式,不实际提交作业，打印作业属性 | 无差异 |
-@ | 是 | 文件路径 | 从文件读取选项 | 无差异 |
账户与项目
| 选项 | 是否需要值 | 取值范围 | 功能描述 | 主要差异 |
|---|---|---|---|---|
-A | 是 | 账户名称 | 指定账户名称 | 无差异 |
调度与队列
| 选项 | 是否需要值 | 取值范围 | 功能描述 | 主要差异 |
|---|---|---|---|---|
-q | 是 | 队列名称 | 队列名称 | 无差异 |
-h | 否 | 无 | 提交后将作业置于hold状态 | 无差异 |
-masterq | 是 | 队列列表 | 主队列（用于并行作业） | 参数被接受，但无实际功能 |
资源请求
| 选项 | 是否需要值 | 取值范围 | 功能描述 | 主要差异 |
|---|---|---|---|---|
-l | 是 | resource=value,... | 资源需求列表，多个资源用逗号分隔 | 支持mem_free、h_rt、num_proc、hostname，使用时需确认FSCHED 配置 |
-pe | 是 | pe_name n | 并行环境及slots数量，空格分隔 | 无差异 |
优先级
| 选项 | 是否需要值 | 取值范围 | 功能描述 | 主要差异 |
|---|---|---|---|---|
-p | 是 | -1023到1024 | 作业优先级 | 无差异 |
-js | 是 | 非负整数 | 作业份额（job share）。SGE的js越大优先级越高 | 映射为nice值：nice=-(js/10) |
交互式执行控制
| 选项 | 是否需要值 | 取值范围 | 功能描述 | 主要差异 |
|---|---|---|---|---|
-pty | 是 | y/n（默认：无命令=y，有命令=n） | 分配伪终端 | 无差异 |
-inherit | 否 | 无 | 继承已有作业分配 | 需设置SLURM_JOB_ID环境变量（SGE使用JOB_ID） |
-nostdin | 否 | 无 | 不提供标准输入到作业 | 无差异 |
-now | 是 | y/n | 立即运行或失败 | 无差异 |
邮件通知
| 选项 | 是否需要值 | 取值范围 | 功能描述 | 主要差异 |
|---|---|---|---|---|
-m | 是 | b/e/a/s/n的组合 | 邮件通知选项 | 无差异 |
-M | 是 | 邮箱地址 | 邮件接收地址 | 无差异 |
作业依赖
| 选项 | 是否需要值 | 取值范围 | 功能描述 | 主要差异 |
|---|---|---|---|---|
-hold_jid | 是 | job_id,...（逗号分隔） | 指定作业依赖关系，多个ID用逗号分隔 | 仅支持数字job ID，不支持作业名称解析（SGE支持） |
-hold_jid_ad | 是 | job_id,...（逗号分隔） | 指定数组作业依赖关系，多个ID用逗号分隔 | 仅支持数字job ID，不支持作业名称解析（SGE支持） |
环境变量和上下文
| 选项 | 是否需要值 | 取值范围 | 功能描述 | 主要差异 |
|---|---|---|---|---|
-v | 是 | VAR[=value],... | 导出指定环境变量。支持逗号分隔多个变量 | 无差异 |
-V | 否 | 无 | 导出所有环境变量 | 默认传递所有环境变量（相当于默认-V） |
-ac | 是 | var[=value],... | 添加上下文变量 | 存储在作业comment字段,格式：CONTEXT:var=value（不影响调度） |
-dc | 是 | var,... | 删除上下文变量 | 存储在作业comment字段中 |
-sc | 是 | var=value,... | 设置上下文变量（替换所有） | 存储在作业comment字段中 |
资源请求控制
| 选项 | 是否需要值 | 取值范围 | 功能描述 | 主要差异 |
|---|---|---|---|---|
-hard | 否 | 无 | 硬性资源请求模式。后续-l和-q选项会被解析 | 无差异（默认为hard模式） |
-soft | 否 | 无 | 软资源请求（尽量满足但不强制） | 后续-l和-q选项会被忽略 |
作业执行控制
| 选项 | 是否需要值 | 取值范围 | 功能描述 | 主要差异 |
|---|---|---|---|---|
-wd | 是 | 目录路径 | 工作目录。支持相对路径和绝对路径 | 无差异 |
-w | 是 | e/w/n/v/p | 验证选项 | v等同于-verify |
-notify | 否 | 无 | 在终止/暂停前通知作业 | 参数被接受，但无实际功能 |
-noshell | 否 | 无 | 不使用shell包装 | 参数被接受，但无实际功能 |
其它选项
| 选项 | 是否需要值 | 取值范围 | 功能描述 | 主要差异 |
|---|---|---|---|---|
--help | 否 | 无 | 显示帮助信息 | 无差异 |
--version | 否 | 无 | 显示版本信息 | 无差异 |
使用示例
示例1：基础交互式作业
qrsh -N myjob hostname
- 效果：提交交互式作业并获取主机名。
示例2：指定资源需求
qrsh -l num_proc=4,mem_free=8G my_program
- 效果：要求4核CPU和8GB内存。
- 说明：多个资源用逗号分隔。
示例3：不分配伪终端
qrsh -pty n hostname
- 效果：不分配PTY。
示例4：继承已有作业
qrsh -inherit node01 hostname
- 效果：在已有作业分配的节点上执行命令。
- 要求：必须在已有作业内执行。
示例5：设置作业依赖
qrsh -hold_jid 12345,12346 my_script.sh
- 效果：等待作业ID=12345和12346都完成后执行。
示例6：设置作业hold
qrsh -h myjob.sh
- 效果：提交后作业处于hold状态，需要手动释放。
示例7：验证模式
qrsh -verify -N testjob -l num_proc=4 hostname
- 效果：验证作业配置，打印作业属性但不实际提交。
示例8：设置环境变量
qrsh -v DEBUG=1,WORKERS=4 python script.py
- 效果：导出环境变量到作业。
示例9：从文件读取选项
qrsh -@ options.txt myscript.sh
- 效果：从文件读取选项配置。
示例10：使用上下文变量
qrsh -ac PROJECT=myproj -ac ENV=dev hostname
- 效果：添加上下文变量，存储在作业comment中。
示例11：指定工作目录
qrsh -wd /scratch/user/workdir ./myjob.sh
- 效果：在指定目录下执行作业。