webMethods SWIFT FIN Module 6.1 Service Pack 1 readme

December 2006

This file provides important information you should read before installing and using WebMethods SWIFT FIN Module 6.1 Service Pack 1.

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

Information in this readme might have been updated since you last downloaded it. Go to the webMethods Bookshelf or the webMethods Installer for the latest version of the readme.

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

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

2.0 Known Issues

None.

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

3.0 Usage Notes

-  webMethods SWIFT FIN Module 6.1 Service Pack 1 resolves some important issues and also includes support for the SWIFTStandards MT Messages for 2006.

-  Refer to the webMethods SWIFT FIN Module Installation and User’s Guide 6.1 for instructions to configure the SWIFT FIN Module. To use the SWIFT 2006 messages, use the nov06 version of the message types.

4.0 Enhancements and Fixes

4.1 Fixes and Service Packs Included in This Service Pack

webMethods SWIFT FIN Module 6.1 Service Pack 1 includes the following fixes and service packs that were shipped since the last release:

-  FIN_6-1_Fix1 to FIN_6-1_Fix18

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

For information on enhancements and fixes in webMethods SWIFT FIN Module 6.1 Service Pack 1, go to the webMethods Bookshelf and read the webMethods SWIFT FIN Module 6.1 Service Pack 1 Enhancements and Fixes document.

5.0 Deprecated Items

None.

6.0 Service Pack Requirements

None.

7.0 Platform Support

webMethods SWIFT FIN Module 6.1 Service Pack 1 is supported on all platforms supported by webMethods SWIFT FIN Module 6.1.

8.0 Installation

To install this service pack, do the following.

1. Download the latest webMethods Installer from the webMethods Advantage Web site at http://advantage.webmethods.com.

2. If you are going to install the webMethods SWIFT FIN Module on an already installed Integration Server, shut down the Integration Server.

Important! You must have administrator privileges on the webMethods Integration Server to execute these procedures. If you do not have administrator privileges, have your webMethods Integration Server administrator perform these procedures.

3. Start the Installer.

4. During the install process, the Installer prompts you for an installation directory. If an Integration Server is already installed on the computer, specify your existing webMethods installation directory. If you are installing the webMethods SWIFT FIN Module 6.1 Service Pack 1 and the Integration Server at the same time, specify an installation directory for webMethods software or accept the default directory.

5. If you are installing the service pack and webMethods SWIFT FIN Module 6.1 at the same time, in the component selection list, select eStandards > webMethods SWIFT FIN Module 6.1 to install webMethods SWIFT FIN Module 6.1 along with Service Pack 1.

In addition, select any required webMethods components you have not installed.

6. If you are installing the Service Pack 1 over an existing installation of the SWIFT FIN Module 6.1:

a. Back up the following webMethods SWIFT FIN Module 6.1 packages: WmFIN, WmFINDev, WmFINMarketPractice, WmFINMessages, WmFINSamples, WmFINTransport, WmCASmf, and WmIPCore.

b. In the component selection list, navigate to eStandards > webMethods SWIFT FIN Module 6.1. Select the Service Pack 1 for installation.

7. Click Next until you see the installation complete message.

8. Click Close.

9. Start the Integration Server.

10.If you are already using SWIFT FIN Module 6.1, you must re-import all the message types that you are using by invoking the wm.fin.dev:importFINItems service.

Please note that before re-importing the message types, you should delete the existing IS document types in the wm.fin.doc.<version>.<category> folders in the Developer to avoid any problem that may arise due to the existence of an older version.

If you are using a previous version of the message types and you would like to upgrade to SWIFT 2006 messages, see section 8.1 Upgrading to SWIFT 2006 Messages.

11.If you are a new user of SWIFT FIN Module 6.1, see the webMethods SWIFT FIN Module Installation and User’s Guide 6.1 for instructions to configure and use the SWIFT FIN Module. To use the SWIFT 2006 messages, use the nov06 version of the message types.

8.1 Upgrading to SWIFT 2006 Messages

To upgrade to SWIFT 2006 messages:

If you are using a previous version of the message types, and would like to upgrade to SWIFT 2006 messages, import all the 2006 message types that you would like to use, and then update the TPA and the mapping services.

1.Import the 2006 message types for the message types you are using:

a. Import all the message types by invoking the wm.fin.dev:importFINItems service using the webMethods Developer.

b. In the input dialog box for importFINItems, input the following:

             msgType = <Message type. For example, 535>

             version = <nov06>

             createDocType = false

             createProcessingRule = false

             createTPA = false

       A new nov06 folder, wm.fin.doc.nov06, is created in the WmFINMessages package with the new IS document types.

2.Update the TPA for the message types using the Trading Networks Console Agreement Details screen:

- For the inbound messages, the Agreement ID is in the format: MT<msg type>. For example, MT535.

- For the outbound messages, the Agreement ID is the name of the TN document type for the backend system format document. For example, InternalCorporateAction.

       a. Change the Agreement Status to Proposed. Open the TPA.

       b. Modify the TPA's SWIFT-specific input parameters using the Input for <IS Document Type> dialog:

                1)  Click the Set Inputs dialog button (located on the right side of the Agreement Details screen). The Input for <IS Document Type> dialog appears.

                2)  Set the ISDocumentName parameter to point to the corresponding document type in the nov06 version folder, wm.fin.doc.nov06.

                3)  Set the Version parameter to "nov06".

                4)  If the ValidateNetworkRules parameter is set to Yes, update the NetworkValidationService parameter to point to the service in the wm.fin.doc.nov06 folder.

                5)  If the ValidateMarketPracticeRules parameter is set to Yes, update the MarketPracticeRulesService parameter to point to the service in the wm.fin.doc.nov06 folder.

                6)  Click OK to save your input parameter changes.

       c. Click OK to save the information on the Agreement Details. Change the Agreement Status to Agreed.

3.Update the inbound and outbound mapping services using webMethods Developer. If you want to use a modified SWIFT 2006 message type, remap the elements of the message type to the corresponding elements of the new nov06 version of the IS doc type.

For more information on importing the message types, updating the TPA, and mapping the message types, see the webMethods SWIFT FIN Module Installation and User’s Guide.

8.2 Uninstalling the Service Pack

To uninstall only the WebMethods SWIFT FIN Module 6.1 Service Pack 1:

Important! The following steps are valid only if you would like to uninstall only the Service Pack 1 and revert back to your previous installed version of the SWIFT FIN Module 6.1. If you are a new user of SWIFT FIN Module, and have installed the webMethods SWIFT FIN Module 6.1 along with the Service Pack 1, do not try to uninstall just the Service Pack 1, you must uninstall the entire SWIFT FIN Module 6.1.

1. Shut down the Integration Server that hosts the webMethods SWIFT FIN Module.

2. Start the webMethods Uninstaller for your operating system as described in the webMethods Installation Guide.

3. Select “webMethods release installation_directory” as the program to uninstall, where release and installation_directory are the release and installation directory of the Integration Server on which the webMethods SWIFT FIN Module Service Pack 1 is installed.

4. In the component selection list, navigate to eStandards and select webMethods SWIFT FIN Module > Service Pack 1 as the program to uninstall.

5. The uninstaller removes all webMethods SWIFT FIN Module 6.1 Service Pack 1 related files that were installed in the IntegrationServer\packages directory and reverts back to the previous installed version of the SWIFT FIN Module.

6. Re-import all the message types that you are using by invoking the wm.fin.dev:importFINItems service.

9.0 Globalization

SWIFT FIN messages do not support UTF-8. FIN only supports the X-character set. It uses a custom character set, which is a subset of 7-bit ASCII (or optionally a subset of EBCDIC code page 037). This means that no field in a SWIFT document can contain accented or multibyte (non-ASCII) characters. The webMethods SWIFT FIN Module enforces this limit and will generate an error instead of sending the document to the SWIFT network. Users are cautioned to normalize their data to ASCII before mapping it to SWIFT documents.

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

For webMethods SWIFT FIN Module 6.1 technical documentation, go to the …IntegrationServer\packages\WmFIN\pub\doc directory or the webMethods Bookshelf. The following manual is provided as a PDF file:

webMethods SWIFT FIN Module Installation and User's Guide 6.1

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

11.1 webMethods Copyright

B2B Integration Server, Business Process Integration, Cerebra, Get There Faster, Glue, Glueprints, Glueware, Guided SOA Governance, Infravio X-Broker, Infravio X-Registry, Infravio, My webMethods Server, My webMethods, Process Improvement Lifecycle, Process Improvement Lifecycle Methodology, webMethods Access, webMethods Administrator, webMethods Broker, webMethods Central Configuration, webMethods Dashboard, webMethods Designer, webMethods Developer, webMethods Fabric, webMethods Glue, webMethods Infrastructure Data Collector, webMethods Infravio X-Broker, webMethods Infravio X-Registry, webMethods Installer, webMethods Integration Server, webMethods logo, webMethods Mainframe, webMethods Manager, webMethods Modeler, webMethods Monitor, webMethods Optimize for Infrastructure, webMethods Optimize for Process, webMethods Optimize, webMethods Portal, webMethods Process Engine, webMethods Servicenet, webMethods SOA Governance, webMethods SOA Management, webMethods Task Engine, webMethods Trading Networks, webMethods Workflow, and webMethods are either registered trademarks or trademarks of webMethods, Inc. in the United States and/or other countries.

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.

This product includes software developed by the Apache Software Foundation.

This product includes software developed by Entrust, Inc.

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   +1800 117 411 or 8913 1111
Japan          0120-979-762 (Toll Free in Japan
               or +81-3-6229-3751

Contact information for webMethods offices not listed here is available at http://advantage.webmethods.com/contact_us.

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

SWIFTFIN-RM-61-20061215