Case Submit

Contents

Case Submit#

After a new case is built, the tool that submits the experiment to start it running is case.submit. This tool is located in the $CASEROOT directory.

Running this script results in the following actions:

  • Checking archive and run options

  • Checking in namelists that need to be rebuilt

  • Checking input data

  • Submitting the case.run script to the NCAR HPC batch job scheduler

  • Submitting the case.st_archive script to archive the model output. This step is dependent on the successful completion of case.run

CESM case.submit

Figure: Detailed view of the location of case.submit

For the current tutorial on Derecho, the paths are:

  • $SRCROOT = /glade/u/home/$USER/code/my_cesm_code

  • $CASEROOT = /glade/u/home/$USER/cases/$CASE

  • $CIME_OUTPUT_ROOT = /glade/derecho/scratch/$USER

  • $EXEROOT =/glade/derecho/scratch/$USER/$CASE/bld

  • $RUNDIR =/glade/derecho/scratch/$USER/$CASE/run

Command Syntax#

You should still be in the CASEROOT directory after running case.build

cd /glade/u/home/$USER/cases/CASE

Example case.submit command: 

./case.submit

NOTE: Do not enter the example above at the command line. You will create your first case in the Exercise at the end of this section.

Click here for example output 
  2026-06-30 21:32:46 atm 
Create namelist for component cam
   Calling /glade/u/home/$USER/my_cesm_code/components/cam//cime_config/buildnml
CAM namelist copy: file1 /glade/u/home/$USER/cases/b1850.basics/Buildconf/camconf/atm_in file2 /glade/derecho/scratch/$USER/b1850.basics/run/atm_in 
  2026-06-30 21:32:49 lnd 
Create namelist for component clm
   Calling /glade/u/home/$USER/my_cesm_code/components/clm//cime_config/buildnml
  2026-06-30 21:32:50 ice 
Create namelist for component cice
   Calling /glade/u/home/$USER/my_cesm_code/components/cice//cime_config/buildnml
RUN: /glade/u/home/$USER/my_cesm_code/components/cice/bld/generate_cice_decomp.pl -ccsmroot /glade/u/home/$USER/my_cesm_code -res tx2_0v1 -nx 180 -ny 128 -nproc 256 -thrds 1 -output all 
FROM: /glade/u/home/$USER/cases/b1850.basics
  output: 180 128 5 4 5 sectrobin square-ice

  2026-06-30 21:32:51 ocn 
Create namelist for component mom
   Calling /glade/u/home/$USER/my_cesm_code/components/mom//cime_config/buildnml
  2026-06-30 21:32:52 rof 
Create namelist for component mosart
   Calling /glade/u/home/$USER/my_cesm_code/components/mosart//cime_config/buildnml
  2026-06-30 21:32:52 glc 
Create namelist for component dglc
   Calling /glade/u/home/$USER/my_cesm_code/components/cdeps/dglc/cime_config/buildnml
  2026-06-30 21:32:52 wav 
Create namelist for component ww3
   Calling /glade/u/home/$USER/my_cesm_code/components/ww3//cime_config/buildnml
   Running /glade/u/home/$USER/my_cesm_code/components/ww3//cime_config/buildnml 
  2026-06-30 21:33:04 esp 
Create namelist for component sesp
   Calling /glade/u/home/$USER/my_cesm_code/cime/CIME/non_py/src/components/stub_comps_nuopc/sesp/cime_config/buildnml
  2026-06-30 21:33:04 cpl 
Create namelist for component drv
   Calling /glade/u/home/$USER/my_cesm_code/components/cmeps/cime_config/buildnml
Writing nuopc_runconfig for components ['CPL', 'ATM', 'LND', 'ICE', 'OCN', 'ROF', 'GLC', 'WAV']
Checking that inputdata is available as part of case submission
Loading input file list: 'Buildconf/ctsm.input_data_list'
Loading input file list: 'Buildconf/cpl.input_data_list'
Loading input file list: 'Buildconf/mom.input_data_list'
Loading input file list: 'Buildconf/ww3.input_data_list'
Loading input file list: 'Buildconf/cice.input_data_list'
Loading input file list: 'Buildconf/mosart.input_data_list'
Loading input file list: 'Buildconf/cam.input_data_list'
Loading input file list: 'Buildconf/dglc.input_data_list'
Check case OK
submit_jobs case.run
Submit job case.run
Submitting job script qsub -q main -l walltime=12:00:00 -A P93300606 -l job_priority=regular -v ARGS_FOR_SCRIPT='--resubmit' /glade/u/home/$USER/cases/b1850.basics/.case.run
Submitted job id is 6606898.desched1
Submit job case.st_archive
Submitting job script qsub -q develop -l walltime=00:20:00 -A P93300606 -l job_priority=regular  -W depend=afterok:6606898.desched1 -v ARGS_FOR_SCRIPT='--resubmit' /glade/u/home/$USER/cases/b1850.basics/case.st_archive
Submitted job id is 6606899.desched1
Submitted job case.run with id 6606898.desched1
Submitted job case.st_archive with id 6606899.desched1

Notes:

  • case.submit coordinates all the tasks of running CESM.

  • case.run is submitted to the batch job scheduler by case.submit. Do not try to submit case.run separately.

  • CESM runs in the Build/Run Directory.

  • case.st_archive moves the history files to the archive directory and runs only after case.run completes successfully. If a model run was unsuccessful, the output remains in the Run Directory.

Contents