Intelligent Management: IIOP operands

Use IIOP operands and their associated protocols in the subexpression utility builder, an optional tool that helps you build complex rule conditions from subexpressions by using AND, OR, NOT and parenthetical grouping.

Use the following subtopic links to find specific information:


Rules

Each work class contains an optional ordered list of rules that are evaluated for a particular request to determine the policy for that request. Each rule consists of a Boolean expression and a policy value. If the expression evaluates to true for a particular request, the policy associated with that rule is used.

The syntax and semantics of a Boolean expression for a rule are similar to the WHERE clause of a Structured Query Language (SQL) expression. More precisely, the syntax of an expression is defined by the Java Message Service (JMS) 1.1 specification. For more information, read about rule-based request classification.

In the JMS specification, identifiers refer to various attributes that can be associated with a request, for example, a specific query parameter, cookie, or HTTP header. A JMS identifier can be thought of as a request variable, or operand. These operands can be specific to a protocol. For example, the SOAP service name is an operand that is valid only in a SOAP work class.

Because the SOAP is over HTTP, the HTTP operands are also valid in a SOAP request. JMS specification uses literals to specify a specific value to use in a comparison to a request variable. For example, in the expression:

'%.ibm.com' is a literal used to compare to the client host name for a request. This expression is true for all requests that originate from a computer in the ibm.com domain. Enclose string literals by single quotes. Do not enclose numeric literals in single quotes. Parentheses together with the AND, OR, and NOT operators can also be used to form compound Boolean expressions. See the JMS 1.1 specification for a detailed description.


IIOP operands

Operand Syntax Description

Application

application The name of the enterprise application where the EJB is contained.

Client host

clienthost The fully-qualified client host name. This is the value of the internet protocol (IP) command host name. This operand does not support numeric operators such as >, >=, <, <=.

Client port

clientport

The client port name.

EJB module

ejbmodule

The module name of an EJB.

EJB name

ejb

The name of an EJB.

EJB method

ejbmethod The name of a method within the EJB.

Percentage

percentage$val The percentage operand evaluates to true, a fixed percentage of the time.

For example, percentage$50 evaluates to true on average 50% of the time.

Port

port The listening port on which the request was received.

Rampup

rampup$startTime

$<completionTime>

The rampup operand evaluates to true a variable percentage of the time. It always evaluates to false before startTime and to true after completionTime. As time progresses from startTime to completionTime, it evaluates to true, a linearly increasing percentage.

The format of startTime and completionTime is day/month/year::hour:min:sec. where day is the day of the month, month is one of the twelve months: Jan, Feb, Mar, Apr, May, Jun, Jul, Aug, Sep, Oct, Nov, Dec, year is the 4 digit year, hour is the 2 digit hour of the 24 hour clock, and min and sec are 2 digit values for minute and second, respectively.

For example, rampup$01/Jan/2007::08:00:00$01/Jan/2007::17:00:00 begins to occasionally evaluate to true at 8 AM on Jan 1, 2007 and always evaluates to true by ramp up completion time at 5 PM of the same day.

Server host

serverhost The fully-qualified host name of the server. This operand does not support numeric operators such as >, >=, <, <=.

Time

time

Used to define the date and time of day that a given request must be honored. Two optional fields are StartTime and EndTime. If a request is received outside of that defined window, the request will not be processed.

The Start Time and End Time fields each have the following format: dayOfWeek/dayOfMonth/month/year::hour:minute:second.

For example, Thursday, the 11th of April, year 2007 at 1:03:45 PM is specified as:

Thu/11/Apr/2007::13:03:45

Any field can use a wild card with the value *.

For example, the 1st of each month is specified as */1.

The dayofWeek values are Sun, Mon, Tue, Wed, Thu, Fri, Sat, and the dayOfMonth values range from 1-31.

The month value is a non-numeric value that represents the twelve months: Jan, Feb, Mar, Apr, May, Jun, Jul, Aug, Sep, Oct, Nov, Dec.

The year value is comprised of the year's four digits. For example, 2007.

The hour value is the hour of day in the 24-hour clock. For example, 8am is represented as ::8. The minute and second are integers ranging from 0-59.

The forward slash (/) is used to separate date parameters, the double colon (::) is used to separate the date parameters, and the colon (:) is used to separate the time of day parameters. Note that it is the Boolean result of the entire rule in which the time operand is used that determines the routing action taken.


Operators

Intelligent Management supports the operators in the following table in the rules expressions. These operators are also referred to as predicates in SQL terminology because they appear inside of a WHERE or HAVING clause. Operators are case insensitive.

Operator Description
OR The logical OR operator.
AND The logical AND operator.
NOT The negation operator.
IN Expresses an operand with multiple values in a single expression. Its meaning is consistent with the SQL standard meaning of the operator.

For example, to express that the port value could be any or all of the values such as 9080, 9090, 9091, use the expression fragment:

    port IN (9080,9090,9091)

In SQL, how the values inside the parenthesis are expressed depends on the data type of port. If the port is an integer, the values without the single quotation marks are syntactically correct. If the port is a string, the correct expression is:

    port IN ('9080','9090','9091')

LIKE

Expresses pattern matching for string operand values. The value must contain the wildcard character (%) in the position where the pattern matching is expected to start.

For example, the expression:

    host LIKE %blanca

matches the word blanca and any other word that ends in blanca, while the expression:

    host LIKE blanca%

matches the word blanca and any other word that starts with blanca. The expression:

    host LIKE %blanca%

matches the word blanca and any word that has the token blanca imbedded in it.

The java.util.regex.Pattern class is used.

= The equality operator expresses a match in case-sensitive match.
> Greater-than operator for use with numeric operands.
>= Greater-than or equal operator for use with numeric operands.
< Less-than operator for use with numeric operands.
<= Less-than or equal operator for use with numeric operands.
<> Not-equal operator.
BETWEEN Used with AND to select a range of values inclusive of the first (low) value and the last (high) value. Together, they operate on numbers and dates values.
IS NULL Tests for an operand having a NULL value.
IS NOT NULL Tests for an operand having a value other than NULL.


Related concepts

  • Rule-based request classification


    Related tasks

  • Define a service policy
  • Set maintenance mode
  • Activating concurrent application editions
  • Validating an edition


    Related information:

  • Intelligent Management: rules for ODR routing policy administrative tasks
  • Intelligent Management: rules for ODR service policy administrative tasks