sr_directory_info_by_date_c

	status.i4.v = sr_directory_info_by_date_c(start_date.u4.v,
						  end_date.u4.v,
						  data_source.i4.v,
						  num_categories.i4.v,
						  categories.i4a.r,
						  options.u4.v,
						  num_files.i4.r,
						  directory_info.gp.r)

	This routine will return the save/restore or SDA files from a
	given period of time.

	start_date	start date of desired period in clinks
			(seconds since January 1, 1972)
	end_date	end date of desired period in clinks
			(seconds since January 1, 1972)
	data_source	source of data
			(SRMNGR_NORMAL -> normal save/restore files,
			 SRMNGR_SDA_DATA -> SDA data)
	num_categories	number of categories to check
			(If a value of zero is passed for this argument,
			 all categories will be selected.)
	categories	types of files ("num_categories" entries)
			If the data source is SRMNGR_NORMAL, this argument
			determines which supersystem to check.
			(SR_GLOBAL -> global supersystem,
			 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,
			 CLIB_DEFAULT_ARG -> previously selected supersystem)
			If the data source is SRMNGR_SDA_DATA, this argument
			determines which SDA usage to check.
			(SDA_COLLIDER_SHOT_USAGE_NUMBER -> Collider shot,
			 SDA_PBAR_XFER_SHOT_USAGE_NUMBER -> pbar transfer shot,
			 SDA_RECYCLER_SHOT_USAGE_NUMBER -> Recycler shot)
	options		retrieval options
			(SRMNGR_OPT_NONE -> no options selected,
			 SRMNGR_OPT_ORDER_ASCENDING -> return data in ascending
						       order (default is
						       descending),
			 SRMNGR_OPT_ORDER_BY_NUMBER -> order by file number
						       (default is by date),
			 SRMNGR_OPT_FULL_INFO -> return data as SR_DIR_INFO_FULL
						 structures (default is to
						 return SR_DIR_INFO structures))
	num_files	returned number of files
	directory_info	returned directory information
			(array of structures of type SR_DIR_INFO)
			(This memory is allocated by the routine and
			 should NOT be freed by the caller.) (A value
			 of NULL can be passed for this argument if this
			 information is not needed.)

	This function returns status values as follows:

	OK			success
	CLIB_INVARG		invalid data source
	CLIB_NO_SUCH		no such save/restore category or SDA usage
	CLIB_MEMFAIL		dynamic memory allocation failure
	SQL_xxx			error reading database

	This function requires the following include files:

	cbslib_h, acnet_errors_h

	Related functions:

	sr_directory_info_c, sr_newest_file_c, sr_oldest_file_c,
	sr_maximum_file, sr_file_menu_c, sr_file_devices_c,
	sr_sda_data_lengths_c, sr_sda_cases_present_c,
	sr_sda_subcases_present_c, sr_sda_num_subcases_c, sr_get_device_c,
	sr_get_device_raw_c, sr_get_array_device_c, sr_get_snapshot_c,
	sr_read_snapshot_c, sr_snapshot_header_c, sr_snapshot_info_c,
	sr_snapshot_info_list_c, sr_is_on_c, sr_is_positive_c, sr_status_c,
	sr_status_text_c, sr_restore_device_c, sr_sda_case_times_c

	C/C++ usage:

	int	status;
	int	data_source = SRMNGR_NORMAL;
	int	num_categories = 1;
	int	categories[1] = SR_GLOBAL;
	int	num_files;
	unsigned int	start_date;
	unsigned int	end_date;
	unsigned int	options = SRMNGR_OPT_NONE;
	SR_DIR_INFO	*directory_info;

	status = sr_directory_info_by_date_c(start_date,end_date,data_source,
					     num_categories,categories,
					     options,&num_files,
					     (void **) &directory_info);