BASICS: A basic example

This specifies all the steps necessary to create, set up, build, and run a case. The following assumes that $CCSMROOT is /user/ccsmroot.

1. Create a new case named EXAMPLE_CASE in the ~/cesm directory. Use an 1850 control compset at 1-degree resolution on yellowstone.

   > cd /user/ccsmroot/scripts > ./create_newcase -case ~/cesm/EXAMPLE_CASE \ -compset B_1850_CN \ -res 0.9x1.25_gx1v6 \ -mach yellowstone

2. Go to the $CASEROOT directory. Edit env_mach_pes.xml if a different pe-layout is desired first. Then set up and build the case.

   > cd ~/cesm/EXAMPLE_CASE > ./cesm_setup > ./EXAMPLE_CASE.build

3. Create a production test. Go to the test directory. Build the test first, then run the test and check the TestStatus (the first word should be PASS).

   > cd ~/cesm/EXAMPLE_CASE > ./create_production_test > cd ../EXAMPLE_CASE_ERT > ./EXAMPLE_CASE_ERT.test_build > ./EXAMPLE_CASE_ERT.submit Wait for test to finish..... > cat TestStatus

4. Go back to the case directory, set the job to run 12 model months, use an editor to change the time limit in the run file to accommodate a 12-month run, and submit the job.

   > cd ../EXAMPLE_CASE > xmlchange STOP_OPTION=nmonths > xmlchange STOP_N=12 > # use an editor to change EXAMPLE_CASE.run "#BSUB -W 4:00" to "#BSUB -W 6:00" > ./EXAMPLE_CASE.submit

5. Make sure the run succeeded. Look for the following line at the end of the cpl.log file in your run directory.

   (seq_mct_drv): =============== SUCCESSFUL TERMINATION OF CPL7-CCSM ===============

6. Set it to resubmit itself 10 times so that it will run a total of 11 years (including the initial year), and resubmit the case. (Note that a resubmit will automatically change the run to be a continuation run).

   > xmlchange RESUBMIT=10 > ./EXAMPLE_CASE.submit