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 ~/cesm1 directory. Use a an 1850 control compset at 1-degree resolution on bluefire.

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

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 ~/cesm1/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).

   > ./create_production_test > cd ../EXAMPLE_CASE_ERT > EXAMPLE_CASE_ERT.build > bsub < EXAMPLE_CASE_ERT.test > 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 -id STOP_OPTION -val nmonths > xmlchange -id STOP_N -val 12 > # use an editor to change EXAMPLE_CASE.run "#BSUB -W 1:30" to "#BSUB -W 6:00" > bsub < EXAMPLE_CASE.run

5. Make sure the run succeeded.

   > grep "SUCCESSFUL TERMINATION" poe.stdout.*

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 -id RESUBMIT -val 10 > bsub < EXAMPLE_CASE.run