跳到主要内容

qsh

提交X-windows交互式会话作业到FSCHED调度系统。

参数介绍​

基础选项​

选项是否需要值取值范围功能描述主要差异
-N是字符串（不含空格）作业名称默认为INTERACTIVE
-cwd否无使用当前工作目录无差异
-verify否无验证模式,不实际提交作业，打印作业属性无差异
-@是文件路径从文件读取选项无差异

账户与项目​

选项是否需要值取值范围功能描述主要差异
-A是账户名称指定账户名称无差异

调度与队列​

选项是否需要值取值范围功能描述主要差异
-q是队列名称队列名称仅支持单个队列
-masterq是队列列表主队列（用于并行作业）参数被接受，但无实际功能

资源请求​

选项是否需要值取值范围功能描述主要差异
-l是resource=value,...资源需求列表，多个资源用逗号分隔支持mem_free、h_rt、num_proc、hostname，使用时需确认FSCHED 配置
-pe是pe_name n并行环境及slots数量，空格分隔无差异
-hard否无硬性资源请求模式。后续-l和-q选项会被解析无差异（默认为hard模式）
-soft否无软资源请求（尽量满足但不强制）后续-l和-q选项会被忽略

优先级​

选项是否需要值取值范围功能描述主要差异
-p是-1023到1024作业优先级仅管理员可用，普通用户设置无效
-js是非负整数作业份额（job share）映射为nice值：nice=-(js/10)

交互式执行控制​

选项是否需要值取值范围功能描述主要差异
-now是y/n立即运行或失败无差异
-display是host:displayX-windows显示位置（必须包含主机名）无差异
-verbose否无详细输出参数被接受，但无实际功能（qsh默认详细输出）

邮件通知​

选项是否需要值取值范围功能描述主要差异
-m是b/e/a/s/n的组合邮件通知选项无差异
-M是邮箱地址邮件接收地址无差异

环境变量和上下文​

选项是否需要值取值范围功能描述主要差异
-v是VAR[=value],...导出指定环境变量。支持逗号分隔多个变量无差异
-V否无导出所有环境变量默认传递所有环境变量（相当于默认-V）
-ac是var[=value],...添加上下文变量存储在作业comment字段,格式：CONTEXT:var=value（不影响调度）
-dc是var,...删除上下文变量存储在作业comment字段中
-sc是var=value,...设置上下文变量（替换所有）存储在作业comment字段中

作业执行控制​

选项是否需要值取值范围功能描述主要差异
-wd是目录路径工作目录。支持相对路径和绝对路径无差异
-S是解释器路径指定shell解释器无差异
-w是e/w/n/v/p验证选项v等同于-verify

其它选项​

选项是否需要值取值范围功能描述主要差异
--help否无显示帮助信息原生qsh不支持
--version否无显示版本信息原生qsh不支持

使用示例​

示例1：基础会话​

qsh -N my_xsession
  • 效果：提交交互式X-windows会话作业，启动xterm。
  • 说明：qsh不接受命令参数，只启动xterm。

示例2：指定资源需求​

qsh -l h_rt=3600,mem_free=8G,num_proc=4 -pe mpi 4
  • 效果：要求4核CPU、8GB内存、1小时运行时间。
  • 说明：多个资源用逗号分隔。

示例3：指定队列和账户​

qsh -q gpu.q -A myproject
  • 效果：在gpu队列上提交作业，账户为myproject。

示例4：立即执行​

qsh -now y -N urgent_session
  • 效果：立即运行或失败，不排队等待。

示例5：验证模式​

qsh -verify -N testjob -l mem_free=4G
  • 效果：验证作业配置，打印作业属性但不实际提交。

示例6：设置环境变量​

qsh -v DISPLAY=host:0,TERM=xterm
  • 效果：导出环境变量到作业。

示例7：从文件读取选项​

qsh -@ options.txt
  • 效果：从文件读取选项配置。

示例8：使用上下文变量​

qsh -ac PROJECT=myproj -ac ENV=dev
  • 效果：添加上下文变量，存储在作业comment中。

示例9：指定工作目录​

qsh -wd /scratch/user/workdir
  • 效果：在指定目录下执行作业。