TDS640__Initialize (ul_pbar_instruments)

 *  Synopsis:
 *    #include <ul_pbar_instruments:tds640.h>
 *
 *    CTDS640ptr TDS640__Initialize( int *errorCode, const int retryCount,
 *				     const char *houseName,
 *				     const char *moduleType,
 *				     const int nodeID,
 *				     const int moduleAddress,
 *				     const char *moduleName )
 *
 *  Function intent:
 *    TDS640__Initialize() does a GPIB select to establish a connection to
 *    the specified module and if successful returns a unique TDS 640 module
 *    pointer for use in future TDS640__ calls.
 *    It also initializes the TDS 640 to the factory settings as outlined in
 *    Appendix F of the User Manual.
 *    It also initializes the Device Event Status Enable Register (DESER),  the
 *    Event Status Enable Register (ESER) and the Service Request Enable
 *    Register (SRER).
 *  Function parameters:
 *    int	*errorCode	GPIB I/O status/error code - returned
 *    int	retryCount	ACNET I/O error retry count:
 *				  0 <= retryCount <= 10
 *    char	*houseName	ASCII house name (2 characters)
 *    char	*moduleType	ASCII module type (4 characters)
 *    int	nodeID		Front end node identification.  If the node
 *				points to a VME crate, the houseName and
 *				moduleType arguments are ignored.
 *    int	modAddress	Unit's GPIB addres
 *				  0 <= modAddress <= 255
 *    char	*moduleName	Any descriptive text identifying the module
 *				  if NULL is passed the module's nodeID
 *				  and modAddress are encoded into a string
 *				  of the form:
 *					TDS 640 @ Addr xxxx
 *  errorCode return values:
 *    CBS_OK		The unit was successfully initialized
 *    CLIB_INVARG	Invalid parameter value
 *    CLIB_INVALID_DATA	TDS 640 status error after GPIB command
 *    CLIB_MEMFAIL	Memory allocation failed
 *    CLIB_NO_SUCH	The responding module returned the wrong *IDN? string
 *    CBS_INVARG	Invalid GPIB address or
 *			no such module type for the given front end
 *    CBS_NO_SUCH	VME interface device doesn't exist
 *    CBS_NODAT		VME interface device could not be retrieved
 * 			for this GPIB address
 *    DIO_xxx		Error retrieving VME interface device
 *    GAS_xxx_yyy	GAS error
 *  Function return value:
 *    NULL		GPIB I/O error, see errorCode parameter
 *    otherwise		unique TDS 640 module pointer