<html>
  <head>
    <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
  </head>
  <body>
    <p>Folks,</p>
    <p>We are changing the value of the BMS_OSNAME environment variable.
      Some user-owned directories will need patching to work with the
      new scheme. A script to do the patching will be available (see
      below). This action was discussed and endorsed at recent Software
      Meetings.</p>
    <p>The change occurs when we update from Build Scripts version 2.34
      to version 3.0.<b> This will occur at JLab at 8:00 am, on
        Wednesday, June 8.</b></p>
    <p>Note<b>: </b>there is a test version of the new Build Scripts
      checked out at /group/halld/Software/build_scripts-3.0 for those
      who would like to test the new arrangement.<br>
      <b></b> </p>
    <p>This change will affect you if you have any private builds of
      certain GlueX packages (e.g., halld_recon, halld_sim) or if you
      have personal plugins in your HALLD_MY directory. Also people who
      maintain their own GLUEX_TOP directories will have to apply a
      patch. You will know that you have been affected if you start to
      suddenly get file-not-found-like errors.</p>
    <p>The script to patch your directories is
      $BUILD_SCRIPTS/change_bms_osname.sh. The usage message is</p>
    <pre>usage: change_bms_osname.sh <target>
    
where target is one of

  "jlab": convert the /group/halld/Software/builds tree at JLab (script must be
          executed from a directory named "builds")
  "gluex_top": convert a GLUEX_TOP tree (GLUEX_TOP must be defined in the
               environment)
  "halld_my": convert a HALLD_MY tree (HALLD_MY must be defined in the
              environment)
  "jana": convert a jana tree (JANA_HOME must be defined in the environment)
  "hdds": convert a hdds tree (HDDS_HOME must be defined in the environment)
  "halld_recon": convert a halld_recon tree (HALLD_RECON_HOME must be defined in
                 the environment)
  "halld_sim": convert a halld_sim tree (HALLD_SIM_HOME must be defined in the
               environment)
  "gluex_root_analysis": convert a gluex_root_analysis tree (ROOT_ANALYSIS_HOME
                         must be defined in the environment)

</pre>
    <p>So, for example, if you want to patch your private build of
      halld_sim, the command is</p>
    <pre>$BUILD_SCRIPTS/change_bms_osname.sh halld_sim</pre>
    <p>The script uses the definition of HALLD_SIM_HOME that it finds in
      your environment to identify the directory to be patched.</p>
    <p>Basically, since BMS_OSNAME appears in the directory structure
      for our packages, links have to be added, from new name to old
      name, to keep the built package viable after the change.</p>
    <p>A table of old and new BMS_OSNAME definitions is attached.</p>
      -- Mark<br>
  </body>
</html>