acl_file_write_c

	status.i4.v = acl_file_write_c(file_name.i1a.r, file_type.i4.v,
				       command_text.ia.r, command_length.i4.v,
				       description.i1a.r, long_descrip.i1a.r
				       [,options.u4.v] [,error_string.i1a.r])

	This routine writes Accelerator Command Language (ACL) code to a
	file or database table.  If the database option is chosen, the
	table which will be written to is ACL_DB_TABLE.

	file_name	null terminated file name
	file_type	type of file
			(ACL_FLAT_FILE -> ASCII text file,
			 ACL_DB_FILE -> "file_name" will be the database
					table name written to ACL_DB_TABLE)
	command_text	ASCII commands to execute
	command_length	total length of command text  (If a value of zero
			is passed for this argument, the command text will
			be treated as a single null terminated string.)
	description	null terminated description of this file
	long_descrip	null terminated verbose description of this file
	[options]	options (not presently used)
			(ACL_OPT_NONE -> no options selected (default))
	[error_string]	returned error string
			(Allow ACL_ERROR_STRING_LEN + 1 characters.)
			(A value of NULL can be passed for this argument
			 if this information is not needed.) (default is NULL)

	This function returns ACNET status values as follows:

	OK			success
	CLIB_NOTOPN		failed to open file
	CLIB_SYNTAX		syntax error
	CLIB_INVSIZ		command line too long
	CLIB_CORRUPT		command buffer is corrupted
	CLIB_NOTENB		writes not allowed on this console
	SQL_xxx			error accessing database
	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_read_c, acl_file_exists_c, acl_db_file_exists_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, 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_expand_file_name_c, acl_get_user_execution_privilege,
	acl_get_user_db_edit_permission

	C/C++ usage:

	static const char	file_name[] = "acl_file.acl";
	static const char	command_text[] = "read M:OUTTMP";
	static const char	description[] = "read outdoor air temperature";
	static const char	long_descrip[] = "longer description";
	char	error_string[ACL_ERROR_STRING_LEN+1];
	int	status;
	int	file_type = ACL_FLAT_FILE;
	int	command_length = 0;

	status = acl_file_write_c(file_name,file_type,command_text,
				  command_length,description,long_descrip,
				  options,error_string);