sr_sda_get_status_text_over_time_c

	status.i4.v = sr_sda_get_status_text_over_time_c(device_index.i4.v,
							 sda_usage.i1a.r,
							 search_type.i4.v,
							 search_info.g.v,
							 case_info.s.r,
							 set_info.s.r,
							 options.u4.v,
							 num_points.i4.r,  
							 status_text.sp.r,
							 value_data.sp.r,
							 [,vals_per_point.i4.r]
							 [,raw_length.i4.v]
							 [,raw_offset.i4.v])

	This routine returns device status text from data that has been
	previously saved by the SDA system.  It returns data from a group
	of samples with the data in time order.

	device_index	device index
	sda_usage	null terminated SDA usage string
			(If a value of NULL is passed for this argument,
			 a value of 'ColliderShot' will be used.)
	search_type	type of file search
			(SRMNGR_SEARCH_BY_ALL -> search all files,
			 SRMNGR_SEARCH_BY_FILE_NUMBER -> search by file number,
			 SRMNGR_SEARCH_BY_DATE -> search by date)
	search_info	search information which depends on "search_type"
			(SRMNGR_SEARCH_BY_ALL -> argument is unused,
			 SRMNGR_SEARCH_BY_FILE_NUMBER -> structure of type
							 SRMNGR_SEARCH_BY_FILE_DATA,
			 SRMNGR_SEARCH_BY_DATE -> structure of type
						  SRMNGR_SEARCH_BY_DATE_DATA)
	case_info	case search limits
			(structure of type SRMNGR_SEARCH_SDA_CASE_DATA)
			(If a value of SRMNGR_SEARCH_SDA_DEVICE_CASES is
			 passed for the minimum case number, only cases
			 currently configured to retrieve this device
			 will be searched.)
			(Note: Passing a value of NULL will result in a
			 search including all cases.)
	set_info	set search limits
			(structure of type SRMNGR_SEARCH_SDA_SET_DATA)
			(Note: Passing a value of NULL will result in a
			 search including all sets.)
	options		retrieval options (currently unused)
	num_points	returned number of saved points found
	status_text	returned device status text
			(array of XCHAR structures with
			 DIO_NUM_STATUS_TYPES + 1 structures per entry)
			(Note: This is a pointer to a buffer allocated by this
			 routine. The caller should neither allocate or free
			 this buffer.)
	value_data	returned value data (pointer to an array of
			structures of type SRMNGR_SDA_SEARCH_VALUE_DATA)
			(Note: This is a pointer to a buffer allocated by
			 this routine. The caller should neither allocate
			 or free this buffer.)
	[vals_per_point]returned number of values per entry (default is NULL)
	[length]	raw device length (default is 0 which results in
			using the database default size for each device)
	[offset]	raw data offset or array of data offsets in bytes
			(default is 0)

	This function returns status values as follows:

	OK			success
	DIO_MEMFAIL		memory allocation failure
	DIO_INVLEN		too much data requested
	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, cbslib_h, acnet_errors_h

	Related functions:

	sr_set_source_c, sr_get_status_text_over_time_c,
	sr_sda_get_device_over_time_c, sr_sda_get_device_over_time_raw_c,
	sr_get_device_over_time_c, sr_get_device_over_time_raw_c,
	sr_get_device_c, sr_get_device_raw_c, sr_sda_data_lengths_c,
	sr_status_c, sr_status_text_c, sr_is_on_c, sr_is_positive_c,
	sr_sda_snapshot_stats_c, sr_snapshot_header_c, sr_snapshot_info_c,
	sr_snapshot_info_list_c, sr_get_snapshot_c, sr_read_snapshot_c,
	sr_disconnect, sr_get_array_device_c, sr_sda_cases_present_c,
	sr_sda_num_subcases_c, sr_sda_subcases_present_c, sr_sda_case_times_c

	C/C++ usage:

	static const char	sda_usage[] = "ColliderShot";
	int	status;
	int	device_index = 4976;
	int	search_type = SRMNGR_SEARCH_BY_DATE;
	int	num_points;
	int	values_per_point;
	int	length = 2;
	int	offset = 0;
	unsigned int	options = 0;
	XCHAR	*status_text;
	SRMNGR_SEARCH_BY_DATE_DATA	search_info;
	SRMNGR_SEARCH_SDA_CASE_DATA	*case_info = (SRMNGR_SEARCH_SDA_CASE_DATA *) NULL;
	SRMNGR_SEARCH_SDA_SET_DATA	*set_info = (SRMNGR_SEARCH_SDA_SET_DATA *) NULL;
	SRMNGR_SDA_SEARCH_VALUE_DATA	*value_data;

	status = sr_sda_get_status_text_over_time_c(device_index,sda_usage,
						    search_type,
						    (void *) &search_info,
						    case_info,set_info,
						    options,&num_points,
						    &status_text,&value_data,
						    &vals_per_point,length,
						    offset);
-