Instance Location Manager Release Notes

Version

Version of ILM:

New User Stories

User Story User Story Title Status in this version Unit Test Results Acceptance Test Results
ILM51 I want to change the InstanceLocator and InstanceLocatorFactory interfaces so that the reference to an EJBLocalHome is obtained from the CorrelationDefinitionReader. (Agreed interfaces documented in note from Adrian Dick, dated 22/10/2003 @ 10:30 to Dan Pollitt and Colin Thorne). Complete Complete Complete
ILM50 I want a WSIFMessage (Serialisable) to be passed into the Create(...) method as well as a HashTable (union of property name/value pairs) when creating a new process instance from implicitCreate="yes" scenarios. Complete Complete Complete

Defects

Defect Abstract Status
181484 ILM31 not implemented to specification.

When instance not found and implicitCreate is false should throw an InstanceNotFoundException.

But,

FindInstance(String, WSIFMessage) throws an InstanceLocationException

while

FindInstance(CorrelationProperties) throws a ServiceDefinitionException

Complete
181348 Update/correct and test ILM message.nlsprops. Complete

User Stories delivered in previous iterations.

User Story User Story Title Status in this version Unit Test Results Acceptance Test Results
ILM43 I want to be able to retrieve a Map of propertyNameValue pairs form a message via the ILM for use when calling micro flows for initialising EJB value.
e.g. Map InstanceLocator.extractPropertyValues(String opName, WSIFMessage message )
Complete Pass Pass
ILM42 I want PropertyAlias to support different names for property name and associated message part name.
If an instance is not found, based on the Correlation information, and implicit create is true I want the property name to be used when placing Correlation values in to hash table used by create method of stateful web service.
Complete Pass Pass
ILM41 Extension to ILM40:
Support for more than 1 CorrelationSet
Complete Pass Pass
ILM40 If an instance cannot be found and ImplicitCreate is true then I want a new instance to be created and returned. A Hashtable of PropertyAlias/value pairs should be passed into the create method of the Entity EJB. If there is one CorrelationSet then the Hashtable should be populated with a PropertyAlias/value pair from the CorrelationSets. I want a com.ibm.websphere.ilm.bpel.InstanceCreationFailedException to be thrown where appropriate from the ILM (in accordance with Exception model in ILM SDD) Corresponds to scenario g Assumes: 1 CorrelationSet. Complete Pass Pass
ILM39 I want to be able to locate a pre-existing Entity EJB instance based on multiple sets of Correlation information made available via a CorrelationDefinitionReader (CDR). All CorrelationSets should be used in turn to locate. In this case the instance IS NOT the same for all CorrelationSets and a com.ibm.websphere.ilm.bpel.MultipleInstancesException to be thrown where appropriate from the ILM (in accordance with Exception model in ILM SDD) Complete Pass Pass
ILM37 I want to be able to locate a pre-existing Entity EJB instance based on Correlation information made available via a CorrelationDefinitionReader (CDR), so that it aligns with the current interfaces. Complete Pass Pass
ILM36 I want a com.ibm.websphere.ilm.bpel.InvalidMessageException to be thrown when message does not match Correlation information (in accordance with Exception model in ILM SDD). Complete Pass Pass
ILM35 I want a com.ibm.websphere.ilm.bpel.ServiceDefinitionException to be thrown where appropriate from the ILM (in accordance with Exception model in ILM SDD) Complete Pass Pass
ILM34 If an instance cannot be found and ImplicitCreate is true then I want a new instance to be created and returned. An empty Hashtable should be passed into the create method of the Entity EJB.

If this fails I want an com.ibm.websphere.ilm.bpel.InstanceCreationFailedException or com.ibm.websphere.ilm.bpel.ServiceDefintionException to be thrown where appropriate from the ILM (in accordance with Exception model in ILM SDD)
Complete Pass Pass
ILM33 Extension to ILM30:
Support for more than 1 CorrelationSet with more than 1 PropertyAlias. Returning instance if all CorrelationSets return same instance.
Complete Pass Pass
ILM32 I want a com.ibm.websphere.ilm.bpel.ServiceDefinitionException to be thrown when no Correlation information is found and implicit create is false (in accordance with Exception model in ILM SDD). Complete Pass Pass
ILM31 I want an com.ibm.websphere.ilm.bpel.InstanceNotFoundException to be thrown when an instance is not found, based on Correlation information from 1 CorrelationSet, and implicit create is false (in accordance with Exception model in ILM SDD). Complete Pass Pass
ILM30 Extension to ILM37:
Support for CorrelationSet with more than 1 PropertyAlias.
Complete Pass Pass
ILM38 I want to specify an XPath expression as part of a PropertyAlias to get a value from a complete message part. Complete Pass Pass

Summary of new function

This version supports:

Installation Instructions

The following jar files will be copied to to the \lib directory during installation of WebSphere Business Integration Foundation.

Examples

See the Javadoc for coding examples.