webMethods SWIFTNet Module 6.0.1 Service Pack 1 readme

August 2006

This file provides important information you should read before installing and using webMethods SWIFTNet Module 6.0.1 Service Pack 1.

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

Contents

1.0 Critical Information

2.0 Known Issues

3.0 Usage Notes

4.0 Enhancements and Fixes

4.1 Fixes and Service Packs Included in This Service Pack

4.2 Enhancements

4.3 Fix Descriptions

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-15H87F
Issues with processing multiple FileAct messages in Store and Forward Push mode (Seen in sample packages).

If multiple FileAct messages are pushed in the same session by SWIFTNet SnF, only the first file is successfully fetched in a single attempt. While processing subsequent pushed FileAct messages, the following behavior may be seen:

-  Fetching the file may fail with the error message "The File notification message was not delivered in this session. Retrieve the message first and then send the acknowledgement again". The files are, however, fetched successfully in subsequent attempts in the same push session because SWIFTNet SnF continues to push these FileAct messages until the corresponding files are fetched and successfully acknowledged.

-  The file may be fetched successfully, but the corresponding FileAct message may be pushed again even after a successful acknowledgement is sent after the file is fetched. In this case, fetching the file a second time gives an error "System internal error. Please retry later. If the problem persists please call SSIS to ensure availability".

-  Even if an acknowledgement is sent for an Sw:HandleSnFRequest that is pushed by SWIFTNet SnF, sometimes the same message gets pushed again with a retry reason: "Call to server application failed". This behavior is noticed in the case of both FileAct and InterAct."

At the time of writing this document, there is an open support ticket raised by webMethods with SWIFT to investigate this issue.

For other known issues and troubleshooting information relating to webMethods SWIFTNet Module, 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

webMethods SWIFTNet Module 6.0.1 Service Pack 1 includes the following fixes and service packs that were shipped since the last release.

-  SWNTC_6-0-1_Fix1

-  SWNTC_6-0-1_Fix2

-  SWNTS_6-0-1_Fix1

-  SWNTS_6-0-1_Fix2

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

4.2 Enhancements

Store and Forward Support

1-163IA8  Store and Forward Mode Support for InterAct and FileAct Services
In Store and Forward mode, the need for the Sender and Receiver to be online at the same time, as is required for real-time messaging is removed. The messages and files are stored centrally within SWIFTNet in a queue. These messages and files are delivered from the queue to the receiver at a later time.

Improvements to Installation and Configuration

1-163IBG  Improved Installation and Configuration Experience
The installation and configuration experience has been improved:

-  The setting of Integration Server environment variables and addition of SAG DLLs to the Integration Server classpath has been removed. Previously these tasks were done manually during configuration.

A new configuration file, env.cnf, has been added in both the Client and Server modules to set the environment variables. This simplifies the initial configuration process.

Improvements to Documentation

1-163IC3  Improved Documentation
In addition to providing information about the Store and Forward support and installation and configuration instructions, the webMethods SWIFTNet Module Installation and User’s Guide has been updated to include information about each service’s runtime process, including diagrams of process flow. Also, documentation for the sample services in the WmSWIFTNetClientSample package and the WmSWIFTNetServerSample package is now included.

4.3 Fix Descriptions

1-WWYJT  (SWNTC_6-0-1_Fix1) Client module of webMethods SWIFTNet Module does not support SWIFT Alliance Gateway (SAG) 5.0.
The Client module of webMethods SWIFTNet Module has been updated to support SAG 5.0. To support SAG 5.0, the WmSWIFTNetClient.dll has been recompiled and relinked with the SAG 5.0 libraries. Additionally, the IS document types have been regenerated using the SAG 5.0 DTDs.

1-XR4R7  (SWNTC_6-0-1_Fix1) webMethods SWIFTNet Client module issues an error message when processing a response document.
The Client module of webMethods SWIFTNet Module was searching for an incorrect namespace prefix for a FileAct message, which resulted in an error message being issued. The Client module has been updated to search for the correct FileAct message namespace prefix.

1-YKSIM  (SWNTC_6-0-1_Fix2) InterAct sample was not working with SAG 5.0 libraries.
Validation problems on the client side prevented InterAct messages from being sent. The mapping services have been updated to correct the validation errors.

1-WWYJT  (SWNTS_6-0-1_Fix1) Server module of webMethods SWIFTNet Module does not support SWIFT Alliance Gateway (SAG) 5.0.
The Server module of webMethods SWIFTNet Module has been updated to support SAG 5.0. To support SAG 5.0, the WmSWIFTNetServer.dll has been recompiled and relinked with the SAG 5.0 libraries. Additionally, the IS document types have been regenerated using the SAG 5.0 DTDs.

1-XU323 (SWNTS_6-0-1_Fix1) Server module of webMethods SWIFTNet Module does not receive inbound notifications.
Inbound notifications were not being received because the Execute ACL on wm.swiftnet.server.services:handleRequest service was not set to 'Anonymous'. This is now resolved.

1-Y2DL5  (SWNTS_6-0-1_Fix1) webMethods Trading Networks did not recognize documents received by the Server module of webMethods SWIFTNet Module.
The SWIFTNet Server TN document types included the namespace prefix in the root tag and namespace declarations. To correct the recognition problem, the TN document types have been updated to remove the namespace prefix from the root tag and all namespace declarations.

1-Y2FJX  (SWNTS_6-0-1_Fix1) The Server module sample of webMethods SWIFTNet Module does not construct the incoming request document correctly.
The sample invoked the wm.tn.doc.xml:bizDocToRecord service to create the incoming request document. However, using this service did not correctly create the incoming request document. To correct the problem, the call to the wm.tn.doc.xml:bizDocToRecord service was replaced to use other low-level services.

1-YKSM2  (SWNTS_6-0-1_Fix2) InterAct sample was not working with SAG 5.0 libraries.
IS document type changes with new SAG 5.0 DTDs prevented the successful processing of incoming InterAct messages in the WmSWIFTNetServerSample package. The mapping services have been updated to correct the validation errors.

5.0 Deprecated Items

None.

6.0 Service Pack Requirements

None.

7.0 Platform Support

Platform and Operating System Support:

-  Microsoft Windows 2003 Server

-  Microsoft Windows XP Professional

-  Microsoft Windows 2000 Professional (only for webMethods Integration Server 6.1)

webMethods Software Support:

-  webMethods Integration Server 6.1, 6.5

-  webMethods Developer 6.1, 6.5

-  webMethods Trading Networks 6.1, 6.5

8.0 Installation

To install this service pack, follow the procedure described in the webMethods SWIFTNet Module Installation and User’s Guide 6.0.1 SP1.

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 tested with non-English configurations and non-ASCII data. The tested environments included English locale on an English Windows machine, Japanese locale on an English Windows Machine and French Locale on an English Windows Machine.

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. Language packs containing support for other languages, when available, can be installed at any time using webMethods Installer.

10.0 Documentation

The technical documentation for webMethods SWIFTNet Module 6.0.1 Service Pack 1 is available in both the WmSWIFTNetServer and WmSWIFTNetClient packages at IntegrationServer directory\packages\WmSWIFTNetServer\pub\doc and IntegrationServer directory\packages\WmSWIFTNetClient\pub\doc, respectively. The documentation is also available on the SWIFTNet Module page on the webMethods Bookshelf. The following manual is provided as a PDF file:

webMethods SWIFTNet Module Installation and User’s Guide 6.0.1 SP1

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

10.1 Major Documentation Changes

The webMethods SWIFTNet Module Installation and User’s Guide has been updated for this service pack to include information for the Store and Forward mode support for InterAct and FileAct Services, as well as providing complete documentation for the SWIFTNet Module services and its sample services.

10.2 Known Documentation Issues

None.

11.0 Copyright Information

11.1 webMethods Copyright

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.

11.2 Other Product Copyrights

SWIFT, S.W.I.F.T., Sibos, and SWIFT-derived product and service names (such as but not limited to SWIFTNet and SWIFTAlliance) and the SWIFT logo are trademarks of S.W.I.F.T. SCRL.

SWIFT is the trading name of S.W.I.F.T. SCRL. All other products or company names mentioned on this site are trademarks or registered trademarks of their respective owners.

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 SWIFTNet Module, see the previous readme on the webMethods Bookshelf.

 

ESTD-SWIFTNET-RM-601SP1-20060818