<chapter id="CPL7_Namelist">
<title>CPL7 Namelist</title>

<sect1 id="namelist_overview ">
<title>Namelist Overview</title>

<para> 
In general, a user can modify the driver/coupler settings by editing
either env variables or the buildnml files under Buildconf.  Specifically,
the driver/coupler namelist can be found in and will be generated by the
script, $CASEROOT/Buildconf/cpl.buildnml.csh.
</para> 

<para> 
There are several namelists associated with the driver/coupler
and they will be described below.  Not all namelist variables are resolved
in the buildnml script, but they all can be used.  Below, a description
of each namelist group and each namelist variable in each group
will be presented including a summary of the type and defaults and whether
any env variable is associated with the setting.  The types are either
char (character string), int (integer), r4 (real*4), r8 (real*8), or
log (logical).
</para> 

<para> 
There are three important driver/coupler namelist input files
(cpl_modelio.nml, drv_in, and seq_maps.rc)
and each file has at least one namelist input group.  The namelist groups
are modelio, seq_infodata_inparm, seq_timemgr_inparm, ccsm_pes,
prof_inparm, pio_inparm, and seq_maps.  The files, namelist groups, and
list of variables in each namelist group are<literallayout>
<link linkend="infile_modelio">cpl_modelio.nml</link> (input_filename)
   <link linkend="nml_modelio">modelio</link> (cpl_modelio.nml namelist)
      <link linkend="nmlv_diri">diri</link> - obsolete
      <link linkend="nmlv_diro">diro - obsolete</link> - obsolete
      <link linkend="nmlv_logfile">logfile</link> - logfile name

<link linkend="infile_drv_in">drv_in</link> (input filename)
   <link linkend="nml_infodata">seq_infodata_inparm</link> (drv_in namelist)
      <link linkend="nmlv_case_desc">case_desc</link> - case description
      <link linkend="nmlv_case_name">case_name</link> - case name
      <link linkend="nmlv_start_type">start_type</link> - start type
      <link linkend="nmlv_model_version">model_version</link> - model version
      <link linkend="nmlv_username">username</link> - current username
      <link linkend="nmlv_hostname">hostname</link> - hostname
      <link linkend="nmlv_brnch_retain_casename">brnch_retain_casename</link> - retain branch casename
      <link linkend="nmlv_info_debug">info_debug</link> - debug level
      <link linkend="nmlv_bfbflag">bfbflag</link> - bit for bit flag
      <link linkend="nmlv_drv_threading">drv_threading</link> - turn on variable threading in driver
      <link linkend="nmlv_samegrid_ao">samegrid_ao</link> - atm and ocean samegrid flag
      <link linkend="nmlv_samegrid_al">samegrid_al</link> - atm and land samegrid flag
      <link linkend="nmlv_samegrid_ro">samegrid_ro</link> - runoff and ocean samegrid flag
      <link linkend="nmlv_eps_frac">eps_frac</link> - domain checking fraction tolerance
      <link linkend="nmlv_eps_amask">eps_amask</link> - domain checking atm/lnd mask tolerance
      <link linkend="nmlv_eps_agrid">eps_agrid</link> - domain checking atm/lnd grid tolerance
      <link linkend="nmlv_eps_aarea">eps_aarea</link> - domain checking atm/lnd area tolerance
      <link linkend="nmlv_eps_omask">eps_omask</link> - domain checking ocn/ice mask tolerance
      <link linkend="nmlv_eps_ogrid">eps_ogrid</link> - domain checking ocn/ice grid tolerance
      <link linkend="nmlv_eps_oarea">eps_oarea</link> - domain checking ocn/ice area tolerance
      <link linkend="nmlv_shr_map_dopole">shr_map_dopole</link> - polar correction in shr_map
      <link linkend="nmlv_npfix">vect_map</link> - vector mapping algorithm for vectors in a2o mapping
      <link linkend="nmlv_flux_epbal">flux_epbal</link> - fresh water balance
      <link linkend="nmlv_flux_albav">flux_albav</link> - albedo averaging mode
      <link linkend="nmlv_aoflux_grid">aoflux_grid</link> - grid for atmocn flux calculation
      <link linkend="nmlv_ocean_tight_coupling">ocean_tight_coupling</link> - tight ocean coupling flag
      <link linkend="nmlv_perpetual">perpetual</link> - perpetual mode, untested
      <link linkend="nmlv_perpetual_ymd">perpetual_ymd</link>, perpetual date, untested
      <link linkend="nmlv_orb_mode">orb_mode</link> - orbital mode
      <link linkend="nmlv_orb_iyear_align">orb_iyear_align</link> - orbital model year alignment
      <link linkend="nmlv_orb_iyear">orb_iyear</link> - orbital year
      <link linkend="nmlv_orb_obliq">orb_obliq</link> - orbital obliquity
      <link linkend="nmlv_orb_eccen">orb_eccen</link> - orbital eccentricity
      <link linkend="nmlv_orb_mvelp">orb_mvelp</link> - orbital vernal equinox
      <link linkend="nmlv_atm_adiabatic">atm_adiabatic</link> - atm adiabatic mode
      <link linkend="nmlv_atm_ideal_phys">atm_ideal_phys</link> - atm ideal physics mode
      <link linkend="nmlv_aqua_planet">aqua_planet</link> - aqua planet
      <link linkend="nmlv_single_column">single_column</link> - single column mode
      <link linkend="nmlv_scmlon">scmlon</link> - single column longitude
      <link linkend="nmlv_scmlat">scmlat</link> - single column latitude
      <link linkend="nmlv_do_budgets">do_budgets</link> - turn on budgets
      <link linkend="nmlv_budget_inst">budget_inst</link> - instantaneous budget flag
      <link linkend="nmlv_budget_daily">budget_daily</link> - daily budget flag
      <link linkend="nmlv_budget_month">budget_month</link> - monthly budget flag
      <link linkend="nmlv_budget_ann">budget_ann</link> - annual budget flag
      <link linkend="nmlv_budget_ltann">budget_ltann</link> - long term annual budget flag
      <link linkend="nmlv_budget_ltend">budget_ltend</link> - long term end of run budget flag
      <link linkend="nmlv_cpl_cdf64">cpl_cdf64</link> - turn on 64bit netcdf files in driver
      <link linkend="nmlv_restart_pfile">restart_pfile</link> - restart pointer file
      <link linkend="nmlv_restart_file">restart_file</link> - restart filename
      <link linkend="nmlv_timing_dir">timing_dir</link> - timing output directory
      <link linkend="nmlv_tchkpt_dir">tchkpt_dir</link> - timing checkpoint directory
      <link linkend="nmlv_logFilePostFix">logFilePostFix</link> - untested
      <link linkend="nmlv_outPathRoot">outPathRoot</link> - untested
      <link linkend="nmlv_histaux_a2x">histaux_a2x</link> - driver aux history files for a2x fields
      <link linkend="nmlv_histaux_a2x3hr">histaux_a2x3hr</link> - driver aux history files for a2x 3 hour fields 
      <link linkend="nmlv_histaux_a2x3hrp">histaux_a2x3hrp</link> - driver aux history file for a2x 3 hour precip fields
      <link linkend="nmlv_histaux_a2x24hr">histaux_a2x24hr</link> - driver aux history file for a2x daily fields
      <link linkend="nmlv_histaux_l2x">histaux_l2x</link> - driver aux history file for l2x fields
      <link linkend="nmlv_histaux_r2x">histaux_r2x</link> - driver aux history file for r2x fields

   <link linkend="nml_timemgr">seq_timemgr_inparm</link> (drv_in namelist)
      <link linkend="nmlv_calendar">calendar</link> - calendar type
      <link linkend="nmlv_start_ymd">start_ymd</link> - start year/month/day
      <link linkend="nmlv_start_tod">start_tod</link> - start time of day
      <link linkend="nmlv_ref_ymd">ref_ymd</link> - reference year/month/day
      <link linkend="nmlv_ref_tod">ref_tod</link> - reference time of day
      <link linkend="nmlv_curr_ymd">curr_ymd</link> - current year/month/day, obsolete
      <link linkend="nmlv_curr_tod">curr_tod</link> - current time of day, obsolete
      <link linkend="nmlv_atm_cpl_dt">atm_cpl_dt</link> - atm coupling period
      <link linkend="nmlv_ocn_cpl_dt">ocn_cpl_dt</link> - ocn coupling period
      <link linkend="nmlv_ice_cpl_dt">ice_cpl_dt</link> - ice coupling period
      <link linkend="nmlv_lnd_cpl_dt">lnd_cpl_dt</link> - lnd coupling period
      <link linkend="nmlv_glc_cpl_dt">glc_cpl_dt</link> - glc coupling period
      <link linkend="nmlv_atm_cpl_offset">atm_cpl_offset</link> - atm coupling offset
      <link linkend="nmlv_lnd_cpl_offset">lnd_cpl_offset</link> - lnd coupling offset
      <link linkend="nmlv_ocn_cpl_offset">ocn_cpl_offset</link> - ocn coupling offset
      <link linkend="nmlv_ice_cpl_offset">ice_cpl_offset</link> - ice coupling offset
      <link linkend="nmlv_glc_cpl_offset">glc_cpl_offset</link> - glc coupling offset
      <link linkend="nmlv_stop_option">stop_option</link> - stop flag
      <link linkend="nmlv_stop_n">stop_n</link> - stop value
      <link linkend="nmlv_stop_ymd">stop_ymd</link> - stop date
      <link linkend="nmlv_stop_tod">stop_tod</link> - stop time of day
      <link linkend="nmlv_restart_option">restart_option</link> - restart flag
      <link linkend="nmlv_restart_n">restart_n</link> - restart value
      <link linkend="nmlv_restart_ymd">restart_ymd</link> - restart date
      <link linkend="nmlv_end_restart">end_restart</link> - restart at end of run
      <link linkend="nmlv_history_option">history_option</link> - driver snapshot history flag
      <link linkend="nmlv_history_n">history_n</link> - driver snapshot history value
      <link linkend="nmlv_history_ymd">history_ymd</link> - driver snapshot history date
      <link linkend="nmlv_histavg_option">histavg_option</link> - driver average history flag
      <link linkend="nmlv_histavg_n">histavg_n</link> - driver average history value
      <link linkend="nmlv_histavg_ymd">histavg_ymd</link> - driver average history date
      <link linkend="nmlv_tprof_option">tprof_option</link> - timing flag
      <link linkend="nmlv_tprof_n">tprof_n</link> - timing value
      <link linkend="nmlv_tprof_ymd">tprof_ymd</link> - timing date

   <link linkend="nml_ccsm_pes">ccsm_pes</link> (drv_in namelist)
      <link linkend="nmlv_atm_ntasks">atm_ntasks</link> - atm mpi tasks
      <link linkend="nmlv_atm_rootpe">atm_rootpe</link> - atm root task in global comm
      <link linkend="nmlv_atm_pestride">atm_pestride</link> - atm mpi task stride
      <link linkend="nmlv_atm_nthreads">atm_nthreads</link> - atm threads per mpi task
      <link linkend="nmlv_lnd_ntasks">lnd_ntasks</link> - lnd mpi tasks
      <link linkend="nmlv_lnd_rootpe">lnd_rootpe</link> - lnd root task in global comm
      <link linkend="nmlv_lnd_pestride">lnd_pestride</link> - lnd mpi task stride
      <link linkend="nmlv_lnd_nthreads">lnd_nthreads</link> - lnd threads per mpi task
      <link linkend="nmlv_ice_ntasks">ice_ntasks</link> - ice mpi tasks
      <link linkend="nmlv_ice_rootpe">ice_rootpe</link> - ice root task in global comm
      <link linkend="nmlv_ice_pestride">ice_pestride</link> - ice mpi task stride
      <link linkend="nmlv_ice_nthreads">ice_nthreads</link> - ice threads per mpi task
      <link linkend="nmlv_ocn_ntasks">ocn_ntasks</link> - ocn mpi tasks
      <link linkend="nmlv_ocn_rootpe">ocn_rootpe</link> - ocn root task in global comm
      <link linkend="nmlv_ocn_pestride">ocn_pestride</link> - ocn mpi task stride
      <link linkend="nmlv_ocn_nthreads">ocn_nthreads</link> - ocn threads per mpi task
      <link linkend="nmlv_glc_ntasks">glc_ntasks</link> - glc mpi tasks
      <link linkend="nmlv_glc_rootpe">glc_rootpe</link> - glc root task in global comm
      <link linkend="nmlv_glc_pestride">glc_pestride</link> - glc mpi task stride
      <link linkend="nmlv_glc_nthreads">glc_nthreads</link> - glc threads per mpi task
      <link linkend="nmlv_cpl_ntasks">cpl_ntasks</link> - cpl mpi tasks
      <link linkend="nmlv_cpl_rootpe">cpl_rootpe</link> - cpl root task in global comm
      <link linkend="nmlv_cpl_pestride">cpl_pestride</link> - cpl mpi task stride
      <link linkend="nmlv_cpl_nthreads">cpl_nthreads</link> - cpl threads per mpi task

   <link linkend="nml_prof">prof_inparm</link> (drv_in namelist)
      <link linkend="nmlv_profile_disable">profile_disable</link>
      <link linkend="nmlv_profile_barrier">profile_barrier</link>
      <link linkend="nmlv_profile_single_file">profile_single_file</link>
      <link linkend="nmlv_profile_global_stats">profile_global_stats</link>
      <link linkend="nmlv_profile_depth_limit">profile_depth_limit</link>
      <link linkend="nmlv_profile_detail_limit">profile_detail_limit</link>
      <link linkend="nmlv_profile_outpe_num">profile_outpe_num</link>
      <link linkend="nmlv_profile_outpe_stride">profile_outpe_stride</link>
      <link linkend="nmlv_profile_timer">profile_timer</link>
      <link linkend="nmlv_profile_papi_enable">profile_papi_enable</link>

   <link linkend="nml_pio">pio_inparm</link> (drv_in namelist)
      <link linkend="nmlv_pio_async_interface">pio_async_interface</link> - future asynchronous IO capability (not currently supported)
      <link linkend="nmlv_pio_numtasks">pio_numtasks</link> - number of io tasks in pio used generically, component based value takes precedent
      <link linkend="nmlv_pio_root">pio_root</link> - io task root in pio used generically, component based value takes precedent
      <link linkend="nmlv_pio_stride">pio_stride</link> - stride of tasks in pio used generically, component based value takes precedent
      <link linkend="nmlv_pio_typename">pio_typename</link> - io type in pio used generically, component based value takes precedent
      <link linkend="nmlv_pio_debug_level">pio_debug_level</link> - debug level for pio
      <link linkend="nmlv_cpl_io_numtasks">cpl_pio_numtasks</link> - number of io tasks in pio for coupler
      <link linkend="nmlv_cpl_io_root">cpl_pio_root</link> - io task root in pio for coupler
      <link linkend="nmlv_cpl_io_stride">cpl_pio_stride</link> - stride of tasks in pio for coupler
      <link linkend="nmlv_cpl_io_typename">cpl_pio_typename</link> - io type in pio for coupler
      <link linkend="nmlv_atm_io_numtasks">atm_pio_numtasks</link> - number of io tasks in pio for atmosphere
      <link linkend="nmlv_atm_io_root">atm_pio_root</link> - io task root in pio for atmosphere
      <link linkend="nmlv_atm_io_stride">atm_pio_stride</link> - stride of tasks in pio for atmosphere
      <link linkend="nmlv_atm_io_typename">atm_pio_typename</link> - io type in pio for atmosphere
      <link linkend="nmlv_lnd_io_numtasks">lnd_pio_numtasks</link> - number of io tasks in pio for land
      <link linkend="nmlv_lnd_io_root">lnd_pio_root</link> - io task root in pio for land
      <link linkend="nmlv_lnd_io_stride">lnd_pio_stride</link> - stride of tasks in pio for land
      <link linkend="nmlv_lnd_io_typename">lnd_pio_typename</link> - io type in pio for land
      <link linkend="nmlv_ice_io_numtasks">ice_pio_numtasks</link> - number of io tasks in pio for ice
      <link linkend="nmlv_ice_io_root">ice_pio_root</link> - io task root in pio for ice
      <link linkend="nmlv_ice_io_stride">ice_pio_stride</link> - stride of tasks in pio for ice
      <link linkend="nmlv_ice_io_typename">ice_pio_typename</link> - io type in pio for ice
      <link linkend="nmlv_ocn_io_numtasks">ocn_pio_numtasks</link> - number of io tasks in pio for ocean
      <link linkend="nmlv_ocn_io_root">ocn_pio_root</link> - io task root in pio for ocean
      <link linkend="nmlv_ocn_io_stride">ocn_pio_stride</link> - stride of tasks in pio for ocean
      <link linkend="nmlv_ocn_io_typename">ocn_pio_typename</link> - io type in pio for ocean
      <link linkend="nmlv_glc_io_numtasks">glc_pio_numtasks</link> - number of io tasks in pio for land ice
      <link linkend="nmlv_glc_io_root">glc_pio_root</link> - io task root in pio for land ice
      <link linkend="nmlv_glc_io_stride">glc_pio_stride</link> - stride of tasks in pio for land ice
      <link linkend="nmlv_glc_io_typename">glc_pio_typename</link> - io type in pio for land ice

<link linkend="infile_seq_maps">seq_maps.rc</link> (input filename)
   <link linkend="nml_seq_maps">seq_maps</link> (not a Fortran namelist)
      <link linkend="nmlv_atm2ocnFmapname">atm2ocnFmapname</link> - atm to ocn flux mapping file
      <link linkend="nmlv_atm2ocnFmaptype">atm2ocnFmaptype</link> - atm to ocn flux mapping type
      <link linkend="nmlv_atm2ocnSmapname">atm2ocnSmapname</link> - atm to ocn state mapping file
      <link linkend="nmlv_atm2ocnSmaptype">atm2ocnSmaptype</link> - atm to ocn state mapping type
      <link linkend="nmlv_ocn2atmFmapname">ocn2atmFmapname</link> - ocn to atm flux mapping file
      <link linkend="nmlv_ocn2atmFmaptype">ocn2atmFmaptype</link> - ocn to atm flux mapping type
      <link linkend="nmlv_ocn2atmSmapname">ocn2atmSmapname</link> - ocn to atm state mapping file
      <link linkend="nmlv_ocn2atmSmaptype">ocn2atmSmaptype</link> - ocn to atm state mapping type
      <link linkend="nmlv_atm2iceFmapname">atm2iceFmapname</link> - atm to ice flux mapping file
      <link linkend="nmlv_atm2iceFmaptype">atm2iceFmaptype</link> - atm to ice flux mapping type
      <link linkend="nmlv_atm2iceSmapname">atm2iceSmapname</link> - atm to ice state mapping file
      <link linkend="nmlv_atm2iceSmaptype">atm2iceSmaptype</link> - atm to ice state mapping type
      <link linkend="nmlv_ice2atmFmapname">ice2atmFmapname</link> - ice to atm flux mapping file
      <link linkend="nmlv_ice2atmFmaptype">ice2atmFmaptype</link> - ice to atm flux mapping type
      <link linkend="nmlv_ice2atmSmapname">ice2atmSmapname</link> - ice to atm state mapping file
      <link linkend="nmlv_ice2atmSmaptype">ice2atmSmaptype</link> - ice to atm state mapping type
      <link linkend="nmlv_atm2lndFmapname">atm2lndFmapname</link> - atm to lnd flux mapping file
      <link linkend="nmlv_atm2lndFmaptype">atm2lndFmaptype</link> - atm to lnd flux mapping type
      <link linkend="nmlv_atm2lndSmapname">atm2lndSmapname</link> - atm to lnd state mapping file
      <link linkend="nmlv_atm2lndSmaptype">atm2lndSmaptype</link> - atm to lnd state mapping type
      <link linkend="nmlv_lnd2atmFmapname">lnd2atmFmapname</link> - lnd to atm flux mapping file
      <link linkend="nmlv_lnd2atmFmaptype">lnd2atmFmaptype</link> - lnd to atm flux mapping type
      <link linkend="nmlv_lnd2atmSmapname">lnd2atmSmapname</link> - lnd to atm state mapping file
      <link linkend="nmlv_lnd2atmSmaptype">lnd2atmSmaptype</link> - lnd to atm state mapping type
      <link linkend="nmlv_rof2ocnFmapname">rof2ocnFmapname</link> - rof to ocn flux mapping file
      <link linkend="nmlv_rof2ocnFmaptype">rof2ocnFmaptype</link> - rof to ocn flux mapping type
</literallayout>
</para>

</sect1>

<sect1 id="infile_modelio">
<title>cpl_modelio.nml Input File</title>

<para>
The cpl_modelio.nml file sets the filename for the primary standard output file.  Existance is 
largely historical.  The cpl.buildnml.csh script actually generates the _modelio.nml 
files for all components.  
</para>

<sect2 id="nml_modelio">
<title>modelio namelist</title>

<variablelist>

<varlistentry id="nmlv_diri"><term><option>diri (char)</option></term>
<listitem><para>unused</para>
</listitem></varlistentry>

<varlistentry id="nmlv_diro"><term><option>diro (char)</option></term>
<listitem><para>unused</para>
</listitem></varlistentry>

<varlistentry id="nmlv_logfile"><term><option>logfile (char)</option></term>
<listitem><para>the name of the logfile for the component.  default="", required but set automatically by ccsm scripts</para>
</listitem></varlistentry>

</variablelist>

</sect2>

</sect1>

<sect1 id="infile_drv_in ">
<title>drv_in Input File</title>

<para>
The drv_in input file contains several different namelist groups associated with general
options, time manager options, pe layout, timing output, and parallel IO settings.
The different groups are seq_infodata_inparm, seq_timemgr_inparm, ccsm_pes, prof_inparm,
and pio_inparm.
</para>

<sect2 id="nml_infodata">
<title>seq_infodata_inparm namelist</title>

<para>
These namelist are associated with some general driver/coupler options.
</para>

<variablelist>

<varlistentry id="nmlv_aoflux_grid"><term><option>aoflux_grid (char)</option></term>
<listitem><para> untested</para></listitem>
</varlistentry>

<varlistentry id="nmlv_aqua_planet"><term><option>aqua_planet (log)</option></term>
<listitem><para> turns on aqua planet mode.  this mode is only available in limited configurations.  default=false.</para></listitem>
</varlistentry>

<varlistentry id="nmlv_atm_adiabatic"><term><option>atm_adiabatic (log)</option></term>
<listitem><para> turns on atm model adiabatic mode. this mode is only available in limited configurations.  default=false.</para></listitem>
</varlistentry>

<varlistentry id="nmlv_atm_ideal_phys"><term><option>atm_ideal_phys (log)</option></term>
<listitem><para> turns on atm ideal physics mode.  this mode is only available in limited configurations.  default=false.</para></listitem>
</varlistentry>

<varlistentry id="nmlv_bfbflag"><term><option>bfbflag (log)</option></term>
<listitem><para> turns on bfb option in coupler which produce bfb results in the coupler on different processor counts.  set by BFBFLAG in env_run.xml, default=false.</para></listitem>
</varlistentry>

<varlistentry id="nmlv_brnch_retain_casename"><term><option>brnch_retain_casename (log)</option></term>
<listitem><para> information about whether the base casename can be reused for the branch casename. </para></listitem>
</varlistentry>

<varlistentry id="nmlv_budget_ann"><term><option>budget_ann (int)</option></term>
<listitem><para> sets the diagnotics level of the annual budgets. [0,1,2,3], 0=none, 1=+net summary budgets, 2=+detailed lnd/ocn/ice component budgets, 3=+detailed atm budgets, set by BUDGET_ANNUAL in env_run.xml.  default=1</para></listitem>
</varlistentry>

<varlistentry id="nmlv_budget_daily"><term><option>budget_daily (int)</option></term>
<listitem><para> sets the diagnotics level of the daily budgets. [0,1,2,3], 0=none, 1=+net summary budgets, 2=+detailed lnd/ocn/ice component budgets, 3=+detailed atm budgets, set by BUDGET_DAILY in env_run.xml.  default=0</para></listitem>
</varlistentry>

<varlistentry id="nmlv_budget_inst"><term><option>budget_inst (int)</option></term>
<listitem><para> sets the diagnotics level of the instantaneous budgets. [0,1,2,3], 0=none, 1=+net summary budgets, 2=+detailed lnd/ocn/ice component budgets, 3=+detailed atm budgets, set by BUDGET_INST in env_run.xml.  default=0</para></listitem>
</varlistentry>

<varlistentry id="nmlv_budget_ltann"><term><option>budget_ltann (int)</option></term>
<listitem><para> sets the diagnotics level of the longterm budgets written at the end of the year. [0,1,2,3], 0=none, 1=+net summary budgets, 2=+detailed lnd/ocn/ice component budgets, 3=+detailed atm budgets, set by BUDGET_LONGTERM_EOY in env_run.xml.  default=1</para></listitem>
</varlistentry>

<varlistentry id="nmlv_budget_ltend"><term><option>budget_ltend (int)</option></term>
<listitem><para> sets the diagnotics level of the longterm budgets written at the end of each run. [0,1,2,3], 0=none, 1=+net summary budgets, 2=+detailed lnd/ocn/ice component budgets, 3=+detailed atm budgets, set by BUDGET_LONGTERM_STOP in env_run.xml.  default=0</para></listitem>
</varlistentry>

<varlistentry id="nmlv_budget_month"><term><option>budget_month (int)</option></term>
<listitem><para> sets the diagnotics level of the monthy budgets. [0,1,2,3], 0=none, 1=+net summary budgets, 2=+detailed lnd/ocn/ice component budgets, 3=+detailed atm budgets, set by BUDGET_MONTHLY in env_run.xml.  default=1</para></listitem>
</varlistentry>

<varlistentry id="nmlv_case_desc"><term><option>case_desc (char)</option></term>
<listitem><para> case description.  set by CASESTR in env_run.xml.</para></listitem>
</varlistentry>

<varlistentry id="nmlv_case_name"><term><option>case_name (char)</option></term>
<listitem><para> case name.  set by CASE in env_case.xml.</para></listitem>
</varlistentry>

<varlistentry id="nmlv_cpl_cdf64"><term><option>cpl_cdf64 (log)</option></term>
<listitem><para> flag for 64 bit netcdf files for the cpl component, may or may not be used by the cpl component depending on cpl implementation.  default=false</para></listitem>
</varlistentry>

<varlistentry id="nmlv_do_budgets"><term><option>do_budgets (log)</option></term>
<listitem><para> turns on budget calculation and budget output, set by BUDGETS in env_run.xml.  default=false</para></listitem>
</varlistentry>

<varlistentry id="nmlv_drv_threading"><term><option>drv_threading (log)</option></term>
<listitem><para> turn on run time control of threading per pe per component by the driver.  set by DRV_THREADING in env_run.xml.  default=false</para></listitem>
</varlistentry>

<varlistentry id="nmlv_eps_aarea"><term><option>eps_aarea (r8)</option></term>
<listitem><para> variable associated with error checking the atm/lnd areas, absolute differences, set by EPS_AAREA in env_run.xml.  default=9.0e-07</para></listitem>
</varlistentry>

<varlistentry id="nmlv_eps_agrid"><term><option>eps_agrid (r8)</option></term>
<listitem><para> variable associated with error checking the atm/lnd longitudes and latitudes, absolute differences, set by EPS_AGRID in env_run.xml.  default=1.0e-12</para></listitem>
</varlistentry>

<varlistentry id="nmlv_eps_amask"><term><option>eps_amask (r8)</option></term>
<listitem><para> variable associated with error checking the atm/lnd mask, absolute differences, set by EPS_AMASK in env_run.xml.  default=1.0e-13</para></listitem>
</varlistentry>

<varlistentry id="nmlv_eps_frac"><term><option>eps_frac (r8)</option></term>
<listitem><para> variable associated with error checking the domain fractions, absolute differences.  set by EPS_FRAC in env_run.xml.  default=1.0e-02</para></listitem>
</varlistentry>

<varlistentry id="nmlv_eps_oarea"><term><option>eps_oarea (r8)</option></term>
<listitem><para> variable associated with error checking the ocn/ice areas, absolute differences, set by EPS_OAREA in env_run.xml.  default=1.0e-01</para></listitem>
</varlistentry>

<varlistentry id="nmlv_eps_ogrid"><term><option>eps_ogrid (r8)</option></term>
<listitem><para> variable associated with error checking the ocn/ice longitudes and latitudes, absolute differences, set by EPS_OGRID in env_run.xml.  default=1.0e-02</para></listitem>
</varlistentry>

<varlistentry id="nmlv_eps_omask"><term><option>eps_omask (r8)</option></term>
<listitem><para> variable associated with error checking the ocn/ice mask, absolute differences, set by EPS_OMASK in env_run.xml.  default=1.0e-06</para></listitem>
</varlistentry>

<varlistentry id="nmlv_flux_albav"><term><option>flux_albav (log)</option></term>
<listitem><para> turns on albedo averaging.  set by CPL_ALBAV in env_run.xml, default=false</para></listitem>
</varlistentry>

<varlistentry id="nmlv_flux_epbal"><term><option>flux_epbal (char)</option></term>
<listitem><para> turns on fresh water balance in coupler, set by CPL_EPBAL in env_run.xml, default=false</para></listitem>
</varlistentry>

<varlistentry id="nmlv_histaux_a2x"><term><option>histaux_a2x (log)</option></term>
<listitem><para> turns on coupler history stream for instantaneous atm to coupler fields.  default=false</para></listitem>
</varlistentry>

<varlistentry id="nmlv_histaux_a2x24hr"><term><option>histaux_a2x24hr (log)</option></term>
<listitem><para> turns on coupler history stream for daily average atm to coupler fields.  default=false</para></listitem>
</varlistentry>

<varlistentry id="nmlv_histaux_a2x3hr"><term><option>histaux_a2x3hr (log)</option></term>
<listitem><para> turns on coupler history stream for 3-hour average atm to coupler fields.  default=false</para></listitem>
</varlistentry>

<varlistentry id="nmlv_histaux_a2x3hrp"><term><option>histaux_a2x3hrp (log)</option></term>
<listitem><para> turns on coupler history stream for 3-hour average atm to coupler precip fields.  default=false</para></listitem>
</varlistentry>

<varlistentry id="nmlv_histaux_l2x"><term><option>histaux_l2x (log)</option></term>
<listitem><para> turns on coupler history stream for instantaneous land to coupler fields.  default=false</para></listitem>
</varlistentry>

<varlistentry id="nmlv_histaux_r2x"><term><option>histaux_r2x (log)</option></term>
<listitem><para> turns on coupler history stream for instantaneous runoff to coupler fields.  default=false</para></listitem>
</varlistentry>

<varlistentry id="nmlv_hostname"><term><option>hostname (char)</option></term>
<listitem><para> hostname information, set by MACH in env_case.xml</para></listitem>
</varlistentry>

<varlistentry id="nmlv_info_debug"><term><option>info_debug (int)</option></term>
<listitem><para> debug level in driver/coupler, set by INFO_DBUG in env_run.xml, default=1.</para></listitem>
</varlistentry>

<varlistentry id="nmlv_logFilePostFix"><term><option>logFilePostFix (char)</option></term>
<listitem><para> untested</para></listitem>
</varlistentry>

<varlistentry id="nmlv_model_version"><term><option>model_version (char)</option></term>
<listitem><para> model version documentation, set by CCSM_REPOTAG in env_run.xml</para></listitem>
</varlistentry>

<varlistentry id="nmlv_npfix"><term><option>vect_map(char)</option></term>
<listitem><para> turns on the vector mapping option for u and v vector mapping between atm and ocean grids in the coupler.  the options are none, npfix, cart3d, cart3d_diag, cart3d_uvw, and cart3d_uvw_diag.  the none option results in scalar mapping independently for the u and v field which tends to generate large errors near the poles.  npfix is the traditional option where the vectors are corrected on the ocean grid north of the last latitude line of the atmosphere grid.  the cart3d options convert the east (u) and north (v) vectors to 3d (x,y,z) triplets, and maps those fields before converting back to the east (u) and north (v) directions.  the cart3d ignores the resuling "w" velocity.  the cart3d_uvw calculates the resulting u and v vectors by preserving the total "u,v,w" speed and the angle of the (u,v) vector.  the _diag options just add diagnotics to the log file about the vector mapping.  set by VECT_MAP in env_run.xml  default=npfix</para></listitem>
</varlistentry>

<varlistentry id="nmlv_ocean_tight_coupling"><term><option>ocean_tight_coupling (log)</option></term>
<listitem><para> turns on ocean tight coupling flag which forces the ocean to coupling at the same time as the other surface models.  by default, there is a lag of one coupler timestep in addition to any difference in coupling frequency to accomodate the ability to run the ocean concurrently with the rest of the system for performance reasons.  set by OCN_TIGHT_COUPLING in env_run.xml.  default=false</para></listitem>
</varlistentry>

<varlistentry id="nmlv_orb_mode"><term><option>orb_mode (char)</option></term>
<listitem><para> orbital model setting.  this sets how the orbital mode will be configured.  "fixed_year" uses the orb_iyear and other orb inputs are ignored.  In this mode, the orbital parameters are constant and based on the year.  "variable_year" uses the orb_iyear and orb_iyear_align.  In this mode, the orbital parameters vary as the model year advances and the model year orb_iyear_align has the equivalent orbital year of orb_iyear.  "fixed_parameters" uses the orb_eccen, orb_mvelp, and orb_obliq to set the orbital parameters which then remain constant through the model integration.  set by ORBITAL_MODE in env_run.xml.  [fixed_year, variable_year, fixed_parameters] default='fixed_year'.</para></listitem>
</varlistentry>

<varlistentry id="nmlv_orb_iyear"><term><option>orb_iyear (int)</option></term>
<listitem><para> year of orbit, used when orb_mode is fixed_year or variable_year.  set by ORBITAL_YEAR in env_run.xml.  default=unset</para></listitem>
</varlistentry>

<varlistentry id="nmlv_orb_iyear_align"><term><option>orb_iyear_align (int)</option></term>
<listitem><para> model year associated with orb_iyear when orb_mode is variable_year.  set by ORBITAL_YEAR_ALIGN in env_run.xml.  default=unset</para></listitem>
</varlistentry>

<varlistentry id="nmlv_orb_eccen"><term><option>orb_eccen (r8)</option></term>
<listitem><para> eccentricity of orbit, used when orb_mode is fixed_parameters.  default=unset</para></listitem>
</varlistentry>

<varlistentry id="nmlv_orb_mvelp"><term><option>orb_mvelp (r8)</option></term>
<listitem><para> location of vernal equinox in longitude degrees, used when orb_mode is fixed_parameters.  default=unset</para></listitem>
</varlistentry>

<varlistentry id="nmlv_orb_obliq"><term><option>orb_obliq (r8)</option></term>
<listitem><para> obliquity of orbit in degrees, used when orb_mode is fixed_parameters.  default=unset</para></listitem>
</varlistentry>

<varlistentry id="nmlv_outPathRoot"><term><option>outPathRoot (char)</option></term>
<listitem><para> untested</para></listitem>
</varlistentry>

<varlistentry id="nmlv_perpetual"><term><option>perpetual (log)</option></term>
<listitem><para> flag to turn on perpetual mode, default=false (untested?)</para></listitem>
</varlistentry>

<varlistentry id="nmlv_perpetual_ymd"><term><option>perpetual_ymd (int)</option></term>
<listitem><para> ymd date of perpetual mode, default=unset (untested?)</para></listitem>
</varlistentry>

<varlistentry id="nmlv_restart_file"><term><option>restart_file (char)</option></term>
<listitem><para> driver restart file.  if set, this overwrites anything in the restart_pfile file.  default=unset and uses filename in restart_pfile.</para></listitem>
</varlistentry>

<varlistentry id="nmlv_restart_pfile"><term><option>restart_pfile (char)</option></term>
<listitem><para> restart pointer filename.  default="rpointer.drv"</para></listitem>
</varlistentry>

<varlistentry id="nmlv_samegrid_al"><term><option>samegrid_al (log)</option></term>
<listitem><para> tells the coupler to treat the atm and land grids as "the same".  automatically set by comparison of ATM_GRID and LND_GRID set in env_case.xml.  default=true</para></listitem>
</varlistentry>

<varlistentry id="nmlv_samegrid_ao"><term><option>samegrid_ao (log)</option></term>
<listitem><para> tells the coupler to treat the atm and ocean grids as "the same".  automatically set by comparison of ATM_GRID and OCN_GRID set in env_case.xml.  default=true</para></listitem>
</varlistentry>

<varlistentry id="nmlv_samegrid_ro"><term><option>samegrid_ro (log)</option></term>
<listitem><para> tells the coupler to treat the runoff and ocean grids as "the same".  automatically set by comparison of LND_GRID and OCN_GRID set in env_case.xml.  default=false</para></listitem>
</varlistentry>

<varlistentry id="nmlv_shr_map_dopole"><term><option>shr_map_dopole (log)</option></term>
<listitem><para> turns on special polar mapping feature in shr_map_mod.  set by SHR_MAP_DOPOLE in env_run.xml.  default=true</para></listitem>
</varlistentry>

<varlistentry id="nmlv_scmlon"><term><option>scmlon (r8)</option></term>
<listitem><para> grid point longitude associated with single column mode.  set by PTS_LON in env_run.xml.</para></listitem>
</varlistentry>

<varlistentry id="nmlv_scmlat"><term><option>scmlat (r8)</option></term>
<listitem><para> grid point latitude associated with single column mode.  set by PTS_LAT in env_run.xml.</para></listitem>
</varlistentry>

<varlistentry id="nmlv_single_column"><term><option>single_column (log)</option></term>
<listitem><para> turns on single column mode.  set by PTS_MODE in env_case.xml, default=false</para></listitem>
</varlistentry>

<varlistentry id="nmlv_start_type"><term><option>start_type (char)</option></term>
<listitem><para> mode to start the run up, [startup,branch,continue], set by RUN_TYPE in env_conf.xml</para></listitem>
</varlistentry>

<varlistentry id="nmlv_timing_dir"><term><option>timing_dir (char)</option></term>
<listitem><para> location of timing output.</para></listitem>
</varlistentry>

<varlistentry id="nmlv_tchkpt_dir"><term><option>tchkpt_dir (char)</option></term>
<listitem><para> location of timing checkpoint output.</para></listitem>
</varlistentry>

<varlistentry id="nmlv_username"><term><option>username (char)</option></term>
<listitem><para> username documentation, set by CCSMUSER in env_run.xml</para></listitem>
</varlistentry>

</variablelist>

</sect2>

<sect2 id="nml_timemgr">
<title>seq_timemgr_inparm namelist</title>

<para>
This namelist is associated with time manager options.
</para>

<variablelist>

<varlistentry id="nmlv_atm_cpl_dt"><term><option>atm_cpl_dt (int)</option></term>
<listitem><para> atm coupling timestep in seconds.  set via ATM_NCPL in env_run.xml.  ATM_NCPL is the number of times the atm is coupled per day.</para></listitem>
</varlistentry>

<varlistentry id="nmlv_atm_cpl_offset"><term><option>atm_cpl_offset (int)</option></term>
<listitem><para> controls phasing of the coupling.  offset in seconds.  default=0.</para></listitem>
</varlistentry>

<varlistentry id="nmlv_calendar"><term><option>calendar (char)</option></term>
<listitem><para> calendar in use.  [NO_LEAP, GREOGORIAN].  default="NO_LEAP".  set by CALENDAR in env_run.xml</para></listitem>
</varlistentry>

<varlistentry id="nmlv_curr_tod"><term><option>curr_tod (int)</option></term>
<listitem><para> untested</para></listitem>
</varlistentry>

<varlistentry id="nmlv_curr_ymd"><term><option>curr_ymd (int)</option></term>
<listitem><para> untested</para></listitem>
</varlistentry>

<varlistentry id="nmlv_end_restart"><term><option>end_restart (log)</option></term>
<listitem><para> forces a restart write at the end of the run in addition to any setting associated with rest_option.  default=true.  this setting will be set to false if restart_option is none or never.</para></listitem>
</varlistentry>

<varlistentry id="nmlv_glc_cpl_dt"><term><option>glc_cpl_dt (int)</option></term>
<listitem><para> glc coupling timestep in seconds.  set via GLC_NCPL in env_run.xml.  GLC_NCPL is the number of times the glc is coupled per day.</para></listitem>
</varlistentry>

<varlistentry id="nmlv_glc_cpl_offset"><term><option>glc_cpl_offset (int)</option></term>
<listitem><para> controls phasing of the coupling.  offset in seconds.  default=0.</para></listitem>
</varlistentry>

<varlistentry id="nmlv_history_n"><term><option>history_n (int)</option></term>
<listitem><para> number associated with history_option.  default=-1.  set by HIST_N in env_run.xml.</para></listitem>
</varlistentry>

<varlistentry id="nmlv_history_option"><term><option>history_option (char)</option></term>
<listitem><para> coupler history snapshot option.  see stop_option above.  default="never".  set by HIST_OPTION in env_run.xml.</para></listitem>
</varlistentry>

<varlistentry id="nmlv_history_ymd"><term><option>history_ymd (int)</option></term>
<listitem><para> date associated with history_option date.  yyyymmdd format.  default=-1.  set by HIST_DATE in env_run.xml.</para></listitem>
</varlistentry>

<varlistentry id="nmlv_histavg_n"><term><option>histavg_n (int)</option></term>
<listitem><para> number associated with histavg_option.  default=-1.  set by AVGHIST_N in env_run.xml.</para></listitem>
</varlistentry>

<varlistentry id="nmlv_histavg_option"><term><option>histavg_option (char)</option></term>
<listitem><para> coupler time average history option.  see stop_option above.  defaults="never".  set by AVGHIST_OPTION in env_run.xml.</para></listitem>
</varlistentry>

<varlistentry id="nmlv_histavg_ymd"><term><option>histavg_ymd (int)</option></term>
<listitem><para> date associated with histavg_option date.  yyyymmdd format.  default=-1.  set by AVGHIST_DATE in env_run.xml.</para></listitem>
</varlistentry>

<varlistentry id="nmlv_ice_cpl_dt"><term><option>ice_cpl_dt (int)</option></term>
<listitem><para> ice coupling timestep in seconds.  set via ICE_NCPL in env_run.xml.  ICE_NCPL is the number of times the ice is coupled per day.</para></listitem>
</varlistentry>

<varlistentry id="nmlv_ice_cpl_offset"><term><option>ice_cpl_offset (int)</option></term>
<listitem><para> controls phasing of the coupling.  offset in seconds.  default=0.</para></listitem>
</varlistentry>

<varlistentry id="nmlv_lnd_cpl_dt"><term><option>lnd_cpl_dt (int)</option></term>
<listitem><para> lnd coupling timestep in seconds.  set via LND_NCPL in env_run.xml.  LND_NCPL is the number of times the lnd is coupled per day.</para></listitem>
</varlistentry>

<varlistentry id="nmlv_lnd_cpl_offset"><term><option>lnd_cpl_offset (int)</option></term>
<listitem><para> controls phasing of the coupling.  offset in seconds.  default=0.</para></listitem>
</varlistentry>

<varlistentry id="nmlv_ocn_cpl_dt"><term><option>ocn_cpl_dt (int)</option></term>
<listitem><para> ocn coupling timestep in seconds.  set via OCN_NCPL in env_run.xml.  OCN_NCPL is the number of times the ocn is coupled per day.</para></listitem>
</varlistentry>

<varlistentry id="nmlv_ocn_cpl_offset"><term><option>ocn_cpl_offset (int)</option></term>
<listitem><para> controls phasing of the coupling.  offset in seconds.  default=0.</para></listitem>
</varlistentry>

<varlistentry id="nmlv_ref_tod"><term><option>ref_tod (int)</option></term>
<listitem><para> reference start time of day in seconds.  overwritten if restart file is read.  if unset, will use start_tod.  default=0</para></listitem>
</varlistentry>

<varlistentry id="nmlv_ref_ymd"><term><option>ref_ymd (int)</option></term>
<listitem><para> reference start date.  overwritten if restart file is read.  format yyyymmdd.  if unset, will use start_ymd.  default=0</para></listitem>
</varlistentry>

<varlistentry id="nmlv_restart_n"><term><option>restart_n (int)</option></term>
<listitem><para> number associated with restart_option.  default=-1.  set by REST_N in env_run.xml</para></listitem>
</varlistentry>

<varlistentry id="nmlv_restart_option"><term><option>restart_option (char)</option></term>
<listitem><para> model restart option.  all components write restarts using this setting.  see stop_option above.  default="yearly".  set by REST_OPTION in env_run.xml</para></listitem>
</varlistentry>

<varlistentry id="nmlv_restart_ymd"><term><option>restart_ymd (int)</option></term>
<listitem><para> date associated with stop_option date.  yyyymmdd format.  default=-1.  set by REST_DATE in env_run.xml</para></listitem>
</varlistentry>

<varlistentry id="nmlv_start_tod"><term><option>start_tod (int)</option></term>
<listitem><para> initial start time of day in seconds.  overwritten if restart file is read.  default=0</para></listitem>
</varlistentry>

<varlistentry id="nmlv_start_ymd"><term><option>start_ymd (int)</option></term>
<listitem><para> initial start date.  overwritten if restart file is read.  format yyyymmdd.  default=0, must be set by user on initial runs.</para></listitem>
</varlistentry>

<varlistentry id="nmlv_stop_n"><term><option>stop_n (int)</option></term>
<listitem><para> number associated with stop_option.  default=-1.  set by STOP_N in env_run.xml</para></listitem>
</varlistentry>

<varlistentry id="nmlv_stop_option"><term><option>stop_option (char)</option></term>
<listitem><para> model stop option used in conjuction with stop_n, stop_ymd, and stop_tod.  [none,never,nsteps,nstep,nseconds,nsecond,nminutes,nminute,nhours,nhour,ndays,nday,nmonths,nmonth,nyears,nyear,date,ifdays0,end]  default="".  set by STOP_OPTION in env_run.xml</para></listitem>
</varlistentry>

<varlistentry id="nmlv_stop_tod"><term><option>stop_tod (int)</option></term>
<listitem><para> time of day in seconds associated with stop_option and stop_ymd.  default=0.  </para></listitem>
</varlistentry>

<varlistentry id="nmlv_stop_ymd"><term><option>stop_ymd (int)</option></term>
<listitem><para> date associated with stop_option.  model will stop when stop_option and stop_n OR when stop_ymd and stop_tod is reached.  yyyymmdd format.  default=-1.  set by STOP_DATE in env_run.xml</para></listitem>
</varlistentry>

<varlistentry id="nmlv_tprof_n"><term><option>tprof_n (int)</option></term>
<listitem><para> number associated with tprof_option.  default=-1.  set by TPROF_N in env_run.xml.</para></listitem>
</varlistentry>

<varlistentry id="nmlv_tprof_option"><term><option>tprof_option (char)</option></term>
<listitem><para> timer profiling option.  see stop_option above.  default="never".  set by TPROF_OPTION in env_run.xml.</para></listitem>
</varlistentry>

<varlistentry id="nmlv_tprof_ymd"><term><option>tprof_ymd (int)</option></term>
<listitem><para> date associated with tprof_option date.  yyyymmdd format.  default=-1.  set by TPROF_DATE in env_run.xml.</para></listitem>
</varlistentry>

</variablelist>

</sect2>

<sect2 id="nml_ccsm_pes">
<title>ccsm_pes namelist</title>

<para>
This namelist is associated with the pe layout.
</para>

<variablelist>

<varlistentry id="nmlv_atm_ntasks"><term><option>atm_ntasks (int)</option></term>
<listitem><para> the number of mpi tasks assigned to the atm components. set by NTASKS_ATM in env_mach_pes.xml.  default=all_pes</para></listitem>
</varlistentry>

<varlistentry id="nmlv_atm_nthreads"><term><option>atm_nthreads (int)</option></term>
<listitem><para> the number of threads per mpi task for the atm component.  set by NTHRDS_ATM in env_mach_pes.xml.  default=1</para></listitem>
</varlistentry>

<varlistentry id="nmlv_atm_pestride"><term><option>atm_pestride (int)</option></term>
<listitem><para> the mpi global processors stride associated with the mpi tasks for the atm component.  set by PSTRID_ATM in env_mach_pes.xml.  default=1</para></listitem>
</varlistentry>

<varlistentry id="nmlv_atm_rootpe"><term><option>atm_rootpe (int)</option></term>
<listitem><para> the global mpi task rank of the root processor assigned to the atm component.  set by ROOTPE_ATM in env_mach_pes.xml.  default=0</para></listitem>
</varlistentry>

<varlistentry id="nmlv_cpl_ntasks"><term><option>cpl_ntasks (int)</option></term>
<listitem><para> the number of mpi tasks assigned to the cpl components. set by NTASKS_CPL in env_mach_pes.xml.  default=all_pes</para></listitem>
</varlistentry>

<varlistentry id="nmlv_cpl_nthreads"><term><option>cpl_nthreads (int)</option></term>
<listitem><para> the number of threads per mpi task for the cpl component.  set by NTHRDS_CPL in env_mach_pes.xml.  default=1</para></listitem>
</varlistentry>

<varlistentry id="nmlv_cpl_pestride"><term><option>cpl_pestride (int)</option></term>
<listitem><para> the mpi global processors stride associated with the mpi tasks for the cpl component.  set by PSTRID_CPL in env_mach_pes.xml.  default=1</para></listitem>
</varlistentry>

<varlistentry id="nmlv_cpl_rootpe"><term><option>cpl_rootpe (int)</option></term>
<listitem><para> the global mpi task rank of the root processor assigned to the cpl component.  set by ROOTPE_CPL in env_mach_pes.xml.  default=0</para></listitem>
</varlistentry>

<varlistentry id="nmlv_glc_ntasks"><term><option>glc_ntasks (int)</option></term>
<listitem><para> the number of mpi tasks assigned to the glc components. set by NTASKS_GLC in env_mach_pes.xml.  default=all_pes</para></listitem>
</varlistentry>

<varlistentry id="nmlv_glc_nthreads"><term><option>glc_nthreads (int)</option></term>
<listitem><para> the number of threads per mpi task for the glc component.  set by NTHRDS_GLC in env_mach_pes.xml.  default=1</para></listitem>
</varlistentry>

<varlistentry id="nmlv_glc_pestride"><term><option>glc_pestride (int)</option></term>
<listitem><para> the mpi global processors stride associated with the mpi tasks for the glc component.  set by PSTRID_GLC in env_mach_pes.xml.  default=1</para></listitem>
</varlistentry>

<varlistentry id="nmlv_glc_rootpe"><term><option>glc_rootpe (int)</option></term>
<listitem><para> the global mpi task rank of the root processor assigned to the glc component.  set by ROOTPE_GLC in env_mach_pes.xml.  default=0</para></listitem>
</varlistentry>

<varlistentry id="nmlv_ice_ntasks"><term><option>ice_ntasks (int)</option></term>
<listitem><para> the number of mpi tasks assigned to the ice components. set by NTASKS_ICE in env_mach_pes.xml.  default=all_pes</para></listitem>
</varlistentry>

<varlistentry id="nmlv_ice_nthreads"><term><option>ice_nthreads (int)</option></term>
<listitem><para> the number of threads per mpi task for the ice component.  set by NTHRDS_ICE in env_mach_pes.xml.  default=1</para></listitem>
</varlistentry>

<varlistentry id="nmlv_ice_pestride"><term><option>ice_pestride (int)</option></term>
<listitem><para> the mpi global processors stride associated with the mpi tasks for the ice component.  set by PSTRID_ICE in env_mach_pes.xml.  default=1</para></listitem>
</varlistentry>

<varlistentry id="nmlv_ice_rootpe"><term><option>ice_rootpe (int)</option></term>
<listitem><para> the global mpi task rank of the root processor assigned to the ice component.  set by ROOTPE_ICE in env_mach_pes.xml.  default=0</para></listitem>
</varlistentry>

<varlistentry id="nmlv_lnd_ntasks"><term><option>lnd_ntasks (int)</option></term>
<listitem><para> the number of mpi tasks assigned to the lnd components. set by NTASKS_LND in env_mach_pes.xml.  default=all_pes</para></listitem>
</varlistentry>

<varlistentry id="nmlv_lnd_nthreads"><term><option>lnd_nthreads (int)</option></term>
<listitem><para> the number of threads per mpi task for the lnd component.  set by NTHRDS_LND in env_mach_pes.xml.  default=1</para></listitem>
</varlistentry>

<varlistentry id="nmlv_lnd_pestride"><term><option>lnd_pestride (int)</option></term>
<listitem><para> the mpi global processors stride associated with the mpi tasks for the lnd component.  set by PSTRID_LND in env_mach_pes.xml.  default=1</para></listitem>
</varlistentry>

<varlistentry id="nmlv_lnd_rootpe"><term><option>lnd_rootpe (int)</option></term>
<listitem><para> the global mpi task rank of the root processor assigned to the lnd component.  set by ROOTPE_LND in env_mach_pes.xml.  default=0</para></listitem>
</varlistentry>

<varlistentry id="nmlv_ocn_ntasks"><term><option>ocn_ntasks (int)</option></term>
<listitem><para> the number of mpi tasks assigned to the ocn components. set by NTASKS_OCN in env_mach_pes.xml.  default=all_pes</para></listitem>
</varlistentry>

<varlistentry id="nmlv_ocn_nthreads"><term><option>ocn_nthreads (int)</option></term>
<listitem><para> the number of threads per mpi task for the ocn component.  set by NTHRDS_OCN in env_mach_pes.xml.  default=1</para></listitem>
</varlistentry>

<varlistentry id="nmlv_ocn_pestride"><term><option>ocn_pestride (int)</option></term>
<listitem><para> the mpi global processors stride associated with the mpi tasks for the ocn component.  set by PSTRID_OCN in env_mach_pes.xml.  default=1</para></listitem>
</varlistentry>

<varlistentry id="nmlv_ocn_rootpe"><term><option>ocn_rootpe (int)</option></term>
<listitem><para> the global mpi task rank of the root processor assigned to the ocn component.  set by ROOTPE_OCN in env_mach_pes.xml.  default=0</para></listitem>
</varlistentry>

</variablelist>

</sect2>

<sect2 id="nml_prof">
<title>prof_inparm namelist</title>

<para>
This namelist is associated with timing profile and is namelist for the perf_mod timing utility.
</para>

<variablelist>

<varlistentry id="nmlv_profile_barrier"><term><option>profile_barrier (log)</option></term>
<listitem><para></para></listitem>
</varlistentry>

<varlistentry id="nmlv_profile_depth_limit"><term><option>profile_depth_limit (int)</option></term>
<listitem><para></para></listitem>
</varlistentry>

<varlistentry id="nmlv_profile_detail_limit"><term><option>profile_detail_limit (int)</option></term>
<listitem><para></para></listitem>
</varlistentry>

<varlistentry id="nmlv_profile_disable"><term><option>profile_disable (log)</option></term>
<listitem><para></para></listitem>
</varlistentry>

<varlistentry id="nmlv_profile_global_stats"><term><option>profile_global_stats (log)</option></term>
<listitem><para></para></listitem>
</varlistentry>

<varlistentry id="nmlv_profile_outpe_num"><term><option>profile_outpe_num (int)</option></term>
<listitem><para></para></listitem>
</varlistentry>

<varlistentry id="nmlv_profile_outpe_stride"><term><option>profile_outpe_stride (int)</option></term>
<listitem><para></para></listitem>
</varlistentry>

<varlistentry id="nmlv_profile_papi_enable"><term><option>profile_papi_enable (log)</option></term>
<listitem><para></para></listitem>
</varlistentry>

<varlistentry id="nmlv_profile_single_file"><term><option>profile_single_file (log)</option></term>
<listitem><para></para></listitem>
</varlistentry>

<varlistentry id="nmlv_profile_timer"><term><option>profile_timer (int)</option></term>
<listitem><para></para></listitem>
</varlistentry>

</variablelist>

</sect2>

<sect2 id="nml_pio">
<title>pio_inparm namelist</title>

<para>
  This namelist is associated with pio setting for the system as a whole.  Generic and component
specific settings are available.  If component specific values are not set, then the generic
ones will be used for that component.  PIO depends on the local availability of external libraries
including netcdf (version 3 or version 4) or  pnetcdf.  The pio setup values are passed to 
components via the coupling interfaces.
</para>

<variablelist>

<varlistentry id="nmlv_pio_async_interface"><term><option>pio_async_interface (log)</option></term>
<listitem><para> future asynchronous IO capability (not currently supported). default=.false.</para></listitem>
</varlistentry>
<varlistentry id="nmlv_pio_numtasks"><term><option>pio_numtasks (int)</option></term>
<listitem><para> number of io tasks in pio used generically, component based value takes precedent. default=unset</para></listitem>
</varlistentry>
<varlistentry id="nmlv_pio_root"><term><option>pio_root (int)</option></term>
<listitem><para>io task root in pio used generically, component based value takes precedent. default=unset</para></listitem>
</varlistentry>
<varlistentry id="nmlv_pio_stride"><term><option>pio_stride (int)</option></term> 
<listitem><para>stride of tasks in pio used generically, component based value takes precedent. default=unset</para></listitem>
</varlistentry>
<varlistentry id="nmlv_pio_typename"><term><option>pio_typename (char)</option></term> 
<listitem><para>io type in pio used generically, component based value takes precedent.  [netcdf, pnetcdf, netcdf4p, netcdf4c] default=unset</para></listitem>
</varlistentry>
<varlistentry id="nmlv_pio_debug_level"><term><option>pio_debug_level (int)</option></term> 
<listitem><para>debug level for pio. default=0</para></listitem>
</varlistentry>
<varlistentry id="nmlv_cpl_io_numtasks"><term><option>cpl_pio_numtasks (int)</option></term> 
<listitem><para>number of io tasks in pio for coupler. default=unset</para></listitem>
</varlistentry>
<varlistentry id="nmlv_cpl_io_root"><term><option>cpl_pio_root (int)</option></term> 
<listitem><para>io task root in pio for coupler. default=unset</para></listitem>
</varlistentry>
<varlistentry id="nmlv_cpl_io_stride"><term><option>cpl_pio_stride (int)</option></term> 
<listitem><para>stride of tasks in pio for coupler. default=unset</para></listitem>
</varlistentry>
<varlistentry id="nmlv_cpl_io_typename"><term><option>cpl_pio_typename (char)</option></term> 
<listitem><para>io type in pio for coupler. [nothing, netcdf, pnetcdf, netcdf4p, netcdf4c] default='nothing'</para></listitem>
</varlistentry>
<varlistentry id="nmlv_atm_io_numtasks"><term><option>atm_pio_numtasks (int)</option></term> 
<listitem><para>number of io tasks in pio for atmosphere. default=unset</para></listitem>
</varlistentry>
<varlistentry id="nmlv_atm_io_root"><term><option>atm_pio_root (int)</option></term> 
<listitem><para>io task root in pio for atmosphere. default=unset</para></listitem>
</varlistentry>
<varlistentry id="nmlv_atm_io_stride"><term><option>atm_pio_stride (int)</option></term> 
<listitem><para>stride of tasks in pio for atmosphere. default=unset</para></listitem>
</varlistentry>
<varlistentry id="nmlv_atm_io_typename"><term><option>atm_pio_typename (char)</option></term> 
<listitem><para>io type in pio for atmosphere. [nothing, netcdf, pnetcdf, netcdf4p, netcdf4c] default='nothing'</para></listitem>
</varlistentry>
<varlistentry id="nmlv_lnd_io_numtasks"><term><option>lnd_pio_numtasks (int)</option></term> 
<listitem><para>number of io tasks in pio for land. default=unset</para></listitem>
</varlistentry>
<varlistentry id="nmlv_lnd_io_root"><term><option>lnd_pio_root (int)</option></term> 
<listitem><para>io task root in pio for land. default=unset</para></listitem>
</varlistentry>
<varlistentry id="nmlv_lnd_io_stride"><term><option>lnd_pio_stride (int)</option></term> 
<listitem><para>stride of tasks in pio for land. default=unset</para></listitem>
</varlistentry>
<varlistentry id="nmlv_lnd_io_typename"><term><option>lnd_pio_typename (char)</option></term> 
<listitem><para>io type in pio for land. [nothing, netcdf, pnetcdf, netcdf4p, netcdf4c] default='nothing'</para></listitem>
</varlistentry>
<varlistentry id="nmlv_ice_io_numtasks"><term><option>ice_pio_numtasks (int)</option></term> 
<listitem><para>number of io tasks in pio for ice. default=unset</para></listitem>
</varlistentry>
<varlistentry id="nmlv_ice_io_root"><term><option>ice_pio_root (int)</option></term> 
<listitem><para>io task root in pio for ice. default=unset</para></listitem>
</varlistentry>
<varlistentry id="nmlv_ice_io_stride"><term><option>ice_pio_stride (int)</option></term> 
<listitem><para>stride of tasks in pio for ice. default=unset</para></listitem>
</varlistentry>
<varlistentry id="nmlv_ice_io_typename"><term><option>ice_pio_typename (char)</option></term> 
<listitem><para>io type in pio for ice. [nothing, netcdf, pnetcdf, netcdf4p, netcdf4c] default='nothing'</para></listitem>
</varlistentry>
<varlistentry id="nmlv_ocn_io_numtasks"><term><option>ocn_pio_numtasks (int)</option></term> 
<listitem><para>number of io tasks in pio for ocean. default=unset</para></listitem>
</varlistentry>
<varlistentry id="nmlv_ocn_io_root"><term><option>ocn_pio_root (int)</option></term> 
<listitem><para>io task root in pio for ocean. default=unset</para></listitem>
</varlistentry>
<varlistentry id="nmlv_ocn_io_stride"><term><option>ocn_pio_stride (int)</option></term> 
<listitem><para>stride of tasks in pio for ocean. default=unset</para></listitem>
</varlistentry>
<varlistentry id="nmlv_ocn_io_typename"><term><option>ocn_pio_typename (char)</option></term> 
<listitem><para>io type in pio for ocean. [nothing, netcdf, pnetcdf, netcdf4p, netcdf4c] default='nothing'</para></listitem>
</varlistentry>
<varlistentry id="nmlv_glc_io_numtasks"><term><option>glc_pio_numtasks (int)</option></term> 
<listitem><para>number of io tasks in pio for land ice. default=unset</para></listitem>
</varlistentry>
<varlistentry id="nmlv_glc_io_root"><term><option>glc_pio_root (int)</option></term> 
<listitem><para>io task root in pio for land ice. default=unset</para></listitem>
</varlistentry>
<varlistentry id="nmlv_glc_io_stride"><term><option>glc_pio_stride (int)</option></term> 
<listitem><para>stride of tasks in pio for land ice. default=unset</para></listitem>
</varlistentry>
<varlistentry id="nmlv_glc_io_typename"><term><option>glc_pio_typename (char)</option></term> 
<listitem><para>io type in pio for land ice. [nothing, netcdf, pnetcdf, netcdf4p, netcdf4c] default='nothing'</para></listitem>
</varlistentry>

</variablelist>

</sect2>

</sect1>

<sect1 id="infile_seq_maps ">
<title>seq_maps.rc Input File</title>

<para>
The seq_maps.rc file specifies the mapping files for the configuration and is
generated by the cpl.buildnml.csh file.  It is NOT a Fortran namelist
file but the format should be relatively clear from the default settings. 
</para>

<sect2 id="nml_seq_maps">
<title>seq_maps input variables</title>

<variablelist>

<varlistentry id="nmlv_atm2ocnFmapname"><term><option>atm2ocnFmapname (char)</option></term>
<listitem><para> The atm to ocn mapping file for flux fields.  Set by MAP_A2OF_FILE in env_conf.xml  idmap is a special string used here to specify that just a copy is required.</para></listitem>
</varlistentry>

<varlistentry id="nmlv_atm2ocnFmaptype"><term><option>atm2ocnFmaptype (char)</option></term>
<listitem><para> The type of mapping desired, either "source" or "destination" mapping.  X is associated with rearrangement of the source grid to the destination grid and then local mapping.  Y is associated with mapping on the source grid and then rearrangement and sum to the destination grid.</para></listitem>
</varlistentry>

<varlistentry id="nmlv_atm2ocnSmapname"><term><option>atm2ocnSmapname (char)</option></term>
<listitem><para> see atm2ocnFmapname above but for atm to ocn scalar fields using env variable MAP_A2OS_FILE</para></listitem>
</varlistentry>

<varlistentry id="nmlv_atm2ocnSmaptype"><term><option>atm2ocnSmaptype (char)</option></term>
<listitem><para> see atm2ocnFmaptype above</para></listitem>
</varlistentry>

<varlistentry id="nmlv_ocn2atmFmapname"><term><option>ocn2atmFmapname (char)</option></term>
<listitem><para> see atm2ocnFmapname above but for ocn to atm flux fields using env variable MAP_O2AF_FILE</para></listitem>
</varlistentry>

<varlistentry id="nmlv_ocn2atmFmaptype"><term><option>ocn2atmFmaptype (char)</option></term>
<listitem><para> see atm2ocnFmaptype above</para></listitem>
</varlistentry>

<varlistentry id="nmlv_ocn2atmSmapname"><term><option>ocn2atmSmapname (char)</option></term>
<listitem><para> see atm2ocnFmapname above but for ocn to atm scalar fields using env variable MAP_O2AS_FILE</para></listitem>
</varlistentry>

<varlistentry id="nmlv_ocn2atmSmaptype"><term><option>ocn2atmSmaptype (char)</option></term>
<listitem><para> see atm2ocnFmaptype above</para></listitem>
</varlistentry>

<varlistentry id="nmlv_atm2iceFmapname"><term><option>atm2iceFmapname (char)</option></term>
<listitem><para> see atm2ocnFmapname above but for atm to ice flux fields using env variable MAP_A2IF_FILE</para></listitem>
</varlistentry>

<varlistentry id="nmlv_atm2iceFmaptype"><term><option>atm2iceFmaptype (char)</option></term>
<listitem><para> see atm2ocnFmaptype above</para></listitem>
</varlistentry>

<varlistentry id="nmlv_atm2iceSmapname"><term><option>atm2iceSmapname (char)</option></term>
<listitem><para> see atm2ocnFmapname above but for atm to ice scalar fields using env variable MAP_A2IS_FILE</para></listitem>
</varlistentry>

<varlistentry id="nmlv_atm2iceSmaptype"><term><option>atm2iceSmaptype (char)</option></term>
<listitem><para> see atm2ocnFmaptype above</para></listitem>
</varlistentry>

<varlistentry id="nmlv_ice2atmFmapname"><term><option>ice2atmFmapname (char)</option></term>
<listitem><para> see atm2ocnFmapname above but for ice to atm flux fields using env variable MAP_I2AF_FILE</para></listitem>
</varlistentry>

<varlistentry id="nmlv_ice2atmFmaptype"><term><option>ice2atmFmaptype (char)</option></term>
<listitem><para> see atm2ocnFmaptype above</para></listitem>
</varlistentry>

<varlistentry id="nmlv_ice2atmSmapname"><term><option>ice2atmSmapname (char)</option></term>
<listitem><para> see atm2ocnFmapname above but for ice to atm scalar fields using env variable MAP_I2AS_FILE</para></listitem>
</varlistentry>

<varlistentry id="nmlv_ice2atmSmaptype"><term><option>ice2atmSmaptype (char)</option></term>
<listitem><para> see atm2ocnFmaptype above</para></listitem>
</varlistentry>

<varlistentry id="nmlv_atm2lndFmapname"><term><option>atm2lndFmapname (char)</option></term>
<listitem><para> see atm2ocnFmapname above but for atm to lnd flux fields using env variable MAP_A2LF_FILE</para></listitem>
</varlistentry>

<varlistentry id="nmlv_atm2lndFmaptype"><term><option>atm2lndFmaptype (char)</option></term>
<listitem><para> see atm2ocnFmaptype above</para></listitem>
</varlistentry>

<varlistentry id="nmlv_atm2lndSmapname"><term><option>atm2lndSmapname (char)</option></term>
<listitem><para> see atm2ocnFmapname above but for atm to lnd scalar fields using env variable MAP_A2LS_FILE</para></listitem>
</varlistentry>

<varlistentry id="nmlv_atm2lndSmaptype"><term><option>atm2lndSmaptype (char)</option></term>
<listitem><para> see atm2ocnFmaptype above</para></listitem>
</varlistentry>

<varlistentry id="nmlv_lnd2atmFmapname"><term><option>lnd2atmFmapname (char)</option></term>
<listitem><para> see atm2ocnFmapname above but for lnd to atm flux fields using env variable MAP_L2AF_FILE</para></listitem>
</varlistentry>

<varlistentry id="nmlv_lnd2atmFmaptype"><term><option>lnd2atmFmaptype (char)</option></term>
<listitem><para> see atm2ocnFmaptype above</para></listitem>
</varlistentry>

<varlistentry id="nmlv_lnd2atmSmapname"><term><option>lnd2atmSmapname (char)</option></term>
<listitem><para> see atm2ocnFmapname above but for lnd to atm scalar fields using env variable MAP_L2AS_FILE</para></listitem>
</varlistentry>

<varlistentry id="nmlv_lnd2atmSmaptype"><term><option>lnd2atmSmaptype (char)</option></term>
<listitem><para> see atm2ocnFmaptype above</para></listitem>
</varlistentry>

<varlistentry id="nmlv_rof2ocnFmapname"><term><option>rof2ocnFmapname (char)</option></term>
<listitem><para> see atm2ocnFmapname above but for runoff to ocean fields using env variable MAP_R2O_FILE_R05, MAP_R2O_FILE_R019, or MAP_R2O_FILE_RX1 depending on the configuration.</para></listitem>
</varlistentry>

<varlistentry id="nmlv_rof2ocnFmaptype"><term><option>rof2ocnFmaptype (char)</option></term>
<listitem><para> see atm2ocnFmaptype above</para></listitem>
</varlistentry>

</variablelist>

</sect2>

</sect1>

</chapter>
