file_view_select

	status.i4.v = file_view_select(top_row.i4.v, left_column.i4.v,
				       menu_width.i4.v, menu_length.i4.v,
				       file_spec.i1a.r, file_name.i1a.r,
				       match.i1a.r, show_dir.i4.v
				       [,order_by.i4.v] [,options.u4.v])
	
	This routine displays directories of files.  It allows movement up
	and down the directories associated with the starting file string,
	"file_name".  It returns the user selected file name.

	top_row		top row of window (use WMNGR_CENTER for centering
			or WINDOW_xxx_COORD macros in macro for special
			positioning)
	left_column	left column of window (use WMNGR_CENTER for centering
			or WINDOW_xxx_COORD macros in macro for special
			positioning)
	menu_width	maximum width of menu
			(If a value of 0 is passed for this argument, this
			 routine will determine the appropriate menu width.)
	menu_length	maximum length of menu
	file_spec	desired file string, including disk and
			use of wildcards
			(ex: "/scratch/userb/pic/photos/objects/ *.gif")
	file_name	returned string of selected filename
			(caller should allocate 256 bytes for this)
	match		string to set default menu selection to
			(pass a value of NULL if no default is desired)
			(ex: "/scratch/userb/pic/photos/objects/diamond.gif")
	show_dir	when looking for wildcard filenames,
			parent and child directories displayed:
			(FILE_VIEW_NODIR  -> don't show parent and child,
			 FILE_VIEW_CHILD  -> show child directories,
			 FILE_VIEW_PARENT -> show parent directory,
			 FILE_VIEW_PARENT_CONSTRAIN -> show parent
						       directory but do not
						       allow access to root's
						       parent,
			 FILE_VIEW_FAMDIR -> show parent & child)
				--- or ---
			specify extended file information:
			(bitwise-OR values for composite information;
			 composite information shown in following order)
			(FILE_VIEW_CDATE  -> show file creation date,
			 FILE_VIEW_MDATE  -> show file modification date,
			 FILE_VIEW_CHANGE_DATE  -> show file change date,
			 FILE_VIEW_ACCESS_DATE  -> show file access date,
			 FILE_VIEW_SIZE   -> show file size)
				--- or ---
			specify special handling:
			(bitwise-OR values)
			(FILE_VIEW_NOMESS -> don't display a message window
					     if the requested directory is
					     empty)
	[order_by]	determine file order
			(FILE_VIEW_ORDER_BY_NAME -> order nby name
						    alphabetically (default),
			 FILE_VIEW_ORDER_BY_CREATION_DATE -> order by file
							     creation date)
	[options]	file viewing options
			(FILE_VIEW_OPT_NONE -> no options selected (default),
			 FILE_VIEW_OPT_INVERT_ORDER -> invert the sort order)

	This function returns ACNET status values as follows:

	OK			success
	CBS_MEMFAIL		failed in allocating dynamic memory
	CBS_INVARG		invalid file specification passed
	CBS_NO_SUCH		no files matched the requested specification
	CBS_INVSIZ		menu is too wide

	This function requires the following include files:

	cbslib_h, macro_h, acnet_errors_h

	Related functions:

	file_view_read, file_view_find, menu_setup_c, file_acknowledge_c,
	file_decide_c

	C/C++ usage:

	static const char	file_spec[] = "/some_path/";
	char	file_name[256];
	char	*match = (char *) NULL;
	int	status;
	int	top_row = WMNGR_CENTER;
	int	left_column = WMNGR_CENTER;
	int	menu_width = MENU_WIDTH;
	int	menu_length = MENU_LENGTH;
	int	show_dir = FILE_VIEW_FAMDIR;
	int	order_by = FILE_VIEW_ORDER_BY_NAME;
	unsigned int	options = FILE_VIEW_OPT_NONE;

	status = file_view_select(top_row,left_column,menu_width,
				  menu_length,file_spec,file_name,
				  match,show_dir,order_by,options);