dio_raw_to_control_text_c

	status.i4.v = dio_raw_to_control_text_c(device_indices.i4a.r,
						raw_data.g.v,
						control_text.i1a.r,
						errors.i2a.r
						[,num_devices.i4.v]
						[,lengths.i4a.r]
						[,long_text.i4.v]
						[,options.u8.v])

	This routine converts raw basic control data (property PRBCTL) to
	its corresponding command text.

	device_indices	device index or array of device indices
	raw_data	raw basic control data returned
	control_text	returned control text
			(allow DIO_DIGITAL_CONTROL_TEXT_LEN or
			 DIO_DIGITAL_CONTROL_SHORT_TEXT_LEN characters
			 per entry depending on the value of "long_text")
	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.)
			(Passing a value of NULL results in using the database
			 minimum size for each device.)
			(default is NULL)
	[long_text]	flag indicating whether or not to return long text
			(TRUE -> return long text (DIO_DIGITAL_CONTROL_TEXT_LEN
				 characters per entry),
			 FALSE -> return short text
				  (DIO_DIGITAL_CONTROL_SHORT_TEXT_LEN characters
				   per entry) (default))
	[options]	scaling options
			(DIO_OPT_NONE -> no options selected (default),
			 DIO_OPT_TREAT_AS_ATOMIC -> treat each of the raw values
						    as single, atomic values)

	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_digital_control_info_c, dio_pdb_ctl, dio_raw_to_status_text,
	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, 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];
	char	control_text[NUM_DEVICES][DIO_DIGITAL_CONTROL_TEXT_LEN];
	short	errors[NUM_DEVICES];
	int	status;
	static const int	device_indices[NUM_DEVICES] = {14430, 14431};
	int	num_devices = NUM_DEVICES;
	int	long_text = TRUE;
	int	*lengths = (int *) NULL;
	unsigned long long	options = DIO_OPT_NONE;

	status = dio_raw_to_control_text_c(device_indices,(void *) raw_data,
					   (char *) control_text,errors,
					   num_devices,lengths,long_text,
					   options);