acl_read_symbol_dynamic_info_c
status.i4.v = acl_read_symbol_dynamic_info_c(symbol_name.i1a.r,
options.u4.v,
dynamic_info.s.r)
This routine reads the dynamic information about a symbol created by
an Accelerator Command Language (ACL) script. These symbols still
exist after the ACL file has finished executing to determine
reading or status values resulting from the execution or as
inputs to other scripts.
symbol_name null terminated symbol name
options read symbol name options
(ACL_OPT_NONE -> no options selected,
ACL_OPT_READ_VARIABLE -> return variable info (This
should only be used during
an execution callback.))
dynamic_info returned dynamic symbol information
(structure of type ACL_SYMBOL_DYNAMIC_DATA)
This function returns ACNET status values as follows:
CLIB_OK success
CLIB_NO_SUCH symbol doesn't exist
CLIB_DELETED symbol has been deleted
This function requires the following include files:
acl_h, acnet_errors.h
Related functions:
intro_acl, acl_read_symbol_info_c, acl_read_symbol_c,
acl_read_symbol_as_string_c, acl_set_symbol_c,
acl_parse_symbol_name, acl_execute_c, acl_file_execute_c,
acl_file_read_c, acl_file_write_c, acl_db_file_exists_c,
acl_compile_c, acl_free_c, acl_free_arg_info_c, acl_read_symbol_names,
acl_read_intrinsic_symbol_names, 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_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_search_db_files_c
C/C++ usage:
static const char symbol_name[] = "my_symbol";
int status;
unsigned int options = ACL_OPT_NONE;
ACL_SYMBOL_DYNAMIC_DATA dynamic_info;
status = acl_read_symbol_dynamic_info_c(symbol_name,options,
&dynamic_info);