logger_read_array_device_multiple_c

	status.i4.v = logger_read_array_device_multiple_c(device_index.i4.v,
							  property.i2.v,
							  array_index.i4.v,
							  num_elements.i4.v,
							  node.u2.v,
							  start_time.u4.v,
							  start_nanos.u4.v,
							  end_time.u4.v,
							  end_nanos.u4.v,
							  min_delta_time.u4.v,
							  num_skip.i4.v,
							  timestamps.u4p.r,
							  nanoseconds.u4p.r,
							  values.r8p.r,
							  num_arrays.u4.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]
							  [,update_func.f.v]
							  [,actual_node.u2.r])

	This routine returns logged values for an array device over
	a period of time.

	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'))
	start_time	starting data acquisition time
			(seconds since January 1, 1970 UTC)
	start_nanos	starting time offset in nanoseconds
	end_time	ending data acquisition time
			(seconds since January 1, 1970 UTC)
	end_nanos	ending time offset in nanoseconds
	first_time	returned first timestamp value
	first_nanos	returned first nanosecond value
	min_delta_time	minimum delta time between adjacent points in seconds
	num_skip	number of points to skip (default is 0)
	num_arrays_limit maximum number of arrays to return
			 (a value of 0 will result in returning all arrays)
	timestamps	returned array of individual timestamp values
			(A value of NULL can be passed for this argument.)
			(This argument is allocated by this routine and
			 should be freed by the caller.)
	nanoseconds	returned array of timestamp fractions of a second in
			nanoseconds
			(A value of NULL can be passed for this argument.)
			(This argument is allocated by this routine and
			 should be freed by the caller.)
	values		returned array of device values
			(This argument is allocated by this routine and
			 should be freed by the caller.)
	num_arrays	number of arrays returned
	[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)
			(default is NULL)
	[sample_type]	type of sample specifier
			(LOGGER_SAMPLE_TYPE_NONE -> don't use the sample
						    specifier (default),
			 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.)
			(default is LOGGER_ALL_SDA_CASES)
	[sda_set]	SDA set to return data for (A value of
			LOGGER_ALL_SDA_SETS indicates that all sets
			should be returned.)
			(default is LOGGER_ALL_SDA_SETS)
	[sda_final_data] indicates whether or not to return only the
			 final data samples
			(LOGGER_ANY_SDA_DATA -> return all SDA data values,
			 LOGGER_FINAL_SDA_DATA -> only return the final data
						  values (default))
	[options]	read options
			(LOGGER_OPT_NONE -> no options selected (default),
			 LOGGER_OPT_SDA_DATA -> read SDA data)
	[update_func]	function to be called periodically during data
			retrieval to give information about the progress
			of the data acquisition (a value of NULL may be
			passed if no update function is desired)
			(called as follows:
			 status.i4.v = update_func(update_data.s.r)
			 ("update_data" is a structure of type
			  LOGGER_UPDATE_DATA)
			 (Note: If a status of LJ_ABORT is returned by this
			  function, logger_read_array_device_multiple_c will
			  return immediately to the caller.))
			(default is NULL)
	[actual_node]	returned node actually used for data acquisition
			(default is NULL)

	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_read_array_device_c, 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	num_skip = 0;
	int	num_arrays_limit = 0;
	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_FINAL_SDA_DATA;
	unsigned int	start_time;
	unsigned int	start_nanos = 0;
	unsigned int	end_time;
	unsigned int	end_nanos = 0;
	unsigned int	min_delta_time = 0;
	unsigned int	num_arrays;
	unsigned int	options = LOGGER_OPT_NONE;
	unsigned int	*timestamps;
	unsigned int	*nanoseconds;
	double	*values;
	void	update_func(LOGGER_UPDATE_DATA *update_data);
	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_multiple_c(device_index,property,
						     array_index,num_elements,
						     node,start_time,
						     start_nanos,end_time,
						     end_nanos,min_delta_time,
						     num_skip,num_arrays_limit,
						     &timestamps,&nanoseconds,
						     &values,&num_arrays,
						     sample_spec,sample_type,
						     sda_case,sda_set,
						     sda_final_data,options,
						     update_func,&actual_node);