acl_free_c
status.i4.v = acl_free_c(compiled_code.gp.r, options.u4.v,
error_string.i1a.r)
This routine frees a block of compiled Accelerator Command Language
(ACL) code that was built by an earlier call to 'acl_compile_c'.
compiled_code block of code to free (passed by reference)
options free options
(ACL_OPT_NONE -> no options selected,
ACL_OPT_CANCEL_REQUESTS -> cancel data requests)
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.)
This function returns ACNET status values as follows:
CLIB_OK success
CLIB_INVARG not a valid block of compiled code
This function requires the following include files:
cbslib_h, acnet_errors.h
Related functions:
intro_acl, acl_compile_c, acl_execute_c, acl_file_execute_c,
acl_file_read_c, acl_file_write_c, acl_read_symbol_c,
acl_read_symbol_info_c, acl_read_symbol_names, 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 command_text[] = "set B:HB812 700.0";
char *subst_devices = (char *) NULL;
char error_string[133];
short default_ftd = FTD_ONESHOT;
int status;
int command_length = 0;
int num_devices = 0;
unsigned int options = ACL_OPT_PARSE_ONLY;
void *compiled_code;
status = acl_compile_c(command_text,command_length,subst_devices,
num_devices,default_ftd,options,&compiled_code,
error_string);
.
. (execute code multiple times)
.
status = acl_free_c(&compiled_code,options,error_string);