dio_is_status_attribute_value_c

	status.i4.v = dio_is_status_attribute_value_c(device_index.i4.v,
						      attribute.i1a.r,
						      attr_status.i4.r
						      [,attr_string.i1a.r]
						      [,data_event.i1ar]
						      [,num_elements.i4.v]
						      [,start_element.i4.v])

	This routine returns a device status attribute value.

	device_index	device index
	attribute	desired null terminated attribute string
	attr_status	returned attribute status value
			(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_string]	returned status attribute value string
			(allow DIO_STATUS_SCALING_STATE_TEXT_LEN + 2 characters
			 per element)
			(default is NULL)
	[data_event]	data event on which data is collected
			(default is NULL (one shot))
	[num_elements]	number of array elements to return
			(default is 1)
	[start_element]	first element to return (starts at 0)
			(default is 0)

	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_is_status_attribute_state_value_c,
	dio_is_status_attribute_value_list,
	dio_is_status_attribute_value_by_id_c,
	dio_build_status_attribute_value_list_c, dio_status_scaling_info_c,
	dio_status_scaling_attributes_c,
	dio_raw_to_status_attribute_value_by_id_c,
	dio_raw_to_status_state_value_by_id_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:

	static const char	attribute[] = "On/Off";
	char	attr_string[DIO_STATUS_SCALING_STATE_TEXT_LEN+2];
	static const char	data_event[] = "i";
	int	status;
	int	device_index = 14430;
	int	attr_status;
	int	num_elements = 1;
	int	start_element = 0;

	status = dio_is_status_attribute_value_c(device_index,attribute,
						 &attr_status,attr_string,
						 data_event,num_elements,
						 start_element);