The following describes many of the files and directories in the $CASEROOT directory.
is the directory where the buildnml and buildexe component scripts are generated by configure. The input_data_list files are also generated by configure or the buildnml scripts and copied here.
is a directory where copies of the latest namelist/text input files from the $RUNDIR are stored. These exist only to help document the case setup and run.
is the directory that holds copies of the locked files.
is a directory where previous case configurations are stored. In other words, when configure -clean is run, the current configured scripts are copied into this directory, so when configure -case is subsequently run, there is an opportunity to review and compare previous setups.
is the Makefile Macros file for the current configuration. The Makefile is located in the Tools directory and is identical on all machines. The Macros file is a machine and compiler dependent file. This file is locked during the build step.
provides a summary of the commands used to generate this case.
contains directories for each component where case specific source code modifications can be included. The source files in these directories will always be used in preference to the source code in CCSMROOT. This feature allows users to modify CCSM source code on a case by case basis if that preferable over making modifications in the CCSMROOT sandbox.
is the script that is run interactively to build the CCSM model.
is the script that cleans the CCSM build.
is the script that is submitted to the batch queue to archive CCSM data to the long-term archive disk, like an hpss or mass storage system.
is the script that is submitted to the batch queue to run a CCSM job. This script could also be run interactively if resources allow.
is a tool that checks for missing input datasets and provides a capability for exporting them to local disk.
is the script that is run to generate files in Buildconf and the build and run scripts for a case.
is a tool that generates an exact restart test in a separate directory based on the current case.
contain variables used to setup, configure, build, and run CCSM.
is a directory that contains a copy of the component log files from successful case runs.
is a directory that contains timing output from each successful case run.
is a script that supports changing xml variables in the env files.
contains many scripts that are used to setup and configure the CCSM model as well as run it. Some of particular note are
Makefile is the Makefile that will be used for the build.
Templates is a directory that contains all the component template files used during the configure phase to generate buildnml and buildexe scripts in the $CASEROOT/Buildconf directory.
ccsm_buildexe.csh is invoked by $CASEROOT/$CASE.$MACH.build to generate the model executable. This script calls the component buildexe scripts in Buildconf.
ccsm_buildnml.csh is invoked by $CASEROOT/$CASE.$MACH.build to generate the component namelists in $RUNROOT. This script calls the component buildnml scripts in Buildconf.
ccsm_check_lockedfiles checks that any files in the $CASEROOT/LockedFiles/ directory match those in the $CASEROOT directory. This helps protect users from overwriting variables that should not be changed.
ccsm_getenv converts the xml variables in $CASEROOT to csh environmental variables.
ccsm_l_archive.csh is the script that does long-term archiving of model data as part of the $CASE.$MACH.l_archive batch job.
ccsm_postrun.csh may run the short & long-term archivers, resubmit the run script, and run the timing script.
ccsm_prestage.csh checks that required input datasets are available.
generate_batch.csh is the script that generates resolved run and long-term archiving batch scripts by configure.
generate_resolved.csh generates resolved buildnml and buildexe scripts in the $CASEROOT/Buildconf directory for model components.
getTiming.csh generates the timing information.
getTiming.pl generates timing information and is used by getTiming.csh.
mkDepends generates Makefile dependencies in a form suitable for inclusion into a Makefile.
perf_summary.pl generates timing information.
st_archive.sh is the short-term archive script. It moves model output out of run directory to the short-term archive directory. Associated with DOUT_S and DOUT_S_ROOT env variables in env_run.xml.
taskmaker.pl derives pe counts and task and thread geometry info based on env var values set in the env_mach_pes file.
xml2env converts env_*xml files to shell environment variable files that are then sourced for inclusion in the model environment. Used by the ccsm_getenv script.