webMethods RosettaNet Module, 6.0.1

                           March 2003

Copyright (C) 1996-2003, webMethods, Inc. All Rights Reserved.
_______________________________________________________________

Welcome to the webMethods RosettaNet Module. This file provides
important information for using webMethods RosettaNet Module 
6.0.1.

webMethods Integration Server, webMethods Trading Networks,
webMethods Modeler, and webMethods Monitor must be installed
before you can install and run webMethods RosettaNet Module. For
information about webMethods Integration Server, Trading
Networks, Modeler, or Monitor, see the readme files in the
directory where you installed the software.

For information about webMethods Integration Platform 6.0.1
enhancements, see the webMethods Integration Platform 6.0.1
Release Notes. For information about the status of previous
webMethods releases, see the General Support Statement. You can
download these documents from the webMethods Advantage Web site.

The webMethods Integration Platform Installation Guide contains
important information you must read before you install
webMethods Integration Platform 6.0.1. The guide also contains
instructions you must follow to perform and complete the
installation.

The webMethods Integration Platform Upgrade Guide contains
important information you must read before you upgrade
webMethods Integration Platform 6.0.1. The guide also contains
instructions you must follow to perform and complete the
upgrade.


Contents:

1.0 Getting Started
2.0 Documentation
    2.1 Documentation Corrections and Additions
3.0 Known Problems and Limitations
4.0 Usage Notes
    4.1 Clustering Capability Statement
5.0 Globalization
    5.1 Database Configuration
6.0 Deprecated Components
7.0 Fixes and Enhancements
    7.1 Fixes in RosettaNet Module 6.0.1
    7.2 Added Services in RosettaNet Module 6.0.1
    7.3 Updated Services in RosettaNet Module 6.0.1
    7.4 Removed Services in RosettaNet Module 6.0.1
    7.5 Changes in RosettaNet Module 6.0.1
8.0 Copyright Information
    8.1 webMethods
    8.2 Other Products
9.0 Contacting Us



1.0 Getting Started

The webMethods RosettaNet Installation Guide Version 6.0.1
contains detailed instructions for installing and configuring
webMethods RosettaNet Module.



2.0 Documentation

Documentation for webMethods RosettaNet Module is located in the
packages\WmRosettaNet\pub\doc directory of the WmRosettaNet
package where you installed the server. The following manuals
are provided as PDF files:

- webMethods RosettaNet Module Installation Guide,Version 6.0.1
- webMethods RosettaNet Module User's Guide Version 6.0.1
- webMethods RosettaNet Module Sample Guide Version 6.0.1
- webMethods RosettaNet Module Built-In Services Reference Guide
  Version 6.0.1

An index.html file is located in the packages\WmRosettaNet\pub
directory of the WmRosettaNet package where you installed the
server. This file provides links to release information,
RosettaNet documentation, and other RosettaNet related links.

To view the documentation supplied with this version of
webMethods RosettaNet Module you must have Adobe Acrobat Reader
4.0 or later. You can download and install Acrobat Reader 4.0
from:

   http://www.adobe.com/support/downloads/main.html


2.1 Documentation Corrections and Additions

None.



3.0 Known Problems and Limitations

This product has the following known limitations at release
time:

- When processing large documents, file system archiving is
  turned off.

- Large document processing is not supported in a reverse proxy
  environment.

- For RNIF2.0, to map the location id field in the
  DeliveryHeader, you must populate a field called 'locationID'
  and map it to 'parameters/userParameters/locationID' in
  the outbound map.

- For RNIF 2.0, documents can  be signed using only the SHA-1
  algorithm.

- RNIF 2.0 Debug Headers are not supported.

- On the initiator side of a RosettaNet transaction, the
  conversation cannot be restarted from the first wait step.

- SMTP is not supported in the current release when sending RNIF
  2.0 transactions. This is because of an underlying product
  limitation. This issue will be addressed in a future service
  pack.



4.0 Usage Notes


4.1 Clustering Capability Statement

During operation, webMethods RosettaNet Module data is written
to the Integration Server repository as well as to the database
with which users connect to webMethods Trading Networks. As
such, the webMethods RosettaNet Module is clusterable because
the Integration Server repository is clusterable and most
commercial databases are clusterable.

However, because of the many different options and possible
architectures for clustering, webMethods is not recommending or
certifying a specific configuration at this time. Please
contact webMethods Professional Services for support in
architecting and implementing your webMethods RosettaNet Module
clustering solution.



5.0 Globalization

The webMethods RosettaNet Module Version 6.0.1 has not been
tested for conformance with the internationalization standards
of webMethods. This internal certification is planned for a
future release. Support for character encodings and locally
formatted data depend on functionality in the webMethods Trading
Networks and webMethods Integration Server products, which have
been certified. The RosettaNet Module is therefore supported for
use in any locale and with any platform supported character
encoding.

If you expect to display non-English data in your webMethods
tools, you need to ensure that an appropriate font is installed
in your operating environment. You should test to see whether
hollow boxes or black squares appear where you would expect to
see non-English data, and if you see problems, modify your JRE
font.properties file to reference the font on your system. You
can find information about modifying your font.properties file
on Sun's Java website (for the JRE provided with this release,
see http://java.sun.com/j2se/1.3/docs/guide/intl/fontprop.html)
or refer to the document located at
http://www.unicode.org/help/display_problems.html.


5.1 Database Configuration

The configuration of your Trading Networks database affects
which characters can be stored. If you select a non-Unicode
character encoding for your database, characters in your
documents that are not included in that encoding will be lost
when stored in the database; therefore, webMethods recommends
using a Unicode encoding for your database if possible. Please
refer to the webMethods Integration Platform Installation Guide
6.0.1 and to the Trading Networks Server 6.0.1 Readme
(Globalization section) for information about selecting the
encoding and driver to use with your specific database.



6.0 Deprecated Components

None.



7.0 Fixes and Enhancements


7.1 Fixes in RosettaNet Module 6.0.1

The following is a list of fixes for webMethods RosettaNet
Module 4.6 that have been included in webMethods RosettaNet
Module 6.0.1:

MultipleRNIF20Attachments
Multiple attachments were not being mapped correctly in RNIF 2.0
ServiceHeader's Manifest.

XML Namespace
Processing of XML documents with namespaces.

WmIPRoot_HttpAuth
Pass user authentication while invoking HTTP.

RNIF20Encoding
Ability to specify different encoding values for RNIF 2.0
messages.

CreateReceiptAck
Non-repudiation information incorrectly mapped into ReceiptAck
when signature does not exist. Document Id and DateTimeStamp
mapped correctly to Receipt Ack for large documents.

TNProfileCertsForHTTPS
Use TN profile certificates for HTTPS connections.

StartNOFv1
Exit statement signaling failure was missing the from clause.

XMLToRecord
Incorrect check being done for "Receipt" in
wm.ip.util:XMLToRecord.

InstanceIdentifier
InstanceIdentifier is not the same in all the documents.

PreambleHeader
Preamble header is not available to the inboundMap step.

WmRNIF20TRP
RNIF 2.0 NOF elements are not mapped from the payload.

ContentId
Content Id in the body parts is not enclosed in the angle
brackets<>.

MultipleDUNS
wm.ip.profile:getTPInfo always returns primary DUNS ID, even
when another is specified.

PrivateProcessException
ServiceHeader validation failure when initiating a private
RNIF20 process exception for RNIF 2.0.

RNIF20Unpack
Unpack RNIF 2.0 MIME envelope properly if extra carriage returns
appear before the main envelope.

RNIF20MessageDigest
All MIME headers not included while computing message digest for
RNIF20 documents.

VerifySignature
When multiple DUNS are specified for a partner, signature
verification MultipleDUNS is failing authentication of sender.


7.2 Added Services in RosettaNet Module 6.0.1

wm.ip.archive:getPackageInfo (formerly
   wm.ip.packages:getVersion)
wm.ip.cm.handlers:done
wm.ip.cm:waitStepInit
wm.ip.util:copyIData
wm.ip.rnif11.util:persistRNIF11BizDoc
wm.ip.rnif20.util:persistRNIF20BizDoc
wm.ip.rnif20.util:privateProcessExceptionRNIF20


7.3 Updated Services in RosettaNet Module 6.0.1

wm.ip.archive:createExportArchive
wm.ip.cm.handlers:error
wm.ip.cm:processDocument
wm.ip.cm:startConversation
wm.ip.profile:getInternalIDs
wm.ip.profile:getTPAInfo
wm.ip.util:addAttachment
wm.ip.rn:receive
wm.ip.rnif11.trp.maps:mapNOF
wm.ip.rnif11.trp.maps:mapPreambleHeader
wm.ip.rnif11.trp:inboundValidation
wm.ip.rnif11.trp:startNOFv1
wm.ip.rnif11.trp:validateHeader
wm.ip.rnif11.util:createRNO
wm.ip.rnif20.utiil:createMessageDigest
wm.ip.rnif20.util:sendSyncException


7.4 Removed Services in RosettaNet Module 6.0.1

wm.ip.cm.handlers:end
wm.ip.cm.handlers:start
wm.ip.cm:deleteByStatus
wm.ip.cm:deleteDone
wm.ip.cm:editScript
wm.ip.cm:editScript2
wm.ip.cm:getScriptInfo
wm.ip.cm:viewScript
wm.ip.cm:viewScript2
Entire wm.ip.dictionary folder
  - wm.ip.dictionary:addCategory
  - wm.ip.dictionary:addDictionary
  - wm.ip.dictionary:addEntry
  - wm.ip.dictionary:createAndAddEntry
  - wm.ip.dictionary:createEntry
  - wm.ip.dictionary:deleteCategory
  - wm.ip.dictionary:deleteDictionary
  - wm.ip.dictionary:getEntry
  - wm.ip.dictionary:deleteEntry
  - wm.ip.dictionary:listCategories
  - wm.ip.dictionary:listDictionaries
  - wm.ip.dictionary:listEntries
  - wm.ip.dictionary:validateEntry
Entire wm.ip.doc folder
  ­ wm.ip.doc:insertIPDocType
  ­ wm.ip.doc:persistIPDoc
Entire wm.ip.log folder
  - wm.ip.log:getLog
Entire wm.ip.packages folder
  - wm.ip.packages:getVersion (moved to
       wm.ip.archive:getPackageInfo)
wm.ip.profile:addExtendedField
wm.ip.profile:addGroup
wm.ip.profile:getExtendedFields
wm.ip.profile:getProcessInfo
wm.ip.profile:getTPInfo
Entire wm.ip.smtp.email folder
  - wm.ip.smtp.email:smtp
wm.ip.profile:addExtendedField
wm.ip.util:archive
wm.ip.util:getBytesFromStream
wm.ip.util:getPartnerInfo
wm.ip.util:persistParts
wm.ip.util:secondToDate
Entire wm.ip.rnif11.cm folder
  - wm.ip.rnif11.cm:getScriptTimeouts
  - wm.ip.rnif11.cm:setScriptTimeouts
Entire wm.ip.rnif11.profile folder
  - wm.ip.rnif11.profile:addExtendedFields
  - wm.ip.rnif11.profile:getPreferredProtocol
  - wm.ip.rnif11.profile:getTPAInfo
  - wm.ip.rnif11.profile:overrideRNIF11ExtendedFields
Entire wm.ip.rnif20.profile folder
  - wm.ip.rnif20.profile:addExtendedFields
  - wm.ip.rnif20.profile:getExtendedFields
  - wm.ip.rnif20.profile:getTPAInfo
  - wm.ip.rnif20.profile:overrideRNIF20ExtendedFields
wm.b2b.rn.sample.company1.maps.outbound:PORequest1_4
wm.b2b.rn.sample.company1.inbound:POAcceptance1_4
wm.b2b.rn.sample.company2.maps.outbound:POAcceptance1_4
wm.b2b.rn.sample.company2.maps.inbound:PORequest1_4
wm.b2b.rn.sample.handler:end
Entire WmRNUpgrade Package
  - wm.b2b.rn.upgrade.impt folder
  - wm.b2b.rn.upgrade.impt:checkPackages
  - wm.b2b.rn.upgrade.impt:importPIPs
  - wm.b2b.rn.upgrade.impt:importPartners
  - wm.b2b.rn.upgrade.impt:importRules
  - wm.b2b.rn.upgrade.export folder
  - wm.b2b.rn.upgrade.export.pips:getMultiPips
  - wm.b2b.rn.upgrade.export.pips:getNextPipToResolve
  - wm.b2b.rn.upgrade.export.pips:getRoles
  - wm.b2b.rn.upgrade.export.pips:init
  - wm.b2b.rn.upgrade.export.pips:resPip2
  - wm.b2b.rn.upgrade.export.pips:resolveMultiPip
  - wm.b2b.rn.upgrade.export.pips:start
  - wm.b2b.rn.upgrade.export.pips:status
  - wm.b2b.rn.upgrade.export.profiles:extractElement
  - wm.b2b.rn.upgrade.export.profiles:getNextProfileToResolve
  - wm.b2b.rn.upgrade.export.profiles:getProfileInfo
  - wm.b2b.rn.upgrade.export.profiles:getResolvedProfiles
  - wm.b2b.rn.upgrade.export.profiles:getSelf
  - wm.b2b.rn.upgrade.export.profiles:getStatus
  - wm.b2b.rn.upgrade.export.profiles:init
  - wm.b2b.rn.upgrade.export.profiles:pickSelf_UI
  - wm.b2b.rn.upgrade.export.profiles:setResolvedProfile
  - wm.b2b.rn.upgrade.export.profiles:setResolvedProfile_UI
  - wm.b2b.rn.upgrade.export.routingRules:exportRules
  - wm.b2b.rn.upgrade.export.routingRules:status
  - wm.b2b.rn.upgrade.util folder
       wm.b2b.rn.upgrade.util:toImport
Entire WmRN_1x Package
  - wm.b2b.rn.cm folder
       wm.b2b.rn.cm:beginAction
       wm.b2b.rn.cm:beginConversation
       wm.b2b.rn.cm:exists
       wm.b2b.rn.cm:getFocalRole
  - wm.b2b.rn.doc folder
       wm.b2b.rn.doc:addDocType
       wm.b2b.rn.doc:clearDocTypes
       wm.b2b.rn.doc:getDocType
  - wm.b2b.rn.handlers folder
       wm.b2b.rn.handlers:InboundMapWrapper
       wm.b2b.rn.handlers:OutboundMapWrapper
       wm.b2b.rn.handlers:exceptionHandler
       wm.b2b.rn.handlers:receiptACKHandler
  - wm.b2b.rn.rn_1x folder
  - wm.b2b.rn.util folder
       wm.b2b.rn.util:createPID
       wm.b2b.rn.util:dateTimeUTC
       wm.b2b.rn.util:writeLogS


7.5 Changes in RosettaNet Module 6.0.1

None.



8.0 Copyright Information


8.1 webMethods

webMethods Administrator, webMethods Broker, webMethods
Developer, webMethods Installer, webMethods Integration Server,
webMethods Mainframe, webMethods Manager, webMethods Modeler,
webMethods Monitor, webMethods Trading Networks, webMethods
Workflow, and the webMethods logo are trademarks of webMethods,
Inc. "webMethods" is a registered trademark of webMethods, Inc.

All other marks are the property of their respective owners.
Copyright (c) 2003 by webMethods, Inc. All rights reserved,
including the right of reproduction in whole or in part in any
form.


8.2 Other Products

Portions of this software contain encryption software from RSA
Data Security, Inc.

Portions of this software are copyrighted by DataDirect
Technologies, 1991-2002.

Portions of this software are based upon third party copyrighted
materials from Informix.

Portions of this software are copyrighted by JClass Chart
Copyright (c) 2002 by Sitraka Inc. 260 King Street E, Toronto,
Ontario, M5A 4L5 Canada. All rights reserved.



9.0 Contacting Us

You can reach webMethods Technical Services for support via:

  Advantage: http://advantage.webMethods.com
  E-mail: support@webMethods.com
  US Phone: 1-888-222-8215
  Europe/EMEA Phone: +800-963-84-637 or +31-356462770
  Asia/Pacific Phone: +612-8913-1198 or +656-389-3222