acl_read_symbol_info_c

	status.i4.v = acl_read_symbol_info_c(symbol_name.i1a.r, options.u4.v,
					     value_type.i4.r, value_length.i4.r,
					     num_elements.i4.r)

	This routine reads the 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 names  (This
						  should only be used during
						  an execution callback.))
	value_type	returned type of the stored value
			(ACL_BYTE_VALUE -> byte integer value,
			 ACL_UNSIGNED_BYTE_VALUE -> unsigned byte integer value,
			 ACL_SHORT_INT_VALUE -> short integer value,
			 ACL_UNSIGNED_SHORT_VALUE -> unsigned short integer
						     value,
			 ACL_INTEGER_VALUE -> long integer value,
			 ACL_UNSIGNED_INT_VALUE -> unsigned long integer value,
			 ACL_FLOAT_VALUE -> single precision floating
					    point value,
			 ACL_DOUBLE_VALUE -> double precision floating
					     point value,
			 ACL_STRING_VALUE -> null terminated string value,
			 ACL_LOGICAL_VALUE -> logical value (integer value),
			 ACL_DATE_VALUE -> date value in clinks
					   (unsigned integer value),
			 ACL_ERROR_VALUE -> ACNET error value (integer value),
			 ACL_SYSTEM_ERROR_VALUE -> system error value
						   (integer value),
			 ACL_RTL_ERROR_VALUE -> RTL error value (integer value),
			 ACL_NODE_VALUE -> ACNET node value (integer value),
			 ACL_EVENT_VALUE -> clock event value (integer value),
			 ACL_DEVICE_INDEX_VALUE -> device index value
						   (integer value))
	value_length	returned length of the stored value
	num_elements	returned number of elements

	This function returns ACNET status values as follows:

	CLIB_OK			success
	CLIB_NO_SUCH		symbol doesn't exist
	CLIB_DELETED		symbol has been deleted
	CLIB_NOINIT		symbol has not been set

	This function requires the following include files:

	acl_h, acnet_errors.h

	Related functions:

	intro_acl, acl_read_symbol_c, acl_set_symbol_c, acl_execute_c,
	acl_file_execute_c, acl_file_read_c, acl_file_write_c, acl_compile_c,
	acl_free_c, acl_read_symbol_names, acl_delete_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;
	int	value_type;
	int	value_length;
	int	num_elements;
	unsigned int	options = ACL_OPT_NONE;

	status = acl_read_symbol_info_c(symbol_name,options,&value_type,
					&value_length,&num_elements);