bpm_file_menu_c

	choice.i4.v = bpm_file_menu_c(top_row.i4.v, left_column.i4.v
				      [,filter.i4.v] [,options.u4.v]
				      [,file_range.i4a.r])

	This routine displays a menu of BPM save files for the currently
	selected machine.  It returns the number of the file selected or
	zero if no file was selected.  See bpm_machine_c.

	top_row		top row of menu (use WMNGR_CENTER for centering
			or WINDOW_xxx_COORD macros in macro for special
			positioning)
	left_column	left column of menu (use WMNGR_CENTER for centering
			or WINDOW_xxx_COORD macros in macro for special
			positioning)
	[filter]	filter on files to be displayed in the menu
			(BPM_ALL_FILES -> display all files (default),
			 BPM_PROTECTED_FILES -> display only protected files,
			 BPM_REFERENCE_FILES -> display only reference files,
			 BPM_LINKED_FILES -> display only files linked to
					     other files)
	[options]	special option selection
			(BPM_OPT_NONE -> no options selected,
			 BPM_OPT_TIME_ORDER -> order meu entries in ascending
					       time order (default is in file
					       number order),
			 BPM_OPT_FILE_TITLE -> display the BPM file name as
					       the menu title,
			 BPM_OPT_UNUSED_FILES -> allow the user to select a
						 previously unused file
						 (overrides request for
						  time order))
	[file_range]	array containing the minimum and maximum file numbers
			to include (default is NULL which results in selecting
			all file numbers)

	This function returns status values as follows:

	CBS_NO_SUCH		no directory entries found
	SQL_xxx			database error
	otherwise		number of file selected or zero if no file
				was selected

	This function requires the following include files:

	ul_cbsaux/bpmuti.h, cbslib_h, macro_h, acnet_errors_h

	Related functions:

	bpm_machine_c, bpm_directory_info, bpm_protect_file_c,
	bpm_rename_file_c, bpm_save_data, bpm_set_save_file,
	bpm_master_file_menu_c

	C/C++ usage:

	int	choice;
	int	top_row = WMNGR_CENTER;
	int	left_column = WMNGR_CENTER;
	int	filter = BPM_ALL_FILES;
	int	*file_range = (int *) NULL;
	unsigned int	options = BPM_OPT_NONE;

	choice = bpm_file_menu_c(top_row,left_column,filter,options,file_range);