11 Glossary

• archive - a phase of the CCSM production process in which model output is moved from the executable directory to a local disk before being saved to the local long-term storage system. This encompasses both short and long term archiving. See also ccsm_archive or l_archive.
• ARCH - machine architecture, set in env_mach.
• BATCH - machine batch system, set in env_mach.
• branch - a specific RUN_TYPE that starts the model from a complete restart set from a previous run.
• build script - The C-shell scripts which builds the CCSM. In the CCSM3 distribution, this script is created by configure for a specific machine.
• CASE - experiment or case name.
• ccsm_archive - a script that carries out short term archiving of model output. See also archive.
• CASEROOT - full path to the scripts directory (often this is $CCSMROOT/scripts/$CASE).
• CCSMROOT - full path to the top directory of the source code release.
• COMP_ - Defines a specific CCSM component. There are five CCSM components, ATM, LND, ICE, OCN, CPL which are set in env_conf. This parameter is resolved in CCSM script generation.
• component - Each CCSM model (except for the coupler) is represented by at least three CCSM components. The CCSM components are are cam, latm, datm, xatm, clm, dlnd, xlnd, csim, dice, xice, pop, docn, xocn, cpl.
• component set - A unique set of CCSM3 component combinations. Often designated by a single letter like A, B, F, G, M, or X.
• CONTINUE_RUN - Sets the run type. A run is either a continue run or it will be a RUN_TYPE run. See RUN_TYPE
• Delay Mode - Runs of CCSM where the ocean model starts on the second day of the run. This is the default way of starting up for startup and hybrid runs.
• DIN_LOC_ROOT - full path to the inputdata directory.
• DOUT_S - logical that turns on short term archiving.
• DOUT_S_ROOT - full path to the short term archival directory. See also archive and ccsm_archive.
• DOUT_L - logical that turns on long term archiving.
• DOUT_S_ROOT - full path to the long term archival directory on the mass store.
• EXEROOT - full path to the top directory where CCSM is going to run.
• GRID - overall CCSM grid combination. Set in env_conf. GRID is a resolved parameter in script generation.
• hybrid - a specific RUN_TYPE that starts the model from restart and initial datafiles from previous runs (hybrid mode). Can also refer to combined MPI/OpenMP parallelization paradigm (hybrid parallel).
• l_archive - See l_archive script.
• l_archive script - the long term archiver script. a phase of the CCSM production process in which model output is moved from local disk to the local long-term storage system. The l_archive is $CASE.$MACH.l_archive.
• MACH - machine name, typically blackforest, seaborg, moon, etc.
• model - There are are five in CCSM3: atmosphere, land, sea-ice, ocean, and coupler. See also component. See also component or component set.
• NTASK_ - the number of MPI tasks for each model, set in the env_mach script.
• NTHRD_ - the number of OpenMP threads for each MPI task for each model. Set in the env_mach script.
• OS - local operating system, typically AIX, IRIX64, etc.
• resolution - The grid, see also GRID
• resolved scripts - Scripts that are generated for a specific configuration. Configuration settings that are resolved include resolution (grid), components, RUN_TYPE, and machine. If any of these items is changed, new scripts must be generated.
• RESUBMIT - an integer flag in env_run. If it's greater than zero, the run will be resubmitted after completion and the flag will be decremented.
• RUN_TYPE - Sets the initialization type for the given case. This variable should not be confused with CONTINUE_RUN which is a flag which determines whether the given case is restarted or not. This is set in env_conf and is a resolved variable in the generation of scripts. RUN_TYPE can have values of STARTUP, BRANCH, or HYBRID. The initial run is executed when CONTINUE_RUN is FALSE. If CONTINUE_RUN is TRUE, then the run operates in continue mode. See CONTINUE_RUN.
• run script - The C-shell scripts which runs the CCSM. In the CCSM3 distribution, this script is created by configure for a specific machine.
• sandbox - A users working directory. This term is typically used when referring to a users local copy of a version of CCSM under development. A shared source code area is NOT a sandbox.
• script or scripts - The term script refers to two different things in CCSM. First, there are scripts that are used to generate files that will run CCSM. These are things like create_newcase, configure, and files that exist in the ccsm_utils directory. Second, scripts also refer to the files that build, run, and archive CCSM. These are also called run scripts. Those files are usually named $CASE.$MACH.[build/run/l_archive] In the most sense, CCSM scripts generate CCSM run scripts.
• script or scripts directory - The directory named scripts in the ccsm3 directory. Scripts required to create a CCSM3 case are here. Typically, CCSM3 run scripts and cases are also located in this directory.
• SITE - location, typically NCAR, LANL, ORNL, NERSC, etc. The env_mach script sets this automatically.
• startup - a specific RUN_TYPE that starts the model from some arbitrary initial conditions.