GPIB__InstrumentMenuSelect (ul_pbar_gpib)

 *  Synopsis:
 *    #include <ul_pbar_gpib:gpibdir.h>
 *
 *    int GPIB__InstrumentMenuSelect( const char *instrumentType,
 *                                    const int row, const int col,
 *                                    char *model, char *name,
 *                                    char *house, char *module, int *node,
 *                                    int *address,
 *                                    const int nullTerminate )
 *
 *  Function intent:
 *    GPIB__InstrumentMenuSelect() displays a pop-up menu of instruments of the
 *    specified type and returns addressing and identification information for
 *    the user selected item.  The routine will open the instrument directory
 *    if necessary.  Upon return the user may call GPIB__CloseInstrumentDir()
 *    to release directory resources if desired.  If the nullTerminate parameter
 *    is TRUE then the routine will null terminate all returned strings.  In
 *    this event the caller is responsible for providing space for the null
 *    terminator in all string parameter buffers.
 *  Function parameters:
 *    instrumentType	instrument type code string (e.g., NA, SA, OS, VM)
 *                        Use "**" to match any instrument type
 *                        (KTYPE_LENGTH characters)
 *    row		screen row of upper left corner of menu
 *                        use WMNGR_CENTER_IT for centering
 *    col		screen col of upper left corner of menu 
 *                        use WMNGR_CENTER_IT for centering
 *    model		returned instrument model (KMODEL_LENGTH characters)
 *    name		returned instrument name (KNAME_LENGTH characters)
 *    house		returned ACNET house ID (KHOUSE_LENGTH characters)
 *    module		returned ACNET module ID (KMODULE_LENGTH characters)
 *    node		returned ACNET node ID
 *    address		returned GPIB instrument address
 *    nullTerminate	NULL terminate strings:
 *                      TRUE = terminate, FALSE = don't terminate
 *  Function return value:
 *    CBS_INVARG	illegal instrument type
 *    CLIB_NO_SUCH	instrument type not found in directory
 *    TRUE		user made a valid menu selection
 *    FALSE		user interrupted outside of menu