Page History

...

The facilities package does some special things at build time which impact the entire container.  It creates a file config.h in the facilities/src directory and the file src/commonUtilities.cxx has a  #include for this file.  The contents of config.h is a macro defining the set of packages in the container, something commonUtilities needs to know in order to properly define environment variables at run-time so that, for example, job options files and xml files may be found.  Each container must have its own compilation of commonUtilities.

Partial Solution

In the new external CommonExt: make a new package, provisionally called commonExtSetup.  Move the commonUtilities class out of facilities into the new package.  Code in commonUtiliites stays the same except namespace will be changed to commonExtSetup and internal references to package or namespace need to be changed.  The new package will build a library libcommonExtSetup.so (or commonExtSetup.dll on Windows).   All references to facilities::commonUtilities in other packages in CommonExt will be changed to commonExtSetup::commonUtilities.  All programs belonging to CommonExt will link against the new library and will therefore be able to define environment variables such as XXXDATAPATH  for all packages XXX belonging to CommonExt by calling commonExtSetup::commonUtilities::setupEnvironment( ).

Outside CommonExt: make a new package, provisionally called runtimeSetup.  Copy the commonUtilities class in here as well, but keep namespace name = facilities. It will build a library libruntimeSetup.so (runtimeSetup.dll).  Change linking of any packages in ST and GR using commonUtilities to include the new library (linking has to be changed anyway for most packages in ST and GR; this won't add significantly to the work involved). All programs belonging to ST (respectively GR) will be able to define environment variables such as XXXDATAPATH for all packages XXX belonging to ST (resp. GR) -- but not for packages in CommonExt -- by calling facilities::commonUtilities::setupEnvironment( ).

Remaining Issues

1. For the most part environment variables pointing inside CommonExt will not be of interest to ST and GR but there are exceptions: environment variables CALDB, CALDBCONFIG and CALDBALIAS having to do with the caldb subpackage of irfs. Possible solutions include
   1. Programs in ST or GR needing these variables can call commonExtSetup::commonUtiities::setupEnvironment( ) as well as facilities::commonUtilites::setupEnvironment.  That might just work as is.
   2. If not (could be, for example, that this only works if you're running with CommonExt where it was built, not if you're running with a copy) add a new routine to commonExtSetup::commonUtilities which defines the CALDB* variables properly for use outside CommonExt
   3. Enhance SCons handling of externals somehow to export these things
2. The class st_facilities::Environment was written to simplify access to commonUtilities::setupEnvironment.  However, since st_facilities will be in CommonExt, it only has access to the internal (namespace commonExtSetup)  version of this routine.  Perhaps the same gambit used for the commonUtilities class will work here.  That is, move the st_facilities::Environment class out of the st_facililties package, into some other package outside of CommonExt. We probably could use the same new package: runtimeSetup.