提交运行与结果检查

完成 case.setup 和 case.build 后，CESM case 应通过 case.submit 提交运行。CIME 官方文档明确说明，case.submit 是启动 case 的规范入口；即使没有批处理系统，它也会按照交互式运行方式组织命令。

1. 预览运行命令

提交前建议先查看实际运行环境、批处理命令和 MPI 启动命令：

cd $CASEROOT
./preview_run

重点检查：

• 节点数、总 task 数、每节点 task 数和线程数。
• module 加载命令是否符合当前平台。
• 批处理队列、账号、墙钟时间是否正确。
• mpirun、mpiexec 或平台 MPI 启动命令是否符合预期。

2. 设置运行长度

默认测试运行通常较短。提交前可查询：

./xmlquery STOP_OPTION,STOP_N

将运行长度设置为 1 个月：

./xmlchange STOP_OPTION=nmonths,STOP_N=1

如需关闭短期归档以便先在 $RUNDIR 中检查输出：

./xmlchange DOUT_S=FALSE

3. 设置队列参数

常见队列变量包括：

./xmlquery PROJECT,JOB_QUEUE,JOB_WALLCLOCK_TIME

修改墙钟时间：

./xmlchange JOB_WALLCLOCK_TIME=02:00:00

只修改 case.run 子任务的墙钟时间：

./xmlchange JOB_WALLCLOCK_TIME=00:20:00 --subgroup case.run

提交前应确认项目账号、队列名称和时间限制符合平台规则。

4. 提交 case

执行：

./case.submit

case.submit 会加载运行环境、检查锁定文件、生成 namelist、检查输入数据，并提交 case.run 作业。若 $DOUT_S 为 TRUE，成功运行后还会提交短期归档任务 case.st_archive。

5. 查看运行状态

查看 case 操作历史：

cat CaseStatus

查询输出位置：

./xmlquery RUNDIR,CASE,CASEROOT,DOUT_S,DOUT_S_ROOT

运行完成后，优先检查 $RUNDIR 或归档目录中的 cpl.log.*。若日志末尾包含 SUCCESSFUL TERMINATION OF CPL7-cesm，通常可视为本次运行正常结束。

6. 学习提示

提交前建议遵循“先 preview_run，再 case.submit”的顺序。对于国内集群，队列名、项目账号和 walltime 往往是最常见问题；如果提交失败，应先检查批处理系统返回的信息，再回到 CIME 配置中定位变量。

官方参考

• CESM2.2 Quick Start: https://escomp.github.io/CESM/versions/cesm2.2/html/quickstart.html
• CIME Running a Case: https://esmci.github.io/cime/versions/master/html/users_guide/running-a-case.html