acl_expand_file_name_c

	status.i4.v = acl_expand_file_name_c(file_name.i1a.r, file_type.i4.v,
					     options.u4.v, actual_name.i1a.r
					     [,max_return.i4.v])

	This routine expands an Accelerator Command Language (ACL) file name.

	file_name	null terminated file name to expand
	file_type	type of file
			(ACL_FLAT_FILE -> ASCII text file,
			 ACL_DB_FILE -> "file_name" should be in the database
					table named ACL_DB_TABLE)
	options		read options
			(ACL_OPT_NONE -> no options selected)
	actual_name	returned null terminated actual file name
			(default is NULL)
	[max_return]	maximum number of characters to return for the
			actual name
			(default is 0 (no limit))

	This function returns ACNET status values as follows:

	OK			success
	CLIB_INVARG		invalid file type passed
	CLIB_MEMFAIL		failed in allocating dynamic memory
	otherwise		other ACNET format error code

	This function requires the following include files:

	ul_acl_h:acl_h, acnet_errors_h

	Related functions:

	intro_acl, acl_file_exists_c, acl_db_file_exists_c, acl_file_read_c,
	acl_file_write_c, acl_file_execute_c, acl_execute_c, acl_compile_c,
	acl_free_c, acl_free_arg_info_c, acl_read_symbol_c,
	acl_read_symbol_as_string_c, acl_read_symbol_info_c,
	acl_read_symbol_dynamic_info_c, acl_read_symbol_names,
	acl_read_intrinsic_symbol_names, acl_parse_symbol_name,
	acl_script_argument_info_c, acl_script_has_symbol_list_c,
	acl_script_has_setting_c, acl_delete_symbol, acl_reinit_symbol,
	acl_info_c, acl_cancel_requests_c, acl_set_symbol_c,
	acl_default_data_source_c, acl_log_file_c, acl_default_script_path_c,
	db_close, acl_script_is_executing, acl_register_host_request_func,
	acl_unregister_host_request_func, acl_translate_command_string,
	acl_file_read_description_c, acl_file_read_author_c,
	acl_file_read_title_c, acl_search_db_files_c,
	acl_file_is_in_repository_c, acl_parse_script_argument_string_c,
	acl_get_user_execution_privilege, acl_get_user_db_edit_permission

	C/C++ usage:

	static const char	file_name[] = "/some_path/acl_file.acl";
	char	actual_name[MAX_RETURN+1];
	int	status;
	int	file_type = ACL_FLAT_FILE;
	int	max_return = MAX_RETURN;
	unsigned int	options = ACL_OPT_NONE;

	status = acl_expand_file_name_c(file_name,file_type,options,actual_name,
					max_return);