dio_raw_to_status_text

	status.i4.v = dio_raw_to_status_text(device_indices.i4a.r, raw_data.g.v,
					     status_text.sa.r, errors.i2a.r
					     [,num_devices.i4.r]
					     [,lengths.i2a.r]
					     [ret_ramp_dc.i4.r])

	This routine converts raw basic status data (property PRBSTS) to four
	(or five) color coded characters of basic status text.

	device_indices	device index or array of device indices
	raw_data	raw basic status data returned by a previous
			call to dio_get_raw(_c) or dio_get_lst_raw(_c)
	status_text	returned status text (array of DIO_NUM_STATUS_TYPES
			XCHAR structures containing color coded text for
			each device)
			(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 device.)
	errors		returned ACNET status value or array of returned
			status values
	[num_devices]	number of devices in list (default is 1)
	[lengths]	device length or array of lengths for support of
			array devices  (If the first value is less than zero,
			all devices will use a length which is equal to the
			absolute value of this argument.)
			(default is NULL which results in using the database
			 default/atomic size for each device)
	[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 status values as follows:

	OK			success
	DIO_MEMFAIL		memory allocation failure
	DIO_INVLEN		an invalid device length was requested for
				one or more devices
	negative value		other ACNET format error
	positive value		number of devices in error

	This function requires the following include files:

	cns_data_structs_h, dbprops_h, diolib_h, acnet_errors_h

	Related functions:

	dio_raw_to_status_text_extended_c, dio_raw_to_status_c,
	dio_raw_to_status_extended_c, dio_sts_txt(_c),
	dio_bld_get(_c), dio_sts_txt_lst, dio_get_raw(_c), dio_bld_get_raw(_c),
	dio_get_lst_raw(_c), dstatx, dio_raw_to_scaled_data(_c),
	dio_raw_to_value_text_c, dio_raw_to_scaled_custom_c,
	dio_primary_to_scaled_custom_c, dio_scaled_to_raw_custom_c,
	error_in_list(_c)

	C/C++ usage:

	char	raw_data[TOTAL_LENGTH];
	short	errors[NUM_DEVICES];
	short	*lengths = (short *) NULL;
	int	status;
	static const int	device_indices[NUM_DEVICES] = {14430, 14431};
	int	num_devices = NUM_DEVICES;
	int	ret_ramp_dc = FALSE;
	XCHAR	status_text[NUM_DEVICES][DIO_NUM_STATUS_TYPES];

	status = dio_raw_to_status_text(device_indices,(void *) raw_data,
					(XCHAR *) status_text,errors,
					&num_devices,lengths,&ret_ramp_dc);