ilog.rules.res.session.ruleset

Interface IlrExecutionTrace

All Superinterfaces:

java.io.Serializable

All Known Subinterfaces:

IlrDWTrace

All Known Implementing Classes:

IlrBusinessExecutionTrace

public interface IlrExecutionTrace
extends java.io.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:

• working memory
• execution times
• number of rules fired

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

Methods

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

Method Detail

getTotalRulesFired

java.lang.Long getTotalRulesFired()

Returns the number of rules fired.

Returns:

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

getTotalRulesNotFired

java.lang.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

java.lang.Long getTotalTasksExecuted()

Returns the number of tasks executed.

Returns:

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

getTotalTasksNotExecuted

java.lang.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

java.util.Date getExecutionDate()

Returns the execution date.

Returns:

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

getExecutionDuration

java.lang.Long getExecutionDuration()

Returns the execution duration in milliseconds.

Returns:

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

getWorkingMemory

java.util.Collection<java.lang.Object> getWorkingMemory()

Returns the working memory as a Collection.

Returns:

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

getRulesNotFired

java.util.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

java.util.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

java.util.Map<java.lang.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

java.util.Map<java.lang.String,IlrTaskInformation> getTasks()

Returns the ruleset tasks by name.

Returns:

All tasks in the ruleset. If this information is not available, null is returned.

getExecutionEvents

java.util.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

java.net.InetAddress getInetAddress()

Returns the internet address.

Returns:

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

getSystemProperties

java.util.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.