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, $_string, $_status, $_return_value,
	$_line_number, $_execution_index, $_error_status, $_last_error_status,
	$_error_line, $_error_execution_index, $_error_command,
	$_error_source_text, $_pending_count, $_error_count, $_error_device,
	$_last_error_device, $_generic_error_count, $_error_string,
	$_command_error, $_num_device_args, $_num_string_args, $_proc_status,
	$_script_name, $_num_devices, $_num_values, $_eof, $_temp,
	$_output_strings, $_last_execution_status, $_last_exit_value_type).

	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:

	OK			success
	CLIB_MEMFAIL		dynamic memory allocation failure
	CLIB_NO_SUCH		no symbol exists

	This function requires the following include files:

	ul_acl_h:acl_h, acnet_errors_h

	Related functions:

	intro_acl, acl_read_intrinsic_symbol_names, acl_parse_symbol_name,
	acl_script_has_symbol_list_c, acl_read_symbol_info_c,
	acl_read_symbol_dynamic_info_c, acl_read_symbol_c,
	acl_read_symbol_as_string_c, acl_set_symbol_c,
	acl_delete_symbol, acl_reinit_symbol, acl_execute_c,
	acl_file_execute_c, acl_compile_c, acl_free_c, acl_free_arg_info_c,
	acl_file_read_c, acl_file_write_c, _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, acl_file_read_description_c,
	acl_file_read_author_c, acl_file_read_title_c, acl_search_db_files_c,
	acl_script_argument_info_c, acl_script_has_setting_c,
	acl_get_user_execution_privilege, acl_get_user_db_edit_permission

	C/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);