GPIB__InitInstrumentDir (ul_pbar_gpib)

 *  Synopsis:
 *    #include <ul_pbar_gpib:gpibdir.h>
 *
 *    int GPIB__InitInstrumentDir( void )
 *
 *  Function intent:
 *    GPIB__InitInstrumentDir() opens the instrument directory file on the first
 *    call, and initializes the directory search function.  Successive calls may
 *    be done as necessary to initialize searches of the instrument directory
 *    for multiple instruments.
 *  Function parameters:
 *    none
 *  Function return value:
 *    FSHARE_OK		success
 *    CBS_MEMFAIL	error in allocating dynamic memory
 *    FSHARE_xxx	error opening or reading file
 *    CBS_INVNAME	file name is too long
 *    CBS_NO_SUCH	unable to seek requested record
 *    CBS_GENERR	unable to read requested record
 *    CBS_TIMEOUT	timeout on locked record
 *    CBS_MEMFAIL	error in allocating dynamic memory