dio_raw_to_status_attribute_value_by_id_c

	status.i4.v = dio_raw_to_status_attribute_value_by_id_c(device_index.i4.v,
								raw_data.g.v,
								attribute_id.i4.v,
								attr_status.i4.r,
								attr_strings.i1a.r,
								errors.i2a.r
								[,num_devices.i4.v]
								[,lengths.i4a.r])

	This routine converts raw device data to a status attribute value
	specified by an attribute ID.

	device_indices	device index or array of device indices
	raw_data	raw basic status data to scale
	attribute_id	desired scaling attribute ID
	attr_status	returned attribute status value or array of
			status values
			(TRUE -> device is in the attribute state,
			 FALSE -> device is not in the attribute state,
			 DIO_NOATT -> attribute is not defined)
			(need to provide "num_elements" values)
	attr_strings	returned status attribute value string or array
			of strings
			(allow DIO_STATUS_SCALING_STATE_TEXT_LEN + 2 characters
			 per element)
			(default is NULL)
	errors		array of returned ACNET status values
			(one for each device)
	[num_devices]	number of devices
			(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)

	This function returns status values as follows:

	OK			success
	DIO_NO_SUCH		no status scaling information found
	DIO_NOATT		requested attribute not found
	negative value		ACNET format error

	This function requires the following include files:

	cnsparam_h, diolib_h, acnet_errors_h

	Related functions:

	dio_raw_to_status_state_value_by_id_c,
	dio_is_status_attribute_value_by_id_c, dio_is_status_attribute_value_c,
	dio_is_status_attribute_state_value_c,
	dio_is_status_attribute_value_list,
	dio_build_status_attribute_value_list_c, dio_status_scaling_info_c,
	dio_status_scaling_attributes_c, dio_find_status_scaling_attr_id_c,
	dio_find_status_scaling_attribute_c,
	dio_find_status_scaling_by_attr_id_c,
	dio_find_status_scaling_by_mask_c,
	dio_find_status_scaling_by_state_c, dio_pdb_sts, dio_get_pdb,
	dio_is_on(_c), dio_is_ready(_c), dio_is_remote(_c),
	dio_is_positive(_c), dio_status(_c), dio_sts_lst, dio_get_raw(_c)

	C/C++ usage:

	char	raw_data[TOTAL_LENGTH];
	char	attr_strings[NUM_DEVICES][DIO_STATUS_SCALING_STATE_TEXT_LEN+2];
	short	errors[NUM_DEVICES];
	int	status;
	static int	device_indices[NUM_DEVICES] = {14430, 14431};
	int	attribute_id = 1;
	int	attr_status[NUM_DEVICES];
	int	num_devices = NUM_DEVICES;
	int	*lengths = (int *) NULL;

	status = dio_raw_to_status_attribute_value_by_id_c(device_indices,
							   raw_data,
							   attribute_id,
							   attr_status,
							   attr_strings,
							   errors,num_devices,
							   lengths);