webMethods for Microsoft Package 6.5 readme

April 2005

This file provides important information you should read before using the webMethods for Microsoft Package 6.5.

Documentation about how to install the webMethods for Microsoft Package 6.5 is located in the webMethods for Microsoft Package Installation and User's Guide 6.5. Documentation on how to upgrade is located on the webMethods Bookshelf.

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 Known Globalization Issues

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

Important Installation Pre-Requisite

Please install the following Microsoft products prior to installing the product:

Microsoft .NET Framework Version 1.1 Redistributable Package

Visual J# .NET Version 1.1 Redistributable Package

Please see the webMethods for Microsoft Package Installation and User's Guide 6.5 for additional information regarding installation prerequisites.

2.0 Known Issues

Nested data objects such as Structures and Classes are not supported at this time. Should services be generated for methods containing nested data objects as input or output parameters, invocation of those services will fail.

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

3.0 Usage Notes

The webMethods for Microsoft Package provides two kinds of tracing for services created from .NET assembly methods: .NET assembly method invocation tracing and .NET assembly introspection tracing. Both kinds of tracing information are written to the same log file.

The log file for all tracing performed by the webMethods for Microsoft Package is:

<IntegrationServerDirectory>\logs\traceManagedServer.log

Please see thewebMethods for Microsoft Package Installation and User's Guide 6.5for more information.

4.0 Enhancements and Fixes

This release adds several new features to the webMethods' support for .NET. The key features of the release include:

·         You can invoke methods on .NET assemblies as services. You can then use these services just as you would use other services in webMethods Fabric.

·         You can invoke services natively from .NET applications using the .NET native API to Integration Server. This feature allows you to invoke services from .NET assemblies written in any .NET Framework language.

·         We provide the webMethods Add-in for Microsoft Visual Studio .NET. This feature allows you to introspect services in webMethods Fabric and invoke .NET native client code to invoke those services.

5.0 Deprecated Items

None.

6.0 Globalization

webMethods for Microsoft Package 6.5 conforms to the international standards of webMethods and includes support for operation in any country, locale, or language. Support for character encodings and proper formatting, display, and validation of data (such as number and date formats) has been provided throughout the package. The webMethods for Microsoft Package 6.5 complies with the requirements of Unicode Standard 3.0 and later.

This version of the package was tested with both English and Japanese versions of the .NET operating environment (CLR), including passing non-ASCII data values. .NET services invoked through the Microsoft Package have their default thread CultureInfo set by the "Locale Policy" property you apply to the service in webMethods Developer. By default this is the session locale of user invoking the service, which may be different than either the .NET host environment or the Integration Server's JVM default locale. You can also set the property to a specific value.

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 the font. For information on modifying your font.properties file, go to Sun's Java website. For information on the JRE provided with this release, go to:

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

Or refer to the document located at:

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

6.1 Known Globalization Issues

None.

7.0 Documentation

For webMethods for Microsoft Package 6.5 technical documentation, go to the <IntegrationServer_Directory>/packages/WmDotNet/pub/doc directory or browse to http://<IntegrationServer>:5555/WmDotNet/ and look under Resources. The following manuals are provided as PDF files:

webMethods for Microsoft Package Installation and User's Guide

webMethods for Microsoft Package Client API Programmer's Guide

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

For information regarding this release of the webMethods for Microsoft Package, see the webMethods Fabric Release Notes 6.5 on the webMethods Bookshelf.

For information about technical support, see the General Support Statement for webMethods Fabric.

7.1 Major Documentation Changes

None.

7.2 Known Documentation Issues

None.

8.0 Copyright Information

8.1 webMethods Copyright

webMethods Administrator, webMethods Broker, webMethods Dashboard, webMethods Developer, webMethods Fabric, webMethods Glue, webMethods Installer, webMethods Integration Server, webMethods Mainframe, webMethods Manager, webMethods Mobile, webMethods Modeler, webMethods Monitor, webMethods Optimize, webMethods Portal, 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) 2005 by webMethods, Inc. All rights reserved, including the right of reproduction in whole or in part in any form.

8.2 Other Product Copyrights

Java (TM) 2 Runtime Environment, Standard Edition, Version 1.4 Licensed material - Property of IBM (c) Copyright IBM Corporation, 1996-2004.  All rights reserved.

This product includes software developed by the Apache Software Foundation.

This product includes software developed by Entrust, Inc.

9.0 Contacting webMethods

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

  webMethods Advantage Web site

  E-mail: support@webMethods.com

  US Phone: 1-888-222-8215

  Europe/EMEA Phone: +800-963-84-637 or +31-207783640

  Asia/Pacific Phone: +1800-117-114 or 8913-1111

Self-service support is also available in the webMethods Advantage Knowledge Base and in the Advantage Customer Forums.

10.0 Viewing the readme for the Previous Version

To view information about the previous release of webMethods Package for Microsoft, see the previous readme on the webMethods Bookshelf.

 

MSP-RM-650-20050429