dio_status_scaling_attributes_c

	status.i4.v = dio_status_scaling_attributes_c(device_indices.i4a.r,
						      num_entries.i4a.r,
						      status_strings.i1a.r,
						      attribute_ids.i4a.r,
						      errors.i2a.r
						      [,max_return.i4.v]
						      [,num_devices.i4.v]
						      [,short_strings.i4.v])

	This routine returns status scaling attributes for a device.
	The number of status entries per device is returned in "num_entries".
	If "max_entries" is specified, the number of entries per device
	returned will be limited to that number.  "num_entries", however,
	will always contain the number of entries in the database for the
	corresponding device.  If "num_devices" is specified, status
	scaling attributes for a list of devices can be retrieved.

	device_indices	device index or array of device indices
	num_entries	returned number of status scaling attributes or
			array of number of status scaling attributes (A value
			of NULL may be passed if no entry counts are needed.)
	status_strings	returned array of corresponding null terminated
			status attribute names
			(allow DIO_STATUS_SCALING_TEXT_LEN + 2 characters
			 per entry for long status strings and
			 DIO_STATUS_SCALING_SHORT_TEXT_LEN + 2 characters
			 for short status strings)
			(A value of NULL may be passed if no actual status
			 scaling attribute names are needed.)
	attribute_ids	returned array of attribute_ids
			(A value of NULL may be passed if no actual status
			 scaling attribute names are needed.)
	errors		returned ACNET status value or array of status values
	[max_return]	maximum number of status scaling attributes to return
			per device
			(default is DIO_MAX_STATUS_SCALING_ENTRIES attributes)
	[num_devices]	number of devices (default is 1)
	[short_strings]	flag indicating whether or not short status strings
			are desired
			(TRUE -> want short status strings,
			 FALSE -> want long status strings (default))

	This function returns status values as follows:

	OK			success
	DIO_BADARG		invalid number of devices passed
	DIO_MEMFAIL		memory allocation failure
	negative value		ACNET format error indicating overall failure
	positive value		number of devices in error indicating partial
				success

	This function requires the following include files:

	cnsparam_h, diolib_h, acnet_errors_h

	Related functions:

	dio_status_scaling_info_c, dio_is_status_attribute_value_c,
	dio_is_status_attribute_state_value_c,
	dio_is_status_attribute_value_list,
	dio_is_status_attribute_value_by_id_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_state_c,
	dio_find_status_scaling_by_mask_c, dio_pdb_sts, dio_get_pdb,
	dio_scaling, dio_status(_c), dio_sts_lst, dio_get_raw(_c),
	dio_get_lst_raw(_c), error_in_list(_c)

	C/C++ usage:

	char	status_strings[NUM_DEVICES*DIO_MAX_STATUS_SCALING_ENTRIES*DIO_STATUS_SCALING_TEXT_LEN+2];
	short	errors[NUM_DEVICES];
	int	status;
	static const int	device_indices[NUM_DEVICES] = {14430, 14431};
	int	num_entries[NUM_DEVICES];
	int	attribute_ids[NUM_DEVICES*DIO_MAX_STATUS_SCALING_ENTRIES];
	int	max_return = MAX_ENTRIES;
	int	num_devices = NUM_DEVICES;
	int	short_strings = FALSE;

	status = dio_status_scaling_attributes_c(device_indices,num_entries,
						 status_strings,attribute_ids,
						 errors,max_return,num_devices,
						 short_strings);