Rebuilding the executable

The model should be rebuilt under the following circumstances:

If env_conf.xml, env_build.xml or $Macros.$MACH has been modified, and/or if code is added to SourceMods/src.*, then it's safest to clean the build and rebuild from scratch as follows,


> cd $CASEROOT
> $CASE.$MACH.clean_build
> $CASE.$MACH.build

If ONLY the PE layout has been modified in env_mach_pes.xml (see setting the PE layout) then it's possible that a clean is not required.


> cd $CASEROOT
> $CASE.$MACH.build

But if the threading has been turned on or off in any component relative to the previous build, then the build script should error as follows


  ERROR SMP STATUS HAS CHANGED
    SMP_BUILD = a0l0i0o0g0c0
    SMP_VALUE = a1l0i0o0g0c0
    A manual clean of your obj directories is strongly recommendend
    You should execute the following:
      ./b39pA1.yellowstone.clean_build
    Then rerun the build script interactively
    ---- OR ----
    You can override this error message at your own risk by executing
      ./xmlchange -file env_build.xml -id SMP_BUILD -val 0 
    Then rerun the build script interactively

and suggest that the model be rebuilt from scratch.

Note: The user is responsible for manually rebuilding the model when needed. If there is any doubt, you should rebuild.