dio_value_text_c

	status.i4.v = dio_value_text_c(device_index.i4.v, property.i2.v,
				       element.i4.v, ftd.i4.v, format.i4.v,
				       value_string.i1a.r, units.i1a.r
				       [,max_length.i4.v] [,options.u4.v])

	This routine reads a scaled value for a specified device and
	property and returns this value as a null terminated ASCII string.
	The routine, dio_tuner(_c), can be used to adjust reading timeout
	values if necessary.  If a repetitive Frequency Time Descriptor
	(FTD) is selected, the request can be cancelled by a call to
	dio_cancel_get_array_c or dio_can_get_c.

	device_index	device index
	property	device property (constants are in 'dbprops')
			(PRREAD -> reading property,
			 PRSET -> setting property,
			 PRNAME -> device name property,
			 PRTEXT -> device description property,
			 PRFLNM -> device full name property,
			 PRFLTX -> device full description property)
	element		element to return (starts at 0) (Note:  A nonzero
			value for this argument only makes sense in the
			case of an array device.)
			(Note: This argument is ignored for properties
			 PRNAME, PRTEXT, PRFLNM, and PRFLTX.)
	ftd		frequency/time that data is collected
			(FTD_ONESHOT -> one shot,
			 FTD_DEFAULT -> use database default FTD,
			 FTD_1HZ -> 1 Hz request (Note: This value can be
				    multiplied by an integer constant to
				    retrieve data every "constant" seconds.),
			 FTD_EVENT_MASK OR'ed with TCLK event value -> read
			 on TCLK event (event constants are in 'tclk_events')
			 (can use the macro BUILD_EVENT_FTD(event) or
			  BUILD_EVENT_PLUS_DELAY_FTD(event,delay) in 'macro'))
			(Note: This argument is ignored for properties
			 PRNAME, PRTEXT, PRFLNM, and PRFLTX.)
	format		desired format of output string
			(DIO_FORMAT_NO_SPACES -> no leading or trailing blanks,
			 DIO_FORMAT_SPACE_PADDED -> blank padded to the default
						    length for that device,
			 DIO_FORMAT_UNIFORM_LENGTH -> blank padded to a length
						      of DIO_LONG_DISPLAY_LEN)
	value_string	returned null terminated value string
			(DIO_LONG_DISPLAY_LEN + 1 characters)
	units		returned null terminated units text
			(LEN_DEV_UNITS + 1 characters)
			(If a value of NULL is passed, no text is returned.)
	[max_length]	maximum output length
			(default is DIO_LONG_DISPLAY_LEN)
	[options]	display options
			(DIO_DISPLAY_OPT_NONE -> no options selected (default),
			 DIO_DISPLAY_OPT_ALLOW_TRUNCATED -> allow truncated
							    display strings)

	This function returns ACNET status values as follows:

	OK			success
	DIO_MEMFAIL		memory allocation failure
	DIO_INVDEV		not a valid array device
	DIO_BADARG		invalid array element or format type requested
	DIO_SCALEFAIL		no scaling information available
	negative value		ACNET format error

	This function requires the following include files:

	cnsparam_h, dbprops_h, diolib_h, acnet_errors_h, tclk_events_h, macro_h

	Related functions:

	dio_raw_to_value_text_c, dio_get_array_device_c,
	dio_get_array_device_double_c, dio_cancel_get_array_c,
	dio_get_dev(_c), dio_can_get(_c), dio_get_raw(_c),
	dio_get_lst, dio_get_directed_list, dio_tuner(_c),
	dio_raw_to_value_text_c, dio_scaled_to_value_text_c

	C/C++ usage:

	char	value_string[DIO_LONG_DISPLAY_LEN+1];
	char	units[LEN_DEV_UNITS+1];
	short	property = PRSET;
	int	status;
	int	device_index = 14430;
	int	element = 0;
	int	ftd = FTD_ONESHOT;
	int	format = DIO_FORMAT_UNIFORM_LENGTH;
	int	max_length = DIO_LONG_DISPLAY_LEN;
	unsigned int	options = DIO_DISPLAY_OPT_NONE;

	status = dio_value_text_c(device_index,property,element,ftd,format,
				  value_string,units,max_length,options);