logger_read_array_device_c

	status.i4.v = logger_read_array_device_c(device_index.i4.v,
						 property.i2.v,
						 array_index.i4.v,
						 num_elements.i4.v,
						 node.u2.v, time.u4.v,
						 time_nanos.u4.v,
						 first_time.u4.r,
						 first_nanos.u4.r,
						 delta_timestamp.u4.r,
						 timestamps.u4a.r,
						 nanoseconds.u4a.r,
						 values.r8a.r,
						 sample_spec.g.v,
						 sample_type.i4.v,
						 sda_case.i4.v, sda_set.i4.v,
						 sda_final_data.i4.v,
						 options.u4.v,
						 actual_node.u2.r)

	This routine returns logged values for an array device.

	device_index	device index
	property	property index (constants are in 'dbprops')
			(PRREAD -> reading property,
			 PRSET -> setting property,
			 PRBSTS -> basic status property,
			 PRBCTL -> basic control property)
	array_index	first element to return (starts at 0)
	num_elements	number of array elements to return
	node		Lumberjack source node
			(LOGGER_ANY_NODE -> routine picks a node logging this
					    device and property,
			 LOGGER_FASTEST_NODE -> routine picks node which is
						logging this device and
						property at the fastest rate,
			 LOGGER_COLLIDER_SDA_NODE -> Collider SDA node,
			 LOGGER_PBAR_SDA_NODE -> Pbar SDA node,
			 otherwise -> Lumberjack node value
				      (constants are in 'nodedefs'))
	time		data acquisition time
			(seconds since January 1, 1970 UTC)
	time_nanos	data acquisition time offset in nanoseconds
	first_time	returned first timestamp value
	first_nanos	returned first nanosecond value
	delta_timestamp	returned range of timestamp values for the requested
			array elements
	timestamps	returned array of individual timestamp values
			(A value of NULL can be passed for this argument.)
	nanoseconds	returned array of timestamp fractions of a second in
			nanoseconds
			(A value of NULL can be passed for this argument.)
	values		returned array of device values
	sample_spec	data sample specifier whose type depends on the
			value of the "sample_type" argument  (Pass a value
			of NULL if no special sampling is being requested.)
			(LOGGER_SAMPLE_TYPE_DATA_EVENT -> string describing
							  data event,
			 LOGGER_SAMPLE_TYPE_LIST_ID -> integer containing
						       list ID number)
	sample_type	type of sample specifier
			(LOGGER_SAMPLE_TYPE_NONE -> don't use the sample
						    specifier,
			 LOGGER_SAMPLE_TYPE_DATA_EVENT -> return data sampled
							  on a particular
							  data event,
			 LOGGER_SAMPLE_TYPE_LIST_ID -> return data from a
						       particular list)
	sda_case	SDA case to return data for (A value of
			LOGGER_ALL_SDA_CASES indicates that all cases
			should be returned.)
	sda_set		SDA set to return data for (A value of
			LOGGER_ALL_SDA_SETS indicates that all sets
			should be returned.)
	sda_final_data	indicates whether or not to return only the
			final data samples
			(LOGGER_ANY_SDA_DATA -> return all SDA data values
						(default),
			 LOGGER_FINAL_SDA_DATA -> only return the final data
						  values)
	options		read options
			(LOGGER_OPT_NONE -> no options selected (default),
			 LOGGER_OPT_SDA_DATA -> read SDA data)
	actual_node	returned node actually used for data acquisition

	This function returns ACNET status values as follows:

	OK			success
	DBM_NOREC		invalid device index
	LJ_INVARG		invalid property or array index
	LJ_NO_SUCH		requested Lumberjack does not have the
				requested device and property or there
				is no data point at the requested time)
	LJ_MEMFAIL		dynamic memory allocation failure

	This function requires the following include files:

	dbprops_h, nodedefs_h, clib_h, acnet_errors_h

	Related functions:

	logger_get_array_device_c, logger_get_device_c,
	logger_get_device_list_c, logger_get_device_by_name_c,
	logger_return_data, logger_read_device_c, logger_read_device_by_name_c,
	logger_setnode, logger_return_names, logger_check_alive,
	logger_restart_lists, logger_shutdown, logger_find_device_c,
	logger_name_to_node, logger_available_device_dates_c,
	logger_available_device_data_entries_c, logger_get_list_data_events_c,
	logger_find_lists_by_data_event_c, logger_find_devices_by_data_event_c

	C/C++ usage:

	short	property = PRREAD;
	unsigned short	node = LOGGER_FASTEST_NODE;
	unsigned short	actual_node;
	int	status;
	int	device_index = 149526;
	int	array_index = 0;
	int	num_elements = NUM_ELEMENTS;
	int	sample_type = LOGGER_SAMPLE_TYPE_NONE;
	int	sda_case = LOGGER_ALL_SDA_CASES;
	int	sda_set = LOGGER_ALL_SDA_SETS;
	int	sda_final_data = LOGGER_ANY_SDA_DATA;
	unsigned int	TIME;
	unsigned int	time_nanos = 0;
	unsigned int	first_time;
	unsigned int	first_nanos;
	unsigned int	delta_timestamp;
	unsigned int	timestamps[NUM_ELEMENTS];
	unsigned int	nanoseconds[NUM_ELEMENTS];
	unsigned int	options = LOGGER_OPT_NONE;
	double	values[NUM_ELEMENTS];
	void	*sample_spec = (void *) NULL;

	TIME = date_to_clinks("01-JAN-2006 12:00",&status);
	TIME = convert_seconds_c(TIME,DATE_CLINKS_TO_GMT);

	status = logger_read_array_device_c(device_index,property,array_index,
					    num_elements,node,TIME,time_nanos,
					    &first_time,&first_nanos,
					    &delta_timestamp,timestamps,
					    nanoseconds,values,sample_spec,
					    sample_type,sda_case,sda_set,
					    sda_final_data,options,
					    &actual_node);