dio_historic_device_addressing_c

	status.i4.v = dio_historic_device_addressing_c(device_indices.i4a.r,
						       properties.i2a.r,
						       clinks.u4.v,
						       nodes.i4a.r,
						       ssdns.u1a.r,
						       errors.i2a.r
						       [,num_devices.i4.v]
						       [,options.u4.v])

	This routine returns the addressing information for a device
	and property (DI/PI) for a given date.

	device_indices	device index or array of device indices
	properties	property index or array of indices
			(If the first value is less than zero, all devices
			 will be requested with a property index which is
			 equal to the absolute value of this argument.)
			(constants are in 'dbprops')
	clinks		date of interest in clinks
	nodes		returned property node or array of property nodes
			(A value of NULL may be passed if no property nodes
			 are needed.)
	ssdns		returned array of SSDNs
			(A value of NULL may be passed if no SSDNs are needed.)
	errors		returned ACNET status value or array of status values
	[num_devices]	number of devices (default is 1)
	[options]	retrieval options
			(DIO_OPT_NONE -> no options selected (default),
			 DIO_OPT_ALLOW_OBSOLETE -> return data for obsolete
						   devices)

	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, dbprops_h, diolib_h, acnet_errors_h

	Related functions:

	dio_dev_node, dio_dev_ssdn(_c), dio_historic_data_length_c,
	dio_get_historic_scaling_c, dio_raw_to_scaled_historic_c,
	dio_historic_raw_data_type_c,  dio_dpreq_info,
	dio_cache_property_info_c, error_in_list(_c),
	dio_enable_obsolete_dev_info, dio_disable_obsolete_dev_info

	C/C++ usage:

	unsigned char	ssdns[NUM_DEVICES][LEN_SSDN];
	short	errors[NUM_DEVICES];
	short	properties = -PRSET;
	int	status;
	static const int	device_indices[NUM_DEVICES] = {14430, 14431};
	int	nodes[NUM_DEVICES];
	int	num_devices = NUM_DEVICES;
	unsigned int	clinks = DATE_IN_CLINKS;
	unsigned int	options = DIO_OPT_NONE;

	status = dio_historic_device_addressing_c(device_indices,&properties,
						  clinks,nodes,ssdns,errors,
						  num_devices,options);