webMethods WebSphere MQ Adapter 6.5 readme

webMethods WebSphere MQ Adapter 6.5 readme

July 2006

This file provides important information you should read before using webMethods WebSphere MQ Adapter 6.5.

Installation and upgrade instructions are located in the webMethods WebSphere MQ Adapter Installation Guide. For a complete list of webMethods WebSphere MQ Adapter documentation, see section 7.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 Globalization

    6.1 Certification

    6.2 Configuration

    6.3 Localization

7.0 Documentation

    7.1 Major Documentation Changes

    7.2 Known Documentation Issues

8.0 Copyright Information

9.0 Contacting webMethods

10.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-14A8TJ
After installing webMethods WebSphere MQ Adapter 6.5, certain listener and connection parameters configured using webMethods WebSphere MQ Adapter 6.0 do not display their configured values:

- Listener parameter "Convert Application Data" displays as blank.

- Connection parameters "Encoding", "Cache Overridden Connections", and "Action before disconnecting an in-transaction connection" display as blank.

To make these parameter values appear in webMethods WebSphere MQ Adapter 6.5, open each listener or connection in edit mode and save it.

For other known issues and troubleshooting information about webMethods WebSphere MQ Adapter, go to the webMethods Advantage Knowledge Base.

3.0 Usage Notes

None.

4.0 Enhancements and Fixes

For information about enhancements and fixes in webMethods WebSphere MQ Adapter 6.5, see the webMethods WebSphere MQ Adapter 6.5 Enhancements and Fixes document.

5.0 Deprecated Items

None.

6.0 Globalization

webMethods WebSphere MQ Adapter 6.5 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.

6.1 Certification

webMethods WebSphere MQ Adapter 6.5 was tested with non-ASCII data using various Unicode and non-Unicode encodings. It was tested in common European and Far East Asian locales and is supported for operation in any locale provided by your operating environment. The tested environments included English locale on an English Windows machine and Japanese locale on an English Windows machine.

6.2 Configuration

If you expect to display non-English data in your webMethods tools, make sure an appropriate font is installed in your operating environment. If you see hollow boxes or black squares where you expect to see non-English data, modify your JRE font.properties file to reference an appropriate font. For information on modifying your font.properties file, go to Sun's Java website. For instructions, see:

http://java.sun.com/j2se/1.4.2/docs/guide/intl/fontprop.html

http://java.sun.com/j2se/1.5.0/docs/guide/intl/fontconfig.html

http://www.unicode.org/help/display_problems.html

The configuration of the database you use with webMethods WebSphere MQ Adapter 6.5 affects the characters the database can contain. If you select a non-Unicode encoding for the database, characters from outside that encoding will be lost when you store data in the database. webMethods recommends that you use the most appropriate Unicode encoding for your database character set. See the webMethods Installation Guide and your database vendor's documentation for instructions on choosing and setting the character encoding for your database and environment.

6.3 Localization

webMethods WebSphere MQ Adapter 6.5 is provided with an English user interface, messages, and documentation. Language packs containing support for other languages, when available, can be installed at any time using the webMethods Installer. webMethods WebSphere MQ Adapter 6.5 supports simultaneous multi-locale operation.

7.0 Documentation

For webMethods WebSphere MQ Adapter 6.5 technical documentation, go to the IntegrationServer\packages\WmMQAdapter\doc directory or the webMethods Advantage Bookshelf. These manuals are provided as PDF files:

-  webMethods WebSphere MQ Adapter Installation Guide

-  webMethods WebSphere MQ Adapter User’s Guide

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

7.1 Major Documentation Changes

None.

7.2 Known Documentation Issues

None.

8.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.

9.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 webMethods Advantage Customer Forums.

10.0 Viewing the readme for the Previous Version

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

ADAPTER-WEBSPHEREMQ-RM-650-20060731