C.5 Request Tag Library

The Request custom tag library contains tags that can access information in the Operations Center performance engine.

To reference this custom tags in the Operations Center 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/request" prefix="request" %>

To obtain results using the performQuery tag, it is necessary to use request tags to obtain any type of information from the Operations Center performance engine. Use the request tag within a createQuery tag as you might use constrain and expand tags. All the tags belonging to this library have no body content. It is possible to provide any number of unique requests within a query. When a request is provided within a createQuery tag, it adds the requested value into the query result set. When the performQuery starts executing the tag, it takes the requests from the query and creates results containing the value.

The syntax for using the request tag is: <query:createQuery> <constrain:element name="<%=dname%>"> <request:availability> <query:performQuery> [result manipulation] </query:performQuery> </query:createQuery>

C.5.1 summaryState

Obtains the condition or state of a given Operations Center element:

<request:summaryState/>

C.5.2 compliance

Requests compliance from an element’s agreement/objectives for a specified period of time:

<request:compliance/>

A time constrain tag must be provided within the createQuery tag to provide a time window to obtain compliance from the performance engine.

It is necessary to provide the element, time and offering constrain tags and a compliance request tag within the createQuery tag to obtain compliance from an element’s agreement (SLA):

<constrain:time from="start time" to="end time"/> <constrain:element name=” org=Check+Bill/root=Organizations”/> <constrain:offering name=“SLA Name”/> <request:compliance/>

C.5.3 availability

Requests availability of an element’s agreement (SLA) or of an objective of an agreement, for a specified period of time:

<request:availability/>

A time constrain tag must be provided within the createQuery tag to use a time window to obtain availability from the performance engine.

In order to make available an element’s agreement, provide the element and offering constraints and request availability within the createQuery tag, as shown in the following code:

<constrain:time from="<%=""+start%>" to="<%=""+end%>" /> <constrain:element name=” org=Check+Bill/root=Organizations”> <constrain:offering name=“<%=SLA%>”> <request:availability>

C.5.4 outageCount

Requests the outage count (the number of times an outage occurred) for an element’s agreement or objective:

<request:outageCount/>

To obtain the outage count, a time constrain tag must be provided.

C.5.5 breachCount

Requests the breach count (the number of times a breach occurred) from an element’s agreement/ objectives for a specified period of time.

<request:breachCount/> <request:breachCount filter=”(severity=major)”/> <request:breachCount filter=”(severity=major)&(alarm.status=closed)”/>

A time constrain tag is required within the createQuery tag to provide a time window to obtain a breach count from the performance engine. The optional attribute filter selects the type of alarms to consider when counting the breach.

To obtain a breach count for an element agreement, provide the element and offering constrain tags and request a breach count within the createQuery tag:

<constrain:time from="start time" to="end time" /> <constrain:element name=” org=Check+Bill/root=Organizations”/> <constrain:offering name=“SLA Name”/> <request:breachCount/>

C.5.6 outageDuration

Requests the outage duration (how long an outage occurred) for an element’s agreement or objective:

<request:outageDuration/>

The time constrain tag must provide the time span to use for obtaining the outage count from the performance engine.

C.5.7 objectiveInstance

Requests an instance of an objective of a given Operations Center element:

<request:objectiveInstance/>

The results returned are the name, description, and other information about the objective. To obtain the instance of an objective, the element, offering, and objective constrain tags must be provided within the createQuery tag.