webMethods SAP Adapter 6.5 Service Pack 1 readme

October 2006

This file provides important information you should read before installing and using webMethods SAP Adapter 6.5 Service Pack 1.

For a complete list of webMethods SAP Adapter documentation, see section 10.0 Documentation in this readme. For information about technical support, see the Adapter Support Policy.

Contents

1.0 Critical Information

2.0 Known Issues

3.0 Usage Notes

4.0 Enhancements and Fixes

5.0 Deprecated Items

6.0 Service Pack Requirements

7.0 Platform Support

8.0 Installation

9.0 Globalization

    9.1 Localization

10.0 Documentation

    10.1 Major Documentation Changes

    10.2 Known Documentation Issues

11.0 Copyright Information

12.0 Contacting webMethods

13.0 Viewing the readme for the Previous Version

1.0 Critical Information

None.

For late-breaking critical information, refer to the Critical Information area on the webMethods Advantage Web site.

2.0 Known Issues

1-17RUP1
Changing the default Function Name in an RFC notification does not remove the old fields that belong to the default function, and results in a runtime error.

When configuring an Integration Server with the SAP Adapter and creating an RFC Notification, the default Function Pattern for a new RFC notification is 'RFC*', which might select an RFC function on a configured SAP System that has a specific input/output signature. The Adapter Runtime (WmART) then adds these fields from this RFC to the request/reply signature for this notification. However, when the Function Name is changed, WmART does not delete these old fields. Therefore, the fields of the originally selected RFC are still in the publishable document for the new function. In case of an Asynchronous RFC Notification, this leads to a runtime error later because these fields are not optional.

This issue will be addressed in a future release. As a workaround for this issue, change the RFC Function Name back to the default first entry. Then select/deselect all the fields in the Request Field Selection tab of the RFC notification in webMethods Developer, and then change the Function Name back to the desired function name.

For other known issues and troubleshooting information relating to webMethods SAP Adapter, see the Knowledge Base on the webMethods Advantage Web site.

3.0 Usage Notes

None.

4.0 Enhancements and Fixes

4.1 Fixes and Service Packs Included in This Service Pack

The webMethods SAP Adapter 6.5 Service Pack 1 includes the following fixes that were shipped since the last release.

-  WmSAP_6-5_Fix1

-  WmSAP_6-5_Fix2

-  WmSAP_6-5_Fix3

-  WmSAP_6-5_Fix4

For detailed information regarding these fixes and service packs, see the Knowledge Base on the webMethods Advantage Web site.

4.2 Enhancement and Fix Descriptions

webMethods SAP Adapter 6.5 Service Pack 1 includes the following enhancements:

Migration Utility
SAP Adapter 6.5 does not support upgrading from the previous versions of the SAP Adapter. With SAP Adapter 6.5 SP1, a migration utility is introduced that allows you to programmatically upgrade existing SAP Adapter 4.6 based application packages to be compatible with SAP Adapter 6.5. Alternatively, you can also perform the upgrade steps manually, following the detailed instructions provided in the webMethods SAP Adapter Installation Guide 6.5 Service Pack 1.

Asynchronous RFC Notification Template
To process the inbound RFC's asynchronously, that is, to publish them locally or to the Broker, a new RFC listener notification template is added.

Centralized Transaction Store
A Centralized Transaction Store is introduced that enables you to implement robust inbound or outbound load balancing using tRFCs and IDocs in a cluster of logically grouped SAP Adapters.

Static Local RFC Metadata Repository
A static local RFC metadata repository is introduced to run the WmSAPOptimize package without adding RFC declarations to the SAP R/3 backend.

The webMethods SAP Adapter 6.5 Service Pack 1 includes the following fixed items:

1-131BHX (WmSAP_6-5_Fix1)
SAP Adapter routing notifications with wildcards are not working.

1-12TBD9 (WmSAP_6-5_Fix1)
High CPU utilization when an SAP Adapter routing listener is enabled on an idle Integration Server.

1-131BJ0 (WmSAP_6-5_Fix1)
SAP Adapter reads IDoc fields as Integer instead of String.

1-1435KX (WmSAP_6-5_Fix2)
Public service pub.sap.client:getAttributes always returns the same connection attributes.

1-1495YL (WmSAP_6-5_Fix2)
SAP Adapter 6.5 does not include JCo log output in the adapter log file.

1-14CNU2 (WmSAP_6-5_Fix2)
SAP Adapter Edit Connection screen shows incorrect connection pooling status.

1-148GTN (WmSAP_6-5_Fix2)
SAP Adapter services and notifications fail while sending IDOCs from SAP Adapter 6.5 to SAP 3.1H system.

1-14D1B1 (WmSAP_6-5_Fix2)
A SYSTAT status IDoc created for IDocs received by an Asynchronous ALE Notification contains incorrect error messages in the fields STATXT and STAPA1, even if the received IDoc was processed without errors.

1-14M6QH (WmSAP_6-5_Fix3)
Setting 'serverName' in the pipeline to the alias name of an existing and enabled SAP connection can redirect the call of an RFC Adapter Service to this SAP connection.

1-155IGV (WmSAP_6-5_Fix3)
SAP Adapter 6.5 throws nullpointer exceptions during Integration Server startup.

1-15G88N (WmSAP_6-5_Fix3)
The pub.sap.transaction:Sweep service does not delete transactions in the expected manner.

1-15QNZL (WmSAP_6-5_Fix4)
SAP Adapter error when processing inbound IDocs with empty fields of type INT.

1-175Y9Y (WmSAP_6-5_Fix4)
Missing encoding parameter causes problems.

1-17P5NF (WmSAP_6-5_Fix4)
SAP Adapter Log facilities drop down list is unpopulated when there is no log file.

1-172RW1
The SAP Adapter package (WmSAP) is not displayed in the list of Installed Packages and Updates, which is part of the webMethods Packages and Updates page in the Integration Server.

5.0 Deprecated Items

None.

6.0 Service Pack Requirements

- webMethods SAP Adapter 6.5

7.0 Platform Support

This service pack is supported on all platforms supported by the webMethods SAP Adapter 6.5.

8.0 Installation

Install this service pack using the latest webMethods Installer. For complete instructions, see the webMethods SAP Adapter Installation Guide 6.5 Service Pack 1.

9.0 Globalization

This service pack conforms to the internationalization standards of webMethods and includes support for operation in any country, locale, or language as specified in the webMethods Installation Guide. It was not tested with non-English configurations and non-ASCII data. However, this service pack has no globalization impact and can be applied to systems running in any supported locale or configuration.

9.1 Localization

This service pack does not require an updated Language Pack. It might contain new messages and these messages will appear in English.

10.0 Documentation

For webMethods SAP Adapter 6.5 SP1 technical documentation, go to the <Integration_Server_Directory>\packages\WmSAPAdapter\doc directory or the webMethods Bookshelf. These manuals are provided as PDF files:

webMethods SAP Adapter Installation Guide

webMethods SAP Adapter User's Guide

To view the documentation, you must have Adobe Acrobat Reader 5.0 or later.

10.1 Major Documentation Changes

None.

10.2 Known Documentation Issues

None.

11.0 Copyright Information

webMethods Access, webMethods Administrator, webMethods Broker, webMethods Dashboard, webMethods Developer, webMethods Fabric, webMethods Glue, webMethods Installer, webMethods Integration Server, webMethods Mainframe, webMethods Manager, webMethods Modeler, webMethods Monitor, webMethods Optimize, webMethods Portal, webMethods Servicenet, webMethods Trading Networks, and webMethods Workflow are trademarks of webMethods, Inc. webMethods and the webMethods logo are registered trademarks of webMethods, Inc.

All other marks are the property of their respective owners.

Copyright (c) 2006 by webMethods, Inc. All rights reserved, including the right of reproduction in whole or in part in any form.

12.0 Contacting webMethods

Authorized technical support contacts can reach webMethods Customer Care for support via:

Web: webMethods Advantage  webMethods online support center

E-mail: support@webMethods.com

Phone:   North America  +1-888-222-8215 or +1 703 460 2584
Europe         +800 963 84-637 or +31 20 77 83 640
Asia Pacific   +1 1-800-088-880 or +61-2-8913 1111
Japan          0120-979-762 (Toll Free in Japan) 
               or +81-3-6229-3751

In addition, self-service support is available in the webMethods Advantage Knowledge Base and in the Advantage Customer Forums.

13.0 Viewing the readme for the Previous Version

To view information about the previous release of webMethods SAP Adapter, see the previous readme on the webMethods Bookshelf.

ADAPTER-SAP-RM-65-SP1-20061006