GPIB__RequestString (ul_pbar_gpib)

 *  Synopsis:
 *    #include <ul_pbar_gpib:gpib.h>
 *
 *    int GPIB__RequestString( const CGPIBptr modulePtr, const char *command,
 *			       char *response, const int maxLenght )
 *
 *  Function intent:
 *    GPIB__RequestString() selects the specified GPIB module if not currently
 *    selected, sends the provided request, and reads and returns the resulting
 *    response string.  If the response string contains an LF or CR immediatly
 *    preceeding the terminating '\0' it is replaced with a '\0'.
 *  Function parameters:
 *    CGPIBptr	modulePtr	The unique GPIB module I/O control pointer
 *                              returned by GPIB__InitializeModule().
 *    char	*command	The null terminated command string to be sent
 *    char	*response	The destination data array
 *    int	maxLenght	The largest data count expected.  If the
 *				actual response is shorter than maxLenght it
 *				will be null terminated.
 *  Function return value:
 *    CBS_OK		command successfully written
 *    CLIB_NO_SUCH	invalid reference number
 *    CBS_INVARG	invalid GPIB address
 *			no such module type for the given front end
 *			or invalid module pointer
 *    CBS_NODAT		VME interface device could not be retrieved
 *   				for this GPIB address
 *    CBS_NO_SUCH	VME interface device doesn't exist
 *    DIO_xxx		error retrieving VME interface device
 *    otherwise		GAS error