acl_read_symbol_names
status.i4.v = acl_read_symbol_names(symbol_names.i1p.r,
num_symbols.i4.r [,options.u4.v])
This routine reads the the list of symbol names created by
Accelerator Command Language (ACL) commands. These symbol
values still exist after the ACL file has finished executing
to determine reading or status values resulting from the execution.
This list does not include the global symbols that are always
present in ACL ($_value, $_status, $_error_status, $_error_device,
$_error_string, $_string, $_return_value, $_script_name,
$_num_device_args, $_num_string_args, $_proc_status, $_eof).
symbol_names returned array of null terminated symbol names
(ACL_SYMBOL_NAME_LEN + 1 characters per entry)
(This memory is allocated by this routine and
should not be freed by the caller.)
num_symbols returned number of symbols
[options] read symbol name options
(ACL_OPT_NONE -> no options selected,
ACL_OPT_READ_VARIABLE -> return variable names (This
should only be used during
an execution callback.))
This function returns ACNET status values as follows:
CLIB_OK success
CLIB_MEMFAIL dynamic memory allocation failure
CLIB_NO_SUCH no symbol exists
This function requires the following include files:
cbslib_h, acnet_errors.h
Related functions:
intro_acl, acl_read_symbol_info_c, acl_read_symbol_c, acl_set_symbol_c,
acl_delete_symbol, acl_execute_c, acl_file_execute_c, acl_compile_c,
acl_free_c, acl_file_read_c, acl_file_write_c, acl_info_c,
acl_cancel_requests_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:
char *symbol_names;
int status;
int num_symbols;
unsigned int options = ACL_OPT_NONE;
status = acl_read_symbol_names(&symbol_names,&symbol_names,options);