IBM WebSphere Business Integration Adapter for SAP Software, version 6.1.0.6_IF07 notes

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

This table lists the enhancements and fixes in interim fix version 6.1.0.6_IF07.
Enhancements
# CR APAR Title Details
There are no enhancements in this interim fix.
Fixes
# CR APAR Title Details
1 JR38640 ADAPTER THROWS NULLPOINTER EXCEPTION IF NON-MANDATORY LEVEL 1 IDOC SEGMENTS ARE OMITTED WHEN SENDING IDOC TO SAP.
Symptom:ADAPTER THROWS NULLPOINTER EXCEPTION IF NON-MANDATORY LEVEL 1 IDOC SEGMENTS ARE OMITTED WHEN SENDING IDOC TO SAP.
Resolution: This is fixed now.

This table lists the enhancements and fixes in interim fix version 6.1.0.6_IF06.
Enhancements
# CR APAR Title Details
There are no enhancements in this interim fix.
Fixes
# CR APAR Title Details
1 CR101122 IDoc field Value are getting trimmed.
Symptom:When an IDoc is sent from SAP to adapter, field's value are getting trimmed.
Resolution: A optional check-box is provided in EMD run, to configure if data needs to be trimmed or not. Check-box is set to TRUE (which means trim is enabled)by default.Set the check-box to FALSE if leading spaces in the IDoc field need to be preserved.

This table lists the enhancements and fixes in interim fix version 6.1.0.6_IF05.
Enhancements
# CR APAR Title Details
There are no enhancements in this interim fix.
Fixes
# CR APAR Title Details
1 CR101361 JR36754 DETAILED LOGGING BEING LOGGED IN SYSTEMOUT EVEN WHEN NO J2CA TRACE IS SET FOR B
Symptom: Even when the trace is not enabled i.e, with just *=info,detailed logging is logged into the systemout log
Resolution: This problem is now fixed.
2 CR77600 JR33249 The adapter doesn?t perform the best when there are one ore more DATE fields in the return when BAPI interface is used
Symptom: When there are one or more DATE fields in the return BAPI, the adapter needs to be tuned for better performance
Resolution: This problem is now fixed.

This table lists the enhancements and fixes in interim fix version 6.1.0.6_IF04.
Enhancements
# CR APAR Title Details
There are no enhancements in this interim fix.
Fixes
# CR APAR Title Details
1 CR101358 JR36753 EVENT NOT FOUND ERROR LOGGED IN THE WEBSPHERE BI CONNECTOR LOG: AEP INBOUND
Symptom: The WebSphere BI log prints the statement evt_id xxxx not found in the table /CWLD/EVT_Cur incorrectly, though the event exists and is processed
Resolution: This problem is now fixed.
This table lists the enhancements and fixes in interim fix version 6.1.0.6_IF03.
Enhancements
# CR APAR Title Details
There are no enhancements in this interim fix.
Fixes
# CR APAR Title Details
1 JR37259 AEP INBOUND:BAR file cannot be deployed after setting any property using mqsicreateconfig comamnd
Symptom: AEP INBOUND: BAR deployment gives error when mqsiconfig command used while deployment.
Resolution: This problem is now fixed.
This table lists the enhancements and fixes in interim fix version 6.1.0.6_IF02.
Enhancements
# CR APAR Title Details
1 CR76307 Flat file IDoc support for ALE passthrough inbound.
Symptom: SAP adapter can send IDoc to endpoint in inline format(ie each Control record 524 bytes and Data record 1063 bytes) only
Resolution: Support for flat file IDoc is provided as an enhancemnent in EMD.Option provided in EMD to select flat file IDoc.If a user select flat file IDoc in EMD , field appears to select IDoc version and enter the delimiter value.IDoc Version can be left blank if unreleased segment also needs to be discoverd. If IDoc version selected in EMD is less than the version of IDoc sent from SAP,extraneous data if present in segments would be truncated automatically.
Fixes
# CR APAR Title Details
1 CR100223 JR34866 AEP TRANSPORTS- LOG UPDATES NOT WORKING CORECTLY
Symptom: AEP transports - The logging is not being done correctly, it points to the old ABAP code
Resolution: This is now fixed with the new set of AEP Transports provided.
2 CR100226 JR34865 AEP TRANSPORTS - DELETE QUEUE EVENTS NOT WORKING CORRECLTY
Symptom: AEP transports- when delete queue events operatin is executed, adapter doesnt delete from the correct event table
Resolution: This is now fixed with the new set of AEP Transports provided.
3 CR100229 JR34867 AEP TRANSPORTS - DELETE ARCHIVED EVENTS NOT DELETING CORRECTLY
Symptom: AEP transports - delete archive events is not deleting from correct archive table
Resolution: This is now fixed with the new set of AEP Transports provided.
4 CR100253 JR34901 AEP INTERFACE: EVENT DATA BEING RETUNED AS BLANK EVENTHOUGH THERE IS DATA
Symptom: Event data is retuned as blank eventhough there is data available for the fields.
Resolution: This problem is now fixed.
5 CR100266 JR34928 CXIGNORE IS BEING SET FOR FIELDS WITH NO VALUES-AEP INBOUND
Symptom: AEP transports - The logging is not being done correctly, it points to the old ABAP code
Resolution: Whenever there is no value for a field being sent to an AEP inbound node , the value is being set to CxIgnore.
6 CR100375 JR34964 Adapter is corrupting BCD Value in BAPI call when locale has a comma as decimal seperator.
Symptom: When using BAPI outbound with a BCD field, adapter is corrupting value under certain locale.
Resolution: Fixed.Adapter set BCD value independent of locale and always use dot(.) as decimal seperator.
7 CR100393 JR35006 Adapter will encounter NPE after restart the application on standalone deployment.
Symptom: For stand-alone deployment, after the application is restarted, the NPE error will appear when the adapter tries to query the ASI Information from cache.
Resolution: Fixed.Adapter do not use stale date in cache after restart the application.
8 CR100412 JR35196 QUEUED EVENTS ARE NOT GETTING PROCESSED AT STARTUP
Symptom: During adapter startup, any pre-queued events existing in the event table are not getting processed.
Resolution: This problem is now fixed.
9 CR100563 JR35479 Error handling for malformed IDocs and incorrect partner charset value.
Symptom: ALE pass through outbound dont throw any exception in case of malformed IDoc or incorrect partner charset value
Resolution: Error handling is now fixed, adapter also set encoding to UTF-8 by default if SAP system in unicode
10 CR100630 JR33573 EMPTY FIELDS COMING OUT AS CXIGNORE
Symptom: Even after using the 6103 IF13 , where issue with AEP module, and empty fields were being set to Cxignore,some of the segment fields with no data being sent are still coming out as CxIgnore. This happens with only delete opearation.
Resolution: This problem is now fixed.
11 CR100655 JR35631 IN A FAILURE CASE TWO ALEAUD IDOCS ARE GENERATED.
Symptom: When a ALE IDoc processing is not succesful, two ALE AUD IDocs one for failure and success each are getting created.
Resolution: This problem is now fixed.
12 CR100705 JR35738 AEP INBOUND: Unpopulated fields being outputted incorrectly.
Symptom: AEP INBOUND: Unpopulated fields being outputted incorrectly.
Resolution: This problem is now fixed.
13 CR100752 JR35482 EMD wizard in WMB:"Send IDoc as a packet:True" cannot be changed
Symptom:In WMB while running ALE inbound, user is unable to select the property to split IDOc packet.
Resolution: Fixed. Checkbox appear now which can be configured to send IDoc as single or packet.
14 CR100905 JR36095 Using ALE passthrough for outbound messages going to SAP,SAP throws an error.
Symptom: Using ALE Passthrough for outbound messages going to SAP, not all the fields are set SAP throws an error and the SAP request node gets the error about those missing values. 'com.ibm.j2ca.sap.exception.SapAleOutboundException: Value ' ' cannot be converted to NUM type at field PSGNUM' (CHARACTER)"
Resolution: This problem is now fixed.

This table lists the enhancements and fixes in interim fix version 6.1.0.6_IF01.
Enhancements
# CR APAR Title Details
There are no enhancements in this interim fix.
Fixes
# CR APAR Title Details
1 CR100797 JR35905 CANT DEPLOY THE SAPINPUT NOTE IF NUMBER OF LISTENERS IS SET TO 1
Symptom: CANT DEPLOY THE SAPINPUT NOTE IF NUMBER OF LISTENERS IS SET TO 1
Resolution: This problem is now fixed.
2 CR100887 JR36038 CONNECTIONS STILL REMAIN ACTIVE EVEN AFTER THE ADAPTER IS STOPPED
Symptom: CONNECTIONS STILL REMAIN ACTIVE EVEN AFTER THE ADAPTER IS STOPPED
Resolution: This problem is now fixed.
3 CR100540 JR35446 LOAD BALANCING INBOUND: NOT RECEIVING EVENTS
Symptom: Event data is not processed by the adapter during inbound when the SAP System participates in Load Balancing
Resolution: This problem is now fixed.
This table lists the enhancements and fixes in interim fix version 6.1.0.6
Enhancements
# CR APAR Title Details
1 75527 Provide the WAIT before invoking BAPI_TRANSACTION_COMMIT
Symptom: The adapter does not wait for sometime before invoking BAPI_TRANSACTION_COMMIT.
Resolution: This is fixed
2 99253 Support for multiple idoc in ALE pass through outbound.
Symptom: The adapter supports the Outbound scenario for ALE PassThrough IDocs only for a single IDoc.
Resolution: Now it support posting multiple IDocs.Delimiter can be used to seperate IDoc.Using delimiter is an optional feature.
3 99998 Make adapter 6.1 comply with the new WPS v7.0 SDO implementation
Symptom: Currently the Adapter 6.1 version only supports EMF, and doesn't support XCI.
Resolution:A fix has been delivered to make Adapter 6.1 comply with the new WPS v7.0 SDO implementation.
Fixes
# CR APAR Title Details
1 100282 JR34939 Field naming of IDoc control record and data record cannot be handled independently
Symptom: Currently both Control record and Data record can be generated either using Field name or Field Description
Resolution: Option is provided in EMD to generate control record and data record independently.For eg now control record can be generated using field name and data record using field description and vice versa.
2 100127 JR34712 SAP Adapter reports that an accessor for BAPI fields of type STRING is not found
Symptom: When a BAPI contains fields of type String, the request fails with "No accessor-to-data mapping" found error
Resolution: The fix for SAP Adapter is made to map the JCO Type String to the corresponding accessor
3 76155 JR31207 The adapter does not correctly handle stale connections and does not do a retry when the connection is lost during request processing.
Symptom: The adapter does not correctly handle stale connections to the SAP EIS.
Resolution: This is now fixed. The adapter also does a retry if the connection is invalid during request processing.
4 100079 JR34652 Error message when building a new SAP request adapter connection if BAPI contain changing parameter.
Symptom: Error message when building a new SAP Request Adapter Connection. Receive com.ibm.adapter.framework.BaseException message Reason: unable to create definitions local part cannot be "null"when creating a QName.
Resolution: EMD was failing for changing paramter.The code is corrected
5 99343 JR34424 BAPI Inbound with namespace syntax "/ABC/XYZ" is throwing exceptions.
Symptom: com.ibm.websphere.sca.ServiceRuntimeException: commonj.connector.runtime.SelectorException: commonj.connector.runtime.SelectorException: For the RFC TypeSapABCXYZWrapperOperation is not found using the application-specific information: caused by: commonj.connector.runtime.SelectorException: commonj.connector.runtime.SelectorException: For the RFC TypeSapABCXYZWrapperOperation is not found using the application-specific information
Resolution: This is now fixed.
6 99304 JR34330 ALE Inbound with Extended IDocs fails when using the qRFC protocol.
Symptom: Incorrect handling for Extended IDoc naming conventions.
Resolution: This is now fixed.
7 99289 JR34365 Empty xml tags are not sent after atleast one more populated field within an IDoc segment
Symptom: If an IDoc segment has 3 fields field1,filed2 and field3 and only field1 and filed 2 are populated in the output object.
Resolution: 3 options are provided in the Advanced Tab of the Connection Wizard 1.BEFORE_AND_AFTER - Sends empty field tags before and after one more populated IDoc field. 2.ONLY_BEFORE - Sends empty field tags before one more populated IDoc field. 3.ALL_UNPOPULATED_FIELDS_SEGMENTS - Sends empty field tags before and after unpopulated fields as well as segments. This is highly performance intensive and meant to be selected if there are no alternatives.
8 77031 JR32699 The adapter ALE module fail at runtime when BO names are resolved in different cases.
Symptom: com.ibm.j2ca.sap.exception.SapAleOutboundException: Exception while getting accessor. Please make sure property exists with accessor name NameOfTableStructure or TABNAM or Tabnam
Resolution: This is now fixed.
9 77612 JR33266 Czech characters in the IDoc are getting corrupted while running ALE passthrough inbound
Symptom: While running ALE pass through inbound, some Czech characters are getting corrupted in the output IDoc from adapter
Resolution: This is now fixed.
10 77900 JR33557 Duplicate Control Record in IDoc packet sent to endpoint
Symptom: While running ALE pass through inbound adapter sends IDoc packet to endpoint with duplicate control record
Resolution: This is now fixed.
11 76730 JR33951 Maxlength asi property is incorrectly set to 0 for BAPI OUT and INOUT parameters
Symptom: For BAPI OUT and INOUT parameters, the maxlength asi property is incorrectly set to 0. As a result, maxlength restriction is not imposed on these parameters.
Resolution: This is now fixed.
12 77941 JR33598 The adapter does not use the value set for "Use SAP Field names" checkbox during Metadata Discovery
Symptom: The adapter always generates the Business Object attributes names in Camel casing inspite of the setting for "Use SAP Field names" checkbox during Metadata Discovery.
Resolution: This is now fixed. The adapter now provides options to choose casing for the Control Record and the Data Record separately
13 75643 JR29813 When doing outbound using the BAPI WU interface, data was not correctly updated in the SAP EIS.
Symptom: When running an outbound using the BAPI WU interface, the adapter was resetting connection resource after each BAPI execution, thus resetting global state. This was causing BAPI called later not to get the latest values.
Resolution: This was corrected. The reset is now being called only once, after all BAPIs are executed. A new property was added in EMD for this feature.
14 93528 JR34574 When two different business objects have the same name but different namespaces, inbound/outbound operations may fail.
Symptom: In multiple applications, if some Business Objects have the same BO name but different BO namespaces, inbound or outbound operation may fail, e.g., retreive may report NullPointerException. This issue impacts both inbound and outbound.
Resolution: Delivered a fix to not only use BO name but also namespace to differentiate BO during runtime.
15 100313 JR34869 Adapter does not use connectionpool in the first pollcycle during "unordered" delivery.
Symptom: When using "unordered" delivery mode with "maximum connections" larger than 1, connection pool will not be used during the first poll cycle and NPE will be thrown.
Resolution: A fix has been delivered to have the ActivationSpec for one specific endpoint to be configured before polling for the first cycle, thus enable connection pool be used for "unordered" mode


This table lists the enhancements and fixes in fix pack version 6.1.0.5.
Enhancements
# CR APAR Title Details
There are no enhancements in this fix pack.
Fixes
# CR APAR Title Details
1 76555 Any activity in a listener thread causes a state change for other active threads.
Symptom: The adapter was incorrectly printing status changes for all listener threads.
Resolution: This is now fixed.
2 76556 Incorrect tags in messages for successful BAPI outbound
Symptom: The adapter incorrectly tags success messages with an 'E' tag
Resolution: The adapter now correctly tags messages
3 77011 The QISS module retrieves wrong data from non-unicode SAP system
Symptom: The RFC function used to read data from SAP could not handle non-unicode data.
Resolution: The adapter now correctly handles non-unicode data
4 77010 Time field value is passed to SAP in incorrect format
Symptom: The adapter incorrectly handles time fields in BAPI
Resolution: The adapter now correctly handles time fields
5 77008 Decimal value corrupted in RFC
Symptom: The adapter incorrectly decimal values in BAPIs
Resolution: The adapter now correctly handles decimal values


This table lists the enhancements and fixes in fix pack version 6.1.0.4.
Enhancements
# CR APAR Title Details
There are no enhancements in this fix pack.
Fixes
# CR APAR Title Details
1 75473 The adapter returns old information/data from the SAP EIS.
Symptom: When the adapter retrieves data that was recently modified, the values that were returned were not the latest values.
Resolution: The adapter resets all connection resources before retrieving data, thereby, retrieving the latest data.
2 75474 JCO Connection pool error during server restart
Symptom: After restarting the server, some of the deployed modules threw an exception which looks like: MessageEndpoint activation failed for ActivationSpec com.ibm.j2ca.sap.SAPActivationSpecWithXid and MDB Application SAPInboundInvoiceServiceApp#SAPInboundInvoiceServiceEJB.jar#export.interfaces.SAPInvoiceInboundInterfaceEIS, due to the following exception: com.sap.mw.jco.JCO$Exception: (106) JCO_ERROR_RESOURCE: Connection pool boy.novo.dk is removed. at com.sap.mw.jco.JCO$Pool.getClient(JCO.java:5006)
Resolution: The adapter now uses a unique pool name for all applications and the symptom is no longer reproducible.
3 75643 While running an outbound using the BAPI WorkUnit interface, the adapter resets the connection resource after executing each BAPI thereby resetting the global state. BAPI's executed later did not get the latest values.
Symptom: When running an outbound using the BAPI WorkUnit interface, the adapter was resetting connection resource after each BAPI execution, thus resetting global state. This was causing BAPI called later not to get the latest values.
Resolution: The adapter now resets the connection resource only after executing all BAPIs.
4 96037 When a simple BAPI call fails, the adapter does not rollback to remove table locks.
Symptom: While using the BAPI_GOODSMVT_CREATE BAPI, the adapter does not rollback correctly in cases of failure.
Resolution: This has been corrected. The adapter now rolls back correctly after any failure.
5 96094 ALE inbound fails with a null pointer exception after applying JR26701 on WPS.
Symptom: The adapter was still excepting the WebSphere Process Server runtime to return an exception when the attribute being queries does not exist. The WebSphere Process Server runtime now returns a NULL instead this leading to an NullPointerException.
Resolution: The adapter can now handle a NULL if the BO.getProperty() call fails, in line with the API specification change.
6 75522 The adapter does not support more than four BAPIs in the EMD Object selection screen.
Symptom: When more than four BAPIs are selected for processing during an inbound EMD, the adapter does not correctly generate the artifacts and the event processing fails.
Resolution: The adapter can now handle more than four BAPIs and it generates the artifacts correctly.
7 92875 During inbound processing, if you select three BAPIs, an index out of range error is thrown during EMD.
Symptom: In the Configure Composite Properties panel, if you select three BAPI's and click on Next, the following error message is displayed: Error in creating schema files. Array index out of range: 3
Resolution: The EMD now completes properly for any number of BAPIs.
8 92924 An error message is always displayed at runtime, without any effect on the behavior.
Symptom: While running any inbound or outbound scenario, the following error message is always dispayed, without any impact on runtime: [10/14/08 16:55:44:890 CST] 00000093 LogUtils E SAPRFCDataBinding getDataObject CWYBS0499E: An invalid key was encountered while the adapter was using Resource Bundle com.ibm.j2ca.sap.LogMessages with Locale en_US. The key is either null or an empty string.
Resolution: This issue has been fixed.
9 75748 Commit or Rollback on BAPI should be done by the container.
Symptom: The adapter was calling the Commit or Rollback functionality on its own and not based on the request by the container.
Resolution: This has been fixed. Adapter will now call Commit or Rollback as per container request if it is Local Transaction. When NoTransaction is used, the adapter does an automatic auto-Commit/Rollback
10 75654 When the Import or Export section of a BAPI (instead the Tables section) contains tables, then a BAPI fails.
Symptom: During runtime, a BAPI call with Table parameters in the Import or Export section fails with the exception: CWYAP2044:The Z_READ_PRICING_DATA BAPI (without transaction) failed. Error: Cannot convert field CONFIG of type TABLE to JCO.Structure Explanation=In the input BAPI business object, the data, metadata or both are incorrect.
Resolution: The adapter now supports Table parameters in the Import/Export section.
11 75545 The adapter EMD throws "Error: nothing found" while discovering certain BAPIs.
Symptom: When we attempt to discover a nested BAPI(more than 2 levels deep) using the EMD Discovery screen, ESD wizard connects to SAP with the Filter, if specified. While retrieving the metadata from SAP, the wizard terminates with the error ("Nothing found").
Resolution: The adapter can now handle nested BAPIs in the discovery screen.
12 75649 Decimal fields are not saved in BAPIs.
Symptom: When decimal fields are present in a BAPI, there are errors in the return type.
Resolution: The adapter can now correctly handle decimal fields in BAPI parameters.
13 75878 When more than one inbound application is running, during startup an error message is displayed stating that the JCO pool name already exists.
Symptom: When the first inbound application is started, the hostname of the SAP system is used as the pool name. When more than one application is started simultaneously, an error message is displayed stating that the JCO pool name already exists.
Resolution: The adapter now creates unique pool names for each inbound module.
14 75880 1475880ALE inbound listener threads still remain and are not killed after the application is stopped
Symptom: When running an inbound ALE module, some listener threads still remain and try to process idocs even after the application is stopped.
Resolution: This has been fixed. Listener threads are killed after the application stops.
15 76039 ESD fails if two BAPIs have the same field names, separted by a '_'.
Symptom: When you select two BAPIs in the SCI interface ESD with field names that differ by a _ alone(though the structures are the same), the ESD fails to generate the artifacts.
Resolution: This has been fixed. The adapter now ignores case while trying to generate the second XSD.
16 92923 An error message displayed in the log when running ALE outbound without a Business Graph.
Symptom: If you deploy an ALE outbound module, uncheck "Generate business graph" in EMD, and deploy it in WebSphere Process Server there is an exception logged at runtime eventhough the functionality works fine - [10/14/08 15:27:03:406 CST] 0000006d LogUtils E com.ibm.j2ca.sap.ale.outbound.AleInvoker postIDoc CWYAP3068:Cursor.getNext() method call failed, verify that the input business object Cursor com.ibm.j2ca.extension.dataexchange.sdo.InputCursorSDO@61b261b2 data is initialized. Error Message: Exception while getting accessor. Please make sure property exists with accessor name verb Explanation=The input data has not been populated in the input business object Cursor. UserAction=Input business object data may not have been initialized in the business object specified in the error message, make sure data in initialized before calling getNext().
Resolution: This has been fixed. The adapter now displays an Information message in the log file.
17 92929 Log file has no information about the partner character set information.
Symptom: If an incorrect value is given to the partner character set, like abc123, the adapter does not log an error indicating that the value set is not valid.
Resolution: This has been fixed. The adapter now displays an appropriate log message.
18 93147 When you deploy SAP adapter module on WebSphere Process Server, IllegalCharsetNameException is thrown.
Symptom: If no value is specified for the Partner character set, the adapter throws an IllegalCharsetNameException at runtime.
Resolution: This has been fixed. The adapter does not throw the exception if no value is set. The default value is used instead.
19 76089 SQI without Business Graph throws an exception
Symptom: Executing SQI without BG throws the following exception: com.ibm.websphere.sca.ServiceRuntimeException: DataBinding Exception thrown in J2CMethodBindingImpl.invoke() commonj.connector.runtime.DataBindingException: Failed to initialize cursor at com.ibm.ws.sca.internal.j2c.J2CMethodBindingImpl.invoke(J2CMethodBindingImpl.java:360) at com.ibm.ws.sca.internal.j2c.J2CInterfaceBindingImpl.invoke(J2CInterfaceBindingImpl.java:118) at com.ibm.ws.sca.internal.j2c.handler.J2CImportHandler.invokeDynamicImport(J2CImportHandler.java:1044) at com.ibm.ws.sca.internal.j2c.handler.J2CImportHandler.processMessage(J2CImportHandler.java:338) at ..................
Resolution: This has been fixed.
20 76042 Adapter throws an error if the data record is not populated.
Symptom: When using one or more SAPRequestNodes, the adapter fails to complete subsequent request after a failure.
Resolution: This has been fixed.
21 75794 Poor service diagnostics for wrongly configured SAP Gateway host setting.
Symptom: The Adapter does not throw an exception if the gateway host setting is wrongly configured. It only logs a trace of the issue - thus the Message Broker cannot catch an exception to be able to report the issue to the user.
Resolution: This has been fixed.
22 75795 Building Connection with Async q/tRFC BAPI with Out Params gives bad error.
Symptom: The adapter continues to execute a q/tRFC BAPI request which has a required Output paramater. Since the q/tRFC call is async, required Output parameters cannot be supported.
Resolution: This has been fixed. The adapter does not allow completion of the EMD wizard when selected BAPIs have required Output parameters for executing a q/tRFC BAPI call.
23 75814 While using the adapter connection wizard to build an Inbound to SAP adapter, if you set only "Gateway Service" and omit "Gateway Host" the following error message is thrown: throw NullPointerException SAPManagedConnectionFactory.isGatewayConfigured
Symptom: The Adapter Connection Wizard can allow a user to build an Inbound to SAP Adapter that will throw NullPointerException SAPManagedConnectionFactory.isGatewayConfigured if they only set "Gateway Service" and omit "Gateway Host".
Resolution: This has been fixed.
24 76058 46390,082,000 The JCA SAP adapter does not correctly generate the operation name for inbound using extension IDocs.
Symptom: The adapter was generating a different operation name during the EMD run and another at runtime. This mismatch caused a FunctionSelectorException at runtime.
Resolution: This has been fixed.
25 90460,217,631 The time fields are being translated to hhmmss format(0-12hr format) with missing AM/PM information.
Symptom: Adapter returns the time value in 12 hour format without the AM/PM information which is not complete.
Resolution: The adapter now sends the time in 24 hour format correctly.
26 52930,SGC,724 Adapter messages incorrectly uses the event type "E"
Symptom: BAPI trace messages that are actually non-error messages incorrectly uses the event type "E".
Resolution: This has been fixed.
27 76149 40278,999,858 The JCA SAP Adapter does not handle multibyte characters from non-Unicode systems correctly.
Symptom: When using the QISS module to retrieve data from a non-Unicode system, the BO gets filled incorrectly as soon as table contains multibyte characters.
Resolution: The adapter now correctly handles multibyte characters from non-Unicode systems.
28 76163 52369,SGC,724 The adapter does not serialize a complex IDoc structure correctly in the endpoint.
Symptom: A BO dump of a complex, multi-segment IDoc is not serialized correctly.
Resolution: This has been fixed.
29 75915 Nullname space support in base class.
Symptom: Base class doesn't support null namespace using 6.1 adapter.
Resolution: This has been fixed.
30 93155 TypeFactory is using ext classloader instead of application classloader in WAS.
Symptom: Class.forName method could not find the record and throws Business Object not found exception and Inbound on ALE fails.
Resolution: This has been fixed.
31 76299 Adapter on WebSphere Transformation Extender throws a NullPointerException.
Symptom: NullPointerException thrown while performing outbound or inbound communication with Websphere Adapter on WebSphere Transformation Extender.
Resolution: No more NullPointerExceptions are thrown by the Adapter on WebSphere Transformation Extender while performing outbound and inbound operation.


This table lists the enhancements and fixes in fix pack version 6.1.0.3.
Enhancements
# CR APAR Title Details
1 86210 Support for asynchronous inbound processing of BAPI calls
Symptom: The adapter supports only synchronous processing of inbound events.
Resolution: The adapter now supports the asynchronous processing of events. With this fix pack, the adapter supports tRFC and qRFC asynchronous protocols for inbound processing. When using these protocols, the client SAP application does not wait for a response from the adapter. For more information about this feature, refer to the adapter documentation.
2 95726 Support for asynchronous outbound processing of BAPI calls
Symptom: The adapter supports only synchronous processing of outbound events.
Resolution: The adapter now supports the asynchronous processing of events. With this fix pack, the adapter supports tRFC and qRFC asynchronous protocols for outbound processing. When using these protocols, the adapter does not wait for a response from the SAP server. For more information about this feature, refer to the adapter documentation.
Fixes
# CR APAR Title Details
1 96046 JR28793 The basic properties user name and password are stored in an advanced configuration section
Symptom: When version 6.1 of the adapter is used with WebSphere Message Broker, the user name and password properties are stored in an advanced configuration section of the adapter properties, even though they are basic, mandatory properties.
Resolution: Because the user name and password are mandatory properties, they have been moved to the basic properties section.
2 96221 JR29142 The adapter does not embed an application exception
Symptom: When a BAPI outbound call fails, version 6.1 of the adapter does not embed the application exception in the FaultException message.
Resolution: The adapter includes an application exception in the FaultException message when a BAPI outbound call fails.
3 96094 JR28825 Ale inbound fails with NullPointerException
Symptom: After applying a WebSphere(R) Process Server fix (6.0.2.1 for APAR JR26701), ALE inbound events fail with a NullPointerException.
Resolution: This problem has been corrected.
4 96095 JR28827 Subsequent calls to SAP fail after an outbound event fails
Symptom: In some scenarios, when an outbound BAPI call from the adapter fails, the table corresponding to the BAPI is locked and all subsequent BAPI calls fail.
Resolution: The adapter now calls the BAPI_TRANSACTION_ROLLBACK function when an outbound call to SAP fails, which enables the underlying resources within SAP to be released.


This table lists the enhancements and fixes in fix pack version 6.1.0.2.
Enhancements
# CR APAR Title Details
1 95574 Support for generic IDoc type in ALE pass-through interface
Symptom: A separate IDoc definition is required for each IDoc that the adapter is expected to process. This can become unwieldy when the ALE pass-through interface is used to process many different IDoc types.
Resolution: The ALE pass-through interface supports a generic IDoc definition that enables the adapter to process any IDoc type. An IDoc type field in the object definition is used to indicate the IDoc type.
2 95236 Support for custom SAP function module in QISS interface
Symptom: QISS interface uses the SAP RFC_READ_TABLE function module to retrieve data. On some SAP systems, the RFC_READ_TABLE function fails and causes SAP short dumps, which result in the following error: Error in ASSIGN statement in the program SAPLSDTX.
Resolution: To overcome this issue, SAP OSS note #758278 recommends creating and using a custom function module instead of the RFC_READ_TABLE function. After this custom function module is created on the SAP system, you can enter the custom function module name when running the external service wizard. The adapter uses this custom function module at run time.
3 95594 Support inbound split IDoc packet in ALE pass-through interface
Symptom: The ALE pass-through inbound interface does not support a split IDoc packet.
Resolution: Each IDoc in the inbound packet can be sent as an individual business object.
4 95622 Transaction ID (event ID) for ALE inbound operation not populated in the business object
Symptom: The transaction ID (event ID) is not populated in the business object.
Resolution: The transaction ID (event ID) is now populated in the business object.


This table lists the enhancements and fixes in fix pack version 6.1.0.1.
Enhancements
# CR APAR Title Details
There are no enhancements in this fix pack.
Fixes
# CR APAR Title Details
1 86215 Support for IDoc streams with no partial parsing
Symptom: The ALE inbound interface does not support the processing of an incoming IDoc as an unparsed stream.
Resolution: The ALE inbound interface supports the processing of an incoming IDoc as an unparsed stream. The external service discovery wizard now generates the required artifacts to provide this support.
2 89221 Support for Secure Network Communication (SNC)
Symptom: The adapter does not support Secure Network Communication (SNC).
Resolution: This support has been added.
3 90957 Configurable retry for failed events
Symptom: The adapter continues to redeliver failed events indefinitely.
Resolution: A new property, FailedEventRetryLimit, has been added to the activation specification. Through this property, you can specify the number of times the adapter attempts to deliver an event before marking it as FAILED. This only applies to failures that are normally retried; data binding errors and function selector errors are excluded. If the adapter or server is shut down and restarted, the adapter will start fresh and deliver the event the specified number of times, without regard to any retries that were attempted before the adapter was shut down.


This table lists new connector properties
# Version Platform Add or Remove Property (Note that property names are case sensitive)
1 6.1.0.2 all Add customFunctionName - Custom function name
2 6.1.0.1 all Add SncMode - Secure Network Communication (SNC) mode, 0 (off) or 1 (on)
3 6.1.0.1 all Add SncMyname - Secure Network Communication (SNC) name
4 6.1.0.1 all Add SncPartnername - Secure Network Communication (SNC) partner, for example, p:CN=R3, O=ABC-TES, C=EN
5 6.1.0.1 all Add SncQop - Secure Network Communication (SNC) level of security, valid values are 1 to 9
6 6.1.0.1 all Add SncLib - Path to the library that provides the SNC service
7 6.1.0.1 all Add FailedEventRetryLimit
8 6.1.0.4 all Add ConnectionRetryLimit
9 6.1.0.4 all Add ConnectionRetryInterval


This table lists new or changed files
# Version Platform Add or Remove or Replace File (Starting from %INSTALLDIR% directory)
No files were introduced or modified for this version of the interim fix.


To upgrade to the version 6.1.0.6, 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. To update deployed applications(that have an embedded adapter RAR file) on the WebSphere Process Server,use the following procedure
   a. Stop the application that needs to be updated,using the WebSphere Process Server admin console
   b. Select Update for the corresponding application in the WebSphere Process Server admin Console.
   c. Select Replace or add a single file option with relative path as name of the rar file - .
   d. Click the Browse button to select the updated RAR file on your local file system.
   e. Select the default values for the consecutive steps and select Finish.This will ensure that existing configurations e.g. MCF,are not changed and the JAR files are only updated.

To see a list of files that have been updated in this interim fix, refer to the file 'updatedFileList.txt'

April 4th, 2008 6:00 PM
(C) 2008 IBM Corporation. Proprietary and Confidential. All Rights Reserved.