act_eventList variable

The act_eventList variable provides access to methods that apply to the list of events that have been accepted by a rule.

Details

Both a filter rule and a duplicate rule always have a list of no more than one event because a filter rule is a stateless rule and because a duplicate rule retains only the first analyzed event.

The act_eventCount and act_eventList variables are not valid within a timer rule because a timer rule does not process events.

If a rule is defined with a grouping key, the act_eventCount, act_eventList, and act_threshold variables are not valid within the following expression contexts:
  • Life cycle actions
  • <filteringPredicate> within <activateOnEvent> or <deactivateOnEvent> within <activationInterval>
  • <computedValue>
This is because in this case, the rule variables apply only to a rule instance, and rule instances do not exist at the time that these expressions are run.

Coding example

The following code accesses the act_eventList variable to obtain the second event in the event list:
IEvent second_event = act_eventList.get(1);

Methods that can be accessed

The methods to which the act_eventList variable provides access are defined in the IEventList interface, as shown in Table 1.
Table 1. IEventList interface with corresponding methods and location of Javadoc method descriptions
Interface Methods Location of Javadoc method descriptions
IEventList
  • get
  • size
  • isEmpty
  • listIterator
com.ibm.correlation.IEventList