
                         Note For CDF YBOS Users
                         -----------------------    
                             
Histo-Scope has been tested and can be used with CDF YBOS applications.
However, instead of using HISTOLIB_DIR:SHR_OPTIONS_FILE.OPT in the link
command for your application, use the file:

     HISTOLIB_DIR:BCOPY_HISTO_OPT.OPT
           
Using this options file is necessary because Histoscope uses libraries
from the TGV MultiNet communication software package.  The Multinet 
libraries unfortunately contain a routine called bcopy which conflicts 
with the YBOS routine of the same name.  Because the Multinet library 
is packaged as a shareable image, steps must be taken to ensure that 
the YBOS bcopy routine takes precedence over the Multinet bcopy routine.
BCOPY_HISTO_OPT references a shareable image, BCOPY_SHR, which is basically
the YBOS routine BCOPY linked with the routines it references from the
YBOS and CERN libraries.  The maintainer of your system's YBOS library
MUST rebuild this shareable image whenever a new release of YBOS or
CERN would make BCOPY_SHR incompatible with that new release.

BCOPY_HISTO_OPT.OPT defines a cluster for BCOPY_SHR, and then defines 
another cluster for HISTO_SHR.  This will cause the linker to use 
BCOPY_SHR to resolve references before using HISTO_SHR and the Multinet
library it references.  As a general guideline, BCOPY_HISTO_OPT.OPT 
should be one of the last options files referenced in your link command.
If your application itself uses clusters in its linker options files, 
please note that the cluster used for HISTO_SHR should be defined AFTER 
all clusters defined for YBOS routines (you may want to extract the two 
lines in the BCOPY_HISTO_OPT.OPT file to arrange the cluster definitions 
as you require).

As a final note, every time you link your YBOS application that references
the YBOS BCOPY routine, you will get a LINK warning message:

     %LINK-W-MULDEF, symbol BCOPY multiply defined
             in module MULTINET_SOCKET_LIBRARY file 
                  MULTINET_COMMON_ROOT:[MULTINET]MULTINET_SOCKET_LIBRARY.EXE
                  
This warning should be ignored as long as it refers to the MULTINET library
instead of the YBOS library or your own routines.
