acl_parse_symbol_name

	status.i4.v = acl_parse_symbol_name(string.i1a.r, symbol_name.i1a.r,
					    array_index.i4.r, num_elements.i4.r [,options.u4.v]
					    [,options.u4.v] [,num_indices.i4.r]
					    [,array_indices.i4p.r])

	This routine parses an Accelerator Command Language (ACL)
	symbol/variable string.

	string		null terminated string to parse
	symbol_name	returned null terminated symbol name
			(allow ACL_SYMBOL_NAME_LEN + 1 characters)
	array_index	returned array index
	num_elements	returned number of elements
	[options]	read symbol name options
			(ACL_OPT_NONE -> no options selected (default),
			 ACL_OPT_READ_VARIABLE -> parse variable names  (This
						  should only be used during
						  an execution callback.))
	[num_indices]	returned number of array indices in 'array_indices'
			for multidimensional arrays
			(default is NULL)
	[array_indices]	returned array of array indices for multidimensional
			arrays  (If "num_indices" has a value greater than 1,
			this array will be allocated by this routine and
			should be freed by the caller.)
			(default is NULL)

	This function returns ACNET status values as follows:

	OK			success
	CLIB_NO_SUCH		symbol doesn't exist
	CLIB_DELETED		symbol has been deleted
	CLIB_NOINIT		symbol has not been set
	otherwise		other ACNET format error code

	This function requires the following include files:

	ul_acl_h:acl_h, acnet_errors_h

	Related functions:

	intro_acl, acl_read_symbol_c, acl_read_symbol_as_string_c,
	acl_read_symbol_info_c, acl_read_symbol_dynamic_info_c,
	acl_set_symbol_c, acl_execute_c, acl_file_execute_c, acl_file_read_c,
	acl_file_write_c, acl_file_exists_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_file_read_author_c, acl_file_read_title_c, acl_search_db_files_c,
	acl_file_is_in_repository_c, acl_parse_script_argument_string_c,
	acl_expand_file_name_c, acl_get_user_execution_privilege,
	acl_get_user_db_edit_permission

	C/C++ usage:

	static const char	string[] = "my_symbol[3]";
	char	symbol_name[ACL_SYMBOL_NAME_LEN+1];
	int	status;
	int	array_index;
	int	num_elements;
	int	num_indices;
	int	*array_indices;
	unsigned int	options = ACL_OPT_NONE;

	status = acl_parse_symbol_name(string,symbol_name,&array_index,
				       &num_elements,options,&num_indices,
				       &array_indices);
			.
			.
			.
	if (array_indices != (int *) NULL) free(array_indices);