C.7 Result Tag Library

The Result tag library contains functionalities specific to the Operations Center application for iterating through data returned by the performance engine.

To reference custom tags in the Operations Center Results tag library, add the following code to the top of the JSP file before the <html> tag:

URL = <%@ taglib uri="http://www.managedobjects.com/taglibs/remote/query/result" prefix="result" %>

When a request is performed within the createQuery tag, the result cubes contain the requested information. Iterate these result cubes using the tags belonging to the Result tag library.The following sections explain the tags:

C.7.1 iterator

Cycles through the result cubes returned by the performance engine:

<result:iterator id=”identifier”>

[JSP Body Content] </result:iterator>

To cycle through the result cubes, the iterator tag must be provided within the performQuery tag. All other specific iteration tags, such as alarms and metrics, must also be used within the iterator tag. In order to iterate through the results properly, it is necessary to understand the structure of the query and the resulting cubes. Iteration through the results could become complex if the structure of the query is complex, such as when using nested queries and expansion. Thus, the resulting iteration must analyze the structure of the query and resulting cubes.

C.7.2 ResultTagSupport Class

Acts as a super class for all the tags belonging to result iteration. The methods available in this class retrieve information while iterating the result. Tags that belong to result iteration inherit the functionalities of ResultTagSupport, either directly or indirectly.

The following sections provide the methods for the ResultTagSupport class:

getCompliance()

This method obtains the compliance of an element’s agreement or its objective. This method returns availability as a double value.

public double getCompliance()

getAvailability()

This method obtains the availability of an element’s agreement or its objective. Availability is the amount of time when the condition of an element is below the selected threshold condition. This method returns availability as a double value

public double getAvailability()

getElementCondition()

This method returns a String object that describes the state or condition (OK, CRITICAL, MAJOR, and so on) of an Operations Center element.

public String getElementCondition()

getCondition()

This method returns a String object that describes the state or condition (OK, CRITICAL, MAJOR, and so on) of an element’s objective or an agreement.

public String getCondition()

getBreachCount()

This method returns a breach count as an integer (int) value. A breach count is the number of breaches that occur in a Service Level Agreement or its objective.

public int getBreachCount()

getOutageCount()

This method returns an outage count as an integer (int) value. An outage count is the number of outages that occur in an agreement.

public int getOutageCount()

getDowntime()

This method returns the downtime of an element’s objective as a long value. Downtime is the total time that elapsed during an outage (such as the duration of an outage) when an element condition is above the selected threshold condition

public long getDowntime()