IBM WebSphere Adapter for IBM i, version 7.0.0.4 notes

This document contains the following sections:
Enhancements and fixes
New and modified connector properties
Upgrade notes


This table lists the fixes in Fix Pack version 7.0.0.4
Fixes
#CRAPARTitleDetails
1102877 JR38713 The adapter throws exception when user uses array of structures inside a nested structure
Symptom: When the user uses array of structures inside a nested structure and runs a simple outbound operation, the adapter fails.
Resolution: Now the user can use an array of structures inside a nested structure with the adapter for an outbound operation.
2102592 JR38393 The adapter throws exception when user uses array of simple data types inside structures.
Symptom: When the user uses array of simple data types inside structures and runs a simple outbound operation, the adapter fails.
Resolution: Now the user can use an array of simple data types inside structures with the adapter for an outbound operation.
3102062FITS:MR0906105628 Support for CCSID in the parameters for execution of RPG and COBOL programs. And also support for DBCS characters in adapter
Symptom: Currently the adapter does not support encoding for the parameters.
Resolution: Now the adapter supports Encoding for the parameters of RPG and COBOL programs. The adapter takes the CCSID from the data tag attribute of the PCML. For DBCS graphic-only field, the user need to provide the pure DBCS CCSID in the EMD for the Data CCSID field
4101456InternalDetecting illegal XML characters in SDO DESPI of Adapters.
Symptom: A runtime exception is thrown during the BOXML serialization if the business object generated by the Adapter contains invalid xml characters.
Resolution: Adapter provides options to let the user to make choices and add validation in SDO DESPI of Adapters. Currently user can choose any of the 3 options: (a) Do not validate business object content for illegal XML characters (default); (b) Throw exceptions if business object content contains illegal XML charaters;(c) Discard illegal XML characters in business object content and log.
5101936JR37522In the inbound operation, if BOPrefix is used adapter fails with exception
Symptom: When the user uses BOPrefix and runs a simple Inbound operation, the adapter fails with exception com.ibm.websphere.sca.ServiceRuntimeException: Did not find method for native method 'emit(DataQueueName)'.
Resolution: Now the user can use a BOPrefix with the adapter for an inbound operation.
6102606JR38285The adapter throws exception when user uses relative reference of varaibles inside structures.
Symptom: When the user uses relative reference of varaibles inside structures and runs a simple outbound operation, the adapter fails exception.
Resolution: Now the user can use a relative reference of varaibles inside structures with the adapter for an outbound operation.
7102564JR37664The adapter throws exception when user uses dynamic variable length array.
Symptom: When the user uses dynamic variable length array and runs a simple outbound operation, the adapter fails exception.
Resolution: Now the user can use a dynamic variable length array with the adapter for an outbound operation.
8103446JR39653In some cases,the adapter throws exception when user uses the structure inside array of nested structures.
Symptom: When the user uses the structure inside array of nested structures and runs a simple outbound operation, the adapter fails.
Resolution: Now the user can use the structure inside array of nested structures with the adapter for an outbound operation.
9103414InternalSelecting two objects in EMD with same name, will result in NPE
Symptom: When the user selects two objects with same name in the EMD, the discovery cannot be completed and will result in NPE.
Resolution: Now EMD validates the objects selected by the user.
10103415InternalBOPrefix for RPG, COBOL and service programs does not work.
Symptom: When the user selects a BOPrefix value for RPG,COBOL,Service Program, the BO name is not prefixed with that BOPrefix.
Resolution: Now the user can select BOPrefix, and the BO are prefixed with the BOPrefix
11103417InternalIf "getQueue" operation is invoked with no data present in data queue, then an exception is thrown.
Symptom: When the user does an "getQueue" operation and no data is present in the Data queue, then an excepion is thrown.
Resolution: The adapter will let the user know that no data is present in the Data queue and exception is not thrown
12103418InternalThe user has to explicitly add elements to the structure to get it to work.
Symptom: The user has to add elements to the structure explicitly otherwise the adapter throws an exception
Resolution: Now the user can run the outbound without explicitly adding elements to the structure containing simple data types.
13103419InternalThe adapter throws exception when the user unset the values inside structures or arrays.
Symptom: When the user unset the attributes inside the structures or arrays and calls pgm operation then adapters throws exception.
Resolution: Now the user can unset the attributes, and the adapter works fine with out exception.
14103421InternalDynamic reference for length does not work.
Symptom: When the user selects the pcml having the attribute(length) of the variable is referring to the other variable in the same structure or different structure, then its throwing the exception.
Resolution: Now the user can select pcml having the Dynamic reference for length, and the adapter works fine.
15102613JR38019Enable JCA timer capability for inbound polling
Symptom: Adapter uses a polling thread in the runtime, which will poll as per the pollperiod. The polling thread will be only submitted once and always being in the runtime environment. When there are no events for a longer duration, the polling thread will be hung and throws a warning message from the JCA container.
Resolution: Use JCA timer to schedule the polling thread, so the polling thread would be submitted according to the JCA scheduler, which will solve the thread hang issue.
16103162JR39129Duplicate messages are created in the event table due to unexpected database outage.
Symptom: During Adapter Inbound operation, after several unplanned database outages during event processing duplicate messages can be observed. This is due to the fact that the event is delivered but the overall transaction is marked failure and no rollback is called by the transaction manager.
Resolution: If the event is already delivered to the downstream components but the overall transaction is marked failure due to issues in downstream component, the event is deleted if no rollback is issued.




This table lists the fixes in Fix Pack version 7.0.0.1
Fixes
#CRAPARTitleDetails
1100297The adapter fails at runtime throwing a NullPointerException as part of outbound transactions when the RPG, COBOL or SRVPGM programs contain a complex type hierarchy of a particular format.
Symptom: The adapter fails at runtime throwing a NullPointerException as part of outbound transactions when the RPG, COBOL or SRVPGM programs contain a complex type hierarchy as listed below.
Parent structure
|___________Child array of structures
                              |______________Child array of structures
Resolution: Now the adapter supports this function.
2100101InternalTVT: Hard-coded strings on EMD screen
Symptom: Certain strings in adapter are hard-coded.
Resolution: Have removed the hard coded strings in the adapter.
3100626InternalEdit Binding cause wrong EmptyGetQueueBo generated for Keyed queues
Symptom: EmptyGetQueueBO is getting generated for the Keyed Data Queue and will be set as input for the GetQueue operation. So there is no way to input the "key value" for the query.
Resolution: Now for keyed data queue, EmptyGetQueueBo will not be generated.
4100689InternalRunMig:Got Script Exception during migrate IBMi stand-alone module
Symptom: During running migration script for IBMi stand-alone module, exception message showed up, and migration process stopped.
Resolution: Changed the property in the ra.xml file, and migration runs successfully.
5100356InternalWhen BO name is same and BO namespace is different, inbound work may be failed.
Symptom: When adapter creates 2 or more different modules with BO having same name but different namespace and structure, inbound and outbound operations of those modules will throw NullPointerException.
Resolution: Redefined the methods of "hashCode()" and "equals()" in the SDOV1Type class. Then individual adapter can distinguish those BO correctly by "namespace + name" if those BOs name are equal.
699888InternalChange to use PmiRmJmxService MBean to get arm transaction factory name
Symptom: When adapter gets ARM transaction factory name to process ARM transaction, a WAS internal private API is used for it, which need to be replaced with public interfaces.
Resolution: Switched to Invoke PmiRmJmxService MBean, a set of public interfaces exposed by WAS to get ARM transaction fatory name
7100406InternalAdapter will encoutner NPE after restart the app on server.
Symptom: For Adapter inbound and outbound operation(standalone deployment), after the application is restarted, the NullPointerException will appear when the adapter tries to query the ASI Infor from cache.
Resolution: The BO's namespace and name has been preserved as BO instance's fields. After the application is restarted, adapter can still get them from those instance's field rather than the stale data cache.
8100888InternalFault business object should not be generated for one-way outbound operation.
Symptom: Currently, Fault business objects are generated for one-way operation that do not have a response business object.
Resolution: The one-way outbound operations are now converted to two-way operations by having a response business object generated for them, which supports fault business object.
9100153InternalIBM i adpater to move to latest JTOpen 6.6
Symptom: Currently IBM i adapter uses 6.5.1 version of JTOpen APIs (Thirdparty) to connect to IBM i system. JTOpen 6.5.1 was discovered to have some flaws relating to serializability of the CommandCall and ProgramCall classes
Resolution: IBMi Adapter now uses the latest versiom of JTOpen 6.6 where the serializability issues were fixed.




This table lists new connector properties
#VersionPlatformAdd or RemoveProperty (Note that property names are case sensitive)Property description
17.0.0.4ALLAddconnCCSIDSet this CCSID for the Connection Level CCSID
27.0.0.4ALLAdddataCCSIDSet this CCSID for the Data conversion. This is applicable only to the Graphic Field(Chartype=twobyte) and DataCCSID will override the CCSID present in the PCML Data tag


To upgrade to the Fix Pack version 7.0.0.4, do the following:
1. Ensure you have followed the 'Installation Instructions' section in the download link before proceeding further.
2. If you need to use the Fix Pack for EMD, delete the connector project in the WID, import the new rar and apply the EIS specific dependency files. The following steps describe how to do the same.
   a. Open the Java Build Path for the SCA module and remove the Connector project selected on projects tab.
   b. Open the dependency editor and remove the connector project.
   c. Delete the connector project from workspace.
   d. Import the new rar file. Add any dependency files from EIS specific APIs as needed.
   e. Open Java build path for the SCA module and select the Connector project selected on projects tab.
   f. Open the dependency editor and add the connector project if it is not already present and check "Deploy with Module".
3. If you need to update deployed applications on the WPS.
   a. Select "Update" for the corresponding application on the WPS Admin Console.
   b. Select "Single Module" with relative path as name of the rar file - CWYIS_ios.rar.
   c. Click the "Browse" button on local file system to select the updated rar file that has the changes.
   d. Select the default values in the remaining steps and click 'Finish'. This will ensure that existing configurations e.g. MCF, are not changed and jars will be merely updated.



July 08, 2011 6:00 PM
(C) 2011 IBM Corporation. Proprietary and Confidential. All Rights Reserved.