bpm_find_oldest_file_number_c

	status.i4.v = bpm_find_oldest_file_number_c(file_number.i4.r
						    [,options.u4.v])

	This routine searches through a master BPM file for the
	oldest entry.  There are options to exclude protected and
	linked files in the search.  See bpm_machine_c.

	file_number	returned number of oldest file
	[options]	search options
			(BPM_OPT_NONE -> no options selected (default),
			 BPM_OPT_LINKED -> include linked files,
			 BPM_OPT_PROTECTED -> include protected files)

	This function returns ACNET status values as follows:

	OK			success
	CBS_MEMFAIL		failed to allocate memory
	CBS_BUGCHK		internal failure (should never happen)
	SQL_xxx			database error

	This function requires the following include files:

	ul_cbsaux/bpmuti.h, acnet_errors_h

	Related functions:

	bpm_machine_c, bpm_next_unlinked_file_c, bpm_file_link_info_c,
	bpm_link_file_c, bpm_unlink_file_c, bpm_get_save_file,
	bpm_get_default_save_file, bpm_set_save_file, bpm_save_data,
	bpm_file_menu_c, bpm_directory_info

	C/C++ usage:

	int	status;
	int	file_number;
	unsigned int	options = BPM_OPT_NONE;

	status = bpm_find_oldest_file_number_c(&file_number,options);