Rule Execution Server API

ilog.rules.res.session.ruleset
Interface IlrExecutionTrace

All Superinterfaces:
Serializable
All Known Subinterfaces:
IlrDWTrace
All Known Implementing Classes:
IlrBusinessExecutionTrace

public interface IlrExecutionTrace
extends Serializable

IlrExecutionTrace represents the detailed information about ruleset execution.

Overview

Using IlrExecutionTrace, you have access to a lot of information about the execution such as:

Code example

The following code example shows how to retrieve the list of rules fired and execution events from the execution trace.

   IlrStatelessSession rulesession = factory.createStatelessSession();
   IlrSessionRequest request = factory.createRequest();
   request.setRulesetPath(new IlrPath("/MyruleApp/Myruleset");
   request.setInputParameters(map);
   request.setTraceEnabled(true);
   IlrSessionResponse response = rulesession.execute(request);
   IlrExecutionTrace trace = sessionResponse.getRulesetExecutionTrace();
   List firedRuleBusinessNames = new ArrayList  ();
   Map allRules = trace.getRules();
   int ruleFired = trace.getTotalRulesFired(); 
   List executionEvents = trace.getExecutionEvents();
 

Since:
7.0

Method Summary
 Date getExecutionDate()
          Returns the execution date.
 Long getExecutionDuration()
          Returns the execution duration in milliseconds.
 List<IlrExecutionEvent> getExecutionEvents()
          Returns the list of executed rules and tasks.
 InetAddress getInetAddress()
          Returns the internet address.
 Map<String,IlrRuleInformation> getRules()
          Returns the ruleset rules by name.
 Set<IlrRuleInformation> getRulesNotFired()
          Returns the rule information for the rules that were not fired.
 Properties getSystemProperties()
          Returns the system properties of the execution environment.
 Map<String,IlrTaskInformation> getTasks()
          Returns the ruleset tasks by name.
 Set<IlrTaskInformation> getTasksNotExecuted()
          Returns the task information for the tasks that were not executed.
 Long getTotalRulesFired()
          Returns the number of rules fired.
 Long getTotalRulesNotFired()
          Returns the number of rules that have not fired.
 Long getTotalTasksExecuted()
          Returns the number of tasks executed.
 Long getTotalTasksNotExecuted()
          Returns the number of tasks not executed.
 Collection<Object> getWorkingMemory()
          Returns the working memory as a Collection.
 

Method Detail

getTotalRulesFired

Long getTotalRulesFired()
Returns the number of rules fired.

Returns:
The number of rules fired. If this information is not available, null is returned.

getTotalRulesNotFired

Long getTotalRulesNotFired()
Returns the number of rules that have not fired.

Returns:
The number of rules that have not fired. If this information is not available, null is returned.

getTotalTasksExecuted

Long getTotalTasksExecuted()
Returns the number of tasks executed.

Returns:
The number of tasks executed. If this information is not available, null is returned.

getTotalTasksNotExecuted

Long getTotalTasksNotExecuted()
Returns the number of tasks not executed.

Returns:
The number of tasks not executed. If this information is not available, null is returned.

getExecutionDate

Date getExecutionDate()
Returns the execution date.

Returns:
The execution date. If this information is not available, null is returned.

getExecutionDuration

Long getExecutionDuration()
Returns the execution duration in milliseconds.

Returns:
The execution duration in milleseconds. If this information is not available, null is returned.

getWorkingMemory

Collection<Object> getWorkingMemory()
Returns the working memory as a Collection.

Returns:
The working memory. If this information is not available, null is returned.

getRulesNotFired

Set<IlrRuleInformation> getRulesNotFired()
Returns the rule information for the rules that were not fired.

Returns:
The list of IlrRuleInformation objects for the rules that were not fired. If this information is not available, null is returned.

getTasksNotExecuted

Set<IlrTaskInformation> getTasksNotExecuted()
Returns the task information for the tasks that were not executed.

Returns:
The list of IlrTaskInformation objects for the tasks that were not executed. If this information is not available, null is returned.

getRules

Map<String,IlrRuleInformation> getRules()
Returns the ruleset rules by name.

Returns:
All the rules in the ruleset. If this information is not available, null is returned.

getTasks

Map<String,IlrTaskInformation> getTasks()
Returns the ruleset tasks by name.

Returns:
All the rules. If this information is not available, null is returned.

getExecutionEvents

List<IlrExecutionEvent> getExecutionEvents()
Returns the list of executed rules and tasks.

Returns:
The list of executed rules and tasks. If this information is not available, null is returned.

getInetAddress

InetAddress getInetAddress()
Returns the internet address.

Returns:
The internet address. If this information is not available, null is returned.

getSystemProperties

Properties getSystemProperties()
Returns the system properties of the execution environment.

Returns:
The system properties of the execution environment. If this information is not available, null is returned.

Rule Execution Server API

© Copyright IBM Corp. 1987, 2013