Contents

• 1 Introduction
  • 1.1 The CCSM component models
  • 1.2 The component models: CAM, POP, CSIM, CLM
  • 1.3 Supported resolutions, configurations and platforms
  
  
• 2 CCSM2.0 Quick Start Guide
  • 2.1 What is needed to run CCSM2?
  • 2.2 Downloading and untarring the CCSM2.0 distribution
  • 2.3 The CCSM source code
  • 2.4 Input datasets
  • 2.5 Building the CCSM
  • 2.6 Running the CCSM
  • 2.7 CCSM output data
    • 2.7.1 Output log files
    • 2.7.2 Binary history and restart output data
  
  
• 3 The CCSM Scripts
  • 3.1 The CCSM Run Script: test.a1.run
    • 3.1.1 Set batch system options
    • 3.1.2 Define the common run environment
    • 3.1.3 Select multi-processing and resolution specs
    • 3.1.4 Run the setup script for each component
    • 3.1.5 Run the CCSM integration
    • 3.1.6 Archive and harvest
    • 3.1.7 Resubmit
  • 3.2 Sample Component Setup Script: cpl.setup.csh
    • 3.2.1 Document the setup script
    • 3.2.2 Set local component script variables
    • 3.2.3 Define and position the input datasets
    • 3.2.4 Write the input namelist
    • 3.2.5 Build the component executable
  
  
• 4 Building the CCSM
  • 4.1 The CCSM directory structure
  • 4.2 $CSMBLD contents
  • 4.3 $EXEDIR structure
  • 4.4 Input data positioning
  • 4.5 Building the model interactively
  
  
• 5 Running the CCSM
  • 5.1 Start up
    • 5.1.1 Running a simple test case of the fully coupled model on the NCAR IBM machine, blackforest
    • 5.1.2 Changing the configuration
    • 5.1.3 Changing the RUNTYPE
    • 5.1.4 Running on a new machine
    • 5.1.5 Getting into production
  • 5.2 What is the ccsm_joe file?
  • 5.3 How does auto-RESUBMIT work?
    • 5.3.1 Runaway jobs
  • 5.4 Batch queuing challenges
  • 5.5 Modifying source code
  • 5.6 CCSM Data Management
  • 5.7 What is harvesting doing?
  • 5.8 Monitoring the integration
  • 5.9 Data processing
  • 5.10 Comparing output to NCAR controls
  
  
• 6 Testing the CCSM
  • 6.1 Exact restart test
  
  
• 7 Common Aborts, Errors, Debugging, and Performance Issues
  • 7.1 Common aborts and errors
    • 7.1.1 Component model has trouble building
    • 7.1.2 Model won't continue due to restart problem
    • 7.1.3 Ocean model stops due to ocean non-convergence or time-stepping problem
    • 7.1.4 Ice Model stops due to ice mpdata transport instability
  • 7.2 Debugging
  • 7.3 Performance issues
  
  
• 8 Supporting Scripts:
  • 8.1 Experiment dependent scripts
  • 8.2 Scripts in the tools directory
  
  
• 9 The Graphical User Interface: ccsm_gui
• 10 The Atmosphere Setup Script: atm.setup.csh
  • 10.1 Document the atmosphere setup script
  • 10.2 Define and position the atmosphere input datasets
  • 10.3 Define resolution dependent parameters
  • 10.4 Write the atmosphere input namelist
  • 10.5 Create the atmosphere executable
  
  
• 11 The Ocean Model Setup Script: ocn.setup.csh
  • 11.1 Document the ocean setup script
  • 11.2 Set code location and resolution dependencies
  • 11.3 Position initial files
  • 11.4 Build the executable
  • 11.5 Parse the date variables
  • 11.6 Modify pop_in
  • 11.7 Define the ocean input datasets
  • 11.8 Position the ocean input datasets
  
  
• 12 The Sea-Ice Model Setup Script: ice.setup.csh
  • 12.1 Document the sea-ice setup script
  • 12.2 Set the sea-ice model configuration flags
  • 12.3 Acquire the sea-ice initial and boundary files
  • 12.4 Create the sea-ice namelist input file
  • 12.5 Build the sea-ice model executable
  
  
• 13 The Land Model Setup Script: lnd.setup.csh
  • 13.1 Document the land setup script
  • 13.2 Set the land model configuration flags
  • 13.3 Create the namelist input file
  • 13.4 Create the land model executable
  
  
• 14 The Data Model Setup Scripts: d***.setup.csh
  • 14.1 Create the namelist input file
  
  
• 15 Glossary
• About this document ...