Appendix G. env_build.xml variables

The following table lists all the environment variables set in the env_build.xml file. Default values, where appropriate, are given in parentheses.

Table G-1. env_build.xml variables

NameTypeDefaultDescription [Valid Values]
BUILD_COMPLETElogicalFALSEIf TRUE, models have been built successfully. (DO NOT EDIT) [TRUE,FALSE]
BUILD_STATUSinteger0Status of prior build. (DO NOT EDIT)
BUILD_THREADEDlogicalFALSETRUE implies always build model for openmp capability If FALSE, build model with openmp capability only if THREAD is greater than 1 [TRUE,FALSE]
CICE_BLCKXinteger0Size of cice block in first horiz dimension. Value set by generate_cice_decomp.pl (called by configure). Only expert users should edit this
CICE_BLCKYinteger0Size of cice block in second horiz dimension. Value set by generate_cice_decomp.pl (called by configure). Only expert users should edit this
CICE_DECOMPTYPEchar0cice block distribution type. Value set by generate_cice_decomp.pl (called by configure). Only expert users should edit this
CICE_MXBLCKSinteger0Max number of cice blocks per processor. Value set by generate_cice_decomp.pl (called by configure). Only expert users should edit this
COMP_INTERFACEcharMCTuse MCT or ESMF component interfaces [MCT,ESMF]
DEBUGlogicalFALSETRUE implies turning on run and compile time debugging [TRUE,FALSE]
ESMF_LIBDIRchar directory of esmf.mk in pre-built ESMF library
EXEROOTcharUNSETexecutable root directory
GLC_NECinteger0GLC land ice model number of elevation classes [0,3,5,10]
GMAKE_JintegerUNSETNumber of processors for gmake
HIRESlogicalfalsetrue implies compile with HIRES CPP options. Primarily used by POP to determine physics changes for the eddy-resolving ocean resolution. This is a value that is set by the grid resolution. The user should not edit this [true,false]
INCROOTchar$EXEROOT/lib/includecase lib include directory
LIBROOTchar$EXEROOT/libcase lib directory
OBJROOTchar$EXEROOTcase build directory
OCN_TRACER_MODULESchariageOptional ocean tracers. Any combination of: iage cfc ecosys
PIO_CONFIG_OPTSchar --disable-mct --disable-timing PIO configure options, see PIO configure utility for details
POP_BLCKXinteger0Size of pop block in first horiz dimension. Value determined by generate_pop_decomp.pl which is called by configure. Only expert users should edit this
POP_BLCKYinteger0Size of pop block in second horiz dimension. Value determined by generate_pop_decomp.pl which is called by configure. Only expert users should edit this
POP_DECOMPTYPEchar0pop block distribution type. Value determined by generate_pop_decomp.pl which is called by configure
POP_MXBLCKSinteger0Max number of pop blocks per processor. Value determined by generate_pop_decomp.pl which is called by configure. Only expert users should edit this
RUNDIRchar$EXEROOT/runcase run directory
SMP_BUILDchar0smp status of previous build, coded string. (DO NOT EDIT)
SMP_VALUEchar0smp status of current setup, coded string (DO NOT EDIT)
USE_ESMF_LIBcharFALSETRUE implies using the ESMF library specified by ESMF_LIBDIR or ESMFMKFILE [TRUE,FALSE]