input_file_name(_c)

	status.i4.v = input_file_name_c(top_row.i4.v, left_column.i4.v,
					prompt_text.i1a.r, num_chars.i4.v,
					file_name.i1a.r, max_length.i4.v,
					browse_spec.i1a.r, browse_options.u4.v,
					title.i1a.r, help_info.s.r)

	This routine will prompt the user to input a 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)
	prompt_text	prompt text string
	num_chars	number of characters in the prompt string
			(If a value of zero is passed for this argument,
			the routine will automatically determine the prompt
			text length.)
	file_name	returned null terminated file name
	max_length	maximum length of returned file name (If this is
			negative, the current value of "file_name" is
			displayed.)
	browse_spec	starting null terminated file specification for
			use of browse button
	browse_options	browse options
			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)
	title		null terminated window title (If no title is desired,
			pass a value of NULL.)
	help_info	help callback information  (A value of NULL can be
			passed if no help information is to be supplied.)
			(structure of type HELP_CALLBACK_DATA)

	This function returns status values as follows:

	OK			success
	CBS_INVARG		requested file name length is too int
	CBS_WINDOW_TOO_BIG	window won't fit on the screen
	CBS_MEMFAIL		dynamic memory allocation failure
	CBS_ABORT		user aborted input (file name was not changed)

	This function requires the following include files:

	cnsparam_h, cns_data_structs_h, cbslib_h, macro_h, acnet_errors_h

	Related functions:

	inptxt(_c), input_string_dialog_c, file_view_select, dialog_setup_c,
	window_restore_hint_c

	C/C++ usage:

	static const char	title[] = "Title";
	static const char	prompt_text[] = "File name";
	char		file_name[FILE_NAME_LENGTH+1];
	static const char	browse_spec[] = "/usr/local/userb/";
	int		status;
	int		top_row = WMNGR_CENTER;
	int		left_column = WMNGR_CENTER;
	int		num_chars = 0;
	int		max_length = FILE_NAME_LENGTH;
	unsigned int	browse_options = FILE_VIEW_PARENT;
	HELP_CALLBACK_DATA	*help_info = (HELP_CALLBACK_DATA *) NULL;

	status = input_file_name_c(top_row,left_column,prompt_text,num_chars,
				   file_name,max_length,browse_spec,
				   browse_options,title,help_info);