sr_get_status_text_over_time_c

	status.i4.v = sr_get_status_text_over_time_c(device_index.i4.v,
						     num_categories.i4.v,
						     categories.i4a.r,
						     search_type.i4.v,
						     search_info.g.v,
						     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 save/restore system.  It returns
	data from a group of files with the data in time order.

	device_index	device index
	num_categories	number of file categories to search
	categories	list of file categories to search
			(SR_GLOBAL -> global supersystem (default),
			 SR_LINAC -> Linac supersystem,
			 SR_BOOSTER -> Booster supersystem,
			 SR_MAININJECTOR -> Main Injector supersystem,
			 SR_EXTERNALBEAMS -> external beams supersystem,
			 SR_TEVATRON -> Tevatron supersystem,
			 SR_MUON -> Muon supersystem,
			 SR_FRIG -> refrigerator supersystem,
			 SR_MISC -> miscellaneous supersystem,
			 SR_ARCHIVE -> archive supersystem,
			 SR_RECYCLER -> Recycler supersystem,
			 SR_SHOTS -> shots supersystem,
			 SR_CIRCULAR -> circular supersystem,
			 SR_MINIBOONE -> MiniBooNE supersystem,
			 SR_NUMI -> NuMI supersystem,
			 SR_PXIE -> PXIE supersystem,
			 SR_NML -> NML supersystem,
			 SR_MTA -> MTA (Muon Test Area) supersystem,
			 SR_SYCONFIG -> Switchyard configuration supersystem,
			 SR_CMTF -> CMTF supersystem,
			 SR_ALL_SYSTEMS -> all supersystems)
	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)
	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_SR_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 maximum 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_sda_get_status_text_over_time_c,
	sr_get_device_over_time_c, sr_get_device_over_time_raw_c,
	sr_sda_get_device_over_time_c, sr_sda_get_device_over_time_raw_c,
	sr_get_device_c, sr_get_device_raw_c, sr_data_length_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:

	int	status;
	int	device_index = 4976;
	int	num_categories = 1;
	int	categories = SR_CIRCULAR;
	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_SR_SEARCH_VALUE_DATA	*value_data;

	status = sr_get_status_text_over_time_c(device_index,num_categories,
						&categories,search_type,
						(void *) &search_info,options,
						&num_points,&status_text,
						&value_data,&vals_per_point,
						length,offset);
-