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 at least 133 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:
CLIB_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:
cbslib_h, acnet_errors.h
Related functions:
intro_acl, acl_file_read_c, acl_file_execute, acl_execute_c,
acl_compile_c, acl_free_c, acl_read_symbol_c, acl_read_symbol_info_c,
acl_read_symbol_names, acl_delete_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
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[133];
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);