bpm_frame_file_menu_c

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

	This routine displays a menu of BPM frame 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)
	file_range	array containing the minimum and maximum file numbers
			to include (Passing a value of NULL results in selecting
			all file numbers.)
	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))

	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_file_menu_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_frame_file_menu_c(top_row,left_column,filter,file_range,
				       options);