dio_sts_txt(_c)

	status.i4.v = dio_sts_txt(device_index.i4.r, status_text.sa.r
				  [,ftd.i2.r] [,num_elements.i4.r]
				  [,start_element.i4.r] [ret_ramp_dc.i4.r])

	status.i4.v = dio_sts_txt_c(device_index.i4.v, status_text.sa.r
				    [,ftd.i2.v] [,num_elements.i4.v]
				    [,start_element.i4.v] [ret_ramp_dc.i4.v])

	This routine returns basic status text for a single device in the
	XCHAR color coded text format.  There is one character for each basic
	status attribute.

	device_index	device index
	status_text	returned DIO_NUM_STATUS_TYPES characters of XCHAR
			format color coded status text per entry
			(array of XCHAR structures)
			(Note: If the value of "ret_ramp_dc" is TRUE,
			 there will be DIO_NUM_STATUS_TYPES + 1 characters
			 of XCHAR format color coded status text per entry.)
	[ftd]		frequency/time that data is collected
			(FTD_ONESHOT -> one shot (default),
			 FTD_DEFAULT -> use database default FTD,
			 FTD_1HZ -> 1 Hz request,
			 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'))
	[num_elements]	number of array elements to return
			(default (NULL) is 1)
	[start_element]	first element to return (starts at 0)
			(default (NULL) is 0)
	[ret_ramp_dc]	flag which indicates whether or not to return ramp/DC
			attribute text
			(TRUE -> return ramp/DC attribute text,
			 FALSE -> don't return ramp/DC attribute text
				  (default))

	This function returns ACNET status values as follows:

	OK			success
	DIO_MEMFAIL		memory allocation failure
	DIO_INVDEV		not an array device
	DIO_BADARG		invalid array element specified
	negative value		ACNET format error

	This function requires the following include files:

	cnsparam_h, cns_data_structs_h, diolib_h, acnet_errors_h, tclk_events_h, macro_h

	Related functions:

	dio_sts_txt_lst, dio_raw_to_status_text,
	dio_raw_to_status_text_extended_c, dio_status(_c),
	dio_raw_to_status_c, dio_raw_to_status_extended_c,
	dio_cancel_get_array_c

	C/C++ usage:

	short	ftd = FTD_ONESHOT;
	int	status;
	int	device_index;
	int	num_elements = NUM_ELEMENTS;
	int	start_element = START_ELEMENT;
	int	ret_ramp_dc = FALSE;
	XCHAR	status_text[NUM_ELEMENTS][DIO_NUM_STATUS_TYPES];

	status = dio_sts_txt_c(device_index,(XCHAR *) status_text,ftd,
			       num_elements,start_element,ret_ramp_dc);