You are on page 1of 132

TIBCO BusinessWorks™

Release Notes
Software Release 5.4.2
September 2007
Important Information
SOME TIBCO SOFTWARE EMBEDS OR BUNDLES OTHER TIBCO SOFTWARE. USE OF SUCH EMBEDDED
OR BUNDLED TIBCO SOFTWARE IS SOLELY TO ENABLE THE FUNCTIONALITY (OR PROVIDE LIMITED
ADD-ON FUNCTIONALITY) OF THE LICENSED TIBCO SOFTWARE. THE EMBEDDED OR BUNDLED
SOFTWARE IS NOT LICENSED TO BE USED OR ACCESSED BY ANY OTHER TIBCO SOFTWARE OR FOR
ANY OTHER PURPOSE.
USE OF TIBCO SOFTWARE AND THIS DOCUMENT IS SUBJECT TO THE TERMS AND CONDITIONS OF A
LICENSE AGREEMENT FOUND IN EITHER A SEPARATELY EXECUTED SOFTWARE LICENSE
AGREEMENT, OR, IF THERE IS NO SUCH SEPARATE AGREEMENT, THE CLICKWRAP END USER
LICENSE AGREEMENT WHICH IS DISPLAYED DURING DOWNLOAD OR INSTALLATION OF THE
SOFTWARE (AND WHICH IS DUPLICATED IN TIBCO BUSINESSWORKS CONCEPTS) OR IF THERE IS NO
SUCH SOFTWARE LICENSE AGREEMENT OR CLICKWRAP END USER LICENSE AGREEMENT, THE
LICENSE(S) LOCATED IN THE “LICENSE” FILE(S) OF THE SOFTWARE. USE OF THIS DOCUMENT IS
SUBJECT TO THOSE TERMS AND CONDITIONS, AND YOUR USE HEREOF SHALL CONSTITUTE
ACCEPTANCE OF AND AN AGREEMENT TO BE BOUND BY THE SAME.
This document contains confidential information that is subject to U.S. and international copyright laws and
treaties. No part of this document may be reproduced in any form without the written authorization of TIBCO
Software Inc.
TIB, TIBCO, TIBCO Software, TIBCO Adapter, Predictive Business, Information Bus, The Power of Now,
TIBCO Rendezvous, TIBCO InConcert,TIBCO Administrator, TIBCO Adapter, and TIBCO
BusinessWorks are either registered trademarks or trademarks of TIBCO Software Inc. in the United States
and/or other countries.
All other product and company names and marks mentioned in this document are the property of their
respective owners and are mentioned for identification purposes only.
THIS SOFTWARE MAY BE AVAILABLE ON MULTIPLE OPERATING SYSTEMS. HOWEVER, NOT ALL
OPERATING SYSTEM PLATFORMS FOR A SPECIFIC SOFTWARE VERSION ARE RELEASED AT THE SAME
TIME. PLEASE SEE THE README.TXT FILE FOR THE AVAILABILITY OF THIS SOFTWARE VERSION ON
A SPECIFIC OPERATING SYSTEM PLATFORM.
THIS DOCUMENT IS PROVIDED “AS IS” WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESS OR
IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE, OR NON-INFRINGEMENT.
THIS DOCUMENT COULD INCLUDE TECHNICAL INACCURACIES OR TYPOGRAPHICAL ERRORS.
CHANGES ARE PERIODICALLY ADDED TO THE INFORMATION HEREIN; THESE CHANGES WILL BE
INCORPORATED IN NEW EDITIONS OF THIS DOCUMENT. TIBCO SOFTWARE INC. MAY MAKE
IMPROVEMENTS AND/OR CHANGES IN THE PRODUCT(S) AND/OR THE PROGRAM(S) DESCRIBED IN
THIS DOCUMENT AT ANY TIME.
THE CONTENTS OF THIS DOCUMENT MAY BE MODIFIED AND/OR QUALIFIED, DIRECTLY OR
INDIRECTLY, BY OTHER DOCUMENTATION WHICH ACCOMPANIES THIS SOFTWARE, INCLUDING
BUT NOT LIMITED TO ANY RELEASE NOTES AND "READ ME" FILES.
Copyright © 2001-2007 TIBCO Software Inc. ALL RIGHTS RESERVED.
TIBCO Software Inc. Confidential Information
| iii

Contents

Release Notes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1
New Features. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2
New Features in TIBCO BusinessWorks 5.4 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2
New Features in TIBCO BusinessWorks 5.3 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
New Features in TIBCO BusinessWorks 5.2 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
New Features in TIBCO BusinessWorks 5.1.3 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
New Features in TIBCO BusinessWorks 5.1.2 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12
Changes in Functionality . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22
Changes in 5.4 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22
Changes in 5.3 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23
Changes in 5.2.1 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26
Changes in 5.2 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27
Changes in 5.1.3 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33
Changes in 5.1.2 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39
Migration From Previous Releases . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44
Third-Party Software Support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45
JDBC Support. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45
JMS Support. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47
Application Servers. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47
Known Issues. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49
Closed Issues . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74
Internationalization. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 121
TIBCO Messaging Encoding . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 121
Usage Notes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 122
Using Non-Default TIBCO Rendezvous Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 127

TIBCO BusinessWorks Release Notes


iv
| Contents

TIBCO BusinessWorks Release Notes


|1

Release Notes

These release notes list issues according to topic area.

TIBCO Designer, TIBCO Administrator, and TRA are now shipped as separate
products, each with release notes of their own. The release notes for these
products are no longer included with these TIBCO BusinessWorks Release Notes.

When you first start TIBCO Administrator, each screen takes a noticeable
amount of time to display the first time. Afterwards, display is not delayed.
If you click on individual items too quickly, an error results.

Check the TIBCO Product Support web site at http://support.tibco.com for


product information that was not available at release time. Entry to this site
requires a username and password. If you do not have one, you can request one.
Your web browser must support cookies and you must have a valid maintenance
or support contract to use this site.

Topics

• New Features, page 2


• Changes in Functionality, page 22
• Migration From Previous Releases, page 44
• Third-Party Software Support, page 45
• Known Issues, page 49
• Closed Issues, page 74
• Internationalization, page 121
• Using Non-Default TIBCO Rendezvous Parameters, page 127

TIBCO BusinessWorks Release Notes


2 Release Notes
|

New Features

The following sections list new features of each release covered by these release
notes.

New Features in TIBCO BusinessWorks 5.4


The following sections describe the new features in this release.

Platform Support
SQL Server 2005 and the IBM DB2 Universal Database driver on AS/400 are now
supported by the activities in the JDBC palette.

Monitoring XA Transactions
New TIBCO Hawk microagent methods have been added to monitor XA
transaction activity when using TIBCO XA Transaction Manager or Arjuna
Transaction Manager. The L i s t I n f l i g h t T r a n s a c t i o n ( ) method returns
information about currently active transactions and the
G e t T r a n s a c t i o n S t a t i s t i c s ( ) method returns information for all transactions
since the process engine started. See TIBCO BusinessWorks Administration for more
information.

Policy Palette
The Security Policy resource now allows you to specify a Java object for
implementing custom password lookup functions. See TIBCO BusinessWorks
Process Design Guide and TIBCO BusinessWorks Palette Reference for more
information.

Rendezvous Transport
For activities that can use the TIBCO Rendezvous RVCMQ transport (for
example, activities in the Rendezvous or ActiveEnterprise Adapter palettes), the
C o n f i g . T i b r v . c m Q u e u e T r a n s p o r t . T a s k B a c k l o g L i m i t I n B y t e s property has
been introduced to set the backlog limit (in bytes) of the task scheduler for the
transport. See TIBCO BusinessWorks Administration for more information.

TIBCO BusinessWorks Release Notes


New Features 3
|

Security Context
The SOAP Event Source process starter and the Service resource can now specify
that the security context of the incoming message is available to the process
instance. The security context includes items such as the username and password
of the client when basic authentication is used, or it can include the X509
certificate when Web Service Security policies are used. SeeTIBCO BusinessWorks
Palette Reference for more information about the security context in the SOAP
Event Source and Service resources.

New Features in TIBCO BusinessWorks 5.3


The following sections describe the new features in this release.

Platform Support
Solaris 10 is now supported on32-bit and 64-bit platforms. Oracle 10g with RAC is
now supported.

Web Services Features


Several features have been added to enhance and simplify web services. The
following is a summary of features with references on where to find more
information:
• Service-oriented architecture — This release introduces the Service palette for
creating services. Services are an abstraction that separate the transport from
the implementation. This allows you to create more generic process
definitions that can be used as implementations for operations of any service.
See TIBCO BusinessWorks Process Design Guide for more information.
• Multiple operations per service — web services, when using the Service
resource, can now have multiple operations specified for each service. See
TIBCO BusinessWorks Process Design Guide for more information.
• SOAP 1.2 — messages sent from or received by TIBCO BusinessWorks are
fully-compliant with the SOAP 1.2 specification. See TIBCO BusinessWorks
Palette Reference for more information about SOAP specification compliance.
• Wizards — creating web services involves configuring several resources. Two
new wizards are provided to aid in creating web services. One wizard creates
a Service resource and WSDL file based on one or more process definitions in
your project. This allows you to easily expose process definitions as web
services. The other wizard creates process stubs and a Service resource based
on a WSDL file. This allows you to easily create implementations for
operations of a web service. See TIBCO BusinessWorks Process Design Guide for
more information.

TIBCO BusinessWorks Release Notes


4 Release Notes
|

• UDDI and WSIL Browsing and Publishing — You can now easily browse or
publish WSIL files and UDDI registries from either TIBCO Designer or TIBCO
Administrator. See TIBCO BusinessWorks Process Design Guide and TIBCO
BusinessWorks Administration for more information.
• Security Policy — The Policy palette has been added to allow you to create
web service security policies and associate them with services and SOAP
resources. The security policy is based on the Web Services Security
specification (http://www.oasis-open.org/specs/index.php#wssv1.0). See
TIBCO BusinessWorks Process Design Guide for more information.

Process Instance Recovery


You can now specify that checkpoint information for process instances that fail
during execution should be saved so that the process instances can be recovered
to the point of their last checkpoint, after the problem that caused the failure has
been fixed. See TIBCO BusinessWorks Administration for more information.

New Group Options


Two new options have been added to groups in process definitions. The If group
allows you to conditionally execute business logic. The While True loop group
repeats a series of activities as long as the given condition is true. See TIBCO
BusinessWorks Process Design Guide for more information.

Statistic Collection
Statistics for process instances and activities can be stored and collected in
comma-separated format. This allows you to perform analysis on the statistics
using tools such as Microsoft Excel. See TIBCO BusinessWorks Administration for
more information.

Log File Encoding


You can specify the character encoding of the log file with the
l o g . f i l e . e n c o d i n g custom property. See TIBCO BusinessWorks Administration
for more information.

Process Engine Tracing


You can now specify that the input or output XML is included when process
engine tracing is enabled. This is controlled by the custom engine properties
b w . e n g i n e . s h o w I n p u t and b w . e n g i n e . s h o w O u t p u t . See TIBCO BusinessWorks
Process Design Guide for more information.

TIBCO BusinessWorks Release Notes


New Features 5
|

Integration with TIBCO Enterprise Management Advisor


TIBCO Enterprise Management AdvisorTM (EMA) is a tool that automatically
monitors and manages resources in your enterprise. TIBCO BusinessWorks has
been instrumented to work with the upcoming release of TIBCO EMA. See TIBCO
BusinessWorks Administration for more information.

Schema Import Tool


Complex schemas and WSDL files can have nested imported resources. The
schema import tool allows you to import a root resource (XSD or WSDL file) and
the tool automatically resolves and imports any referenced resources. You can
examine and fix any errors such as broken links to referenced resources before
importing the resources into your project. See TIBCO BusinessWorks Process Design
Guide for more information.

Custom Activities and Process Starters


This release introduces the ability to create custom activities and process starters.
You can define business logic in a process definition and then encapsulate that
logic into a custom activity without exposing the implementation details of the
process. You can then package custom activities into custom palettes and
distribute them to your own organization or to other organizations.
The Java Event Source allows you to create your own process starter that starts a
process based on Java code you write. This is useful if you wish to perform
custom processing on incoming events before starting a process or if you wish to
work with event sources that are not currently supported by TIBCO
BusinessWorks.
See TIBCO BusinessWorks Process Design Guide and TIBCO BusinessWorks Palette
Reference for more information.

File Palette
A Copy File activity has been added. This activity can be used to copy files or
directories to a new location.

General Activities Palette


The following activities have been added to the General Activities palette:
• Catch — execution is transferred to a Catch activity when an unhandled
exception occurs.

TIBCO BusinessWorks Release Notes


6 Release Notes
|

• Custom Activity — allows you to encapsulate a process definition into a


custom activity that can be shared without exposing the implementation
details of the process.
• On Notification Timeout — starts a process when a timeout occurs for a
Notify activity.
• Rethrow — throws the exception caught by a Catch activity again.
See TIBCO BusinessWorks Palette Reference for more information.

Java Palette
The Java Event Source process starter has been added. This allows you to create
your own custom process starter based on Java code you write. See TIBCO
BusinessWorks Palette Reference for more information.

JDBC Palette
A new activity, JDBC Get Connection, has been added to return a Java object
reference to a JDBC connection in the connection pool used by TIBCO
BusinessWorks. This allows you to use managed connections in Java code without
having to specify connection information in your Java code. See TIBCO
BusinessWorks Palette Reference for more information.

New Features in TIBCO BusinessWorks 5.2


The following sections describe the new features in this release.

New Platforms
Platform support has been added for AIX 5.2 and 5.3. Also, support for the
TimesTen 5.0.x and DB2 databases has been added.

Multilingual User Interface (MUI) Support


The Multilingual User Interface (MUI) provides a localized Graphical User
Interface (GUI) in Japanese or English for TIBCO Runtime Agent applications.
Previously, MUI support required a separately installed package. In this release,
MUI support is included in the base product. TIBCO Runtime Agent includes a
utility for choosing the user interface language. The utility is available from the
Windows Start menu, or from < TRA_HOME> \ b i n \ M U I L a n g C h o o s e r.

TIBCO BusinessWorks Release Notes


New Features 7
|

Process Instance Execution


You can now more easily specify that process instances are to be executed in the
order in which they are created. Also, you specify that the process engine should
check for duplicate process instances by specifying a duplicate key value unique
to each process instance. See TIBCO BusinessWorks Process Design Guide for more
information about controlling process instance execution.
You can also specify a custom ID for each process instance that will be displayed
in the process statistics in TIBCO Administrator or through the Engine Command
activity. See the description of the Misc tab on each process starter in TIBCO
BusinessWorks Palette Reference for more information about specifying custom IDs.

TIBCO Administrator
TIBCO Administrator has been enhanced to allow you to gracefully shut down
running process engines. Also, you can now specify a limit to the number of
active process instances for each process starter with the Max Jobs (Flow Limit)
field of a deployment configuration. See TIBCO Administrator User’s Guide for
more information about these features.

Shared Variables
A shared variable allows information to be shared across process instances. This
can be useful if you wish to marshal data across processes or if you wish to make
a common set of information available to all processes. See TIBCO BusinessWorks
Process Design Guide for more information.

Iterate Groups
The Iteration Element field has been added to iterate groups. The Iteration
Element field allows you to supply a name for a process variable containing the
current iteration element. This allows you to easily map the value of the current
iteration element instead of using predicates on the process variable used for
iteration. Using the iteration element can improve performance in proportion to
the number of elements processed in an iteration loop. See TIBCO BusinessWorks
Process Design Guide for more information.

Critical Section Groups


Critical section groups are used to synchronize process instances so that only one
process instance executes the activities within the group at any given time.
Critical section groups are particularly useful for controlling concurrent access to
shared variables. See TIBCO BusinessWorks Process Design Guide for more
information.

TIBCO BusinessWorks Release Notes


8 Release Notes
|

Pick First Groups


Pick First groups allow you to wait for one or more events. The first event that
completes determines which transition to take to continue processing. See TIBCO
BusinessWorks Process Design Guide for more information.

ActiveEnterprise Adapter Palette


The Publish to Adapter activity has been enhanced to allow a request/reply
mode. This is useful if you wish to receive a reply from a message but do not want
to use the Request-Response adapter service.
The Adapter Subscriber process starter has two new output elements when the
RVCM transport is used, certifiedSequenceNumber and certifiedSender. The
Adapter Subscriber process starter has one new output element when the JMS
transport is used, MessageID.
See TIBCO BusinessWorks Palette Reference for more information.

File Palette
The List Files activity has been enhanced to include a new output element,
l a s t M o d i f i e d . This element is a string that contains the timestamp for the last
modification date of the file. You can use the c o m p a r e - d a t e T i m e ( ) XPath
function to compare the modification dates of files. See TIBCO BusinessWorks
Palette Reference for more information.

FTP Palette
The FTP Change Default Directory activity has been added to allow you to
change the current default directory on FTP server. See TIBCO BusinessWorks
Palette Reference for more information.

General Activities Palette


The following are new features added to the General Activities palette:
• The Engine Command activity has been added to perform basic monitoring
and maintenance of the process engine. See TIBCO BusinessWorks Palette
Reference for more information.
• Checkpoint activities have been enhanced to allow you to specify a
duplicateKey value to check for duplicate process instances. See TIBCO
BusinessWorks Process Design Guide for more information about duplicate
detection.
• The Write to Log activity can now write to a set of rolling log files by
specifying UserRole as the role for the log entries. See TIBCO BusinessWorks

TIBCO BusinessWorks Release Notes


New Features 9
|

Process Design Guide for more information about the custom engine properties
that configure rolling log files.
• Three new process starters have been added to the General Activities palette.
The OnStartup process starter allows you to create a process that executes
when the process engine starts. The OnShutdown process starter allows you
to create a process that executes when the process engine shuts down. The
OnEventTimeout allows you to create a process that executes when a Wait For
... activity experiences an event timeout.

HTTP Palette
The file l o g 4 j . p r o p e r t i e s is now exposed in the b w / < relNum> / l i b directory.
You can edit this file to change the logging configuration of the HTTP server used
by TIBCO BusinessWorks. For more information about logging properties, see
http://logging.apache.org/log4j/docs/documentation.html.
The HTTP Receiver process starter has been enhanced. The process starter now
places the IP address of the requestor in the Context/RemoteAddress output
element. Also, you can optionally specify that you would like the security context
of the requestor by checking the Expose Security Context configuration field. This
places the security context into the Context/SecurityContext output element.
The HTTP Connection shared configuration resource now has an Advanced tab
that includes advanced configuration options.
See TIBCO BusinessWorks Palette Reference for more information.

JDBC Palette
Database connections in the connection pool (specified by the Max Connections
field in the JDBC Connection resource) timeout if they are not used. A new
configuration property has been added to allow you to specify the timeout period
for unused connections. See TIBCO BusinessWorks Administration for more
information about the b w . e n g i n e . d b C o n n e c t i o n . i d l e T i m e o u t property.
A new field has been added to the JDBC Connection shared configuration
resource. The Login Timeout field allows you to specify a timeout for obtaining a
successful database connection. Also, the
C o n f i g . J D B C . C o n n e c t i o n . S e t L o g i n T i m e o u t property can be set in the
d e s i g n e r . t r a (for design-time testing) or b w e n g i n e . x m l file (for deployed
projects) to achieve the same goal. The value of the configuration property, if set,
overrides the timeout specified on the JDBC Connection shared configuration
resource. See TIBCO BusinessWorks Palette Reference for more information.

TIBCO BusinessWorks Release Notes


10 Release Notes
|

JMS Palette
The Get JMS Queue Message activity has been added to allow you to retrieve a
message from the queue. You can also use a message selector to retrieve a specific
message, if desired.
See TIBCO BusinessWorks Palette Reference for more information about the JMS
palette.
When a process engine attempts to startup and the JMS server that JMS activities
connect to is not up, the JMS process starters cannot connect to the JMS server. A
new custom engine property has been added to address this,
b w . p l u g i n . j m s . r e c o v e r O n S t a r t u p E r r o r. See TIBCO BusinessWorks
Administration for more information.

Rendezvous Palette
The output of the Rendezvous Subscriber and Wait For Rendezvous Message
resources have been enhanced to include the certifiedSender and
certifiedSequenceNumber elements. Also, the Rendezvous Subscriber has a new
configuration option that allows the RV message to be output as a Java object
reference.
See TIBCO BusinessWorks Palette Reference for more information.

RMI Palette
The RMI palette has been added to allow a process definitions to perform JRMI
lookups and act as a JRMI server. See TIBCO BusinessWorks Palette Reference for
more information.

SOAP Palette
SOAP resources can now be used to send and receive messages over the JMS
transport in addition to the HTTP transport. Also, attachments are now
supported for SOAP messages. See TIBCO BusinessWorks Palette Reference for
more information.

TCP Palette
The TCP/IP palette is new in this release and it provides activities and resources
that can send and receive data using the TCP/IP protocol. This palette is intended
for use when communicating with TCP/IP and there is no corresponding TIBCO
BusinessWorks palette for the protocol. See TIBCO BusinessWorks Palette Reference
for more information.

TIBCO BusinessWorks Release Notes


New Features 11
|

Transaction Palette
The transaction palette has been added to allow greater transaction support. See
TIBCO BusinessWorks Process Design Guide for more information about
transactions.

New Features in TIBCO BusinessWorks 5.1.3


The following sections describe the new features in this release.

Custom Engine Properties


Previous releases of TIBCO BusinessWorks allowed you to specify custom
properties for the process engine when creating a deployment configuration. A
different mechanism for specifying custom properties is introduced in this
release. You can now add custom properties to the
< BW_HOME> / l i b / c o m / t i b c o / d e p l o y m e n t / b w e n g i n e . x m l file. When properties
are added to this file, they are incorporated into Enterprise Archive (EAR) files
built for the project. These properties are then available for modification when
deploying the project in TIBCO Administrator (on the Advanced tab).
Release 5.1.3 has a template b w e n g i n e . x m l file for adding custom properties. If
you have properties that you added in previous releases or if you are instructed to
add a custom property by TIBCO Technical Support, use the existing properties in
this file as a guide for adding new custom properties. Once the EAR file is loaded
into TIBCO Administrator, you can see the properties defined in this file in the
Advanced tab of the deployment configuration.

Mapping
Two menu items have been added to the right-click menu in the Activity Input
area. Statement > Surround with For-Each... and Statement > Surround with
For-Each-Group are shortcuts to surrounding the currently selected element with
the correct statements.
Also, many new XPath functions have been added. See the documentation for the
new functions in the XPath Formula Builder dialog for more information.

ActiveEnterprise Adapter Palette


A new input element has been added to the Publish to Adapter activity. The input
element p r e R e g i s t e r L i s t e n e r allows you to specify a list of pre-registered
RVCM listeners as input to the activity. See TIBCO BusinessWorks Palette Reference
for more information.

TIBCO BusinessWorks Release Notes


12 Release Notes
|

JDBC Palette
The JDBC Call Procedure, JDBC Query, and JDBC Update activities have a new
field on their Configuration tab. The "Interpret Empty Strings as Null" field that
specifies how empty strings in Input elements should be handled. When the field
is checked, nulls are sent to the database where empty strings are supplied. When
the field is unchecked, empty strings are treated as zero-length strings. Whether
you use this field or not, you can still use XPath to set input elements explicitly to
nill. Note that many databases treat empty strings and nulls as the same value, so
this field will not affect how the database interprets empty strings.

JMS Palette
A Browse button has been added to the Destination fields of most JMS activities
and the Reply-to Topic and Reply-to Queue fields on the Advanced tab of the JMS
Topic Publisher and JMS Queue Sender activities. This button allows you to
browse destinations in the JMS server after a connection to the JMS server is
specified. This feature is only available when TIBCO Enterprise Message Service
is used as the JMS provider.
A new message type has been added to the list of message types supported for
sending and receiving messages. The message type is Object Ref, and this is used
to send or receive an object reference to a Java object.

Rendezvous Palette
A new input element has been added to the Publish Rendezvous Message activity.
The input element p r e R e g i s t e r L i s t e n e r allows you to specify a list of
pre-registered RVCM listeners as input to the activity instead of using the static
Pre-register Listener field on the Configuration tab. See TIBCO BusinessWorks
Palette Reference for more information.

New Features in TIBCO BusinessWorks 5.1.2


TIBCO BusinessWorks 5.1.2 contains many new features across all areas of the
product. The following sections describe the new features in this release

TIBCO BusinessWorks Release Notes


New Features 13
|

Platform Support
The platforms upon which TIBCO BusinessWorks runs have changed. The
following table describes the new platforms supported and the platforms that are
no longer supported.

Platforms That Are No Longer Supported Platforms Added In This


Supported Release
Windows NT Windows 2003
Enterprise edition for server class
hardware and Standard edition for
desktops is recommended.

AIX 4.3.3 AIX 5.1

Solaris 9

Deployment
The Deployment palette is no longer part of TIBCO BusinessWorks. Deployment
is handled by using TIBCO Designer to create archive files for your integration
projects and then using TIBCO Administrator to specify the deployment
characteristics.

Deployment is performed by creating Enterprise Archive Files. You no longer


need to have a server-based project to perform deployment.

See TIBCO Designer User’s Guide and TIBCO Administrator User’s Guide for more
information about deploying enterprise integration projects.

TIBCO Designer
Several new features have been added to TIBCO Designer, particularly the ability
to create multi-file projects. The new format for projects allows you to more easily
integrate your project into a source-control system and have many users work on
various parts of the project. See TIBCO Designer Release Notes for more
information about the new features of TIBCO Designer.

Multi-File Project Support


TIBCO Designer allows you to save projects as multiple files. This allows you to
manage your integration project with a version control system, such as Microsoft
Visual SourceSafe, Perforce, or PVCS Version Manager.

TIBCO BusinessWorks Release Notes


14 Release Notes
|

A multi-file project is stored as a hierarchy of folders and files. The structure


mirrors the project tree, however, files are created only for top-level resources.
Files typically contain the repository structure of the resource. For example,
process definitions are files, but the activities within the process definition are
contained within the file.

Process Design
Several new features make process design simpler and more flexible. These
features include:
• Color and line type can be specified for transitions.
• Groups now have a start and end point to which you draw a transition. This
allows you to have breakpoints before and after the group executes. This also
allows you to draw multiple transition lines from the end of a group to other
activities.
• Groups can be maximized, minimized, and resized. This allows you to
collapse and expand groups to see the overall process definition and drill
down into a group when desired.
• The Label activity has been enhanced so that you can use it to cover an area of
a process definition and provide a background color. This allows you to
represent logical groupings in your process definition more clearly.
• The Call Process activity can now dynamically determine which process to
call by specifying an XPath expression in the configuration.
• User-defined process variables can be specified for process definitions. These
variables can be set by way of the Assign activity (new activity in the General
Activities palette). Once set, the value of a process variable can be used in
mappings on the Input tab.
• Shared configuration resources no longer are in a separate palette. Any shared
configuration resources now reside in the same palette as the activities for
which they are used. For example, the Data Format shared configuration
resource is now located in the Parse palette.
• Most configuration fields for activities can now accept global variables. The
TIBCO BusinessWorks documentation lists which fields can accept global
variables. See TIBCO BusinessWorks Palette Reference for more information.
See TIBCO BusinessWorks Process Design Guide for more information about these
features.

TIBCO BusinessWorks Release Notes


New Features 15
|

Process Definition Testing


The testing environment is invoked by way of the Tester tab to the left of the
project panel. The test menu items now appear in two separate menus: Tools
>Test and View >Test Options.
There is now one button that allows you to load and start one or more processes
for testing.
See TIBCO BusinessWorks Process Design Guide for more information about testing
in this release.

Error Handling
Error handling has been improved in this release in the following ways.
• The $_error process variable contains additional elements with more
information on the error that occurred.
• Each activity that can raise errors has one or more defined error schemas
displayed on the Error Output tab of the activity. When an error occurs, the
activity’s error schema is populated and provided in a process variable named
$ _ e r r o r _ < activityName> .

See TIBCO BusinessWorks Process Design Guide for more information on error
handling.

Mapping
Mapping an activity’s input has changed significantly in release 5.1. Mapping has
been enhanced with a more wizard-like interface. As you drag and drop items
from the Process Data panel to the Activity Input panel, you are presented with
dialogs that offer you alternatives for the type of mapping you wish to perform.
Each mapping becomes a statement in the XSLT template for the activity’s input.
Because each line in an activity input tree is an XSLT statement, buttons have been
added to the Input tab toolbar to add, delete, and move statements. You do not
need to know XSLT to successfully create simple mappings and transformations,
but it is helpful to understand that each item is an XSLT statement describing the
transformation necessary to create the activity’s expected input.
The Input tab also has a Check Mappings and Repair button that displays errors
in the current mappings and offers you options to fix simple mapping errors
automatically.

TIBCO BusinessWorks Release Notes


16 Release Notes
|

Previously, you could add variables to the activity input with the Add Variable
button. This functionality is still available, but you access it differently in this
release. Each line in the activity input is an XSLT statement. To add a variable, you
must add a statement to the activity input (using the plus [+] button), then choose
$= Variable as the statement type.
Also in previous releases, you could change the type of an activity input element
using the Set Substitution button. This button has been removed, and type
coercion is now part of the Edit Statement dialog.
A Type Documentation button has been added to the toolbar on the Input tab that
allows you to select a node in the Process Data or Activity Input panel and
display any documentation for the node and the schema tree for the node.
See TIBCO BusinessWorks Process Design Guide for more information how
mapping works in release 5.1.

Process Engines
Sybase 12 is now supported for storing process engine data (that is, checkpoint
and wait/notify data).

Messaging Support
For ActiveEnterprise activities, two messaging transports are now available: JMS
and TIBCO Rendezvous.
• You can send and receive JMS messages with the activities of the
ActiveEnterprise palette using TIBCO Enterprise for JMS software.
• The TIBCO Rendezvous transport is also fully supported, as in previous
releases.
• TIBCO ActiveEnterprise XML wire format messages are now supported for
the TIBCO Rendezvous and JMS transports. ActiveEnterprise and
Rendezvous Message wire formats are also supported for the TIBCO
Rendezvous transport.

Secure Sockets Layer (SSL) Support


Several activities and resources support SSL for secure communication. This
release unifies the configuration of SSL across all activities so that configuration is
similar regardless of the type of activity. Each activity may have different SSL
configuration parameters, but the interface for configuring SSL is similar
regardless of whether you are configuring JMS, HTTP, TIBCO ActiveEnterprise,
SOAP, or TIBCO Rendezvous activities.

TIBCO BusinessWorks Release Notes


New Features 17
|

ActiveEnterprise Adapter Palette


The activities of this palette have been enhanced with the following features:
• Support for using JMS as the transport for activities in this palette. When
using this transport, the XML wire format is provided.
• SSL is supported for JMS and RV transports.
• A new activity has been added for sending exceptions to adapter requests.
This is used when a process is started to handle an adapter request. The
process definition can now send a response or an exception as needed.
• The RV Session tab of all activities in this palette has been replaced with the
Transport tab. This tab is used to specify the transport characteristics, if
needed.
• Configuration fields on the Advanced tab of all activities in this palette has
been merged into the Configuration tab.
See TIBCO BusinessWorks Palette Reference for more information about the Active
Enterprise Adapter palette.

EJB Palette
This is a new palette for invoking Enterprise Java Beans (EJBs). This palette
requires an additional license.
See TIBCO BusinessWorks Palette Reference for more information about the EJB
palette.

File Palette
The activities of this palette have been enhanced with the following features:
• Create File can now create directories in addition to creating files.
• Remove File can remove empty directories as well as removing files.
• Create File and Write File now have a configuration field that allows you to
specify that intermediate directories should be created when the file is
created/written, if the directories do not exist.
• A new activity has been added that allows you to rename or move files and
rename (but not move) directories.
• A new activity has been added that allows you to list information about a file
or list the files within a directory.
See TIBCO BusinessWorks Palette Reference for more information about the File
palette.

TIBCO BusinessWorks Release Notes


18 Release Notes
|

FTP Palette
The activities of this palette have been enhanced with the following features:
• The Write Data to Local File Configuration field in FTP Get and the Get Data
from Disk Configuration field in FTP Put have been changed to "Use Process
Data" to signify that you wish to retrieve or place data from process data
instead of directly from files.
• FTP Get and FTP Put have been modified to work with multiple files (FTP
m g e t and m p u t commands).

• FTP Get and FTP Put have changed their output schemas. There is a field in
the Configuration tab of these activities for projects that have been migrated
from previous releases to maintain compatibility with the functionality of the
previous release.
• Several new activities have been added that provide more FTP commands.
The new commands are: FTP Delete File, FTP DIR, FTP Get Default Directory,
FTP Make Remote Directory, FTP Quote, FTP Remove Remote Directory, FTP
Rename File, FTP Sys Type.
See TIBCO BusinessWorks Palette Reference for more information about the FTP
palette.

General Activities Palette


The activities of this palette have been enhanced with the following features:
• The External Command activity has a new configuration field for specifying
the behavior of line endings for the executed command’s output.
• The Java Code activity has been moved to the new Java palette.
• The Call Process activity can now dynamically determine which process to
call by specifying an XPath expression in the configuration.
• The Label activity has been enhanced so that you can use it to cover an area of
a process definition and provide a background color. This allows you to
represent logical groupings in your process definition more clearly.
• A new activity has been added that allows you to assign a value to a
user-defined process variable (see Process Design on page 14 for more
information about user-defined process variables).
• A new activity has been added (the Inspector activity) that allows you to write
the output of any previously executed activity to a file. This can provide you
with useful information when debugging process definitions.
See TIBCO BusinessWorks Palette Reference for more information about the General
Activities palette.

TIBCO BusinessWorks Release Notes


New Features 19
|

HTTP Palette
The HTTP palette has added support for HTTP 1.1 for both incoming and
outgoing HTTP requests. Also support has been added for automatic redirection
in the Send HTTP Request activity.
Tables in the Configuration tabs of HTTP activities for defining attributes have
been modified to be consistent with other activities. There are a set of controls to
the right of the attribute tables that allow you to add, delete, or move attributes
within the table.
See TIBCO BusinessWorks Palette Reference for more information about the HTTP
palette.

Java Palette
This new palette has been added to consolidate the existing Java Code activity
and Custom Java Function shared configuration resource.
The code editing features of the Java Code activity have been improved. Also, the
Tools > Java Code > Compile All Code menu item has been added to allow you to
compile all Java Code activities in your project with one menu command instead
of compiling the code in each Java Code activity individually.
See TIBCO BusinessWorks Palette Reference for more information about the Java
palette.

JDBC Palette
Support for Sybase 12 has been added for activities in this palette.
See TIBCO BusinessWorks Palette Reference for more information about the JDBC
palette.

JMS Palette
The activities in this palette have been enhanced with the following features:
• SSL support has been added.
• XML Text is now treated in the same manner as Map and Stream.
• A Test Connection button has been added to the JMS Connection shared
configuration resource that allows you to test the connection to the specified
JMS server.
See TIBCO BusinessWorks Palette Reference for more information about the JMS
palette.

TIBCO BusinessWorks Release Notes


20 Release Notes
|

Mail Palette
The Receive Mail process starter now has a Test Connection button for testing the
connection to the specified mail server.
The Send Mail activity now has a replyTo input element for supplying a reply
address for the message.
Both the Send Mail and Receive Mail activities can now use non-default port
numbers for the mail host.
See TIBCO BusinessWorks Palette Reference for more information about the Mail
palette.

Parse Palette
The activities in this palette have been enhanced with the following features:
• The Data Format shared configuration resource now can accept custom fill
characters for padding fixed-width columns.
• Previously, the Parse activity could only accept files with ASCII or Unicode
character encodings. Now, there is a drop-down list of supported character
encodings in the Encoding field.
See TIBCO BusinessWorks Palette Reference for more information about the Parse
palette.

Rendezvous Palette
SSL support has been added to the activities of the Rendezvous palette.
See TIBCO BusinessWorks Palette Reference for more information about the
Rendezvous palette.

SOAP Palette
The SOAP Event Source process starter has been enhanced with the following
features:
• Support has been added for the following encodings: RPC literal, RPC
encoded, Document encoded, and Document literal with typed parts.
• An additional tab is added to configure the style, encoding, and namespaces
for the service binding. SOAP headers support is enhanced to allow multiple
inputs and output headers with additional binding configuration.
• Support for SOAP arrays and any type parts is available. Header parts can
now use the types declared in the WSDL file.
• Input, Output and Fault message parts can use types in addition to elements.

TIBCO BusinessWorks Release Notes


New Features 21
|

• Input and Output Headers allow multiple message parts.


• Message parts can access schemas defined in other WSDL files.
The SOAP Request/Reply activity has been enhanced with the following features:
• Full support for RPC and Document services with literal and SOAP encoding
is available.
• Support for anyType and SOAP arrays has been added.
In the SOAP Event Source and SOAP Request/Reply activities, a WSDL Analyzer
has been added. This is used as a service and operation chooser, and it also
provides an analysis report about the selected WSDL file to show parsing errors,
import errors, and other errors.
See TIBCO BusinessWorks Palette Reference for more information about the SOAP
palette.

WSDL Palette
This is a new palette for defining WSDL files. This palette replaces the WSDL
shared configuration resource from previous releases.
See TIBCO BusinessWorks Palette Reference for more information about the WSDL
palette.

XML Activities
The activities in this palette have been enhanced with the following features:
• The XML Parse activity has a new configuration field that allows you to
specify that the output should be validated.
• The XML Render activity has a new configuration field that allows you to
specify that the input should be validated. Also, you can now specify the
encoding for the output.
• The XML Transform activity permits "text" input and output in addition to the
the previously supported "bytes" input and output.
See TIBCO BusinessWorks Palette Reference for more information about the XML
Activities palette.

TIBCO BusinessWorks Release Notes


22 Release Notes
|

Changes in Functionality

Changes in 5.4
This section lists changes to existing product functionality in release 5.4.

SSL Cipher Suites


Some activities that use SSL connections can specify the Strong Cipher Suites only
field. In previous releases, checking this field did not always expose the strongest
cipher suites available. The custom engine property
b w . p l u g i n . s e c u r i t y . s t r o n g c i p h e r . m i n s t r e n g t h has been introduced to
allow you to specify the minimum strength of the cipher suites you wish to use.
See TIBCO BusinessWorks Administration for more information.

HTTP Palette
Multiple name/value pairs can be sent in the Cookie header element of the Send
HTTP Request activity. Also, the custom engine property
b w . p l u g i n . h t t p . p r o t o c o l . s i n g l e - c o o k i e - h e a d e r has been added to specify
that multiple cookies should be combined into one header element when the
request is sent. See TIBCO BusinessWorks Palette Reference and TIBCO
BusinessWorks Administration for more information.

Mail Palette
In previous releases, the Receive Mail activity threw exceptions when receiving
email, if the email was in rich text format and the first mime part contained nested
mime sub parts. You can fix this by setting the
b w . p l u g i n . m a i l . r e c e i v e r F l a t t e n N e s t e d A t t a c h m e n t s property to t r u e
which flattens out the message structure so that all parts are siblings.
In previous releases, the Receive Mail activity did not handle incoming mime
messages with mime types application/*, audio/*, video/*, or image/*. While
fetching these types of emails, TIBCO BusinessWorks threw exceptions. You can
fix this by setting the b w . p l u g i n . m a i l . r e c e i v e r H a n d l e D i s c r e t e T y p e s
property to t r u e . I
See TIBCO BusinessWorks Administration for more information.

TIBCO BusinessWorks Release Notes


Changes in Functionality 23
|

JMS Palette
The behavior of the Client ID field in JMS connections has been changed.
Previously, client IDs were automatically generated in a variety of circumstances.
Now, there is a field named Auto-Generate Client ID that controls whether client
IDs are automatically generated or not. See TIBCO BusinessWorks Palette Reference
for more information about the new behavior of the fields in the JMS Connection
resource.
For activities that receive JMS messages (for example, JMS Queue Receiver or
Wait for JMS Topic Message), the Receiver Timeout field has been added to the
Advanced tab to allow you to specify a polling interval for the receiver. The
custom engine property b w . p l u g i n . j m s . r e c e i v e r T i m e o u t has also been added
to allow you to specify a default timeout for all JMS receiver activities. See TIBCO
BusinessWorks Palette Reference and TIBCO BusinessWorks Administration for more
information.

Rendezvous Palette
The Publish Rendezvous Message activity now has a replySubject element in the
activity input. This allows you to specify a reply subject for the message so that a
Wait For Rendezvous Message activity later in the process can receive replies to
the message.

Changes in 5.3
This section lists changes to existing product functionality in release 5.3.

XPath Changes
Prior to Release 5.3, numerical expressions were evaluated from right to left. For
example, 10-5+6 returned -1. According to the XPath specification
(http://www.w3.org/TR/xpath20/ section A.4), operators are evaluated
left-to-right. Therefore, as of Release 5.3, operators will be evaluated from left to
right. For example, 10-5+6 now returns 11.

General Changes
The TIBCO Hawk microagent method GetProcessDefinitions now returns process
definitions that can be dynamically called. Previously, these process definitions
were only returned after the process was executed, they are now returned
whether the dynamically called process has been executed or not.

TIBCO BusinessWorks Release Notes


24 Release Notes
|

ActiveEnterprise Adapter Palette


The following describes the changes to the resources in the ActiveEnterprise
Adapter palette:
• When using the JMS transport, ActiveEnterprise activities can participate in
XA or JTA transactions.
• The requestTimeout element is added to the input of the Publish to Adapter
activity. This allows you to specify a timeout when using this activity in
request/reply mode.
• The JMS Application Properties field has been added to the Transport tab
when JMS is the transport type. This allows you to specify a JMS Application
properties shared resource for the input or output of the activity.
• The replyDestination field has been added to the PublishToAdapter (in
request/reply mode) and Invoke an Adapter Service activity. This allows
applications to continue communicating beyond a single request and reply
message.
• The durable subscription name can be specified when a JMS durable
subscription is specified for the ActiveEnterprise Subscriber process starter.
See TIBCO BusinessWorks Palette Reference for more information.

General Activities Palette


The JNDI Configuration shared configuration resource only supports the
provided list of context factories. You can no longer type in the name of a different
context factory.

HTTP Palette
The activities in the HTTP palette now support MIME attachments in HTTP
messages.

JDBC Palette
The JDBC Call Procedure, JDBC Query, and SQL Direct activities now have an
input item named maxRows that can be used at runtime to specify the maximum
number of rows to return.
All JDBC activities now have a LoginTimedOutException that is raised when a
timeout occurs when connecting to the database. This is only available on JDBC
drivers that support login timeouts.

TIBCO BusinessWorks Release Notes


Changes in Functionality 25
|

JMS Palette
For the JMS Topic Subscriber activity, the TIBCO EMS No Acknowledge mode has
been added for message acknowledgement. Messages delivered in this mode do
not require acknowledgement and are not delivered regardless of whether the
message was delivered successfully. See TIBCO BusinessWorks Palette Reference for
more information.

Mail Palette
The Send Mail activity now supports authentication to the mail server either
through static configuration or through values provided to the activity input.
Also, the Send Mail activity now has an Advanced tab that allows you to specify
you wish to use non-standard email addresses. See TIBCO BusinessWorks Palette
Reference for more information.

Parse Palette
In previous releases, the line length was not enforced and files with one long line
could be parsed. This is no longer the case. If you rely on the behavior of previous
versions, you can set the b w . p l u g i n . p a r s e D a t a . e n f o r c e L i n e L e n g t h property
to f a l s e . See TIBCO BusinessWorks Administration for more information.

SOAP Palette
Resources in the SOAP palette can now handle messages that comply with
version 1.2 of the SOAP specification.
The following has changed for SOAP over the JMS transport:
• Support for topics has been added.
• JMS message type can now be Text Message.
• For SOAP Event Source, The acknowledge mode can now be set to Client,
Dups OK, or TIBCO EM Explicit.
• For SOAP Request Reply, the delivery mode can be set to TIBCO EMS
Reliable.
See TIBCO BusinessWorks Palette Reference for more information.

TCP Palette
The TCP Open Connection activity has a new field Local Host to allow for
machines that have multiple network hosts. The TCP Receiver process starter has
new output elements that specify the IP, Host, and Port of the TCP request.

TIBCO BusinessWorks Release Notes


26 Release Notes
|

The Read TCP Data and Write TCP Data now allow global variables in the
Separator field of the Configuration tab.
See TIBCO BusinessWorks Palette Reference for more information.

XML Activities Palette


The Transform XML activity now can accept and return an XML tree, therefore
parsing and rendering XML is no longer required before or after this activity.
The Render XML activity now supports CDATA tags in string elements.
See TIBCO BusinessWorks Palette Reference for more information.

Changes in 5.2.1
This section lists changes to existing product functionality in release 5.2.1.

General Changes
In Release 5.2.1, the default value of the custom property
j a v a . p r o p e r t y . c o m . t i b c o . s c h e m a . a e . m a k e N i l l a b l e is now true. This can
cause new warnings to appear in existing projects, and the Mapper Check and
Repair button can be used to correct these mappings. See TIBCO BusinessWorks
Administration for more information about this and other custom properties.

ActiveEnterprise Adapter Palette


The ActiveEnterprise Adapter palette now supports the flow control features
introduced in Release 5.2.0. See TIBCO Administrator on page 7 for a description
of the flow control features.

Mail Palette
The Receive Mail process starter can cause the message to be output in binary
form.
The Confirm activity now operates with the Receive Mail process starter. Using
the Confirm activity causes the mail to be deleted from the mail server.
See TIBCO BusinessWorks Palette Reference for more information.

Parse Palette
The Data Format shared configuration resource allows you to specify the rule to
use when multiple characters are entered as a column separator. See TIBCO
BusinessWorks Palette Reference for more information.

TIBCO BusinessWorks Release Notes


Changes in Functionality 27
|

Rendezvous Palette
The Send Rendezvous Request activity now contains the reply subject set on the
reply message, if one is set. See the r e p l y M e s s a g e R e p l y S u b j e c t output element
in the Send Rendezvous Request activity in the TIBCO BusinessWorks Palette
Reference for more information.

Changes in 5.2
This section lists changes to existing product functionality in release 5.2.0. Some of
these changes affect projects that are migrating from version 2.x to 5.2.0. If
possible, you should examine and correct any issues in your 2.x project, test these
changes, then migrate the project to 5.2.0.
Refer to TIBCO ActiveEnterprise Features, Migration, and Compatibility in the TIBCO
Runtime Agent documentation set for more information on how to migrate
projects to TIBCO BusinessWorks 5.2.0.

General Changes
Global variable names must be valid XML names if they are used in input
mappings. In previous releases, even global variables with invalid XML names
were displayed in the $ _ g l o b a l V a r i a b l e s process variable. In this release, only
global variables that have valid XML names are included in the
$ _ g l o b a l V a r i a b l e s process variable. You can still define global variables that
have invalid XML names (for example, 0 1 _ m y V a r ), and those variables can be
used in configuration fields, but they will not be available to use in input
mappings.
Tracing properties have been enhanced to allow wildcards in the
and T r a c e . R o l e . < userRoleName> . L o g
T r a c e . R o l e . < userRoleName> . T e r m
properties. You can now specify T r a c e . R o l e . * . T e r m to control console output of
trace messages for all user-defined roles, and you can specify T r a c e . R o l e . * . L o g
to control log output of trace messages for all user-defined roles.
For Wait For... activities, you can now omit the value for the Event Timeout field
on the Event tab. Specifying no value in this field signifies the event should wait
indefinitely until the activity is executed.
Java object references can currently be created and passed by some activities
within a process definition. This release enhances this functionality by allowing
Java object references to be passed outside of a process definition by using a Call
Process activity.

TIBCO BusinessWorks Release Notes


28 Release Notes
|

Mapping
For a process configuration, users can now specify a default namespace by
leaving the prefix blank.

XPath Functions
In Release 2.x, the XPath function c r e a t e - d a t e T i m e ( ) returned a value that
included a time zone. In Release 5.1.2 and 5.1.3, the function was changed to omit
the time zone. The c o m . t i b c o . x m l . x p a t h . c r e a t e - d a t e T i m e . h a s . t i m e z o n e
custom engine property has been added to control whether the time zone is
included in the output of the c r e a t e - d a t e T i m e ( ) function. Setting the property
to false (the default value) omits the time zone from the function output (the same
behavior as 5.1.x). Setting this property to true causes the time zone to be included
in the function output (the same behavior as 2.x).

EJB Palette
Earlier releases of the TIBCO BusinessWorks EJB Plug-in will not work with
TIBCO BusinessWorks 5.2.0. You must upgrade and install TIBCO BusinessWorks
EJB Plug-in Release 5.2.0 if you wish the plug-in to work with TIBCO
BusinessWorks 5.2.0.

File Palette
The File Poller activity has been modified to allow you to specify the kind of
modification you wish to poll for (creation, modification, deletion). You can also
include sub-directories in the specified directory to monitor. Also, some fields
have been moved from the Configuration tab and now appear on the Advanced
tab.
All activities in this palette that have the fileInfo output element now have two
new sub-elements within the fileInfo element. The configuredFileName element
contains the name of the file or directory the activity is configured to operate on.
The lastModified element contains the time that the file was last modified.
The Write File activity has a new configuration field that allows you to specify
that you would like to compress the output file using the GZip format.
See TIBCO BusinessWorks Palette Reference for more information.

TIBCO BusinessWorks Release Notes


Changes in Functionality 29
|

FTP Palette
The FTP Connection resource has been enhanced to support SSL. You can now
specify SSL configuration parameters to create an SSL connection to the FTP
server. The Remote Filename Encoding field on the FTP Connection shared
configuration resource now supports using a global variable for the value of the
field. Also, the FTP Connection resource now supports both active and passive
mode for FTP connections.
FTP activities that share the same host, port, username, and password will now
share the same FTP session. A new configuration field, Quit (post-command), has
been added to all FTP activities that specifies that the FTP session should be
closed once the command completes.
Prior to release 5.2.0, the FTP Put activity stripped the \n when \r\n was used for
a new line within a file. This caused files to be unusable when a file was taken
from a MS Windows machine and put onto a VMS machine. The FTP Put activity
no longer strips the \n. If you rely on this behavior in existing projects, you can
set the b w . p l u g i n . f t p . s t r i p L i n e F e e d I n P u t property to true to obtain the
behavior of previous releases. See TIBCO BusinessWorks Administration for more
information on setting engine properties.
See TIBCO BusinessWorks Palette Reference for more information about the FTP
palette.

General Activities Palette


In previous releases, the Timer process starter used the Java convention (0-11) for
month numbers in its output, however, the expected convention for month
numbers is 1-12. In this release, the month is now returned as a number between 1
and 12. If you rely on the behavior of previous releases, you can set the property
b w . p l u g i n . t i m e r . u s e J a v a M o n t h to t r u e to maintain compatibility with
previous releases. Set the property in the TIBCO Designer . t r a file when running
projects in test mode in TIBCO Designer. See TIBCO BusinessWorks Administration
for more information on setting engine properties.
The Notify Configuration shared configuration resource has a new configuration
field for specifying that the notify operation should be done in memory as
opposed to stored in a database. The Local Only field can only be checked when
the Wait and Notify operations are performed on the same machine.

HTTP Palette
The HTTP Receiver process starter has the following changes:
• An Advanced tab is added that allows you to specify that incoming messages
that exceed a specified size should be written to disk. This allows you to
accept large incoming messages without consuming very much memory.

TIBCO BusinessWorks Release Notes


30 Release Notes
|

• The output style (string or binary) can now be configured.


• You can choose to output the security context information (username,
password, SSL certificate, and so on) in the output of this process starter.
• You can specify a default encoding for incoming messages that do not specify
a charset in the Content-Type header.
• The output schema now includes the Protocol and Port elements. Protocol is
either HTTP or HTTPS depending upon the client’s connection type. Port is
the port number the HTTP server is configured to listen for incoming
requests.
The Host field has been added to the HTTP Connection shared configuration
resource. This field allows you to specify the name of the host on the current
machine that will accept HTTP requests. This is only applicable when there is
more than one network card on the machine. Also, the Port field on the
Configuration tab of the HTTP Connection shared configuration resource can
now accept a comma-separated list of port numbers.
When the HTTP server sends an error in response to a Send HTTP Request
activity, the activity now stores the HTTP message in the exception schema.
In the Send HTTP Response activity, the Server input header has been removed
from the list of headers in the Input Headers tab. This header is automatically set
by the HTTP server and therefore cannot be set in an input mapping.
The QueryString input element of the Send HTTP Request activity is no longer
URL encoded. Prior to release 5.2, the activity used URL encoding for the Query
specified in the QueryString element. As of this release, it is the user's
responsibility to properly URL-encode the query specified in the QueryString.
Therefore, the activity does attempt to encode the value supplied in this element.
This change may cause backward compatibility issues if you rely on the activity to
actually perform the URL-encoding of the QueryString. The
b w . p l u g i n . h t t p . c l i e n t . u r l E n c o d e Q u e r y S t r i n g property is set to false by
default, but setting it to true reverts to the behavior of previous releases. See
TIBCO BusinessWorks Administration for more information about setting custom
engine properties.

Java Palette
To indicate a null reference, the Java Code activity omits the value in its output.
This causes a String value used as a null place holder when another activity
attempts to read the null in its input. However, other activities did not behave in
this way. Other activities pass an explicit null for null references.

TIBCO BusinessWorks Release Notes


Changes in Functionality 31
|

To preserve backward compatibility, the Java Code activity still behaves the same.
However, you can set the b w . p l u g i n . j a v a C o d e . e x p l i c i t N u l l to t r u e to cause
the Java Code activity to behave in the same way as other activities. When this
property is set to t r u e , an explicit null is set for a null reference. This property is
set to f a l s e by default, maintaining the behavior of the previous releases. See
TIBCO BusinessWorks Administration for more information on setting engine
properties.

JDBC Palette
In previous releases, the JDBC Call Procedure activity created input elements that
were optional for stored procedure parameters. Optional parameters have never
been supported by this activity (see Known Issues on page 49 under the JDBC
Palette heading). When migrating a project from a previous release, there will be
validation errors for any unspecified input elements for stored procedure
parameters. These migrated projects cannot be executed until the errors are
resolved (by using the Check and Repair button in the input mapping tab).
If you wish to migrate a project without fixing this problem, you can do so by
setting the C o n f i g . J D B C . C a l l P r o c e d u r e . I n p u t O p t i o n a l property to true. See
TIBCO BusinessWorks Administration for more information on setting engine
properties.
The JDBC Query activity has been enhanced to allow you to fetch batches of
records instead of one large result set. You can use a loop to iteratively retrieve
smaller batches of records from a result set.
The JDBC Update activity has been enhanced to allow multiple statements to be
created by supplying an array of records as input to the activity. The statements
are then executed as a batch at the end of the activity’s execution.
Some fields that were previously on the Configuration tab of the JDBC activities
have been moved to the Advanced tab.
See TIBCO BusinessWorks Palette Reference for more information about the JDBC
palette.

JMS Palette
For JMS Topic Subscriber activities, when the Acknowledge Mode is set to Client
and the JMS provider is TIBCO Enterprise Messaging Service, messages are
acknowledged automatically.
The EMS_RELIABLE_DELIVERY delivery mode has been added for outgoing
messages when using TIBCO Enterprise Message Service. See the TIBCO
Enterprise Message Service documentation for more information about this
delivery mode.

TIBCO BusinessWorks Release Notes


32 Release Notes
|

The TIBCO EMS Explicit Client Acknowledge mode has been added for incoming
messages when using TIBCO Enterprise Message Service. See TIBCO Enterprise
Message Service documentation for more information about this acknowledge
mode.
The name of the Time to Live field on the Advanced tab of activities that have
outgoing messages has been changed to JMSExpiration.
The Wait for JMS Topic Message activity now has an Acknowledge Mode field.
See TIBCO BusinessWorks Palette Reference for more information.

Mail Palette
An Advanced tab has been added to the Receive Mail process starter that allows
you to specify that incoming messages that exceed a specified size should be
written to disk. This allows you to accept large incoming messages without
consuming very much memory.
Also, an Output Headers tab has been added to the Receive Mail process starter
that allows you to specify a schema for any custom headers that may appear in an
incoming message.
The Send Mail activity has a new tab. The Input Headers tab allows you to define
a schema for any custom headers you wish to add to outgoing mail messages.
Attachment support in both the Send Mail and Receive Mail resources has been
enhanced. Resources created prior to release 5.2.0 must use the Upgrade
Configuration field on the Configuration tab to use the new functionality.
See TIBCO BusinessWorks Palette Reference for more information.

XML Activities Palette


In previous releases, if the encoding is not specified on a Render XML activity, the
output XML has encoding specified as "". This is not a valid encoding, and most
XML tools will return an error when attempting to open an XML file whose
encoding is "". In this release, when the encoding is not specified, the encoding in
the output XML will be specified as UTF-8.

Rendezvous Palette
The RawRVMsg2 schema has been enhanced to include the tibrvXml datatype.
This allows you to send and receive TIBCO Rendezvous messages that contain
fields of type TIBRVMSG_XML. See TIBCO BusinessWorks Palette Reference for
more information on using the RawRVMsg2 schema.

TIBCO BusinessWorks Release Notes


Changes in Functionality 33
|

The Rendezvous Subscriber process starter has been enhanced to allow the RV
message to be output as a Java object reference. See TIBCO BusinessWorks Palette
Reference for more information.

Changes in 5.1.3
This section lists changes to existing product functionality in release 5.1.3. Some of
these changes affect projects that are migrating from version 2.x to 5.1.3. If
possible, you should examine and correct any issues in your 2.x project, test these
changes, then migrate the project to 5.1.3.
Refer to TIBCO ActiveEnterprise Features, Migration, and Compatibility in the TIBCO
Runtime Agent documentation set for more information on how to migrate
projects to TIBCO BusinessWorks 5.1.3.

General Changes
In previous releases, the process engine name was limited to 50 characters. The
new limit for engine names is 128 characters.
When testing process definitions, you are now prompted for input when a called
process requires input.

Mapping
The Apply Template and Call Template XSLT statements are no longer available
in the Statement Type field of the Edit Statement dialog. You can no longer use
these statements in the Input tab.
The mapper GUI has been enhanced to allow more shortcuts for creating complex
XSLT statements by using the right-click menu.
The mapper has been enhanced to automatically add the appropriate if or choice
tests around mappings of optional and nillable elements.

String Representations of Datatypes


When data must be represented in the input or output of an activity, the data is
represented as a string. For example, writing the output of an activity to a file
requires that numeric data be serialized into string form. Also, supplying a
floating point number to an XPath function in the Input tab of an activity often
involves typing the number as a string into the input element. In Release 5.1.3,
TIBCO BusinessWorks follows the XPath 1.0 standard for representing all
numeric datatypes. TIBCO BusinessWorks follows the XML Schema canonical
format for all other datatypes.

TIBCO BusinessWorks Release Notes


34 Release Notes
|

Previous releases of TIBCO BusinessWorks did not use a consistent string


representation of data across all activities, so you may need to alter any projects
created in previous releases that expect a certain string representation of data to
use the new standard representation.
Also, for date and time datatypes, previous releases permitted the localized time
zone name to be obtained using certain XPath functions. This is no longer
supported. Time zones are now always represented as a GMT offset.
See TIBCO BusinessWorks Process Design Guide for more information about the
string representations of datatypes in Release 5.1.3.

Data Validation
Data passed as input to an activity or from an event received by a process starter
is validated to ensure that it conforms to its specified datatype. For example, if
you pass an XML document to a Parse XML activity, the content of the document
is checked to ensure that elements within the document are actually of the
specified datatypes. In previous releases of TIBCO BusinessWorks, not all
datatypes were validated at run time. As of release 5.1.3, much stricter validation
is performed at design time and run time.
Because stricter validation is performed, projects migrating from 2.0.x may not
pass the validation standards in this release. You should ensure that any data in
your project conforms to the appropriate standards before migrating your project.
Invalid data will cause errors in the input mappings of your project and will
subsequently cause your project to fail validation for deployment. These errors
must be corrected before the project can successfully be run using release 5.1.3.
Table 1 describes the validation behavior of release 2.0.6 and release 5.1.3. N/A
indicates no validation was performed for the datatype. Datatype validation
listed with the prefix x s d : is defined in the namespace
http://www.w3.org/2001/XMLSchema, see XML Schema Part2: Datatypes
specification at http://www.w3.org/TR/2004/PER-xmlschema-2-20040318/ for
more information on the proper representation of these datatypes. Datatype
validation listed with the prefix x d t : is defined in the namespace

TIBCO BusinessWorks Release Notes


Changes in Functionality 35
|

http://www.w3.org/2003/11/xpath-datatypes, see Xquery 1.0 and Xpath 2.0


Functions and Operators specification at
http://www.w3.org/TR/2003/WD-xpath-functions-20031112/ for more
information on the proper representation of these datatypes.

Table 1 Comparison of datatype validation

Data Type 2.0.6 Validation 5.1.x Validation


Built-In Primitive Types

boolean xsd:boolean xsd:boolean

decimal xsd:decimal xsd:d e c i m a l

float xsd:f l o a t xsd:f l o a t

double xsd:d o u b l e xsd:d o u b l e

string xsd:string xsd:string

duration N/A xsd:duration

yearMonthDuration N/A xdt:yearMonthDuration

dayTimeDuration N/A xdt:dayTimeDuration

dateTime xsd:dateTime xsd:d a t e T i m e

time N/A xsd:t i m e

date xsd:date xsd:date

gYearMonth N/A xsd:gYearMonth

gYear N/A xsd:gYear

gMonthDay N/A xsd:gMonthDay

gDay N/A xsd:gDay

gMonth N/A xsd:gMonth

hexBinary xsd:hexBinary xsd:hexBinary

base64Binary xsd:base64Binary xsd:base64Binary

anyURI N/A xsd:anyURI

TIBCO BusinessWorks Release Notes


36 Release Notes
|

Table 1 Comparison of datatype validation

Data Type 2.0.6 Validation 5.1.x Validation


QName N/A xsd:QName

NOTATION N/A xsd:NOTATION

untypedAtomic N/A xdt:untypedAtomic

Built-In Derived (Atomic) Types

integer xsd:integer xsd:integer

nonPositiveInteger xsd:nonPositiveInteger xsd:nonPositiveInteger

negativeInteger xsd:negativeInteger xsd:negativeInteger

long xsd:long xsd:long

int xsd:int xsd:int

short xsd:short xsd:short

byte xsd:byte xsd:byte

nonNegativeInteger xsd:nonNegativeInteger xsd:nonNegativeInteger

unsignedLong xsd:unsignedLong xsd:unsignedLong

unsignedInt xsd:unsignedInt xsd:unsignedInt

unsignedShort xsd:unsignedShort xsd:unsignedShort

unsignedByte xsd:unsignedByte xsd:unsignedByte

positiveInteger xsd:positiveInteger xsd:positiveInteger

normalizedString N/A xsd:normalizedString

token N/A xsd:token

language N/A xsd:language

Name N/A xsd:Name

NCName N/A xsd:NCName

ID N/A xsd:ID

TIBCO BusinessWorks Release Notes


Changes in Functionality 37
|

Table 1 Comparison of datatype validation

Data Type 2.0.6 Validation 5.1.x Validation


IDREF N/A xsd:IDREF

ENTITY N/A xsd:ENTITY

NMTOKEN N/A xsd:NMTOKEN

ActiveEnterprise Adapter Palette


The Sync Ledger and Require Old Messages fields on the Transport tab now
support global variables.

File Palette
The File Poller process starter has been modified to allow you to process files in a
specific order. The File Poller processes files at each polling interval, so you can
now specify whether the files to be processed should be sorted by file name or
modification date in ascending or descending order. This is particularly useful
when the process engine starts and the Include Existing Files field is checked. All
existing files will be processed in the specified order.

General Activities Palette


The Timer process starter has been enhanced so that the Start Time and Time
Interval fields on the Configuration tab can now use global variables for their
values.

HTTP Palette
The default minimum/maximum number of threads for processing incoming
HTTP requests has changed. The previous default minimum was 3 and the new
default minimum is 10. The previous default maximum was 5 and the new
default maximum is 75.

JDBC Palette
All activities within this palette have a new input element named t i m e o u t that
allows you to specify a timeout for the activity dynamically.
A new field has been added to the JDBC Call Procedure, JDBC Query, and JDBC
Update activities. This field is labeled Interpret Empty String as Null and it
specifies how empty strings in the activity’s input elements should be handled.
See TIBCO BusinessWorks Palette Reference for more information about this field.

TIBCO BusinessWorks Release Notes


38 Release Notes
|

Return values for stored procedures and functions that are of type decimal and
size float return a different precision in this release than in previous releases.
Previously, a float would be represented as 1.234568E25, for example. In this
release, the same float would be represented as 1.2345678901234568E25.

JMS Palette
The JMS Connection shared configuration resource has been enhanced so that a
drop-down choice list is available in the JNDI Context Factory field for supported
application server vendors.
JMS activities can now receive messages that have the JMSDeliveryMode header
set to R E L I A B L E _ D E L I V E R Y. This value is an extension of the JMS standard
supported by TIBCO Enterprise Message Service. The monitor topics in TIBCO
Enterprise Message Service use this delivery mode, so now JMS activities can
receive messages from the monitor topics. Note that this change only allows
receiving messages delivered with R E L I A B L E _ D E L I V E R Y — sending messages
using this delivery mode is not supported.

TIBCO Rendezvous Palette


The following are changes in the functionality of the TIBCO Rendezvous palette:
• The Send Rendezvous Request activity no longer has the replySubject element
in its input schema. This activity uses the INBOX mechanism to ensure that
reply messages are received only by the process that sent the corresponding
request. Use of the replySubject input element in the previous releases would
not always result in the expected behavior, therefore this element has been
removed to avoid confusion. If you do wish to specify a reply subject, you
should use the Publish Rendezvous Message activity together with the Wait
for Rendezvous Message activity so that the "Wait" activity can use the
appropriate key to receive the correct reply message for the process.
• The Send Rendezvous Request activity now has a timeout field in its Input tab
that allows you to specify a timeout dynamically.
• The Sync Ledger and Require Old Messages fields on the Advanced tab of the
Rendezvous Transport shared configuration resource now support global
variables.
• In the 2.x release, activities in the Rendezvous palette did not alter field names
of incoming or outgoing messages if they were not compliant with XML
naming rules. Therefore, projects migrated from 2.x to 5.1.3 will have this field
unchecked. In the 5.1.2 release, activities in the Rendezvous palette altered
any field names of incoming or outgoing messages to ensure the field name
complied with XML naming rules. In the 5.1.3 release, a field has been added
to the Rendezvous Subscriber, Publish Rendezvous Message, Wait for

TIBCO BusinessWorks Release Notes


Changes in Functionality 39
|

Rendezvous Message, and Send Rendezvous Request activities that allows


you to control this behavior. The XML-Compliant Field Names field of these
activities allows you to specify whether field names should be altered to
comply with XML naming rules.

XML Activities Palette


In previous releases, the ability to dynamically load stylesheets was available in
the Transform XML activity. This was removed, but now this functionality is
reintroduced in this release.

Changes in 5.1.2
This section lists the changes to existing product functionality in release 5.1.2.
Some of these changes affect projects that are migrating from version 2.x to 5.1.2.
If possible, you should examine and correct any issues in your 2.x project, test
these changes, then migrate the project to 5.1.2. The information in this section
provides details about what functionality has changed and may need to be
corrected in your 2.x project.
Refer to TIBCO ActiveEnterprise Features, Migration, and Compatibility in the TIBCO
Runtime Agent documentation set for more information on how to migrate
projects to TIBCO BusinessWorks 5.1.2.

Error Changes
The schema contained in the $ _ e r r o r process variable has changed. If you are
migrating from release 2.x to 5.x, the migration utility should handle the change
in the schema. If you have applied certain hotfixes to release 5.1.2, see the readme
file for the hotfixes you have applied for further information on how the error
schema has changed in your specific hotfix. See TIBCO BusinessWorks Process
Design Guide for more information about the error schema.

Loop Changes
Loops behave differently in release 5.1 than they did in previous releases. Now,
most process variables are reset upon each execution of the loop. If a project is
migrated from a previous release, a field named 2.x Compatibility Mode appears.
This field allows you to maintain the previous behavior of loops for your
migrated projects. Newly created projects in release 5.1 will not have this option
for loop groups.
See TIBCO BusinessWorks Process Design Guide for more information about the
new behavior of loops.

TIBCO BusinessWorks Release Notes


40 Release Notes
|

Mapping Changes
Mapping an activity’s input has changed significantly in release 5.1. An activity’s
input is now explicitly an XSLT template, and each mapping becomes a statement
in the XSLT template for the activity’s input. An activity presents its expected
input as hints, and you can then create mappings based on these hints.
In some cases, input schemas for some activities have changed. During migration,
some of these changes are handled automatically, but some input schemas cannot
be migrated. You may receive "input data invalid" or "empty" input errors in the
migration log. To fix these problems, open the project, select the activity with the
error, and use the Check Mappings and Repair button to fix the problems.
In previous releases, input mappings are automatically removed if they do not
match the input schema for the activity. In Version 5.1, input mappings are not
removed, because they may be useful for reference when creating a valid
mapping. Therefore, you may have some mappings in a migrated project that do
not match the input schema. These invalid mappings are noted when the project
is validated for deployment and these mappings can be deleted using the Check
Mappings and Repair button on the Input tab.

The Check Mappings and Repair button may not make all necessary repairs the
first time. For example, some input elements have been renamed and their
contents have changed. In these cases, you may need to use the Check Mappings
and Repair button two or more times before all problems in the Input mappings
are identified and addressed.

See TIBCO BusinessWorks Process Design Guide for more information about the
new mapping functionality and how to fix errors in input mappings.

BusinessConnect Palette
The BusinessConnect palette is no longer part of TIBCO BusinessWorks. This
palette is shipped and installed with TIBCO BusinessConnect. See the TIBCO
BusinessConnect documentation for more information about this palette.

Java Palette
In previous releases, you could set the CLASSPATH for each Java Code activity.
This is no longer supported. If your Java Code activity requires classes that are
not in the default CLASSPATH for TIBCO BusinessWorks, the CLASSPATH can
be set in the b w e n g i n e . t r a and d e s i g n e r . t r a files. This allows you to specify
the CLASSPATH in one place as opposed to setting the CLASSPATH for each
activity. This also allows you to use the same project on multiple platforms
because the CLASSPATH reference is not defined within the project.

TIBCO BusinessWorks Release Notes


Changes in Functionality 41
|

Also, byte arrays are handled differently by the Java activities. In previous
releases, if an input or output parameter was defined as type byte with the
occurrence specified as repeating, byte arrays were treated as a single byte
repeating element in the input or output. In this release, byte/repeating is the
same as binary/optional, the byte array is passed as a single element. That is, the
stream of bytes is one non-repeating binary element in the input or output
schema.

JMS Palette
Several changes have been made to the input and output schemas for the
activities of this palette.
In previous releases, XML Text messages had their schemas defined by fields on
the Configuration tab. Now, all schemas are defined on the Input and Output
Editor tabs of the activities.
Refer to the TIBCO BusinessWorks Palette Reference for a complete description of
these activities.

JDBC Palette
The following changes have been made to the JDBC palette:
• User-defined functions are now supported in the JDBC Call Procedure
activity.
• The Manual Refresh field on activities in this palette is no longer available.
Automatic refreshing of the schema from the database is no longer performed
— the Fetch button is now the only mechanism for refreshing the schema from
the database.
• The Use Nil field is deprecated in this release. The Input tab now allows you
to specify input elements as explicitly null, so there is no need for the older
mechanism for specifying nulls.
• Statement types are now enforced for activities in this palette. That is, only
queries can be performed in the JDBC Query activity, only INSERT, UPDATE,
or DELETE statements can be performed in the JDBC Update activity, and so
on. In previous releases, there was no strict enforcement to ensure that the
correct kind of statement was specified in an activity. Inappropriate
statements for an activity now result in an error.
When your project is migrated, an attempt is made to choose the correct
activity for the statement you are trying to perform, but you may need to
redefine your process definition to use the correct activity. You will also need
to reconfigure any input mappings for any activities that change due to
migration.

TIBCO BusinessWorks Release Notes


42 Release Notes
|

To avoid losing any configuration during migration, you should edit your 2.x
project in TIBCO BusinessWorks 2.x and change any JDBC activities that use
inappropriate statements to the correct kind of JDBC activity.
• The No Statement Validation field is no longer available in the JDBC Query
activity.
• The datatype of some numeric types was wrongly represented in the input
schema of the JDBC activities. For example, a column of type n u m e r i c ( 3 , 0 )
was represented as a float instead of an integer. The columns are now correctly
represented in this release, but some input mappings may be invalid for
migrated projects. To fix invalid mappings, use the Refresh button on the
activity to refresh the input schema.
• Specifying 0 in the Maximum Rows field now signifies that all rows should be
returned.

Mail Palette
The bcc Output element of the Receive Mail process starter has been removed.
This Output element was always an empty string, so there is no need for it. Any
mappings that use the bcc field produce errors in the migration log. To fix the
error, you can either replace the bcc mapping with an empty string or remove all
references to the bcc element.
The encoding input/output element is now replaced by the contentType element.
This change is handled automatically when an older project is migrated to
Version 5.1. Refer to TIBCO BusinessWorks Palette Reference for more information
about the contentType element.

Parse Palette
The following changes have been made to the Parse palette:
• The done output element of the Parse activity is now named EOF.
• The Skip First Record configuration field in the Parse activity has been
removed Use the Manually Specify Start Record field instead.
• The Parse activity has a new input element, SkipHeaderCharacters. This
specifies the number of characters at the start of the file to skip.
• The output element textString in the Render Data activity is now named text.

Rendezvous Palette
Input and Output schemas for the activities in this palette are no longer specified
in tables on the Configuration tab. There are Input and Output Editor tabs that
allow you to construct the appropriate schemas.

TIBCO BusinessWorks Release Notes


Changes in Functionality 43
|

XML Palette
The XML palette has been renamed to XML Activities palette, and has the
following functionality changes:
• The XML Document resource is replaced by a general Schema resource, which
is integrated with the embedded XA.
• The XML Render activity now has an Input Editor tab for specifying the input
schema. This tab replaces the Schema and Element fields on the Configuration
tab, and therefore those fields are removed in this release. Also the Text-Only
Output field is no longer part of this activity. Instead, you can specify the type
of output (text or binary) and the encoding for text output on the
Configuration tab.
• The XML Parse activity now has an Output Editor tab for specifying the
output schema. This tab replaces the Schema and Element fields on the
Configuration tab, and therefore those fields are removed in this release.

XML Render Activity


For the XML Render activity, when the Output Style is set to binary, the order of
the input schema has changed in this release. The byteEncoding element is now
before the input XML schema element.
For projects created in or migrated to Release 5.0.0 that use this activity and
specify binary output, you must use the Mapper Check and Repair button on the
Input tab of your activity to correct the activity’s input schema.
For projects migrated from Release 2.0.x to Release 5.1, the migration process will
usually place the elements in the correct order and properly migrate the
mappings. However, there are some situations when mappings are not correctly
migrated. For example, relatively complex mappings with statements (using the
Insert Statement button) used at the root of the 2.0.x version of the mapping may
not migrate properly.
If you have XML Render activities in your project that are set to produce binary
output, you should check the Input tab on these activities to ensure the mappings
have migrated properly. In the rare case where the mappings have not migrated
properly, use the Mapper Check and Repair button to correct the input schema
and then recreate your mappings.

TIBCO BusinessWorks Release Notes


44 Release Notes
|

Migration From Previous Releases

Projects created in any 5.x release can be opened and saved in this release. Projects
from Release 2.x must be migrated to Release 5.x before they can be used. TIBCO
Designer has a tab labeled Administration on the startup menu that allows you to
convert . d a t files containing projects from Release 2.x to the current format. You
can also use the b w 2 0 m i g r a t e . e x e utility to perform batch conversions of
projects. Once a project created in Release 2.x is migrated to release 5.x, you can
open the project in this release.
Migrating projects is described in TIBCO ActiveEnterprise Features, Migration, and
Compatibility in the TIBCO Runtime Agent documentation set.

TIBCO BusinessWorks Release Notes


Third-Party Software Support 45
|

Third-Party Software Support

TIBCO BusinessWorks can be used to work with external systems such as


databases and JMS servers. This section lists the third-party products that TIBCO
BusinessWorks supports.

Any products that are not mentioned in this section are not officially supported.

JDBC Support
TIBCO BusinessWorks can communicate with a database using the JDBC
Connection shared configuration resource. The connection can be used to perform
database work with activities in the JDBC palette or it can be used to specify the
data store for a process engine’s internal data. See TIBCO BusinessWorks
Administration for more information about specifying a process engine’s data
store. See TIBCO BusinessWorks Palette Reference for more information about using
the JDBC palette.

Database Support
TIBCO BusinessWorks supports the following databases:
• Oracle 10g with RAC
• Oracle 9.x
• Oracle 8.1.x
• Microsoft SQL Server 2000
• Microsoft SQL Server 2005
• Sybase 12.x
• DB2 8.2
• TimesTen 5.0.x
This release of TIBCO BusinessWorks is specifically tested against Oracle 9.2.0.1,
Oracle 10.1.0.2.0, Sybase 12.5, TimesTen 5.0.34, DB2 8.2, and MS SQL Server 8.0.

TIBCO BusinessWorks Release Notes


46 Release Notes
|

For the 5.0.34 release of the TimesTen database, the maximum size of an object
inserted into the database is 4 MB. Therefore, checkpoints, shared variables, and
data in Notify Configurations cannot exceed this limit.

As of Release 5.2.0, the TimesTen database has been tested with the Checkpoint
activity to store process engine data. DB2 has been tested with JDBC activities.
Other uses of these databases is supported, but has not been tested. If you
experience problems using these databases, please contact TIBCO Support with
details of your usage scenario.

Bundled Drivers
TIBCO Runtime Agent (TRA) bundles Data Direct JDBC Drivers. See the TRA
documentation for the current version of the bundled Data Direct JDBC drivers.
The bundled JDBC drivers can be specified in the JDBC Connection shared
configuration in the JDBC Driver field. These drivers are supplied in a drop-down
list as the following:
• tibcosoftwareinc.jdbc.oracle.OracleDriver

• tibcosoftwareinc.jdbc.oracle.OracleDriver (RAC)

• tibcosoftwareinc.jdbc.sqlserver.SQLServerDriver

• tibcosoftwareinc.jdbc.sybase.SybaseDriver

• tibcosoftwareinc.jdbc.db2.DB2Driver

Supported Drivers That Are Not Bundled


The JDBC Connection resource also lists the following drivers in the drop-down
list:
• oracle.JDBC.driver.OracleDriver (oci)

• oracle.JDBC.driver.OracleDriver (thin)

• com.sybase.jdbc2.jdbc.SybDriver

• com.timesten.jdbc.TimesTenDriver

• com.ibm.db2.jcc.DB2Driver

These drivers are officially supported, but they are not bundled with TIBCO
BusinessWorks. You must download and configure these drivers before using
them in the JDBC Connection resource. Also, you must add the driver location to
the TIBCO BusinessWorks classpath before using them.

TIBCO BusinessWorks Release Notes


Third-Party Software Support 47
|

Unsupported Drivers
There are other JDBC 2.0-compliant drivers listed in the JDBC Connection
resource. These drivers should work correctly, but they are not officially
supported. You must download and configure these drivers because they are not
included with TIBCO BusinessWorks. These drivers are the following:
• sun.jdbc.odbc.JdbcOdbcDriver

• weblogic.jdbc.mssqlserver4.Driver

You can download, install, and use other JDBC drivers, but TIBCO does not
guarantee the drivers will function properly with TIBCO BusinessWorks. To use
an unsupported driver, perform the following:
1. Download the JDBC driver and copy the required JAR files to a location in the
classpath of the TIBCO BusinessWorks Engine. For example, you can copy the
files to the following location: TIBCO_HOME/ t p c l / < version> / j d b c .
2. In the JDBC Connection resource, choose Select Driver from the drop-down
list in the JDBC Driver field and type in the name of the driver class in the text
box within that field. Then, type in the correct URL in the Database URL field
and specify the other fields in the resource.

JMS Support
To use the activities in the JMS palette, you must have installed and configured a
JMS (Java Messaging Service) server. TIBCO BusinessWorks acts as a JMS client
when interacting with a JMS server.
TIBCO BusinessWorks supports TIBCO Enterprise for JMS. The latest release
TIBCO Enterprise for JMS is fully backwardly-compatible with clients from
earlier releases. Therefore, your process definitions that use JMS will run against
any version of the TIBCO Enterprise for JMS server.
TIBCO BusinessWorks also supports the following JMS servers:
• BEA WebLogic Server Version 7.0 Service Pack 2, Version 8.1 Service Pack 1
• IBM WebSphere 5.0.2
• JBoss 3.2.1

Application Servers
For EJB and Java Transaction API (JTA) support, the following application servers
can be used:
• IBM WebSphere 5.0.2

TIBCO BusinessWorks Release Notes


48 Release Notes
|

• BEA WebLogic Version 7.0 Service Pack 2, Version 8.1 Service Pack 1
• JBoss 3.2.1

TIBCO BusinessWorks Release Notes


Known Issues 49
|

Known Issues

This section lists known issues for the current release. The information is
organized alphabetically on a per-palette basis.

General

Increased memory footprint and memory sizing issue (1-8G8PXB): TIBCO


BusinessWorks 5.2.0 and higher versions may see an increase in memory
footprint and a potential memory sizing issue.
Workaround: TIBCO BusinessWorks version 5.2.0 and above point to server
JVM and versions older than TIBCO BusinessWorks 5.2.0 point to client JVM in
the b w e n g i n e . t r a file. While sizing and tuning your environment, consider
the following:
• The total memory used by the JVM (memory footprint) is dependent on the
type of JVM used (Server JVM or Client JVM), the JVM version, and the
JVM vendor.
• A Server JVM occupies a higher memory footprint and may result in higher
performance when compared to a Client JVM.
• A Client JVM may have a lower startup time and memory footprint.
For more information on tuning the JVM to suit your application, refer to the
JVM Tuning Guide of the JVM used in your environment. You may also consult
your JVM vendor for details about the exact memory footprint and heap
management in the JVM version used in your environment.

OutOfMemoryError when BusinessWorks project is deployed and


undeployed repeatedly (1-85R2GN): Repeated deploy/undeploy of a TIBCO
BusinessWorks project can lead to j a v a . l a n g . O u t O f M e m o r y E r r o r. Typically,
this issue is observed after four to five deploy and undeploy activities.
Workaround: You can increase the space from a default 32M to a higher value
by specifying - X X : M a x P e r m S i z e = 2 5 6 M in the
<TIBCO_HOME>\ b w \ <version_number>\ b i n \ b w c o n t a i n e r . t r a file.

TIBCO BusinessWorks Release Notes


50 Release Notes
|

Validation of a schema file fails when the schema file imports other schema
files (1-79SX64): While importing schemas using the Schema Importer tool, a
new location with URL such as C : \ <folder_name>\ s c h e m a . x s d is created and the
schemas are imported. However, validating the schema file containing the
xsd:include fails with a syntactic error saying the attribute ’SchemaLocation’ is
required.
Workaround: Provide the URL for the schema.xsd file as
h t t p : / / s e r v e r : p o r t / <folder_name>/ s c h e m a . x s d

Mapped drives not recognized by deployed services (1-103GMT): If the


TIBCO Hawk Agent is started as an NT Service, mapped drives on the machine
are not recognized by deployed services.
Workaround: Start the TIBCO Hawk Agent from the command line.

Multiple WSDL message references in a schema (1-6ROND3): Currently,


you can create an in-line schema in an Editor tab (for example, on the Output
Editor tab of the Start activity) that has multiple references to WSDL messages.
This is not permitted.
Workaround: You can only have one reference to a WSDL message in an
Editor schema and it must be at the root level of the schema. Do not create
multiple elements in a schema of type WSDL Message. A future version of
TIBCO BusinessWorks will not allow this type of schema to be created.

Uninstalling TIBCO BusinessWorks 5.3.1 (1-70FW9X): Uninstalling TIBCO


BusinessWorks Release 5.3.1 does not restore the base 5.3.0 version. Instead, all
release 5.3 files are removed.
Workaround: If you wish to uninstall Release 5.3.1 and revert to the base 5.3.0
version, manually copy the files from the directory
< install_dir> \ _ u n i n s t \ b a c k u p 5 . 3 . 0 (for example, on MS Windows,
c : \ t i b c o \ b w \ 5 . 3 \ _ u n i n s t \ b a c k u p _ 5 . 3 . 0 ) to their original location.

XPath Formula Builder: On Windows platforms, the XPath Formula Builder


dialog has an X icon in the top right corner that dismisses the dialog. On UNIX
platforms, this icon does not appear.
Workaround: To close the XPath Formula Builder dialog on UNIX systems,
either click the XPath Formula Builder button (the pencil icon) in the Input tab
of the activity (this button toggles the display of the dialog) or use the keyboard
shortcut for dismissing a window in your windowing system. For most UNIX
platforms and windowing systems, this keyboard shortcut is Alt-F4. This will
be fixed in a future release.

TIBCO BusinessWorks Release Notes


Known Issues 51
|

Using the preceding axis in XSLT: In previous releases, the for-each-group


XSLT statement was not available for use. To workaround this, the preceding
axis was sometimes used to create the same output. There were performance
problems when using the preceding axis that caused unreasonable slowdowns
during mapping.
Workaround: The for-each-group statement performs faster than using the
preceeding axis. As such, x s l : f o r - e a c h - g r o u p should be used in preference
to the combination of x s l : f o r - e a c h and the preceding axis to solve the
problem more efficiently. Modify your mappings to use for-each-group.

The Stop Button in Test Mode: In some situations, this button may not stop
the process immediately because TIBCO BusinessWorks may be waiting for the
current operation to be completed. For example, if the current activity is FTP
Put and you are attempting to place a very large file on the remote server, the
process engine will not exit test mode until the FTP command has completed,
failed, or a timeout has been reached.

Test Mode Error: If you attempt to test a process where an XML Render
activity has not specified any input, you will receive the "Unable to reparse
source view error".
Workaround: The cause of this error may not be clear when you receive it.
Check any XML Render activities and make sure the input mappings are
specified.

Deployment of multiple engines: The current version of TIBCO


Administrator does not allow you to specify different values for global
variables for each engine in a load-balancing group. For example, you may
have multiple engines executing the same process definition that starts a
process when a new RVCMQ message is received. For each of these engines,
you cannot specify a different value for global variables such as Worker Weight
or Scheduler Weight in the current TIBCO Administrator interface.
Workaround: If you define a global variable with the Service checkbox
checked (using the Advanced Editor of the global variable tab), TIBCO
Administrator creates an entry into the service’s . t r a file like the following:
t i b c o . c l i e n t V a r . < variableName> = < Value>

You can edit this entry in the . t r a file for the deployed process engine and
specify a value for your global variables. This will allow you to specify
different values for global variables for each engine in a load-balancing group.

TIBCO BusinessWorks Release Notes


52 Release Notes
|

WSIL and UDDI Registry Browser in TIBCO Designer

www.xmethods WSIL (1-1WLHKN): Using the UDDI option on the Tools


menu to browse http://www.xmethods.net/inspection.wsil does not work
properly.
Workaround: This will be fixed in a future release.

Loading UDDI Servers Module (1-6T5PD3): In certain situations, you may


receive the error "Domain has already been destroyed: <d o m a i n N a m e >" when
you click the UDDI Servers Module in the left-hand frame.
Workaround: Click OK to dismiss the error, and the UDDI Servers Module
will load properly. The error message will be removed in a future release.

Web Service Wizards

Service resource generates an invalid WSDL (1-6SU5T4): When folders are


created in a project and the project has not yet been saved, the folders do not
exist in the file system. When referenced folders do not yet exist, the Service
resource cannot generate the WSDL file on the WSDL Source tab properly and
an exception occurs. The following conditions can cause the exception:
— the parent folder of the Service resource or any folder containing
resources that the Service resource depends upon do not exist in the file
system.
— the WSDL file that is referenced by the Service resource is located in a
folder that does not exist on the file system.
— one of the resources (WSDL/XSD) referenced by the WSDL file that is
referenced by the Service resource is located in a folder that does not
exist on the file system.
Workaround: Save the project before viewing the WSDL file on the WSDL
Source tab.

WSDL references in process input/output (1-6T3OMN): Only processes that


have XSD references in the input/output specified on the Start and End
activities are supported. The wizards do not support WSDL messages as input
or output to a process definition.
Workaround: This will be fixed in a future release.

TIBCO BusinessWorks Release Notes


Known Issues 53
|

XSD schema names in process input or output (1-6U6LWB): When using the
wizard that creates a WSDL and Service resource, double byte characters are
not permitted in the XSD schema names in the input and output specified on
the Start and End activities.
Workaround: This will be fixed in a future release.

ActiveEnterprise Adapter Palette

JMS Server crashes: If the JMS server goes down while you are designing and
testing your process definition (and your ActiveEnterprise Adapter activities
are using the JMS transport), you must restart TIBCO Designer because the
connection to the JMS server cannot be refreshed.

Invoking an operation with no "in" parameters: You cannot currently invoke


an operation that has no input parameters. This will be fixed in a future release.

Publishing messages containing unions with XML message format: You


cannot currently publish a message that contains a union when using the XML
message format. This will be fixed in a future release.

Association Lists: You cannot use association lists in any custom adapter.
While there will be no errors during configuration, you will encounter errors at
runtime because association lists are not supported in TIBCO BusinessWorks.

Ledger File field when using the RVCM transport: TIBCO BusinessWorks
constructs the default value of the Ledger File field from global variables and
the Adapter Service configuration. The value of this field must result in a valid
path on the file system where the process is run. It is possible that the default
value may not be a valid path.
Workaround: You may need to modify the default value in this field or
modify the global variables used in this field to make sure the field results in a
valid filesystem path.

EJB Palette

Earlier releases of the TIBCO BusinessWorks EJB Plug-in: The 5.1.x releases
of this plug-in will not work with TIBCO BusinessWorks Release 5.2.0.
Workaround: You must upgrade and install the latest release of the plug-in
(release 5.2.0) if you wish the plug-in to work with TIBCO BusinessWorks 5.2.0.

TIBCO BusinessWorks Release Notes


54 Release Notes
|

WebSphere 5.0.2: The WebSphere EJB components are not fully serializable.
Because of this, checkpoints may not completely capture references to EJB
Home and Remote objects. Therefore, if a process engine crashes after a
checkpoint, the restarted process instance will throw an exception when an EJB
Home or EJB Remote activity attempts to call a method on an EJB object created
before the checkpoint.

WebLogic 7.0 Service Pack 2: In WebLogic 7.0, the EJB components are not
fully serializable. Therefore, checkpoints fail in processes containing EJB Home
or EJB Remote activities when using this version of WebLogic.
Workaround: The issue is fixed in WebLogic 8.1. Upgrade to that version, if
possible.

WebLogic 7.0 Service Pack 2: There is an InitialContext conflict when using


BEA WebLogic Application Server and deploying processes that use activities
in both the JMS palette and the EBJ palette (or when using multiple users in
activities in the EJB palette).
Workaround: Set the Maximum Connections field in the EJB Connection
resource to "0" so that a new InitialContext is created for each lookup operation.

JBoss 3.2.1: For some of the EJB method invocations [for example, calling
g e t E J B H o m e ( ) on a remote object], a j n d i . p r o p e r t i e s file must be present in
the TIBCO BusinessWorks engine classpath, otherwise the following error
occurs:
EJB application exception occurred. The EJBRemote interface
method [test.bw.ejb.stateLess.Test1.getEJBHome] raised exception
[java.lang.reflect.UndeclaredThrowableException].
java.lang.reflect.UndeclaredThrowableException
at
com.tibco.plugin.ejb.EJBRemoteActivity.for(EJBRemoteActivity.jav
a:143)

Workaround: Create the appropriate jndi.properties file and place it into the
engine CLASSPATH. This is most easily done by editing b w e n g i n e . t r a before
starting TIBCO Designer or before deploying your project. See the
documentation for TIBCO Administrator for more information about . t r a files
and deploying projects. Sample j n d i . p r o p e r t i e s files are available in the
JBoss3.2.1 installation.

TIBCO BusinessWorks Release Notes


Known Issues 55
|

Error Transition

Error transitions in parallel tracks: Currently, the $ _ e r r o r process data


produced by an error transition is global to the process.
This means the result of $ _ e r r o r may be unpredictable if there are error
transitions in two or more parallel tracks.
Workaround: Use a group to isolate the tracks with error transitions from
each other.

FTP Palette

FTP servers outside of a firewall (1-6ZIUO1): Only the FTP PUT and FTP
GET activities work properly when using FTP activities to access an FTP server
outside of a firewall (using the Firewall and Proxy fields on the FTP Connection
resource). No other FTP activities can be used to access an FTP server outside of
a firewall.
Workaround: This will be fixed in a future release of TIBCO BusinessWorks.

Implicit Mode for FTP over SSL (1-70DCEV): This is not supported.
Workaround: Only explicit mode is supported.

General Activities Palette

Call Process activity is case sensitive at run time (1-5EPVYK): The Call
Process activity, in debug mode, handles the name of the process to be called in
a case insensitive manner. However, if the process name differs in case from the
actual process name, the Call Process activity returns an error when deployed
and run as the process name is handled in a case sensitive manner.
Workaround: Use the resource picker to select the process to be called.

Editing Shared Variable initial values (1-79Q35L): If you create a schema for
a Shared Variable resource and then attempt to set its initial value, the schema
sometimes does not appear in the dialog to set the initial value.
Workaround: Select a different resource, and then return to the Shared
Variable resource, the schema now appears in the dialog to set the variable’s
initial value.

Changing icon: If you change the icon for a C a l l Process resource and apply
the change, it is not possible to undo the change.
Workaround: Delete the C a l l Process and add a new one.

TIBCO BusinessWorks Release Notes


56 Release Notes
|

HTTP Palette

Separating multiple name/value pairs in cookies (1-7V7K10): The


convention to separate multiple name-value pairs in the same cookie element is
typically a semi-colon (;), but TIBCO BusinessWorks uses a comma (,).
Workaround: Use commas to separate multiple name/value pairs in the same
Cookie header element.

Double-byte characters in mime headers (1-6TH5F9): The m i m e H e a d e r s


element of Send HTTP Request can not contain any double byte characters.
Workaround: This will be fixed in a future release.

Migrated projects that specify the HTTPVersion input element: The Send
HTTP Request activity in previous releases of TIBCO BusinessWorks had an
input element named HTTPVersion. This input element did not throw an
exception if an invalid HTTP version was specified. This field is now
deprecated and no longer appears in the input of Send HTTP Request
activities. However, for migrated projects, this input element will appear, and it
will still not throw an error if an invalid version is supplied.
Workaround: Remove the HTTPVersion from your activity’s input schema in
any migrated projects. It is not needed.

Accept Redirects field on Send HTTP Request: When this field is checked, if
the remote server sends the redirection status code (3xx), the request is
automatically redirected, if the remote host redirects the request to the same
host and port. Currently, redirecting to a different host or a different port on the
same host is not permitted.
Workaround: If the remote host attempts to redirect the request to a different
host and/or port, you must handle this in your process definition logic instead
of expecting automatic redirection.

When we decode the escaped characters of the Request URI of an incoming


HTTP GET request, we always use UTF-8.

When we deserialize an incoming HTTP request, we do not properly use the


encoding specified in the Content-Type header

When the Content-Type of an HTTP POST request that sends parameters is not
specified, we do not default to application/x-www-form-urlencoded.
Workaround: The user will have to specify the Content-Type and not rely on
the default value.

TIBCO BusinessWorks Release Notes


Known Issues 57
|

• TIBCO BusinessWorks does not perform key store validation. i.e. expired
keys.
• TIBCO BusinessWorks validates the certificate when user imports it, but if
certificate expires after that, it becomes an invalid certificate and TIBCO
BusinessWorks does not trust it.
• The key store password must be the same as the keys inside it.
• TIBCO BusinessWorks does not encourage the use of self-signed
certificates. If a self-signed certificate is used, TIBCO BusinessWorks
assumes it is coming from a trusted trading partner.
• In this release, TIBCO BusinessWorks only supports Java key stores. P12
key stores are not currently supported.

Java Palette

Code truncation: Choosing "Invoke Method Body" on the Code tab of a Java
Code activity will sometimes only display a portion of the code. This is because
the Java Code activity expects that there are always matching open and close
curly braces within your code. You could, have code like the following:
myString[4] = new String("A15%!} Z");

This would cause a mismatch of curly braces, and code beyond this point
would be truncated.
No code is lost, but the display will be truncated when a mismatched closing
curly brace is encountered. Choosing Full Class will always display all code, so
this problem: only occurs when you wish to display the Invoke method.
Workaround: You can either choose to always display the full class, or you
can add matching curly braces to your code within comments to avoid the
problem. For example, for the line of code above, you can change it as follows
to make the curly braces match:
// matching brace for next line {
myString[4] = new String("A15%!} Z");

TIBCO BusinessWorks Release Notes


58 Release Notes
|

JDBC Palette

Migration from previous releases: Some activities of the JDBC palette have
changed so that some existing 2.x projects may have errors in the migration log.
Most of the problems that will occur are due to changes in the input schema of
the activities and new enforcement rules for SQL statements.
Workaround: See JDBC Palette on page 41 for a description of the changes in
this release to the activities of the JDBC palette. If possible, update your 2.x
project to take these changes into account before migrating the project. If you
have already migrated to 5.1, alter the migrated activities to account for the
new and changed functionality of the activities of this palette.

Migration from previous releases: When migrating projects from previous


releases, the JDBC connection information found in the project is used to fetch
schema from the database where necessary. If the JDBC connection is
unsuccessful during migration, the input or output schemas of JDBC activities
may not be available.
Workaround: The runtime values for any global variable substitution is not
performed when making the JDBC connection. Therefore, make certain the
connection information is correct in the 2.x project before migration. Also,
make sure the database is up, running, and reachable when migrating the
project. If you open the migrated project in TIBCO BusinessWorks 5.1 and the
input or output schemas are not the expected schemas, click the Fetch or
Refresh button on the activity’s Configuration tab, click Apply, then save the
project.

Migration from previous releases: Prior to release 5.x, if a value returned


from a table was null, the output element corresponding to that table value was
not placed into the output schema for a JDBC Call Procedure activity, if the
output element was optional. In release 5.x, the element is now placed into the
output schema and has "x s i : n i l = t r u e " to indicate the element is null.
Workaround: To be compatible with this release and future releases, you
should surround elements that can be nil with an if statement to determine
whether to output the element. Another way to workaround this problem is to
set a property in the bwengine.tra file to maintain the behavior of previous
releases. The C o n f i g . J D B C . C a l l P r o c e d u r e . O u t p u t U s e N i l property controls
whether elements that are nil are contained in the output. Set the property to
f a l s e to achieve the behavior of previous releases.

TIBCO BusinessWorks Release Notes


Known Issues 59
|

Summary (1-7V3VSS): Under certain situations, time out exceptions are not
thrown when using stored procedures in an Oracle database. This can
sometimes occur if the stored procedure calls Java functions that sleep for some
amount of time.
Workaround: Use caution when calling stored procedures that call Java
functions that sleep.

Stored procedures returning multiple result sets from


Sybase(1-36AMUR): When using the jConn or Data Direct 3.3 driver and
connecting to a Sybase database, stored procedures that are supposed to return
multiple result sets do not return any data.
Workaround: This only occurs when using the jConn or Data Direct 3.3
database drivers and a Sybase database. To avoid this problem, you can either
use the s u n . j d b c . o d b c . J d b c O d b c D r i v e r instead or you can add s e t n o c o u n t
o n to your stored procedure definition.

Parameter Types When Calling A Procedure Using the Sybase JConnect


Driver: When using the JDBC Call Procedure activity with the
c o m . s y b a s e . j d b c 2 . j d b c . S y b D r i v e r driver, you may need to update the
Parameter Types of in/out parameters before execution.
For example, all ProcedureColumnOut types will initially appear as
ProcedureColumnIn. You must manually change these to
ProcedureColumnOut. This can either be done by typing or by selecting from
the pull-down list of values. Then, apply and save your project before
executing the process definition.

Aliases and Sybase: When you use the


tibcosoftwareinc.jdbc.sybase.SybaseDriver driver to connect to a
Sybase database, column alias names are ignored in SQL statements. Instead of
the specified alias, the column name is used in the result set schema.
If you are attempting to execute a query that includes a multi-table join and
you are trying to select columns with the same name, you must use column
name aliases. Because of this issue, these types of queries will not work
properly.
Workaround: This is only an issue when using
t i b c o s o f t w a r e i n c . j d b c . s y b a s e . S y b a s e D r i v e r.
Other drivers work
correctly. Either use a different driver or do not use aliases in your SQL
statements. A future release of this bundled driver may fix this problem.

TIBCO BusinessWorks Release Notes


60 Release Notes
|

Using COUNT(*) in queries: Depending on the JDBC driver you use, the
output datatype of COUNT(*) differs. When using Oracle drivers, the output
datatype is a float. When using MS SQL Server drivers, the output datatype is
an integer.

Select for update statements to Oracle databases: When a JDBC Query


activity has the SELECT statement with the FOR UPDATE clause for an Oracle
database, a "fetch out of sequence" error is returned if the activity is not part of
a transaction.
Workaround: Enclose the activity in a transaction group.

Optional Stored Procedure parameters: Optional stored procedure


parameters are not supported. If one of the arguments is missing, the standard
procedure cannot be executed.
Workaround: Provide a value for all parameters in the JDBC Call Procedure
activity input. If a parameter does not have a value, specify an explicit nil for
the input element.

For Oracle, calling arguments or return values of the PL/SQL types TABLE
(now known as indexed-by tables), RESULT SET, RECORD, or BOOLEAN is
not supported. For more information, please visit
http://otn.oracle.com/tech/java/sqlj_jdbc/htdocs/jdbc_faq.htm

Inserting large BLOBs: If inserting / updating a huge BLOB fails, activity


timeout may need to be adjusted to allow sufficient time to finish the operation

DML statements: If DML statements are used with SQL Direct activity, using
8.x versions of Oracle thin / thick drivers doesn't work in some cases.
Workaround: Upgrade to 9.x drivers. Note that 9.x drivers work with 8.x and
7.x databases, so only the driver must be changed.

Maximum Rows not supported: While working with Oracle stored


procedures, the M a x i m u m R o w s property is not supported by the Oracle thin
driver.
Workaround: Use the Data Direct driver included with the release.

TIBCO BusinessWorks Release Notes


Known Issues 61
|

Stored procedure custom exceptions: A J D B C C a l l P r o c e d u r e activity


throws a generic exception for any custom exceptions raised in stored
procedures. The exception thrown is driver specific. Below are the error
messages thrown for each combination of database and driver:
Data Direct Oracle: JDBC error reported (SQLState = HY000)
Thin Oracle: JDBC error reported (SQLState = 72000)
Data Direct MSSQL: JDBC error reported (SQLState = HY000)

CLOB/BLOB Datatypes Columns of type CLOB or BLOB can only be used in


JDBC activities when you use the
t i b c o s o f t w a r e i n c . j d b c . o r a c l e . O r a c l e D r i v e r driver in the JDBC
Connection resource. Manipulating CLOB or BLOB data is not supported with
other database drivers.

TIBCO BusinessWorks Release Notes


62 Release Notes
|

The U n r e s o l v e d R e s u l t s e t s output parameter can be used to utilize the result


sets returned by stored procedures. It represents records in return result sets as
an XML string. Since the structure of the XML string is unknown at design time
and no mapping can be done if the schema is unknown, use the workaround to
overcome the problem.
Note: At this time, only stored procedures that always generate a fixed schema
can be utilized
Workaround:
1. Configure the C a l l Procedure activity.
2. Add a W r i t e File activity
3. Configure a W r i t e F i l e activity to write a text file, provide a local file
name with . x m l extension.
4. Map unresolved result sets from call activity's output to t e x t C o n t e n t input
field in the W r i t e F i l e activity.
5. Execute the process definition. Upon successful execution, all records are
written to the specified XML file in a predefined format
6. Open the XML file in XML Authority as a schema. XML Authority
generates a schema based on the contents of the XML file (or create the
schema manually using the structure provided in the XML file)
7. Create a schema definition resource using the newly generated schema.
8. Add a P a r s e X M L activity. In the C o n f i g u r a t i o n tab, select the newly
created schema definition and type R e s u l t s e t s in the E l e m e n t field
9. Map unresolved result sets from the C a l l P r o c e s s activity's output to the
P a r s e X M L activity’s x m l S t r i n g input field.

Result sets can now be utilized at design time from the output of the P a r s e XML
activity.

JMS Palette

Using Different Ports for JNDI and the JMS server


(1-6VW8GN): Performance can degrade when using a message selector in the
Get JMS Queue Message activity and different ports have been specified for the
Provider URL and JNDI.
Workaround: Make sure the port number specified in the Provider URL and
JNDI fields match. Alternatively, use TCP to connect to the JMS server. This
will be fixed in a future version.

TIBCO BusinessWorks Release Notes


Known Issues 63
|

JMSProperties Input Elements: For activities that publish messages (for


example, JMS Topic Publisher or Reply to JMS Message), the JMSProperties
input element is available. If you specify a value for any of the JMSProperties,
then save the project, then delete the value for the property, the JMSProperties
element does not get properly removed from the project. You will get an invalid
attribute error if you attempt to execute the process definition where the
property has not been properly deleted.
Workaround: To work around this problem, edit the process definition
. p r o c e s s file in a text editor and search for < J M S P r o p e r t i e s / > . Remove this
string from the . p r o c e s s file, then restart TIBCO Designer. This will be fixed in
a future version.

replyToDestination Input Element Use of the replyToDestination input


element in the JMS Topic/Queue Requestor activities does not always result in
the expected behavior if more than one process instance specifies the same
reply to destination.
Workaround If you do wish to specify a destination name for reply messages,
you should either specify unique reply to destinations for each process instance
or use the JMS Queue Sender and JMS Topic Publisher activities together with
the corresponding Wait for JMS Queue Message and Wait for JMS Topic
Message so that the "Wait" activities can use the appropriate key to receive the
correct reply message for the process.

Mail Palette

Reading Attachments from Files: When attachments are contained in a file,


the file is read using the system default encoding. There is no way to specify
the expected encoding of the file’s contents.
Workaround: None. This will be addressed in a future release.

Text Attachments: When a text attachment is sent by the Send Mail activity,
the attachment appears as b y t e [ ] when opened in MS Outlook.

Receive Mail attachments (Japanese): When email is received that was sent
by Netscape Navigator on a Japanese machine, the content of any attachments
is corrupt in the R e c e i v e M a i l activity.

TIBCO BusinessWorks Release Notes


64 Release Notes
|

Manual Work Palette

To use TIBCO InConcert 6.2 with TIBCO Businessworks, please change the
following in b w e n g i n e . t r a and d e s i g n e r . t r a :
Change all occurrences of:
%TRA_HOME%/icjava55/lib

to the following:
%TRA_HOME%/hotfix/icjava/6.2/lib;%TRA_HOME%/icjava/6.2/lib

Also, change all occurrences of


%TRA_HOME%/icjava55/bin

to the following:
%TRA_HOME%/hotfix/icjava/6.2/bin;%TRA_HOME%/icjava/6.2/bin

Manual Work activities are not supported on AIX because the IC Java JNI
library is not available. Because of this, errors result. For example, if the user
tries to drag and drop a M a n u a l W o r k activity into the design panel.

Manual Work activities are not supported on the HP Itanium platform because
the IC Java JNI library is not available. Because of this, errors result. For
example, if the user tries to drag and drop a M a n u a l W o r k activity into the
design panel.

Returning to login screen: The GUI sometimes returns you to the login
screen. For example, When you select a document in the M a n u a l W o r k TIBCO
Administrator GUI, then click to open the document, you may be returned to
the login screen. This issue is rare and not reliably reproducible. It is under
investigation.
Creating new browsers: You are logged in as userA (in TIBCO Administrator
or the M a n u a l W o r k browser GUI) in browser window windowA. You then
open a new window from the browser (File->New Window menu option). The
new window displays an error that the page has expired. The exact message
depends on the browser.
If you now type the url h t t p : / / m a c h i n e : 8 0 8 0 in the window and then log in
as userB, windowA's session is also switched to have user B as the user.
WindowA still displays the fact that userA is logged in. However, in the
A c q u i r e d , R e a d y and C o m p l e t e d lists, you will see userB's tasks in windowA.

Workaround: If you open a new browser window by running the program


again (Microsoft Internet Explorer or Netscape Navigator) this problem does
not occur.

TIBCO BusinessWorks Release Notes


Known Issues 65
|

By default, all TIBCO InConcert servers within the current network subnet are
listed in the Server field of a Workflow Server Connection shared configuration
resource. If you wish to connect to a server in a different subnet, you must set
the I C _ T I B R V _ D A E M O N environment variable (see the TIBCO InConcert
documentation for more information about using this environment variable).
The value of this variable is the daemon parameter that is used to connect to
the machine running r v d in the network subnet where the desired TIBCO
InConcert server is running. If you specify an invalid value for this
environment variable (for example, if you specify the incorrect machine name),
TIBCO Designer crashes when you attempt to create a Workflow Server
Connection shared configuration resource.
Workaround: Make certain to specify the correct value for the
I C _ T I B R V _ D A E M O N environment variable.

Mapper

Design-time validation: The mapper does not support design-time validation


of string length constraints. It also does not validate maximum and minimum
(inclusive and exclusive) constraints on numbers.

Policy Palette

Longer startup time for projects using Policy palette resources under JRE 1.5
(1-72BWF4): When you are using JRE 1.5, startup time for the engine is
increased for projects that use security policies.
Workaround: JRE 1.5 actually improves performance as the engine continues
to run for longer periods, but startup time can increase when using security
policies.

Exception when encryption enabled (1-6XH7P3): Under some situations,


some requests that have encryption enabled raise an exception.
Workaround: This will be fixed in a future release.

InclusiveNamespaces tag in signature (1-6RU37X): An exception occurs on


messages if you are using j w s d p 1 . 6 ( SUN's API for signing SOAP messages),
and you are using the InclusiveNamespaces tag in the canonicalization
method.
Workaround: This will be fixed in a future release of TRA.

TIBCO BusinessWorks Release Notes


66 Release Notes
|

Exception Thrown When Engine Starts (1-6WT8Q5): When resources in the


Policy palette are in the project, the engine throws a
java.lang.NoSuchFieldException: m_ functions exception upon startup due to
Xalan compatibility issues.
Workaround: Ignore the exception, the engine functions properly. This will be
fixed in a future release.

Using J2SE to Encrypt Messages (1-6XGX2F): Setting


j a v a . p r o p p e r t y . T I B C O _ S E C U R I T Y _ P R O V I D E R to j2se is not supported for
encrypting messages. Authentication and signatures are supported, but not
encryption.
Workaround: This will be fixed in a future release.

Multiple policies applied to the same resource (1-6T6Q6N): You can create
multiple Security Policy Association resources that apply different policies to
the same resource. This is not recommended, but at this time, the product
allows this to occur without a warning. At runtime, the first policy encountered
will be used for the resource.
Workaround: Do not create multiple Security Policy Association resources
that apply to the same SOAP or Service resource. In the future, this condition
will not be permitted.

Rendezvous Palette

Use of the replySubject input element in the Send Rendezvous Request activity
would not always result in the expected behavior if more than one process
instance specified the same reply subject. If you do wish to specify a reply
subject, you should either specify unique reply subjects for each process
instance, or you can use the Publish Rendezvous Message activity together
with the Wait for Rendezvous Message activity so that the "Wait" activity can
use the appropriate key to receive the correct reply message for the process.

TIBCO BusinessWorks Release Notes


Known Issues 67
|

RMI Palette

Using localhost as the registry server host name: Java does not support more
than one registry server running in the same Java VM. If you are using
"localhost" as the registry server host name, you may encounter this problem
when trying to test process definitions. TIBCO BusinessWorks attempts to start
the registry server when a test session is initiated in TIBCO Designer. If you
attempt to start another test session with a different port number on the same
machine (localhost), you will encounter an error when an attempt is made to
use the registry server (for example, to execute a RMI Lookup activity).
Workaround: If you must change the port number of the registry server when
using the same registry server host name, you must restart the Java VM by
closing and restarting TIBCO Designer before starting another test session.

Service Palette

Non-Latin1 Characters in SOAP Action (1-6WAVQR): Non-Latin1 characters


specified in the SOAP Action field are not encoded properly in the resulting
WSDL. Subsequently, an error occurs when calling the operation using the
generated WSDL.
Workaround: Do not use non-Latin1 characters in the SOAP Action.

Exception thrown during WSDL generation (1-6SU5T4): When folders are


created in a project and the project has not yet been saved, the folders do not
yet exist in the file system. When referenced folders do not yet exist, the Service
resource cannot generate the WSDL file on the WSDL Source tab properly and
an exception occurs. The following conditions can cause the exception:
• the parent folder of the Service resource or any folder containing resources
that the Service resource depends upon do not exist in the file system.
• the WSDL file that is referenced by the Service resource is located in a folder
that does not exist on the file system.
• one of the resources (WSDL/XSD) referenced by the WSDL file that is
referenced by the Service resource is located in a folder that does not exist
on the file system.
Workaround: Save the project before viewing the WSDL file on the WSDL
Source tab.

TIBCO BusinessWorks Release Notes


68 Release Notes
|

Validation and the Service Resource (1-709ZQN): Validation of the Service


Resource does not check the following rules (both at design-time and
run-time):
• validate that all the message parts are defined using types - for SOAP
Encoding
• validate that there is only one part defined using type - for document style
services and literal encoding
• validate that all message parts are either defined using types or are all
defined using elements
• validate that each part has a unique name in the context of a message
Workaround: This will be fixed in a future release.

SOAP Palette

Inconsistent representation of the value of charset = UTF-8 (1-7AXT6R): The


value of charset=UTF-8 is inconsistent in the Content-type of HTTP Headers
for SOAP RequestReply, SendSOAPFault, and HTTP RequestReply activities.
SOAP RequestReply accepts the value with quotes, such as "UTF-8", while
SendSOAPFault and HTTP Request Reply activities accept the value without
quotes, such as UTF-8.
Workaround: None

Exception thrown during WSDL generation (1-6SU5T4): When folders are


created in a project and the project has not yet been saved, the folders do not
yet exist in the file system. When referenced folders do not yet exist, the SOAP
Event Source cannot generate the WSDL file on the WSDL Source tab properly
and an exception occurs. The following conditions can cause the exception:
• the parent folder of the SOAP Event Source or any folder containing
resources that the SOAP Event Source depends upon do not exist in the file
system.
• the WSDL file that is referenced by the SOAP Event Source is located in a
folder that does not exist on the file system.
• one of the resources (WSDL/XSD) referenced by the WSDL file that is
referenced by the SOAP Event Source is located in a folder that does not
exist on the file system.
Workaround: Save the project before viewing the WSDL file on the WSDL
Source tab.

TIBCO BusinessWorks Release Notes


Known Issues 69
|

Summary (1-7URNHS ): Under certain conditions, SOAP Request/Reply


activities that attempt to connect to a server by way of a proxy receive a 5xx
error.
Workaround: Do not use a proxy server to access the server. This will be
addressed in a future release.

SOAP One Way operations over JMS (1-3N2VY0): In some cases, when a
client sends an invalid SOAP Request to a SOAP one-way operation using the
JMS protocol, the server does not report the appropriate error.
Workaround: No workaround at this time. This will be addressed in a future
release.

SOAP Request Reply one way operations over HTTP (1-3DGD8X): The
SOAP Request Reply activity (using the HTTP transport) does not report errors
when invoking one-way operations, even if there is an HTTP communication
error or if the remote service returns a fault.
Workaround: No workaround at this time. This will be addressed in a future
release.

Validate For Deployment and Schemas (1-3Q0GSD): When you have a


number of Schemas (WSDL and XSDs) stored in a directory and the directory is
renamed, validate for deployment will initially report errors.
Workaround: Shutdown and restart TIBCO Designer and the errors are no
longer reported when validating for deployment.

Invoking a Web Service implemented by a process definition The URL for


web services that are implemented by TIBCO BusinessWorks process
definitions is derived from the process name and the path to the process within
the project. In previous releases, this URL was represented in the WSDL file
exactly as it appeared in the project. That is, if there were any spaces or other
special characters (for example, &, /, or =), these characters were not altered in
the URL. Therefore, a client of the web service would use URL encoding to
represent the special characters when requesting the service. This has been
changed in release 5.x so that any special characters in the URL are mangled
and represented using regular characters.
Workaround For projects created in release 2.x and migrated to 5.x, you must
use the new URL. That is, for SOAP Request Reply activities that call web
services implemented by process definitions, refresh the WSDL file that calls
the web service. For web clients, retrieve the new WSDL file before calling the
web service.

TIBCO BusinessWorks Release Notes


70 Release Notes
|

Headers and faults have limited support for SOAP encoding. For example, the
h r e f attribute is not supported for fault details or header elements.

Reading Attachments from Files: When attachments are contained in a file,


the file is read using the system default encoding. There is no way to specify
the expected encoding of the file’s contents.
Workaround: None. This will be addressed in a future release.

Validate for Deployment Errors: WSDL files using special types for
attachments report errors for a missing location attribute when validating for
deployment.
Workaround: Ignore the error. The process definition using the WSDL file will
execute properly.

WSDL Palette

Copy and paste not available for resources in the WSDL palette
(1-7V1IOB): Copy and paste are not available for resources in the WSDL
palette.
Workaround: None.

XML Activities Palette

Namespace information for Transform XML activity is lost (1-6RQI5V): The


Transform XML activity is configured such that the styleSheet has XPath
expressions for both, an input document and another XML document that is
configured as a styleSheet parameter. If the nodes in the parameter document
are namespace prefixed, then Namespace information for the parameter
document is lost.
Workaround: None

xsl:number function in the Transform XML activity: The x s l : n u m b e r


function is not supported in style sheets used by this activity.
Workaround: Do not use the x s l : n u m b e r function.

XML Schemas

Redefine: The < r e d e f i n e . . . > mechanism is not supported in XML


Schemas. If you use a schema with this mechanism, the < r e d e f i n e . . . > is
ignored, and if you attempt to validate your project or resources that use the
schema, errors will occur.

TIBCO BusinessWorks Release Notes


Known Issues 71
|

<include> tags: "Chameleon" schemas: When one XML Schema (XSD)


resource that has a targetNamespace attribute includes a XSD which has no
targetNamespace, the element/type/group reference from the including to the
included schema in this case will not be resolved and will result in error
indications (red highlights) in activities' input and output tabs.
This will be fixed in a future release.

<include> tags: Include context: Schema A defines component X and


includes schema B, which defines component Y. Y's definition references X,
even though B does not include A or any other schema that defines X. This
pattern is sometimes used as a way of expressing "templates" in XSDs.
This case results in error indications in activities' input and output tabs even if
they explicitly reference schema A.
This will be fixed in a future release.

QName (qualified name) conflicts: Two XSDs, A and B, both have the same
targetNamespace (or no targetNamespace) and both define component X. In
that case, they are "mutually exclusive" in the context of the same process
definition. For example, you cannot have two XML Parse activities in the same
process with one configured to use element X from A and the other using
element X from B. This results in error indications in the activities' input
and/or output tabs.
There are warnings when this is about to happen (that is, if the user tries to use
A's X and B's X from the same inline schema editor). The warnings will be
clarified, and a facility for explicitly resolving such QName conflicts at the
process definition level will be added in a future release, however the
fundamental restriction is currently expected to always be present.

TIBCO BusinessWorks Release Notes


72 Release Notes
|

XPath

TIBCO BusinessWorks is fully compliant with the XPath 1.0 specification for
comparing booleans. The resulting behavior is counter-intuitive.
Here is an example for writing expressions comparing boolean data values.
Assume this is part of your process data:
$MyResult/
aBooleanValue

... so a B o o l e a n V a l u e is a boolean inside of the variable $ M y R e s u l t .


The cleanest expression for a boolean condition based on this input is:
$MyResult/aBooleanValue = 'true'

The expressions:
$MyResult/aBooleanValue = true()
boolean($MyResult/aBooleanValue) = true()
string($MyResult/aBooleanValue)=true()
$MyResult/aBooleanValue

will, according to the XPath specification, always return true. Specifically:


• In the first two cases the test is if the element a B o o l e a n V a l u e exists.
• In the third case, the test for comparing a string to a boolean is if the
length(string)>0, so this is true for both true and false values.
• The fourth case is equivalent to b o o l e a n ( $ M y R e s u l t / a B o o l e a n V a l u e )
and, like the first two, tests for the existence of a B o o l e a n V a l u e rather than
its string value.
The way to check a boolean in XPath is to check its textual value. This is how
the XPath specification defines the behavior.

Numbers: XPath converts all numbers regardless of their datatypes to double.


For large positive or negative decimals and integers, there could be a loss of
precision.
Workaround Use a string instead of a number. However, for very small float
and double numbers (for example, 1.4E-45), this will not work.

TIBCO BusinessWorks Release Notes


Known Issues 73
|

TIBCO Designer

If you place a process definition in a custom palette, save the custom palette,
then reopen TIBCO Designer, an error occurs preventing you from reopening
TIBCO Designer.
Workaround: Do not place process definitions in custom palettes. Use custom
palettes for Generic Adapter Configuration resources or other non-process
definition resources. If you encounter this error, navigate to the location where
the custom palettes are stored (this is customizable, but Windows NT, for
example, stores these in your
W I N N T \ P r o f i l e s \ < u s e r > \ . T I B C O \ c u s t o m _ p a l e t t e s directory), and delete
the custom palette containing the process definition.

TIBCO Designer 5.2 Strict Naming Convention: A stricter naming


convention is enforced in this release. The strict naming convention prevents
you from renaming an object by changing case and prevents the use of certain
characters. The strict naming convention must be turned off if you are opening
5.1.x project in Designer 5.2 that contains characters that are illegal in release
5.2.
Workaround: The - D s t r i c t n a m e s flag is used to enforce or relax the strict
naming convention. The flag is set in the d e s i g n e r . t r a file. The default is
true.

• If set to t r u e , the strict naming convention is enforced. This means you


cannot rename an object by changing case. For example, you cannot rename
an object from m y o b j e c t to M y O b j e c t . You also cannot use the following
characters in an object name: | / \ " ' : ? .
• If set to f a l s e , the strict naming convention is not enforced. This means
you can rename objects by changing case. You also can use the following
characters in an object name: | / \ " ' : ? .
The - D s t r i c t n a m e s flag should be set to f a l s e when opening a 5.1.3 project in
TIBCO Designer 5.2 that contains object names which use the disallowed
characters. After opening the project, you should change object names by
removing the disallowed characters and reset the - D s t r i c t n a m e s flag to t r u e .
See the TIBCO Designer Release Notes for more information.

TIBCO BusinessWorks Release Notes


74 Release Notes
|

Closed Issues

This section lists issues that were closed in the releases of TIBCO BusinessWorks
since 5.1.3. The information is organized alphabetically on a per-palette basis,
even though many issues refer to the runtime behavior of the activities.

Closed in
Release Description of Fix

General Fixes

5.4.2 When a user specified the global variable ’BW_GLOBAL_TRUSTED_CA_STORE’ and


tested the connection in Design time, BusinessWorks loaded the trusted certificates
specified at the global variable location. However, if the value of the global variable
was modified by the user, TIBCO Designer did not refresh the already loaded trusted
certificates. This has been fixed. In case the certificates at the specified location are
modified, the user still needs to restart TIBCO Designer to refresh the already loaded
certificates. (1-8B6GPG)

5.4.2 TIBCO BusinessWorks required the user certificate to have "dataEncipherment"


KeyUsage flag in addition to "digitalSignature" and "keyEncipherment", even though
the later two KeyUsage attributes were sufficient to encrypt and sign the SOAP
message. This has been fixed. (1-8EGZZ0)

5.4.2 TIBCO Designer validated projects containing a Get JMS Queue Message activity
without any errors. However, validating the same projects from the command line
using the validateProject utility threw a Null Pointer Exception. This has been fixed.
(1-8D25Y1)

5.4.2 After you create process variables and save the project, the process variables are
stored in a particular order. However, the order of process variables did not remain
the same when the same project was reopened on a different machine. This has been
fixed. (1-81BKIY)

5.4.2 When the Namespace Prefix in the Namespace Registry of the Process Definition
Configuration tab was modifed multiple times, the modifications were not saved
properly and consistently. This has been fixed. (1-81GFR5)

5.4.2 TIBCO Designer hangs and was unable to complete creating a project EAR file when
the project contained a secure JMS Connection shared resource. This has been fixed.
(1-8D9OSW)

TIBCO BusinessWorks Release Notes


Closed Issues 75
|

Closed in Description of Fix


Release
5.4.2 When the JMS Application properties were set for the SOAP RequestReply activity in
a project and a project EAR file was created, the JMS Application properties were not
included in the enterprise archive file. Therefore, the deployed application failed to
run. This has been fixed. (1-8CRQZY)

5.4.2 Audit logs for basic authentication using HTTP, HTTP/s, SOAP, WSSE Username
Profile, etc were not available in TIBCO BusinessWorks. This has been fixed. TIBCO
BusinessWorks log messages in the following format - " A u t h e n t i c a t i o n a t t e m p t
[ u s e r = % 1 , d e p l o y m e n t = % 2 , a u t h e n t i c a t i o n _ s u c c e e d e d = % 3 ] ". (1-8C3EI1)

5.4.1 Test Connection for JMS Connection shared resource failed when any changes were
made to the SSL configuration; or when a global variable was defined to provide the
location of external certificates. Test Connection was successful after restarting TIBCO
Designer. This has been fixed. (1-87FWJZ)

5.4.1 The stack trace in TIBCO BusinessWorks 5.4 did not contain the line about the
process_name and activity_name. The stack trace in TIBCO BusinessWorks 5.2
contained these values, which could lead to compatibility issues. This has been fixed.
(1-89C6AE, 1-85UQRZ)

5.4.0 If a custom activity's process name was same as the process definition’s name where
you included the custom activity, the input and output for the custom activity did not
appear correctly. After making the names unique, the process and the design form
were unusable when the project was reopened. This has been fixed. (1-83EUIB,
1-85IACP)

5.4.0 Internal defect corrections. (1-7BHBH3, 1-7GZ08Z, 1-7GUFGH, 1-7C7FS7, 1-7QZHQY)

5.4.0 Checkpoints that store process data in a database now use column names in the insert
statement. (1-7B4601)

5.4.0 In certain situations, the error "Domain has already been destroyed: <domainName>"
was returned when you clicked the UDDI Servers Module in TIBCO Administrator in
the left-hand frame. This has been fixed. (1-6XVGZI)

5.4.0 Some TIBCO Hawk microagent methods were not available when using dynamically
called subprocesses. This has been fixed. (1-7A3O89)

5.4.0 An incorrect number of tabs was displayed in the TIBCO BusinessWorks plug-in to
TIBCO Administrator if TIBCO BusinessWorks was installed while the administration
server was running. This has been fixed. (1-7AVI4S)

TIBCO BusinessWorks Release Notes


76 Release Notes
|

Closed in Description of Fix


Release
5.3.3 The Subscribe activity was unable to get the value of the datetime parameter in DST
mode even though the Publisher published it with the correct DST. This has been
fixed. (1-81QY9Y, 1-83YTQN)

5.3.3 In a TIBCO BusinessWorks process with the 'check point' activity, if you stopped the
process after a few jobs and restarted it from TIBCO Administrator, the duplicate id
information of the checkpointed jobs was not getting cleared from the duplicates table
in the database. This has been fixed. (1-7ZVY88, 1-83YTRU)

5.3.3 The custom ID of a process is stored in the checkpoint job file. However, the custom ID
became null and inaccessible when a process was recovered. This has been fixed.
(1-7VWRPZ, 1-83YTWO)

5.3.3 TIBCO Designer validated certain projects without any errors. However, validating
the same projects from the command line using the validateProject utility threw Null
Pointer Exception. This has been fixed. (1-6NHJ8D, 1-83YTT3)

5.3.3 If a global variable was used by a process activity which was part of a custom activity
and if you changed its value to a non-default value, referencing the same custom
activity in some other process activity reset the global variable value. So each time the
custom activity was used, it used to reset the global variable value to its default value.
This has been fixed. (1-7AYMM2)

5.3.3 Adding Dlog4j.configuration system property to bwengine.tra file for logging errors
worked correctly for a BusinessWorks project in 5.2.0 but printed errors in console for
the same project in BusinessWorks 5.3.0. This has been fixed. (1-7XP1JJ, 1-83QQT4)

5.3.3 Running a process in TIBCO Designer 5.5.0 in test mode or engine mode failed for a
BusinessWorks project with multiple "Java global instance" resources. This has been
fixed. (1-7V51K3, 1-83QQRY)

5.3.3 An error was thrown in TIBCO Administrator when upgrading from TIBCO
BusinessWorks Release 5.3.0 to later versions. This has been fixed and the error is no
longer thrown (1-717SPO).

5.3.3 In the View Service Instances panel of TIBCO Administrator, clicking the link to a
deployed TIBCO BusinessWorks process instance takes a long time to display. This
has been fixed (1-707MCN).

5.3.3 Internal defect corrections (1-6VPKK9, 1-783KB8).

5.3.3 Under some circumstances, the engine threw an "Internal server error". This has been
fixed (1-74YB92).

TIBCO BusinessWorks Release Notes


Closed Issues 77
|

Closed in Description of Fix


Release
5.3.3 When building an EAR file, in some situations some references were not copied into
the EAR file. This has been fixed (1-75S9PH).

5.3.2 When running in fault-tolerant mode, some microagent methods were not available in
the TIBCO Hawk console. This has been fixed. (1-6QQPPL)

5.3.2 After a graceful shutdown, the engine now returns zero as the exit code. (1-71O2VD)

5.3.2 Unrepresentable characters in the specified encoding in an XML document can now
be escaped. (1-714FXQ)

5.3.1 A formflow process throws an error when run in TIBCO BusinessWorks 5.3.0. This has
been fixed. (1-6Z1C7F)

5.3.0 When a persistent shared variable is located within a folder, the variable state was not
persistent. This has been fixed. (1-5ESXWA)

5.3.0 The Custom ID and Sequencing Key fields on the Misc tab were not displaying
properly. This has been fixed. (1-6KTEGE, 1-6KNA16)

5.3.0 Some characters were causing exceptions when the project’s encoding was set to
ISO8859-1. This has been fixed. (1-6USSA4)

5.3.0 Fixed the problem in which the onProcessRemoved callback function did not return
any data. (1-6LTWHN)

5.3.0 Fixed a NullPointerException when using the sequencing feature. (1-6PWSLI)

5.3.0 Fixed some schema and WSDL reference issues. (1-52OD83)

5.3.0 Fixed namespace problems when copying and pasting resources by including the
schema or WSDL import info with the activity on the clipboard. This now works as
long as the namespace information in the original resource is correct. (1-1QBNZP)

5.3.0 A NullPointerException was thrown during pager initialization when the disk is full.
A better error message is now provided. (1-65M571)

5.3.0 Addressed a NullPointerException error when the engine is shut down via Control-C.
(1-65K2GI)

5.3.0 The Checkpoint activity was producing the wrong error message. This has been fixed.
(1-4FRWLY)

TIBCO BusinessWorks Release Notes


78 Release Notes
|

Closed in Description of Fix


Release
5.3.0 Fixed a defect where the Error tab during test mode showed the incorrect information.
(1-605ZP5).

5.3.0 The RestartedFromCheckpoint flag was not set properly when the checkpoint is
configured in a sub-process. This has been fixed. (1-5O0FOX)

5.3.0 PluginProperties was not initialized properly. This has been fixed. (1-62KGCW)

5.3.0 The iteration element is not visible in a nested group when it depends upon the
iteration element of the parent group. This has been fixed. (1-5I9XGW)

5.3.0 Fixed the case sensitivity issue so that explicitly identified . j a r files can show up in
the Class Browser dialog. (1-3IH3CD)

5.3.0 Usage of global variables in some cases was not reported properly by validate for
deployment. Properly used global variables were sometimes reported as unused. This
has been fixed. (1-5EKUES)

5.2.1 During project validation, some global variables were marked as unused, even though
they were used. This has been fixed. (1-27R2AT)

5.2.1 The Input tab was not always updated properly after a change in an activity’s
configuration. This has been fixed. (1-1MFBLB)

5.2.1 A thread deadlock situation may occur after a call process is spawned on multi-CPU
machines. This is now fixed. (1-4V5BO9)

5.2.1 Unused process imports are generating erroneous errors when running 'Validate for
Deployment'. These unused process imports will no longer cause any errors to be
generated in 'Validate for Deployment'. (1-4U9O33)

5.2.1 The TIBCO BusinessWorks engine was not reflecting the correct status in TIBCO
Administrator after a deployed fault-tolerant engine changes state from RUNNING to
STANDBY. (1-4NQTID)

5.2.1 The Sequencing Key field on the Misc tab was not working properly when a
subprocess is called. This has been fixed. (1-44IFDT)

5.2.1 When the referencing process is not added to the list of items to debug, an infinite loop
can occur. This has been fixed by automatically including the referencing process.
(1-49542Q)

5.2.1 In some situations, both primary & secondary fault-tolerant engines are "activated".
This has been fixed. (1-3K6UJW)

TIBCO BusinessWorks Release Notes


Closed Issues 79
|

Closed in Description of Fix


Release
5.2.1 In some situations, projects using dynamically called subprocesses would not work
properly when deployed. This has been fixed. (1-4BCIN3)

5.2.1 An exception was thrown when the command-line utility b u i l d e a r was used to
create an EAR file for projects containing process definitions. The EAR file was
correctly generated, but the exception should not be thrown. This has been fixed.
(1-3ROETI)

5.2.1 When an XSD is moved or renamed, not all references to the schema are changed.
Now the schema location is correctly updated. (1-21V3HA)

5.2.1 In some situations, all resources in a project are included in an EAR file instead of just
the resources used by the processes included in the project. This has been fixed.
(1-4HN9M1)

5.2.1 When nested groups are minimized, their location is not saved properly and some
items within the group may no longer be visible. This issue has been fixed for single
nested groups; now the group size and the activities in it maintain their correct
locations on save/reopen when the group is minimized. (1-34C6G6, 1-34C6HL)

5.2.1 The Apply button was disabled after an option from the Statement right-click menu
was selected in the Input tab (for example, selecting Statement->Surround with
Choice). This has been fixed. (1-1W5NI8)

5.2.0 During process instance recovery, checkpointed jobs were restarted in last-in-first-out
(LIFO) order instead of first-in-first-out (FIFO) order. This has been fixed. (1-32HN1C)

5.2.0 An error is returned when validating a project for deployment and there are spaces
around process variable names in XPath expressions in a group Configuration tab.
This has been fixed.

5.2.0 XSDs used to specify types for process variables are not automatically added to
Enterprise Archive (EAR) files when the EAR file is created. This has been fixed.
(1-26CHLO)

5.2.0 Process starters can hang when process instances are paged out of memory. This has
been fixed. (1-20ZLW5)

5.2.0 XSD resources referenced in End or Generate error activities were not automatically
added to Enterprise Archive Files. This has been fixed.

5.2.0 When an engine is running in fault-tolerant mode, enabling verbose tracing causes an
exception. This has been fixed. (1-20SDXO)

TIBCO BusinessWorks Release Notes


80 Release Notes
|

Closed in Description of Fix


Release
5.2.0 "Wait For" activities within dynamically loaded processes did not get activated. This
has been fixed.

5.2.0 When only the Runtime option is selected during installation, p l u g i n s . j a r is not
installed. This has been fixed. (1-1XG2MH, 1-1XATKX)

5.2.0 Event listeners (for example, the listener required for a Wait for Rendezvous Message
activity) were not started when the engine started if the listener is required by an
activity within a dynamically called process. This has been fixed. (1-216J2Q)

5.1.3 In TIBCO BusinessWorks 2.x, dragging and dropping a process definition from the
project panel to the design panel of another process definition inserted an
appropriately configured Call Process activity. This functionality was not present in
release 5.1.2. This functionality has been reintroduced as of this release.

5.1.3 In previous releases when using a database for storing process engine information, the
database prepared statement cache index was not being reused causing extra
statements to be added to the cache. This eventually caused a maximum number of
open cursors error. This has been fixed.

5.1.3 In previous releases, references in an activity’s input to process variables that are
undefined only caused an error when the activity was run. In this release, when a
process definition is initialized in the process engine, any runable activity that has a
reference to an undefined variable causes an error.
For example, you have a process definition with a Create File activity that references
output from an FTP activity, and these activities are contained in a group that executes
only when a conditional transition is taken. In previous releases, if you delete the FTP
activity the process engine could be started and the process instance run, and it would
encounter an error only when the Create File activity is executed. In this release, the
error is caught when the process definition is loaded into the process engine.

5.1.3 Dynamically calling a subprocess caused problems during a failover of a fault tolerant
engine. This has been fixed.

5.1.3 Selecting an element in a schema (for example, when you use the Browse button to
display available schemas for an XML element reference in an Editor tab) with a very
large number of names (for example, thousands of names) locks TIBCO Designer for a
long period of time. This has been fixed.

TIBCO BusinessWorks Release Notes


Closed Issues 81
|

Closed in Description of Fix


Release
5.1.3 When using SSL for authentication (several activities can use SSL) and there are files
that are not certificates in the folders specified for identities or trusted certificates, an
error could occur. This has been fixed so that any non-certificate files cause an
warning to be logged, but no exception will be raised.

5.1.3 Global variables that were not of type "String" were displayed as strings in the Process
Data area of an Input tab. For example, if a variable was of type "Number", it was
displayed as a string. This has been fixed so that the proper type and icon is used
when displaying the global variable.

5.1.3 When testing process definitions, the execution of the currently running process is
slower when using a language pack (such as Japanese). This has been fixed.

5.1.3 Checkpoint data for process instances started by a service agent did not get deleted
properly. This has been fixed.

5.1.3 Groups would sometimes display invalid transition lines (lines that connected to no
activity) and labels for transitions into and out of groups were sometimes placed in
the wrong location. This has been fixed.

5.1.3 When you add a process starter (for example, File Poller or Timer) and name the
process starter "Start", errors occur when you try to save and reopen the project. This
was due to a naming conflict with the Start activity and has been fixed in this release.

5.1.3 When a Sybase database was used for storing engine data (for example, checkpoint
information), errors occurred. This functionality is supported, but enabling it required
altering the process engine properties in the deployment configuration. This has been
fixed so that Sybase databases can be used without altering the deployment
configuration.

5.1.3 Cutting and pasting into a group did not work properly. This has been fixed.

5.1.3 When the process engine is shutdown, threads for connecting to the project repository
are left running. This has been fixed.

5.1.3 The D a t a element of the default $ _ e r r o r schema was unable to be coerced into a
specific type. This has been fixed.

5.1.3 Displaying certain process definitions took more than a few seconds in some cases.
This has been fixed.

5.1.3 Input and Error Output tabs were sometimes missing from activities added to nested
groups. This has been fixed.

TIBCO BusinessWorks Release Notes


82 Release Notes
|

Closed in Description of Fix


Release
Migration

5.4.2 When a TIBCO BusinessWorks project was migrated from version 5.2 to version 5.4
and opened in TIBCO Designer 5.5, the <SOAP: address> element displayed in the
WSDL Source tab for the SOAPEventSource activity was incorrect. The URL in the
<SOAP: address> element was modified such that, after migration, every occurrence of
two consecutive underscore characters was replaced by a single underscore. This has
been fixed by providing a custom property,
b w . p l u g i n . s o a p . u r i E n c o d i n g . 5 2 c o m p a t i b l e , that can be set in
<TIBCO_HOME>\ d e s i g n e r \ 5 . 5 \ b i n \ d e s i g n e r . t r a .
Set the property b w . p l u g i n . s o a p . u r i E n c o d i n g . 5 2 c o m p a t i b l e to true to ensure the
value of <SOAP: address> remains unchanged after migration. (1-86A7LD, 1-8CKGHX)

5.4.0 During migration of TIBCO BusinessWorks project from version 5.2 to version 5.4, the
HTTP Receiver activity received partial data through HTTP POST. This has been
fixed. (1-83OL8E, 1-85IAC5, 1-81HVZJ)

5.2.1 When a project created before release 5.2.0 is opened, there could be mapping
problems in the Checkpoint activity. This has been fixed. (1-4C4TVB and 1-4BDXVM)

5.1.3 Attributes inside leaf nodes were not always automatically populated properly. This
has been fixed.

5.1.3 Several errors when migrating mappings have been fixed.

5.1.3 In some situations, migration of JDBC activities that had dates in input or output data
did not convert correctly. This has been fixed.

5.1.3 Optional-to-optional elements mapped in 2.x do not migrate properly if the schema
changes in 5.x. This has been fixed.

5.1.3 Migration errors and warnings were not written to a log if the repoconvert.ini file
specified a log. This has been fixed and errors and warnings are now written to the
specified log file.

5.1.3 WSDL files in migrated projects sometimes do not properly resolve the location of
referenced schemas. This has been fixed.

5.1.3 Processes that contain illegal XML characters caused migration to crash. This has been
fixed.

TIBCO BusinessWorks Release Notes


Closed Issues 83
|

Closed in Description of Fix


Release
Mapping

5.3.3 The "Mapping wizard" was creating empty tags for each optional element even if the
optional elements did not appear in the input data. To avoid the empty tags in the
output when the input did not contain the optional element, the user had to manually
create "xsl:if" statement. This is fixed and a new system property
"automatic_mapper_if_surround" is added. (1-777VIX, 1-85QMCN,)

5.3.0 The mapper now handles an AESchema resource that is moved to a new location
automatically. (1-1N6XNP)

5.2.1 The mapper activity now maps t e x t ( ) fields correctly. (1-553U5T)

5.2.1 The Mapper Check and Repair button was mistakenly reporting an error with
unescaped ampersands, and then fixing the problem incorrectly. This has been fixed.
(1-4TMPPX)

5.2.1 Regular expression restriction (in the Mapper) is now enforced at run time.
(1-3Z4SAK)

5.2.0 In a for-each group, the XSLT "select = 1 to 10" is now supported. (1-1XUYOC)

5.2.0 The c o m p a r e - d a t e ( ) XPath function threw an error in TIBCO Designer but executed
successfully at runtime when using valid date formats. This has been fixed.

5.2.0 The Nillable to Optional XPath formula was not always applied correctly. This has
been fixed. (1-25Z3PV)

5.1.3 When setting a coercion on an element within a repeating element, the cardinality of
the coerced element was improperly displayed (that is, the coerced element was listed
as repeating when it’s parent is the repeating element). This has been fixed.

5.1.3 A warning was sometimes incorrectly returned when n a m e ( ) is used in search


predicate of an XPath statement for a repeating element. This has been fixed.

5.1.3 Coercions on Process Data in the Input tab appeared to be lost when the activity was
within a group. This has been fixed.

5.1.3 Coerced data in one activity did not show up as coerced in subsequent activities. This
has been fixed.

5.1.3 Coercions nested within other wildcards caused the outer wildcard to be coerced as
well. This has been fixed.

TIBCO BusinessWorks Release Notes


84 Release Notes
|

Closed in Description of Fix


Release
5.1.3 When global variables are added, changed, or renamed, the change now appears
immediately in the Input tab.

5.1.3 Automatically generated mappings were sometimes incorrect for complex formulas.
This has been fixed.

5.1.3 The mapping wizard sometimes erroneously asked if you would like to create a
copy-of or copy-contents-of when the mapped types were similar, but not identical.
This has been fixed.

5.1.3 On UNIX systems, schema trees were not always displayed properly when using the
mapping wizard dialog. This has been fixed.

ActiveEnterprise Adapter Palette

5.4.2 The ActiveEnterprise adapter subscriber plug-ins supported only top level coercions
and did not support nested level coercions for AE messages. This has been fixed.
(1-8EL3TV)

5.4.2 Optional sequences caused TIBCO Designer to throw Null Pointer Exceptions and
sometimes hang while applying coercions. This has been fixed. (1-8E6V7A)

5.4.1 The ActiveEnterprise adapter subscriber filtered the additional fields of an AE


message when the subscribing schema fields were a subset of the publishing schema
fields. This has been fixed. ActiveEnterprise adapter subscriber plug-ins now provide
type coercions for AE messages. (1-5WQUGY, 1-870W0V)

5.4.0 When two Adapter Request Response servers subscribed to the same subject, the first
server deleted the message as soon as the message was received whereas the second
server got a Null Pointer Exception when referring to the same message. This has been
fixed. (1-79B2E5, 1-83YTU9)

5.3.3 The Adapter Request Response Server activity stopped processing and threw a Null
Pointer Exception ONLY when it received a non-AE message. After the exception, it
was not able to process any more messages. This has been fixed. (1-84ZWIJ, 1-870VY7)

5.3.3 The number of JMS sessions used by the Adapter Subscriber activity kept on growing
as messages were subscribed. This resulted in a large number of open sessions over a
period of time. This has been fixed. (1-78PIET)

5.3.3 The Publish to Adapter activity was not overriding the subject when the
RequestReply field was checked. This has been fixed (1-77A4NE).

TIBCO BusinessWorks Release Notes


Closed Issues 85
|

Closed in Description of Fix


Release
5.3.3 When using the Adapter Subscriber process starter, the TIBCO Hawk microagent
method reviewledger method fails after the first execution. This has been fixed
(1-6W8UU0).

5.3.3 The Publish to Adapter activity is not using the ReplySubject when used in
request-reply mode. This has been fixed (1-734Y6S).

5.3.2 One-way ActiveEnterprise operations using the RV transport no longer experience a


memory leak. (1-72Q5T7)

5.3.1 Unexpected behavior occurs when using the RVCMQ transport and the process
instance containing the scheduler is halted unexpectedly. This has been fixed.
(1-6XEBCA)

5.3.1 The ActiveEnterprise Subscriber activity no longer throws an exception after the JMS
server restarts. (1-6Z9TST)

5.3.0 When an XML message with an Any type attribute was published by TIBCO
BusinessWorks to an adapter, the Any type is substituted with a string. TIBCO
BusinessWorks did not send the x s i : t y p e correctly, and as a result an SDK adapter
threw an exception. This has been fixed. (1-6FCK3O, 1-6MT0VY)

5.3.0 Choice elements at the top-level were not always picking the correct schema for
incoming messages. This has been fixed. (1-6SP0TL)

5.3.0 Fixed a problem in the Adapter Request-Response service activity, where a new
thread was created with each new request. This happened when the Subject name was
specified in the configuration tab to replace the default adapter Subject name.
(1-6KDLV8)

5.3.0 Fixed a memory leak encountered when using Max Jobs with the Adapter Subscriber
process starter. (1-6N8JMD)

5.3.0 The Publish to Adapter activity published the datetime value incorrectly when the
datetime value had "00" in milliseconds. This has been fixed. (1-6ILYBQ)

5.3.0 Invoke an Adapter Request/Response Service activity using JMS as a transport


creates lot of UDP connections. This has been fixed. (1-336DLU)

5.3.0 A deserialization exception occurred when an unsigned integer value greater than 231
is published from a C++ adapter (for example, SAP) to TIBCO BusinessWorks. This
has been fixed. (1-6H19MN, 1-6MT133)

TIBCO BusinessWorks Release Notes


86 Release Notes
|

Closed in Description of Fix


Release
5.3.0 Fixed the 'Not permitted for Distributed CM transport' error in the case of a RPC
server used in RVCMQ mode trying to send a reply. (1-69U9QM, 1-692RAG)

5.3.0 When the Transport Type is set to Tibrv Certified Message Queue, the fields Scheduler
Heartbeat and Scheduler Activation were set to the incorrect unit seconds. They are
now corrected to use milliseconds as the unit. (1-6BW5F6)

5.3.0 Fixed a problem where the process engine was hanging when flow control is used
with ActiveEnterprise Adapter activities. (1-61CWAA)

5.3.0 Validate was not finding some missing mandatory elements in the input. This has
been fixed. (1-5EDM75)

5.3.0 Under certain circumstances, when an RVCMQ listener process is suspended, a hung
worker can result (when using certified messaging) or loss of a message can result
(when using reliable messaging). This has been fixed. (1-5AHBCQ)

5.3.0 Fixed a problem where activities using the JMS transport did not use the reconnected
JMS connection after it failed the previous execution when the JMS server is down.
(1-5PGTU8)

5.3.0 When confirming an ActiveEnterprise subscriber activity, a timeout exception was


thrown for the first RVCM message, all subsequent messages did not receive the
exception. The pre-register listener was not set on the publisher side and in this case
the first message was sent as an RV message. The adapter SDK used to ignore this
message and not confirm at all. Now we throw an exception which is a different
behavior. (1-5ELHZT)

5.3.0 A serialization exception is thrown in some situations when using unsigned integer
fields within Operation schemas. This has been fixed. (1-5TUO09)

5.2.1 The ActiveEnterprise Adapter palette now supports the flow control features
introduced in Release 5.2.0. (1-3HA85C, 1-2QF2KX)

5.2.1 Validate was not finding some broken references. This has been fixed. (1-4IQQYX)

5.2.1 A serialization exception is thrown in some situations when using unsigned integer
fields. This has been fixed when the activities communicate with the SAP adapter and
some other adapters, but this remains a problem for some adapters. (1-3SWI9D,
1-405IF0)

TIBCO BusinessWorks Release Notes


Closed Issues 87
|

Closed in Description of Fix


Release
5.2.1 An adapter JMS RPC client crashes when TIBCO BusinessWorks sends a reply with
closure data. TIBCO BusinessWorks was not setting the x s i : t y p e properly when
publishing data of type Any. This has been fixed. (1-3SFSB2, 1-1Z0S7B, 1-4G9NPT, and
1-1ZHYIB)

5.2.0 Global variables in certain fields were causing errors when attempting to validate the
project for deployment. This has been fixed. (1-2MD6E7)

5.2.0 The Publish to Adapter activity created an unnecessary durable subscriber if


replySubject was provided. This has been fixed. (1-1WAXBC)

5.2.0 The ledger file created by a Publish to Adapter activity within a project run in test
mode is locked until TIBCO Designer is closed. This has been fixed so that the lock is
released when the test engine is stopped. (1-23BJ0A)

5.2.0 The Adapter Subscriber and Publish to Adapter activities did not support input
classes that have a choice or AE union element as the top-level element. This has been
fixed.

5.2.0 Specifying Complete Time on the Transport tab of an Adapter Subscriber activity that
uses the RVCMQ transport had no effect in release 5.1.3. This has been fixed.
(1-216KTF)

5.2.0 Adapter Subscriber activities were not properly deserializing messages that contained
sequences where each element could be any type. This has been fixed.

5.2.0 When the RVCM transport is used, using more than one global variable in the Ledger
File field generated the wrong ledger name. This has been fixed. (1-242MBJ)

5.1.3 When using the Publish to Adapter activity with a JMS transport, an error occurred if
the destination is specified on the Transport tab but not in the subject element on the
Input tab. Also, even if the replySubject input element is specified, the JMSReplyTo
header field is null. These issues have been fixed.

5.1.3 In release 5.1.2, if there are two different ActiveEnterprise Classes with different
names but identical sub-level nodes, the Adapter Subscriber activity did not
differentiate incoming messages containing the different classes. This has been fixed
so that now the Adapter Subscriber throws a deserialization exception, if the incoming
message does not have the correct top-level node.

TIBCO BusinessWorks Release Notes


88 Release Notes
|

Closed in Description of Fix


Release
5.1.3 The Publish To Adapter activity failed when the c u r r e n t - D a t e T i m e ( ) function was
used with a DateTime datatype with the error, "Error serializing the message." The
c u r r e n t - D a t e T i m e ( ) method returns the DateTime with a UTC offset.The datatype
'DateTime' does not expect the offset or TimeZone information. The offset is now
removed when this function is used with this activity.

5.1.3 When the Publish To Adapter activity is configured to use a RVCMQ transport, the
publisher used the reliable transport instead of the RVCM transport. This has been
fixed.

5.1.3 The Refresh Adapter Service button did not always refresh all adapter service
characteristics. This has been fixed.

5.1.3 When a reply subject is specified in a Publish to Adapter activity that uses the JMS
transport, the specified Time to Live is ignored. This has been fixed.

5.1.3 Attributes of type x s i : n i l in messages published in XML format were not handled
properly. This has been fixed.

5.1.3 Illegal XML characters were not handled properly when sent to or received from an
adapter. This has been fixed.

5.1.3 When an Adapter Subscriber process starter specifies a durable subscription name for
a JMS Topic transport, the durable subscription is registered in the JMS server, but
messages can still be potentially missed when the process engine stops. This has been
fixed.

5.1.2 When a process engine is shut down, any pre-registered RVCM listeners are
unregistered. This is problematic for any publishing activity that pre-registers its
RVCM listeners. This has been fixed.

File Palette

5.4.1 The File Rename activity threw an IO Exception when the file being renamed was
locked for use by another application. The error occurred as the activity was unable to
delete the original file after the new file was created and the contents copied to it. This
has been fixed. (1-83LK3S)

5.4.0 Under certain conditions, the File Poller was throwing an


ArrayIndexOutOfBoundsException. This has been fixed. (1-7MSKMO)

TIBCO BusinessWorks Release Notes


Closed Issues 89
|

Closed in Description of Fix


Release
5.3.0 The File Poller was throwing a null pointer exception when the filename is omitted
from directory path (for example, specifying C : \ a \ b \ instead of specifying
C : \ a \ b \ * . * ). This has been fixed. (1-5MIDAA)

5.3.0 The File Poller does not sort properly when sorted by Date Modify in Ascending
order. This has been fixed. (1-3HXV4O)

5.3.0 File Poller process starter triggered a modify event on MS Windows 2003 when a file
was deleted while the poller was only configured to trigger on create and modify
events. This issue has been fixed. (1-614M9A)

5.2.1 The File Poller process occasionally threw "ArrayIndexOutOfBoundsException" while


tagging the files. Once the exception was thrown, it continued throwing exceptions
(approximately one per file) until TIBCO BusinessWorks engine shutdown and
restarted. This has been fixed. (1-7FTIQL)

5.2.1 The File Reader activity was fixed in Release 2.0.6 to strip the byte order mark (BOM)
from Microsoft Windows files that specify the UTF-8 encoding. The correct 2.0.6
behavior is documented and expected, however, this fix was not properly applied to
Release 5.x. This release reintroduces the fix from 2.0.6 and uses the documented
parameter j a v a . p r o p e r t y . D i s c a r d U T F 8 B O M to disable the functionality and restore
compatibility to pre-2.0.6 behavior. (Original defect ID from release 2.0.6: 1-UK8N5,
new defect ID in release 5.2.1: 1-3G77B4)

5.2.1 A fix to handle localized content in the File Poller process starter, which otherwise
produced NoSuchMethodError. (1-4RP1D1)

5.2.1 Checking the Poll for Create Events field on the Advanced tab of File Poller was also
causing the process starter to poll for deletion events. This has been fixed. (1-4FFXF7)

5.2.1 Wildcards did not work properly when specified with the root directory in the File
Poller process starter. This has been fixed. (1-4FFXCS)

5.2.0 Certain wildcard patterns did not find the correct list of files in the File Poller and List
Files activities. For example, * . D A T would not find t e s t . 1 . D A T. This has been fixed.
(1-2F8NO5)

5.1.2 The File Poller process starter was unable to poll from the root directory when certain
wildcard patterns were specified. For example, C : \ * . t x t would not work, but
C : \ t * . t x t or C : \ t e m p \ * . t x t does work. This has been fixed.

TIBCO BusinessWorks Release Notes


90 Release Notes
|

Closed in Description of Fix


Release
FTP Palette

5.4.1 TIBCO BusinessWorks was not able to access a FTP Server and gave a
StringIndexOutOfBoundsException when the FTP Server returned an empty first line
after connection. This has been fixed. (1-85CJL6)

5.3.0 The timeout was not set when using Active Connections. This has been fixed.
(1-6M1ESK, 1-6M1EI4)

5.3.0 Improved the FTP Dir activity behavior when directory is empty. (1-59MRZQ)

5.3.0 Timeout parameters specified for FTP Get and FTP Connection resources are not
honored. This has been fixed. (1-6M15HD)

5.2.1 FTP to VMS systems no longer fails. (1-4UHPHR)

5.2.1 If the FTP Connection becomes stale, FTP activities will now try to re-connect.
(1-42EH46)

5.2.1 The timeout set in the FTP Connection resource was not being used by the FTP
Activities. This has been fixed. (1-4QY707, 1-4ML3UY)

5.2.0 The FTP Delete File activity did not work properly with MS Windows FTP servers.
This has been fixed. (1-24ITCX)

5.2.0 The FTP Dir activity returned item count = 1 even if the directory did not exist. This
has been fixed.

5.2.0 FTP Put was stripping /n when /r/n was used as the end of line character. This
caused the file to be unusable when put onto a VMS machine from a MS Windows
machine. This has been fixed so that the proper behavior occurs, however, the
b w . p l u g i n . f t p . s t r i p L i n e F e e d I n P u t property has been added to specify the old
behavior, if you rely on the old behavior in your applications. (1-2549ZL)

5.1.2 In previous releases, no FTP activities could be used to access FTP servers outside of a
firewall. Now FTP Put and FTP Get can be used to access servers by way of a proxy
server (using the Firewall and Proxy fields on the FTP Connection resource).
However, only FTP Put and FTP Get can be used, no other FTP activities can use a
proxy server.

5.1.2 Passwords are now encrypted and obfuscated in the project.

TIBCO BusinessWorks Release Notes


Closed Issues 91
|

Closed in Description of Fix


Release
General Activities Palette

5.4.1 The Custom Activity resource changed a predefined global variable of type
’password’ to ’string’ and displayed the password in clear text on the GUI when the
Custom Activity was used in a different project. This has been fixed. (1-88KWYN)

5.4.0 Icons specified for custom activities sometimes disappeared when the project was
subsequently opened. This has been fixed. (1-75H3DV)

5.4.0 The External Command activity dropped double quote (") characters from the input
command. This has been fixed. (1-77LYAH)

5.3.3 Although the execution control was passed to the Catch activity when the Call process
activity threw a binding exception, an error transition did not happen. This has been
fixed. (1-79MUS0)

5.3.3 Updating a process containing a custom activity no longer slows down the system
(1-76UWNV).

5.3.3 Under certain situations, using Wait and Notify activities caused the engine to hang.
This has been fixed (1-75GL0W).

5.3.0 The correct information is not returned when the process definition name is provided
on the Input tab of the Engine Command activity for the Get Process Instance Info
command. This has been fixed. (1-6R8XGF)

5.3.0 The Inspector activity was not updated properly after a referenced activity was
renamed. This has been fixed. (1-5SC97Y)

5.3.0 Wait/Notify and Checkpoint activities did not reinitialize stale database connections
in the connection pool. This has been fixed. (1-6OEUDZ, 1-6OEUD9)

5.2.1 The Timer process starter was not working properly when a localized time interval
was specified. (1-5E3FRH)

5.2.1 Setting a breakpoint was available on the pop-up menu for Label activities, but
breakpoints are not permitted on these activities. This option has been removed from
the Label activity. (1-2100P8)

5.2.1 The external command activity was not properly closing open files after the activity
completed executing. This has been fixed. (1-3WTU1Y, 1-4NLLU7)

5.2.1 Under certain conditions, process definitions hang when executing the Generate Error
activity. This has been fixed. (1-4TMJXH)

TIBCO BusinessWorks Release Notes


92 Release Notes
|

Closed in Description of Fix


Release
5.2.1 The choice list for the Confirm activity and other activities was not updated properly
when process starters or wait for... activities were deleted. This has been fixed.
(1-3SRCA1)

5.2.0 In some situations, Timer process starters with the Run Once field checked were
starting processes immediately instead of waiting for the specified start time. This has
been fixed. (1-26MD2A)

5.2.0 Call Process activities were raising the wrong exception. The output instead of the
input error was shown when calling subprocess. This has been fixed. (1-3JORBO)

5.2.0 When the Inspector activity appears within a group, the activity choice box did not
work correctly. This has been fixed. (1-216TH9)

5.2.0 When you specify the Command to Execute field on the Configuration tab of the
External Command activity, a mapping error occurs even though all input elements
are optional. This has been fixed. (1-1SVZ0B)

5.2.0 The External Command activity experienced problems on Unix systems when the
command to execute contained a quoted string (for example, e c h o " H e l l o t h i s i s
a t e s t m e s s a g e " ). This has been fixed. (1-1B1WNM)

5.2.0 The calendar in the Start Time field in the Timer process starter sometimes did not
work properly when the locale is not the United States. This has been fixed.
(1-11E2N5)

5.1.3 Dynamically calling a subprocess did not work in certain situations. This has been
fixed.

5.1.3 Dynamically calling a subprocess caused problems during a failover of a fault tolerant
engine. This has been fixed.

5.1.3 Timer process starter did not account for daylight savings time appropriately. This has
been fixed. Also, the timer process starter started a process when the engine started if
the start time is configured to be before the engine starts. The Timer process starter has
been changed so that periodic intervals cause a process to be started, but no process is
started for intervals that occur before the process engine starts.

5.1.3 Call Process activities did not always list all available processes in the drop-down list
of the Process Name field on the Configuration tab. This has been fixed.

TIBCO BusinessWorks Release Notes


Closed Issues 93
|

Closed in Description of Fix


Release
HTTP Palette

5.4.2 When the size of the incoming data (POST) was greater than 2M, the HTTP Receiver
threw the exception j a v a . l a n g . I l l e g a l S t a t e E x c e p t i o n : P o s t t o o l a r g e . The
exception was because Apache Tomcat 5, by default, sets the maximum size of the
acceptable HTTP POST request to 2M. This has been fixed by enforcing the value of
m a x P o s t S i z e to zero (0) which disables the limit for m a x P o s t S i z e . (1-8F2135)

5.4.0 The HTTP Receiver activity did not parse the post data content according to the
Content-Type of the HTTP request header. This has been fixed. (1-7ZCWEB,
1-85IAD9)

5.4.0 SOAP Event Source and HTTP Receiver return "process initialization failed for..." error
when using JRE 1.5.0 and TRA 5.4.0 on AIX 5.3. This has been fixed. (1-7BBPSJ)

5.3.3 TIBCO BusinessWorks SOAP and HTTP server threw errors while handling 100
concurrent client requests. This is fixed by exposing the Tomcat property
A c c e p t C o u n t . You can tune the engine performance by configuring the
b w . p l u g i n . h t t p . s e r v e r . a c c e p t C o u n t property in the b w e n g i n e . t r a file.
(1-84M057)

5.3.3 The custom engine property bw.plugin.http.client.ResponseThreadPool.type now


allows you to specify whether a single thread pool is created for all SOAP and HTTP
request/response activities or whether a thread pool for each activity is created.
Specify single as the value for this parameter to create a single thread pool for all
activities. Specify default as the value for this parameter to obtain the default behavior
of one thread pool per activity.
The property bw.plugin.http.client.ResponseThreadPool continues to control the size
of the thread pool (1-785003).

5.3.3 When the content-type of an incoming message was "multipart/*", the first part of the
message was presented as the POSTDATA. This is incorrect according to RFC 2388.
The bw.plugin.http.handleAllMimePartsAsAttachment property fixes this problem.
If this property is set to true and the top-level content-type of the incoming HTTP
message is "multipart/*", then an HTTP Receiver will present all the MIME parts as
attachments and the POSTDATA field will be empty. If this property is set to false (the
default value), backward compatibility is maintained and the first MIME part is
presented as the POSTDATA
Note: Do not check the Parse Post Method Data field on the HTTP Receiver process
starter when this property is set to true. This causes an error to be thrown. (1-76B6G1).

TIBCO BusinessWorks Release Notes


94 Release Notes
|

Closed in Description of Fix


Release
5.3.3 When Content-type is not specified in a multi-part message, TIBCO BusinessWorks
now assumes a default type of text/plain (1-778HU3).

5.3.0 Single-part messages that do not have Content-Length specified in the header and
have non-empty message bodies are now accepted by the HTTP Receiver. (1-5KZSQT)

5.3.0 When an HTTP message with attachments was received by HTTP Receiver, the
parameters in the root part were not parsed properly. This has been fixed.
(1-6NBQPH)

5.3.0 The Send HTTP Response activity was converting the HTTP status message to upper
case. This has been fixed. (1-6D15E8)

5.3.0 Send HTTP Request was unable to send a null value for a parameter. This has been
fixed. (1-4W1VL1)

5.3.0 Specifying ? / ? in the Directory field on the Advanced tab of the HTTP Receiver
process starter did not result in the correct behavior. This has been fixed. (1-6M143O)

5.2.1 The Send HTTP Request activity throws ClassCastException at runtime if 'multipart'
content-type is used. This has been fixed. (1-54Q2MH)

5.2.1 For Wait for HTTP Request, the Parse Post Method Data checkbox was incorrectly
remaining set after a switch from String style to Binary Style, and caused "Output data
invalid" when running the project. This has been fixed (1-4AZA0I)

5.2.1 The HTTP Response activity was converting header keys and values to lower case.
This has been fixed so that header keys are lower case, but header values maintain the
same case as the supplied value. (1-3PB930)

5.2.1 Fixed a Null Pointer Exception that occurs when the 'Requires Client Authentication'
field is not set for HTTP Connection/Configure SSL. (1-21CKO9)

5.2.1 The security context was not output when using deferred client authentication. This
has been fixed. (1-3SD5N7)

5.2.0 The SSL Verify Host Name option was not working properly. This has been fixed.
(1-2FKP5F)

5.2.0 Configuring HTTPS using the Identity resource did not work properly on Linux
platforms. This has been fixed. (1-3H4TQH)

TIBCO BusinessWorks Release Notes


Closed Issues 95
|

Closed in Description of Fix


Release
5.2.0 When using the Send HTTP Request and attempting to use SSL, using an Identity
resource configured to use Certificate/Private Key did not work properly. This has
been fixed. (1-2631LX)

5.2.0 Connections are automatically closed after sending HTTP requests in TIBCO
BusinessWorks. This helps to ensure that connections are not held open longer than
needed and the HTTP server does not reach its connection limit. (1-25UTW8)

5.2.0 Fixed a NullPointerException in the Send HTTP Request Activity. (1-1YUXTM)

5.2.0 When using HTTPS with a proxy server, the engine throws a
NoRouteToHostException. This has been fixed, but it requires upgrading to TRA 5.2.0
or later. (1-1R3T2Q)

5.2.0 Using HTTPS through a proxy server did not work prior to TIBCO BusinessWorks
5.1.3-hotfix4 and TRA 5.1.3-hotfix 3. This has been fixed, and this will work, provided
that you have installed the latest TRA and TIBCO BusinessWorks releases. (1-1TTPZK)

5.1.3 Performance of HTTP activities was not the same in release 5.1.2 as it was in previous
releases. Performance of these activities has been improved in this release.

5.1.3 The Set-Cookie output element of the Send HTTP Request only contained the last
cookie set. Also, HTTP Response activity only sent one cookie, even if multiple
cookies were supplied in the activity’s input. This has been fixed.

5.1.3 When sending multiple responses, the reason phrase of the status line was omitted in
subsequent responses after the first response. This has been fixed.

5.1.3 In some cases, multiple "Connection" headers can be sent by the Send HTTP Response
activity (usually this can occur in projects migrated from previous releases). This has
been fixed.

5.1.3 When a socket exception is thrown when running a process definition, some resources
may not be properly released. For example, if you have two ports defined for
incoming HTTP requests in the project, but one of them is in use by a different
application when the project is run, the other port is not released. This has been fixed.

5.1.3 The Send HTTP Request activity displayed all headers in the output response message
in previous releases. In Release 5.1.2, this was changed so that only headers you
specify in the Output Headers tab are displayed. Release 5.1.3 now displays all output
headers.

TIBCO BusinessWorks Release Notes


96 Release Notes
|

Closed in Description of Fix


Release
5.1.3 HTTP messages sent by TIBCO BusinessWorks were always UTF-8 encoded,
regardless of the Content-Type set in the message header. This release fixes this
problem so that the HTTP server sends the message in the encoding specified in
Content-Type.

5.1.3 When an incoming POST message is URL-Encoded, the charset specified in the
Content-Type is now used to URL-decode the data.

5.1.3 The HTTP Receiver process starter was not processing some special characters (<LF>
and <CR>) properly. This has been fixed.

Java Palette

5.4.0 The Java Global Instance resource was not added to the process archive automatically.
This has been fixed. (1-3PHX72)

5.4.0 The Java Process Starter now creates unique jobs for each incoming event. (1-7BBPVG)

5.3.3 The 'Java Method' activity considered the second parameter as the first one if the first
parameter is 'String[]' and the second parameter is 'int'. This has been fixed.
(1-7BYEGV, 1-848HDB)

5.3.3 Cleanup methods were only listed when a Java Method activity that used an Alias
Library was first configured. Upon subsequent viewing of the Java Method activity,
the Cleanup Method field displayed a validation error and the list of methods was
empty. This was only an error at design time, the activity still executed properly.
This has been fixed for newly created Java Method activities, but existing activities
will still display the error (but they will execute properly). To fix the problem on
existing activities, make a modification to the Method or Library fields, and the
Cleanup Method field will be refreshed (1-74L93I).

5.3.3 Under certain circumstances, the Java Method activity would construct a class more
than once when the Cache Constructed Class field was checked. This has been fixed
(1-74NE5D).

5.3.3 Java custom function threw an error if a value of 0 or 0.0 is passed as Float value. This
has been fixed (1-4Y2WWL).

5.3.2 In the Java Event Source process starter, if you press the reset button before you apply
and save changes to the source code, the source code does not reset correctly. This has
been fixed. (1-6WQLVJ)

TIBCO BusinessWorks Release Notes


Closed Issues 97
|

Closed in Description of Fix


Release
5.3.2 Validating a project after opening the product but before any Java Method activity is
selected causes an error if the Java Method activity uses an Alias Library. This has
been fixed. (1-6U11EL)

5.3.2 Modifying a process definition name was not reflected in the package name for the
Java Event Source activity. This has been fixed. (1-6WJV3Z)

5.3.2 The Java Event Source process starter does not properly handle adding then removing
a Java Global Instance in the Advanced tab. This has been fixed. (1-6ZQ8U6)

5.3.0 Fixed a problem in Java Method activities where the activity was not able to recognize
Java classes that implement j a v a . i o . S e r i a l i z a b l e through a super class. Java
classes that implement j a v a . i o . S e r i a l i z a b l e directly are OK. (1-5SFS41)

5.3.0 Addressed an issue with using Java schema for an abstract class in the Java to XML
activity. The Output tab was not always showing the correct class name. (1-6MA3U0)

5.2.1 Java Global Instance resources received errors when the entire project was validated
for deployment unless each resource was individually validated. This has been fixed.
(1-4OX821)

5.2.0 Zero length arrays can now be passed into a method when using the Java Method
activity. To accomplish this, do not provide a binding to the array parameter and the
parameter has empty array as its value. (1-2532JR)

5.2.0 In the Java Code activity, when you specify an optional input parameter of type date
and no input mapping is specified or no value is passed at runtime, an exception is
thrown. This has been fixed. (1-21ZT8Y)

5.2.0 The Java Method activity now checks to make sure the object reference is not null
before invoking the cleanup method.

5.1.3 In release 5.1.2, when a Java Code activity is read-only (for example, when a user is
editing a process definition created by a different user and has no privileges for
editing the process), a user could still edit and compile the activity. This has been fixed
so only users with the proper privileges can edit the configuration or compile the Java
code.

5.1.3 In the Java to XML activity, when package names contain an underscore or begin with
a number, the members of the package were improperly renamed. This has been fixed.
However, any mappings to the improperly renamed members will need to be
recreated after upgrading to this release. You should be able to easily recreate the
mappings by copying and pasting the old mapping to the correct new input item.

TIBCO BusinessWorks Release Notes


98 Release Notes
|

Closed in Description of Fix


Release
5.1.3 On UNIX or Linux platforms, the Show Class Browser button on the Configuration
tab of activities in this palette does not display the available classes in the
CLASSPATH. This has been fixed.

5.1.3 The Java Code activity now treats input time using local time instead of GMT.

5.1.3 Java Custom Functions were not loaded automatically into the enterprise archive file
when deploying a project. This has been fixed.

JDBC Palette

5.4.1 The SQL query specified in the JDBC Query activity gave an error when the query
consisted of case statements. This has been fixed. (1-88YBQC)

5.4.0 The SQL Direct activity using a JConnect driver version 5.2 caused an XML validation
error. This was due to a trailing noOfUpdates after the unknownResultSet in the
output. This has been fixed. (1-838P69, 1-87998N)

5.4.0 If the stored procedure used a 'dateTime' input parameter with the Resultsets Use
Schema' option selected in the 'Advanced' tab, the output schema containing
"Resultsets" element could not be fetched. This has been fixed. (1-7Y9SOO)

5.4.0 No suitable driver error was thrown on engine startup when using Oracle RAC. This
has been fixed. (1-76P7OV)

5.4.0 Some global variables were not properly included when using LibraryBuilder and
releases of TRA earlier than 5.4.0. This has been fixed. (1-7BBPZJ)

5.3.3 The Engine.Database.TestStatement.<name> property now works for Oracle


databases so that you can issue a test statement and retrieve the actual SQL error for a
failed statement instead of receiving a timeout error (1-77DEPP).

5.3.3 An error occurred when using the JDBC activities to invoke a DB2 stored procedure
on OS/390. This has been fixed. (1-716XYM)

5.3.2 Under certain circumstances, there were problems with return values from stored
procedures when using Sybase. This has been fixed. (1-728MHT)

5.3.2 JDBC activities threw a j a v a . l a n g . N u l l P o i n t e r E x c e p t i o n when timeout was


reached in a very light load. This has been fixed. (1-6MC74S)

5.3.1 Multiple jobs using the same SQL statement that fetches subsets of data can cause a
SQL error. This has been fixed. (1-6ZH1RU)

TIBCO BusinessWorks Release Notes


Closed Issues 99
|

Closed in Description of Fix


Release
5.3.0 Fixed the issue where database connections are not released when using JNDI
connection type. (1-638ECC)

5.3.0 Unsupported query was automatically performed on certain databases. This has been
fixed. (1-6SZZO3)

5.3.0 The Fetch button now works properly when the JDBC Connection type is XA and the
database is IBM DB2. (1-6RUB4N)

5.3.0 In some cases when you use TIBCO BusinessWorks with an Oracle OCI JDBC driver,
you may get an erroneous "JDBC activity timed out" message. This has been corrected.
(1-6MBNI5)

5.3.0 Fixed the problems seen when using DB2 in XA transaction mode. (1-6HJW1Y)

5.3.0 Under certain conditions, transaction state is not maintained by a JDBC activity inside
a subprocess. This has been fixed. (1-6E1D0I)

5.3.0 Database connections were not released when using the JNDI connection type. This
has been fixed. (1-5YGUE5)

5.3.0 JDBC Update with batch mode was inserting one record more than configured when
timeout and/or ServerTimeZone optional input fields were also specified. This has
been fixed. (1-57Q9ZT)

5.3.0 A LoginTimedOutException has been added to JDBC activities for database drivers
that support login timeouts. (1-3CJ6W2)

5.3.0 Caching of the procedure list for the JDBC Call Procedure activity has been improved.
(1-2HGUP8)

5.3.0 JDBC activities were adjusting for daylight savings time, even when the server time
zone was set as GMT. This has been fixed. (1-5838D5)

5.3.0 The example in the Database URL field of the JDBC Connection resource is incorrect
when t i b c o s o f t w a r e i n c . j d b c . o r a c l e . O r a c l e D r i v e r ( R A C ) is selected in the
JDBC Driver field. This has been fixed. (1-5DA4IL)

5.3.0 JDBC Call Procedure interprets a schema value as a catalog value when calling a
stored procedure and using the JDBC-ODBC bridge driver. This has been fixed.
(1-5MUJD3)

TIBCO BusinessWorks Release Notes


100 Release Notes
|

Closed in Description of Fix


Release
5.2.1 Under certain circumstances, JDBC connections were not released from the connection
pool when a job completed. This has been fixed so that unused connections timeout
after a job completes. The connections will not immediately be released, but should be
released after a five-minute idle period. (1-50OJNP)

5.2.1 The JDBC Call Procedure activity did not recognize parameters of datatype
TIMESTAMP (Oracle datatype). This has been fixed so that both TIMESTAMP and
TIMESTAMP WITH LOCAL TIME ZONE datatypes can be used for procedure and
function parameters. (1-4MB1NL)

5.2.1 A fix to handle localized content in JDBC Plug-in, which otherwise produced
NoSuchMethodError. (1-4PUL5M)

5.2.1 The DB2 JDBC driver was not included in the drop-down list of drivers on the JDBC
Connection resource. (1-3J61EX)

5.2.1 A null pointer exception is thrown when the number of jobs created exceeds the
maximum number of connections specified on the JDBC Connection resource. This
has been fixed so that a NoConnectionAvailable exception is thrown instead.
(1-48GQAN)

5.2.1 A null pointer exception is thrown in JDBC activities when the data source is defined
in a WebLogic application server using XA type drivers and JNDI is the type specified
for the JDBC Connection resource. This has been fixed. Note: A JTA User transaction
that uses two or more data sources from different JDBC pools must use XA drivers.
Non-XA drivers cannot be used if you wish to use two or more data sources from
different JDBC pools. (1-4ADPGX)

5.2.1 Calling stored procedures under some circumstances worked properly in release 2.x,
but did not work in release 5.x. This has been fixed. (1-408B8M)

5.2.0 When using a Sybase database, errors in a called stored procedure were not returned
and the error transition was not taken. This has been fixed. (1-33849K)

5.2.0 The custom engine property C o n f i g . J D B C . C a l l P r o c e d u r e . O u t p u t U s e N i l did not


work when returning result sets. This has been fixed. (1-2SL5AM)

5.2.0 Behavior of float datatypes in the DataDirect JDBC Driver 3.3 SP2 (with RAC support)
has changed from previous releases. This release of TIBCO BusinessWorks accounts
for this change and handles the data correctly. (1-1X5T3P)

5.2.0 The Refresh button on the Call JDBC Procedure button could take a long time to
perform the refresh. This has been improved in this version.

TIBCO BusinessWorks Release Notes


Closed Issues 101
|

Closed in Description of Fix


Release
5.2.0 Optimized certain SELECT statements in the JDBC Connections during design time
when there are a lot of stored procedures in the database. Also improved the runtime
performance against a similar database.

5.1.3 When using the c o m . s y b a s e . j d b c 2 . j d b c . S y b D r i v e r driver, calling stored


procedures did not work. This has been fixed.

5.1.3 Errors sometimes occurred when attempting to execute a stored function within a
package. This has been fixed.

5.1.3 The JDBC Query activity was trimming leading and trailing spaces when returning
values of CHAR and VARCHAR columns. This has been fixed so that spaces are
preserved as they are returned by the database.

5.1.3 An empty string ("") was not being treated as a null when specified for an input value
in JDBC activities. Most databases treat empty strings as nulls, so the JDBC activities
have been enhanced to accept empty strings as a null.

5.1.3 When using the o r a c l e . j d b c . d r i v e r . O r a c l e D r i v e r ( t h i n ) or


tibcosoftwareinc.jdbc.oracle.OracleDriver and selecting values from a
column of type NUMBER, a trailing ".0" was added to integers. This behavior differs
from previous releases, and therefore, for backward compatibility, the ".0" is now
removed from integers.

5.1.3 When calling a stored procedure in a Sybase database, the database name is displayed
as the package name. Also, if the package name is selected, an error occurs. This has
been fixed so that errors no longer our when packages are selected.

5.1.3 The issue with JDBC activities generating errors under multi-statement transaction
scenario using a JConnect driver with a Sybase database has been resolved.

5.1.3 Overloaded procedures were not correctly displayed in the browse dialog in the Call
JDBC Procedure activity. This has been fixed so that overloaded procedures are listed
separately and each can be selected.

JMS Palette

5.4.2 TIBCO BusinessWorks engine was processing the JMS messages in a non-sequential
manner even though the Sequencing Key on the JMS Queue Receiver activity in the
process was set to a constant value. This has been fixed. (1-8E6UIP)

TIBCO BusinessWorks Release Notes


102 Release Notes
|

Closed in Description of Fix


Release
5.4.2 The Get JMS Queue Message activity using client acknowlegment mode failed while
confirming after receiving a random number of messages. This has been fixed.
(1-88ETUL)

5.4.1 The JMS Topic Publisher was unable to reconnect to the EMS server and gave an
unexpected error message when the EMS server was restarted for two or more
number of times. This has been fixed. (1-89MSYU)

5.4.0 The JMS Topic Subscriber was throwing an error under certain situations when
configured to receive Any Element and a MapMessage is received. This has been
fixed. (1-70517M)

5.4.0 Exceptions resulting from errors returned by the JMS server were not always reported.
This has been fixed. (1-7BI9G7)

5.4.0 The custom engine property bw.plugin.jms.recoverOnStartupError was not working


properly in Release 5.3.2. This has been fixed. (1-79SAS9, 1-7YADED, 1-7DDEOU,
1-7TSPE3, 1-80852B)

5.4.0 In some situations, an exception is thrown when sending JMS queue messages of type
byte. (1-744RC5, 1-7DDCD9)

5.3.3 Even if the sessions associated with the Get JMS activity were closed, the sessions did
not get destroyed. As a result, the engine stalled as all the engine threads hung and a
warning appeared in the EMS log file. This has been fixed. (1-7B94B9, 1-808PW3)

5.3.3 The timeout (in seconds) for activities that receive JMS messages can be specified with
the custom property bw.plugin.jms.receiverTimeout. See TIBCO BusinessWorks Process
Design Guide for more information about setting custom properties. (1-7XJKCF)

5.3.3 When using activities in the JMS palette, reconnection to a JBOSS server was not
working properly. This has been fixed (1-6U6599).

5.3.3 The Get JMS Queue activity now closes the session after a timeout error (1-79BE7J).

5.3.1 An exception is thrown for incoming messages that have Any Element specified. This
has been fixed to work in the case when Lax or Skip is specified as the validation for
the Any Element. The validation cannot be Strict in this case. (1-6VOR1H)

5.3.0 Fixed a reconnection issue to JMS servers. The connection was re-established, but
some of the JMS operations may continue to report errors. (1-6IOLDN, 1-6P0BVK)

5.3.0 Timeout is now honored for Get JMS Queue message. (1-6VH48O)

TIBCO BusinessWorks Release Notes


Closed Issues 103
|

Closed in Description of Fix


Release
5.3.0 The Test Connection button on the JMS Connection resource would become disabled
after clearing the JNDI Context field and would not become re-enabled. This has been
fixed. (1-3ELFKD)

5.3.0 Reconnection in the event of server failure was not working with the JBoss JMS server.
This has been fixed. (1-6R8EE0)

5.3.0 When using JMS client ack mode, the engine sometime stopped processing messages
from the queue. This has been fixed. (1-6OEUA3)

5.3.0 Fixed a NullPointerException encountered when Reply to JMS Message was used to
respond to a message received from the Get JMS Queue Message activity. (1-6OA3JH)

5.3.0 Under certain load situations, the JMS Queue Receiver could go into a thread
deadlock state and stop receiving messages. This issue is now fixed. (1-6Q1ZS2)

5.3.0 Connection failed, but no error message was given when the Test Connection button
was clicked and the Use Shared JNDI Connection option is checked (but no reference
to resource is given) on the JMS Connection resource. This has been fixed. (1-5EFDVL)

5.3.0 A problem with receiving JMS Topic messages has been fixed. (1-6Q5KMK)

5.3.0 JMS activities were not properly handling data of type Date/Time, XML Type Ref,
URI, and any when defined within the Editor tab. (1-1LLBIE)

5.3.0 Flow limit did not work properly after the JMS server was restarted. This has been
fixed. (1-6PTXXW).

5.3.0 JMS application properties were not consistently refreshed in the input tab. This has
been fixed. (1-4R3GDH)

5.3.0 When using Maxsessions > 1 in a JMS queue receiver activity, some of the sessions
hung and did not release the message or acknowledge back to JMS server. This has
been fixed. (1-6O5G48)

5.3.0 Fixed an issue in the Confirm activity when used to confirm JMS messages. Under
certain circumstances, the activity failed to confirm messages and threw a Java
runtime exception. (1-5YBEZV, 1-62V0ZZ)

5.3.0 JMS Topic publisher is now publishing the JMS default property header of
JMSXGroupID and JMSXGroupSeq. (1-6MAGBD)

TIBCO BusinessWorks Release Notes


104 Release Notes
|

Closed in Description of Fix


Release
5.3.0 The Reply to JMS Message activity encounters a "Producer is closed" exception after
the JMS server goes down and then restarts. This has been fixed. (1-5TUNZW,
1-52OD64)

5.3.0 Get JMS Queue Message throws an exception upon starting. This has been fixed.
(1-5N7BRX, 1-5YDPCH)

5.3.0 The JMS Queue Receiver failed with a parsing error when it received a message of
type map containing a field of type DateTime. This has been fixed. (1-3EURIT)

5.2.1 Performance improved for JMS activities that receive messages when the
acknowledge mode is set to Auto, EMS Explicit Client Acknowledge, or Dups OK.
(1-5CKJY7)

5.2.1 The Confirm operation was not working properly if it was contained within a group
and an attempt was made to confirm a message received by using the Get JMS Queue
Message activity. This has been fixed. (1-5A4A0E)

5.2.1 When using IBM MQ Series, the activities in the JMS palette were unable to recover
from a lost connection to the JMS server. This has been fixed. (1-5718S0)

5.2.1 The Max Sessions field allows no value to be set (that is, leaving the field blank). This
signifies an unlimited number of sessions. A warning is now given during project
validation when no value is specified in this field so that you can ensure the behavior
you wish to occur. (1-51XL3X)

5.2.1 Parsing an incoming MapMessage fails when a field containing Short data is
encountered. This has been fixed. (1-4X10ZC)

5.2.1 Using dynamic queues can slow performance. This has been fixed. (1-3IFDZN)

5.2.1 When an exception is thrown by the external Arjuna transaction recovery service, it
was not being propagated. This has been fixed. (1-3K7IPX)

5.2.1 Validate was not finding some broken references. This has been fixed. (1-4JX99K,
1-4IQQYX)

5.2.1 The Time To Live field for JMS activities is not able to be set below 1000. This has been
fixed. (1-4E34IK)

5.2.1 When the Get JMS queue Message activity is configured to use client acknowledge
mode, the messages are not acknowledged properly. This has been fixed. (1-44TH6Y)

TIBCO BusinessWorks Release Notes


Closed Issues 105
|

Closed in Description of Fix


Release
5.2.1 The JMS Topic Subscriber activity was unable to receive hex binary data when an
ActiveEnterprise schema was referenced in output editor. This has been fixed.
(1-4926FP)

5.2.1 When using TIBCO BusinessWorks to connect to a TIBCO Enterprise Message Service
server using SSL, an exception occurs. This has been fixed. (1-4G87BR)

5.2.0 Connecting to two different WebLogic (v 8.1) JMS servers with different credentials
was not possible. This has been fixed. (1-2JV01Z)

5.2.0 The JMS Reply activity slowed when many concurrent process instances executed it.
This has been fixed. (1-2F5ALE)

5.2.0 The long datatype was not handled properly. This has been fixed. (1-22VCFO,
1-26X39F)

5.2.0 Activities in the JMS palette were discarding any attributes on the root element of
incoming XML messages. This has been fixed. (1-21JZSR)

5.2.0 Under some circumstances, an out of memory exception was raised when using the
JMS Queue Requestor activity. This has been fixed. (1-2MPW19)

5.2.0 JMS activities were not handling data of type long (i8). This has been fixed.

5.1.3 The Suppress Local Messages field in the JMS Topic Subscriber and Wait for JMS Topic
Message was not working properly. This has been fixed.

5.1.3 JMS activities could not send and receive base64 encoded binary data bound to a field
of type binary. This has been fixed.

5.1.3 In the JMS Connection resource, if you placed a global variable inside a string (for
example, t c p : / / % % J M S S e r v e r C o n f i g % % : 7 2 2 2 ), the global variable was not expanded
properly and the connection could not be initiated.

5.1.3 Boolean values within JMS messages were not handled properly. This has been fixed.

5.1.3 A security context conflict has been resolved. This conflict occurs when:
• BEA Weblogic Application Server is used
• Process definitions are deployed within the same process engine that use more
than one user name to connect to the application server

5.1.3 Project validation failed and returned an error when required SSL values were not
supplied and Use SSL is unchecked. This has been fixed.

TIBCO BusinessWorks Release Notes


106 Release Notes
|

Closed in Description of Fix


Release
5.1.3 When an exception occurs on a JMS connection, the session was closed and messages
could no longer be sent. The connection functionality has been enhanced to do more
robust error checking, preserve connections, and resend failed messages when
exceptions occur.

5.1.3 Durable subscriptions were not created when specified on the JMS Topic Subscriber
process starter. This has been fixed.

Mail Palette

5.4.0 The Send Mail activity now uses fully qualified domain names in the Received From
mail header field. (1-7AH2B5, 1-7CMKO4)

5.4.0 In previous releases, the Receive Mail activity did not handle incoming mime
messages with mime types application/*, audio/*, video/*, or image/*. While
fetching these types of emails, TIBCO BusinessWorks threw exceptions. You can fix
this by setting the b w . p l u g i n . m a i l . r e c e i v e r H a n d l e D i s c r e t e T y p e s property to
t r u e . See TIBCO BusinessWorks Administration for more information. (1-7U5YS2,
1-7T69CD)

5.4.0 In previous releases, the Receive Mail activity was throwing exceptions when
receiving email if the email was in rich text format and the first mime part contained
nested mime sub parts. You can fix this by setting the
b w . p l u g i n . m a i l . r e c e i v e r F l a t t e n N e s t e d A t t a c h m e n t s property to t r u e which
flattens out the message structure so that all parts are siblings. See TIBCO
BusinessWorks Administration for more information. (1-7U2HJ2, 1-7TV7Q1)

5.3.2 When 'Provide Raw Message' field is checked in the Receive Mail process starter, close
all File Input/Output Streams after downloading the mail. (1-72SJUQ, 1-7372QL)

5.3.0 The multipart sub-type (in top-level Content-type) was ignored in the Send Mail
activity. This has been fixed. (1-6B79JA)

5.3.0 Addressed an issue in which exceptions are thrown in the Receive Mail activity. The
exception occurred for emails with attachments. (1-6MGQ7T)

5.3.0 Fixed an illegal argument exception that happened when a piece of email bounced
because of an incorrect address. (1-6C2CQN, 1-6MF1XE)

5.3.0 Addressed the problem where the Receive Mail process starter is ignoring the
threshold value and always writes the message to a file when write to file is enabled.
(1-65XFZH)

TIBCO BusinessWorks Release Notes


Closed Issues 107
|

Closed in Description of Fix


Release
5.3.0 Receive Mail was holding the contents of received mail in memory until the next
polling interval because the confirm operation is performed at the beginning of the
next polling interval. This unnecessarily holds memory when the polling interval is
long. This has been fixed. (1-5KG2PR)

5.3.0 Removed extra garbage collection from the Receive Mail activity for performance
reasons. (1-5XQUI9)

5.3.0 Performance of writing large received messages to file was slow. This has been
improved. (1-5KG2Q6)

5.3.0 For unavailable messages, Receive Mail was not retrying even when the retry count is
set. This has been fixed. (1-5JXPD1)

5.3.0 Fixed a problem in Receive Mail activity when the 'write to file' option is checked was
still reading mail into memory and caused out of memory error. (1-5KG2PD)

5.3.0 Using the write to file option on Receive Mail was causing the files to be locked until
the engine shut down. This has been fixed. (1-5N8Y9H)

5.2.1 In some situations, a mail server may expose a new message to a Receive Mail process
starter while it is still receiving the message, and later indicate the message is
unavailable. The Receive Mail process starter attempts to receive the message during
subsequent polls of the mail server. The custom engine property
b w . p l u g i n . m a i l . r e c e i v e r R e t r y C o u n t is available for setting the number of times
the process starter retries receiving the message. The amount of time the engine will
attempt to receive the message is the value of this property multiplied by the polling
interval. See TIBCO BusinessWorks Administration for more information about setting
custom engine properties. (1-5822DL)

5.2.1 Specifying Max Jobs (Flow Limit) during deployment caused the Receive Mail process
starter to receive duplicate messages, under some circumstances. This has been fixed.
(1-5AJMAP)

5.2.1 The Mail Receiver process starter now downloads the whole message instead of using
multiple POP3 commands to get the header and body separately. This should improve
the performance of the Mail Receiver, especially when retrieving a large number of
messages. (1-52N2V9)

5.2.1 When a message is over the threshold specified on the Advanced tab of the Receive
Mail process starter, the whole message is no longer loaded into memory before
writing to disk. (1-49RL69)

TIBCO BusinessWorks Release Notes


108 Release Notes
|

Closed in Description of Fix


Release
5.2.1 Activities in the Mail palette were not handling messages that used the
m u l t i p a r t / m i x e d ; c h a r s e t = U T F - 1 6 L E encoding. This has been fixed. (1-3TRG4H)

5.2.1 Attachments stored using an encoding different from the system default encoding are
not handled properly when sending or receiving attachments. This has been fixed.
(1-3QIT7H, 1-3Q45O2, 1-3Q45NP)

5.2.1 Fixed the Receive Mail process starter to parse and provide correct output for EDI
messages. (1-3PB93B, 1-3T9CNP)

5.2.1 The POP3 provider bundled with TIBCO BusinessWorks loads the entire e-mail
message in memory when it is received. This is a problem when dealing with large
e-mails. When the Write to File field is enabled, the e-mail message is now stored in a
file when the message size is greater than the specified threshold. (1-49RL69)

Manual Work Palette

5.2.0 The AssignTo input element was not overriding the Assign To field on the
Configuration tab. This has been fixed. (1-1R20UH)

Policy Palette

5.4.2 When using Java JKS keystore as identity in ibound security policy association for
confidentiality, TIBCO BusinessWorks expected jks keystore to return a single x509
certificate for a given alias name. However, when multiple x509 certificates were
returned, it gave an error. This has been fixed. (1-7A0FI9)

5.4.0 Refresh issue when resetting the X509 Identity field for Outbound policy has been
fixed. (1-6ZQ7GL)

5.3.3 In previous releases, the SOAP Send Reply activity could not send an attachment
when a WSS policy was in place. This has been fixed. (1-6Y6762)

5.3.2 When switching the Security Token field on the Authentication or Integrity tabs from
X509 to a UserNameToken, both the Apply and Reset button are greyed out. This has
been fixed. (1-6WJL0H)

5.3.1 References made by the resources in the Policy palette are not found when using the
Resources > Find References menu item. This has been fixed. (1-6Z0SS1)

5.3.1 Unrequested trace messages no longer display. (1-6TWM2I)

TIBCO BusinessWorks Release Notes


Closed Issues 109
|

Closed in Description of Fix


Release
Parse Palette

5.4.0 The Parse Data activity for the "Fixed Data Format" parsed all the records of
multi-files when the calling process was configured to spawn a new machine process
for executing the parse data activity. However, when the calling process was not
configured to spawn new processes, the inline parse data activity returned incorrect
output. This has been fixed.(1-86QUPV, 1-86U6SX)

5.4.0 The Parse Data activity for the "Fixed Data format" parsed all the records of multi-files
when the "noOfRecords" was set to "-1". However, it did not parse the first record of
each file correctly when "noOfRecords" was set to "1". This has been fixed.
(1-7YQWW3, 1-85IAG3)

5.4.0 The Parse Data activity no longer throws an ArrayIndexOutofBoundException when


the data is longer than 1024. (1-70S50M)

5.4.0 The Parse Data activity was locking the file and not permitting the file to be deleted in
certain situations. This has been fixed. (1-7MSKNW, 1-7HE6TI)

5.3.3 When using the Parse Data activity, the file remained open when reading parts of the
file at a time. This made it impossible to delete or rename the file because the file was
not closed. This has been fixed (1-737IO5).

5.3.1 The file remains locked after being read by the Parse Data activity. This has been fixed.
(1-6YKYJ3)

5.3.0 The Parse Data activity's result cannot match the data format's XML schema. This has
been fixed. (1-5PEQWE)

5.3.0 Fixed a performance issue in the Parse Data activity. (1-6P70TN)

5.3.0 When a required element is missing from a record, the data from the previous element
is written to the missing required element. This has been fixed so that an exception is
thrown when a missing required element is encountered. (1-51QAIT)

5.3.0 When an optional integer element is missing from the input data, the Parse Data
activity fails. This has been fixed. (1-5TIJ91)

5.3.0 The Parse Data activity read the first batch of rows twice- when parsing from file and
configured to read a specific number of rows. This has been fixed. (1-5WXZ4U)

5.3.0 When parsing fixed width format, only the last field is allowed to be optional. This has
been fixed. (1-3W76H2)

TIBCO BusinessWorks Release Notes


110 Release Notes
|

Closed in Description of Fix


Release
5.3.0 Addressed an issue where the data to be parsed is in one long line. The property
bw.plugin.parseData.enforceLineLength has been added for backward
compatibility. If true, the line end is determined based on the line length. If false, any
size line can be parsed. The default value of this property is true. (1-5TUNZQ)

5.2.1 Performance problem with Parse Data activity when parsing a large string has been
fixed. (1-34MZ7R)

5.2.1 Specifying \t as a column separator worked in Release 2.x but did not work in release
5.x. This has been fixed so that \t can be specified as a column separator. (1-427ZGV)

5.2.1 When an XSD is referenced in a schema in a Data Format resource, the XSD was not
properly placed into the EAR file and deployed projects experienced a null pointer
exception. This has been fixed. (1-3Z260Z)

5.2.0 Specifying the Line Separator in the Data Format Configuration tab did not work
properly in release 5.1.3. This has been fixed. (1-1XPI4P)

5.2.0 Empty fields in the data file were not property interpreted when the corresponding
element is optional in the schema (for example, "foo," is not interpreted as three
elements, the second and third are optional, empty elements). This has been fixed.
(1-2MYR48)

5.2.0 When an XML Element was specified as part of a schema in a Data Format resource,
the correct fields and offsets did not appear in the Field Offsets tab. This has been
fixed. (1-2216LG)

5.2.0 Specifying a space as the fill character for fixed format data causes an "S" to appear
instead of spaces as the fill character. This has been fixed. (1-1XTB2Q)

5.1.3 Migrating processes from 2.x to 5.x sometimes incorrectly set the Manually Specify
Start record field in Parse Data activities. This caused different behavior in 5.x than the
original 2.x project This has been fixed.

5.1.3 In previous releases, parsing data using input from a file and looping to read small
chunks of the file at a time (as recommended in the documentation for the Parse Data
activity) caused a performance degradation with very large files. This has been fixed
so that performance should improve when iteratively parsing sets of records in large
files.

5.1.3 Quoted column separators were not parsed correctly; column separators inside of
quotes were treated as column separators instead of part of the column. This has been
fixed.

TIBCO BusinessWorks Release Notes


Closed Issues 111
|

Closed in Description of Fix


Release
5.1.3 The Parse Data activity returned an error when attempting to parse multiple
consecutive empty columns. This has been fixed.

Rendezvous Palette

5.3.3 Size of the ledger file kept on increasing while receiving certified TIBCO Rendezvous
messages on Adapter request reply server activity. This has been fixed. (1-84CF61,
1-870W06)

5.3.3 An exception was thrown when publishing certified messages on a distributed queue
and the subscriber has a pre-registered listener. This has been fixed (1-77DVAN).

5.3.2 Type information for custom AE classes was not handled properly. This has been
fixed. (1-6X9GVQ)

5.3.0 In a certain scenario, the Send RV Request activity took the success transition even
after erroring out with an invalid subject. This has been fixed. (1-67ANC7)

5.3.0 The Publish RV Message activity set the encoding as UTF-8 when "XML Format"
checkbox was checked, even though the project encoding was set to ISO8859-1. This
has been fixed. (1-529MPO)

5.3.0 Setting the Scheduler Weight field to 0 was permitted, but resulted in a runtime error.
This is now caught and reported when the project is validated for deployment.
(1-62U8JL)

5.2.1 BW Engine hung and displayed Null Pointer Exception under heavy stress conditions.
This occurred when paging was enabled and the value of the "activationLimit"
property was set to 'False' in the "RVCMQ starter" process. As a result, CMQ
confirmations and results were not received. This has been fixed. (1-7Z2MD3)

5.2.1 In certain situations, suspending a RVCMQ listener process can lead to a hung worker
in case of a certified message or it can lead to a loss of a message in case of a reliable
message. This has been fixed. (1-52TYEJ)

5.2.1 The Send Rendezvous Request activity times out for one of the messages when
multiple concurrent process instances are executing. This has been fixed. (1-3PH78S)

5.2.0 The Publish Rendezvous Message activity no longer throws any


ClassCastException. (1-1XY6HZ)

TIBCO BusinessWorks Release Notes


112 Release Notes
|

Closed in Description of Fix


Release
5.2.0 The TIBCO Rendezvous rvd browser administration interface has a clients page that
describes RV clients. Previously, RV clients created by TIBCO BusinessWorks did not
have a description specified on this page. This has been fixed so that clients that
TIBCO BusinessWorks create now have a description.

5.2.0 For subscribers, the deserializer threw an exception in the case where input data
received is opaque and the AE schema is attached to the subscriber with data-type
specified as ae:binary. This has been fixed. (1-21IZ21)

5.1.3 The ledger file for Rendezvous Subscriber process starters grew uncontrollably when
receiving messages from Publish Rendezvous Message activities in other processes
(when both publisher and subscriber are configured to use the RVCM transport). This
has been fixed.

5.1.3 There was an issue with publishers in 5.x projects and backwards compatibility. This
has been fixed.

5.1.3 When Distributed Queue is specified for the transport of a Rendezvous Subscriber or
Wait for Rendezvous Message activity and Reply to Rendezvous Request activity is
used to reply to an incoming request, the reply message was not sent. This has been
fixed.

5.1.3 Errors occurred when publishing a message containing a field named "body". Also,
handling of the child "body" element in the reply message was incorrect. These issues
have been fixed.

Service Palette

5.4.2 The documentation tags present in an abstract WSDL were ignored while generating a
concrete WSDL in the Service resource WSDL Source tab. This has been fixed and the
documentation tags are appropriately added to the concrete WSDL generated in the
WSDL Source tab of the Service resource configuration. (1-7Y5Q5S).

5.3.3 The Service resource throws an exception when incoming SOAP request has spaces in
the SOAP body. This has been fixed (1-75RVWG).

SOAP Palette

5.4.2 The JMSCorrelationID received from the incoming request message using SOAP
Event Source or Service resource was not getting mapped to its reply message sent
using SOAP Reply. This has been fixed. (1-8F8CX9)

TIBCO BusinessWorks Release Notes


Closed Issues 113
|

Closed in Description of Fix


Release
5.4.2 SOAP Faults generated by TIBCO BusinessWorks Service implementation, configured
with SOAP 1.2 and ’Document Style’ had fault fields in the wrong order. This has been
fixed. (1-8DSVDX)

5.4.2 TIBCO BusinessWorks could not process a SOAP message when the < S O A P : n a m e
="Untitled"> attribute was not declared and gave an error message - "Only the
default namespace may be undeclared". This has been fixed. (1-89TUOC)

5.4.1 The SOAPSendFault activity returns a Null Pointer Exception when the input data of
"anyType" is substituted. This has been fixed. (1-856C6P, 1-85094Z)

5.4.1 The SOAP over JMS services required the SOAPAction field to be specified in quotes
to enable BusinessWorks service to pick up messages from the queue. This has been
fixed. (1-89WD1R)

5.4.1 The WSDL returned by SOAP EventSource was different from the WSDL generated at
runtime using RetrieveResource activity, when SOAP was configured with an
attachment. This has been fixed. (1-7VZ198)

5.4.1 The value for Timeout in the SOAPRequestReply Activity Configuration tab can be
specified in seconds. However, while calculating the actual timeout, the number of
seconds specified was not converted to milliseconds before adding to the current time
in milliseconds. This has been fixed. (1-7MBL3H)

5.4.0 While receiving SOAP over JMS messages, TIBCO BusinessWorks always looks for
'SoapAction' JMS header in a case-sensitive way. This results in interoperability issues
if client is sending 'SoapAction' JMS header in a different case. Currently SOAP over
JMS is not a standard specification and so this fix will relax the constraints while
receiving SOAP over JMS messages to accept 'SoapAction' header in the following
four commonly used cases: SoapAction, SOAPAction, soapAction and soapaction.
(1-86QT1A, 1-875ITS, 1-875IT0)

5.4.0 The SOAP Request Reply activity lost the default prefix of the first child of soap:Body
because of problems in xsi:type resolutions. This has been fixed. (1-6ME83D,
1-85IAAZ)

5.4.0 When an encryption policy was applied to the entire body of a SOAP fault message,
the SOAP Send Fault activity failed to process the message. This has been fixed.
(1-6TBKTB, 1-85IAFH)

5.4.0 For RPC/literal/type SOAP messaging, the namespace information for parent
element was not passed to the child element. This has been fixed. (1-851ZGF,
1-85IABK)

TIBCO BusinessWorks Release Notes


114 Release Notes
|

Closed in Description of Fix


Release
5.4.0 The Retrieve Resources activity was not using the hostname or port specified on the
Input tab as the concrete service endpoint in the returned WSDL. This has been fixed.
(1-7KR0T3)

5.4.0 Configuring SOAP activities to use the SSL Verify Host Name option was not
working. This has been fixed. (1-79PJ6Z)

5.3.3 In TIBCO BusinessWorks, the JMS application properties could not be set and
retrieved for SOAP RequestReply activity using JMS transport. This has been fixed.
(1-710RNN, 1-870W27)

5.3.3 SOAP Service in BusinessWorks 5.3 did not support URLs (WSDL clients) created in
BusinessWorks 5.2; thus affecting the backward compatibility. This has been fixed.
(1-7WB80D).

5.3.3 In release 5.3.2, the Retrieve Resources activity did not properly return SOAP header
definitions in the retrieved WSDL file. This has been fixed (1-76FWN2).

5.3.2 Under some conditions, SOAP activities throw a Null Pointer exception. This has been
fixed. (1-70AIQH)

5.3.2 Message type is set to bytes as default regardless of type set in WSDL when using JMS
transport for SOAP Request/Reply activity. This has been fixed. (1-6ZDVY7)

5.3.2 Regardless of the WSDL, Retrieve Resource always sets the default body use to literal.
This has been fixed. (1-6ZE0ID)

5.3.2 An exception is thrown by the SOAP Request/Reply activity when the target
namespace uses syntax such as u r n : u d d i - o r g : a p i _ v 3 _ b i n d i n g . This has been fixed.
(1-6ZY510)

5.3.1 Cannot invoke some web services deployed on Sun Java System Application Server,
Platform Edition 8.1.0.2. This has been fixed. (1-6ZC17J)

5.3.0 SOAP reply message should have charset specified in content type in the HTTP
header. (1-5LEOA8)

5.3.0 Attachments to SOAP messages were not processed properly when the message was
sent by way of an HTTP proxy server. This has been fixed. (1-2XQG3M)

5.3.0 When using the JMS transport, a one-way request operation took the success
transition, even if the JMS server was down. This has been fixed. (1-6QV9ZG.)

TIBCO BusinessWorks Release Notes


Closed Issues 115
|

Closed in Description of Fix


Release
5.3.0 The SOAP Request/Reply activity fails if one of the fields in the Soap Response has a
value "CID". This has been fixed. (1-62HIZV)

5.3.0 The SOAP Request Reply activity did not load the JNDI Properties specified in the
JNDI Property table. This has been fixed. (1-3Q3ICT)

5.3.0 In some cases, the SOAP activities were not releasing memory after the job completed.
This has been fixed. (1-6N5O85)

5.3.0 When using the JMS protocol, the SOAP Event Source threw an exception when an old
or unrelated message from the JMS queue was received. This has been fixed.
(1-3QMSKM)

5.3.0 Fixed a memory leak. (1-6N5O85)

5.3.0 The SOAP Request/Reply activity (using the JMS transport) took the success
transition even when the TIBCO Enterprise Message Service server was down. This
has been fixed. (1-6P3WF0)

5.3.0 Retrieve Resource did not return the correct 'port' if 'host' name was overridden in the
input of the activity. This has been fixed. (1-57WTIQ)

5.3.0 In a very rare circumstances, SOAP over HTTP messages are dispatched to the wrong
service. (1-5KZSR5)

5.3.0 SOAP reply message should have charset specified in content type in the HTTP
header. (1-5PNMXX)

5.2.1 Errors were not thrown when an attachment did not exist or was not serialized
properly. This has been fixed. (1-3NX7DH)

5.2.1 Attachments stored using an encoding different from the system default encoding are
not handled properly when sending or receiving attachments. This has been fixed.
(1-3QIT7H, 1-3Q45O2, 1-3Q45NP)

5.2.1 In release 5.1.3, the host name was returned in the SOAP Service Endpoint by the
Retrieve Resources activity when the default hostname was not provided in the HTTP
Connection resource. In release 5.2.0, "localhost" is returned instead. This has been
fixed to maintain backward compatibility with previous releases. (1-4JJ3O3)

5.2.0 The SOAP Event Source process starter builds the incorrect concrete WSDL when
duplicate import statements are included. This has been fixed. (1-2IMCTX)

TIBCO BusinessWorks Release Notes


116 Release Notes
|

Closed in Description of Fix


Release
5.2.0 When using the SOAP Request Reply activity, extraneous namespaces appear in the
SOAP request. This has been fixed. (1-23SEEL)

5.2.0 Connections are automatically closed after sending SOAP requests over the HTTP
protocol in TIBCO BusinessWorks. This helps to ensure that connections are not held
open longer than needed and the HTTP server does not reach its connection limit.
(1-2UTW8)

5.2.0 Encoded types should be nillable as there are no elements but only types used.
(1-1VNA37)

5.2.0 When a service name has a space (for example, "Process Definition"), SOAP clients did
not work correctly with a SOAP server in a project migrated from release 2.x. This has
been fixed. (1-23XIJ4)

5.1.3 Performance of SOAP activities was not the same in release 5.1.2 as it was in previous
releases. Performance of these activities has been improved in this release.

5.1.3 When sending a message to a.NET SOAP server, the server cannot read a message
containing an array type if the array namespace and type are omitted from the
message. In previous releases, you must workaround this problem by including the
array type and namespace. As of this release, the namespace and type can be omitted
and the .NET server will be able to properly read the message.

5.1.3 Retrieve Resources was failing when multiple clients accessed the WSDL at the same
time. This has been fixed.

5.1.3 Corrected the handling of x s d : c h o i c e within a WSDL file.

5.1.3 Improved support for load balancing of SOAP activities.

5.1.3 The default SOAP fault message no longer throws an exception when the SOAP server
attempts to deserialize the message.

5.1.3 Sending or receiving a message with no input structure resulted in an error. This has
been fixed.

5.1.3 Mappings for the SOAP Request Reply activities did not always migrate properly.
This has been fixed.

5.1.3 Validate for Deployment displayed duplicate warning messages when the SOAP
action is "" or """". This has been fixed.

TIBCO BusinessWorks Release Notes


Closed Issues 117
|

Closed in Description of Fix


Release
5.1.3 Migration of SOAP Faults and WSDL files from 2.0.x did not always work properly.
This has been fixed.

TCP Palette

5.4.2 The TCP server socket was bound to the localhost alone and not on all available
interfaces when the Host field in the TCP Connection shared resource was not
specified. This has been fixed. (1-8BVTA5)

5.4.0 On Windows XP systems, even when the Bytes To Read field is set to a larger value,
the Read TCP Data activity can only read up to 64KB. This has been fixed. (1-71UR60)

5.3.3 When the TCP server is started and stopped more than once consecutively, an
exception was thrown. This has been fixed (1-6RTSKX).

5.3.2 The Read TCP Data activity now times out as specified. (1-71UR3N)

5.3.0 Addressed an issue in the 'TCP read activity where some incoming data may be lost
when too much data is coming through. (1-6OJLSZ)

5.3.0 TCP Read (Text mode with String separator) was reading data in chunks and was not
propagating the overflow data to subsequent TCP Read activities,- this was causing
data loss. This has been fixed. (1-6MTCA2)

Transaction Palette

5.4.2 When the connection to a database was lost for a JDBC activity in a transaction, the
transaction was rolled back internally. Since the activity did not throw an error, the
transaction group succeeded when it was expected to fail. This scenario can result in
potential loss of data. This has been fixed. (1-8BTMO5)

5.4.0 When using the BEA WebLogic application server and JTA transactions, TIBCO
BusinessWorks was incorrectly trying to reuse connections that the application server
closed and an exception was thrown. This has been fixed so that TIBCO
BusinessWorks now attempts to obtain a new connection from the pool. (1-7RAIHG,
1-7CGZCU)

5.2.1 For JDBC DataDirect drivers (tibcosoftwareinc.jdbc.oracle.OracleDriver and


tibcosoftwareinc.jdbc.sqlServer.SQLServerDriver), when JDBC activities are part of an
XA transaction group and the network connection to the database is lost or the
database is down during the second phase of the transaction commit operation
(X A R e s o u r c e . c o m m i t ), the transaction recovery was not successful and the
transaction outcome was not be atomic. This has been fixed. (1-3MC8E3)

TIBCO BusinessWorks Release Notes


118 Release Notes
|

Closed in Description of Fix


Release
Web Service Wizards

5.3.3 You can no longer use the process wizard on a WSDL in a project that has not been
saved. The wizard now requires the project to be saved before the process can be
created (1-70FHHY).

5.3.2 The Web Service wizards now cannot be used on processes that are not able to become
web services. For example, processes that use the Timer process starter cannot become
web services. (1-709OOL)

5.3.1 When generating a web service from a WSDL file, the fault message is not correctly
represented by an error schema in the resulting process definition. This has been fixed.
(1-6Z4KZ7)

5.3.1 When creating any Service with more than one process, and each process has its own
input and output XSD schema, the wizard sets same input and output schemas for all
the processes. (1-6XVIHB)

5.3.1 You can now create a service from a process definition that has spaces in its name.
(1-6TJY1X).

5.3.1 Process Definitions that only had a schema defined on the Start activity were not
available to be wrapped in a service. This has been fixed. The service operation that is
generated is one-way (that is, it only has an input schema specified). (1-709OQZ)

5.3.1 Process Definitions with error schemas that were used to generate a Service Definition
did not have the error schemas propagated to the wrapping service process definition
or WSDL. This has been fixed.
One issue here is that the wrapping process definition (that is, the one that is called by
the service agent and does a call process of the user's process definition) only
references the error schema in its end activity.
You must still create a Generate Error activity, link it by way of an Error transition
from the Call Process activity, and map the error schema values. When multiple errors
can be thrown, you must use XPath expressions to cause the correct Generate Error to
be executed. (1-70CT4J)

WSIL and UDDI Registry Browser in TIBCO Designer

5.3.2 Multi-byte characters are now permitted in service names when publishing services.
(1-6VWTCB)

5.3.2 Browsing a registry no longer requires first publishing to the registry (1-6ZVXBF).

TIBCO BusinessWorks Release Notes


Closed Issues 119
|

Closed in Description of Fix


Release
5.3.1 Looking up SAP and Microsoft UDDI registries, especially ones that contain UTF-16
characters, sometimes fail. This has been fixed. (1-6ZE0AB)

5.3.1 The WSDL URL is now preferred over the endpoint URL in the WSDL or Access URL
result column. (1-6ZY3LS, 1-6ZVALU, 1-6ZVXCI)

5.3.1 Publishing a WSDL that uses the JMS protocol caused TIBCO BusinessWorks to hang.
This has been fixed. (1-6ZVXDH)

WSDL Palette

5.4.2 WSDL files can import schemas using relative paths (./ or ../). WSDL files can also
have embedded schemas that can themselves include or import schemas using
relative paths. However, building an enterprise archive (EAR) file for a project,
containing a WSDL file that uses relative paths, resulted in a Null Pointer exception.
This has been fixed. (1-8E6UKD)

5.4.1 A WSDL published via BSC returned an End Point URL instead of the WSDL location
when retrieved or browsed via BusinessWorks UDDI GUI. However, when the WSDL
was published and retrieved using BusinessWorks UDDI GUI, it returned the WSDL
location correctly. This has been fixed. (1-85UUP2)

5.4.0 Some problems were encountered when concrete WSDLs were generated from
abstract WSDLs (for example, when the Retrieve Resources activity generates a
concrete WSDL) when the same namespace was used by multiple schemas. This has
been fixed. (1-7RMRWV)

5.3.3 When a WSDL file uses an include statement to include an XSD, the XSD was not
added to the EAR file when creating the archive. This has been fixed (1-6Y694H).

5.3.0 wsdl:fault/@name in the bindings now matches wsdl:fault/@name in the abstract


operation definition. (1-6MV5O2)

5.1.3 If you move a WSDL resource to another location, mappings that use the WSDL file
are marked as errors, but the reference is resolved properly at runtime. This has been
fixed so that mapping references are resolved without reporting errors.

XML Activities Palette

5.4.0 In certain situations, the XML Transform activity produced incorrect output in some
fields. This has been fixed. (1-7UM0UL)

TIBCO BusinessWorks Release Notes


120 Release Notes
|

Closed in Description of Fix


Release
5.3.3 The Transform XML activity randomly threw exceptions when some parameters were
passed into the stylesheet as "XML document". This has been fixed. (1-81GFX2,
1-82IOQI)

5.3.3 Performance issues were observed with the XML Transform activity in BusinessWorks
5.3.2. This has been fixed. (1-7XOIS2)

5.3.0 Wildcards in the root cause a ClassCastException when selecting the XML Parse
activity. This has been fixed. (1-4BL1EI)

5.3.0 Import statements with relative paths were not working properly in the Transform
XML activity. This has been fixed. (1-6AQPN6)

5.2.1 When the root tag is nested and the XML Renderer is configured to binary output, the
output is not correctly generated. This has been fixed. (1-22X6VE)

5.2.1 Fixed the OutOfMemoryError when parsing a large XML file in the Parse Data
Activity. (1-4MJEJA)

5.1.3 In previous versions, the Render XML activity sometimes replaced namespace
prefixes with new prefixes (for example, ns0, ns1, and so on). This has been fixed.

5.1.3 If parsed data is invalid, the errors sometimes persist to the next process instance even
if the new data is valid. This has been fixed.

TIBCO BusinessWorks Release Notes


Internationalization 121
|

Internationalization

For this release of TIBCO BusinessWorks, the only platform on which


internationalization features have been tested is Japanese Windows 2000. Also,
integration tests have not yet been performed, so internationalization features
have only been tested for TIBCO BusinessWorks as a standalone product.

TIBCO Messaging Encoding


Starting with the 5.0.1 release, only Multi-File projects are allowed. In the project
creation panel, users are given the options to choose the encoding for the project
(either ISO8859-1 or UTF-8). This encoding is not the persistent storage encoding
of the project (that is always UTF-8), but is the TIBCO Messaging Encoding used
for the communication between TIBCO product components. The communication
channel can be either TIBCO Rendezvous or TIBCO Enterprise for JMS.
This TIBCO Messaging Encoding value can be set during the creation of a new
project. Once a project is created, you can change the encoding value by selecting
the root node in project tree. Then select the "Project Settings" tab in Configuration
Window.
If you are familiar with TIBCO BusinessWorks Release 2.x, you can view this
project encoding value as the equivalent of the encoding value configured using
Repository Finder for Local Repository projects.

XML Messages using JMS or AE/RV Wireformats


The current release only supports UTF-8 encoding for XML messages. XML
messages are configured in the following ways:
• TIBCO ActiveEnterprise activities can send or receive messages using AE
XML wireformat.
• TIBCO ActiveEnterprise activities can use JMS as a transport, and this
transport uses XML messages.
• TIBCO Rendezvous activities can specify that messages are RV XML format.
Non-ASCII data in XML messages using Latin-1 encoding is not properly
handled. Therefore, if you choose to use an XML format, you must use UTF-8 as
the message encoding. This will be fixed in a future release.

TIBCO BusinessWorks Release Notes


122 Release Notes
|

Usage Notes

Double-Byte Characters in Filenames


Double-byte filenames can be used in filenames within activities (for text, binary,
or XML or XDS files). However, project names cannot contain double-byte
characters.

Double-Byte Characters in XPath Expressions


The TIBCO Designer GUI allows you to use XPath expressions in many locations
(process parameters, return values, conditions in conditional transitions, and so
on). Double-byte characters are supported in all these locations.

TIBCO Designer Display Font


In the TIBCO Designer Edit > Preferences > View tab, there are two kinds of
fonts, UI Font type and Script Font type. Script Font type is used for display
characters in the XPath Formula Editor and UI Font Type is used to display
characters in other locations. If double-byte characters are displayed as rectangles,
choose an appropriate font in the preferences dialog, then exit and re-open TIBCO
Designer for the change to take effect.

ActiveEnterprise Adapter Palette


Through activities in this palette, TIBCO BusinessWorks can communicate with
TIBCO adapters by way of different wire formats. All wire formats support
transmitting non-ASCII data. The wireformat character encoding is determined
by the TIBCO Messaging Encoding settings described in TIBCO Messaging
Encoding on page 121.

EJB Palette
Non-ASCII data can be used as the EJB Remote call's parameters and return
values for both stateful and stateless session beans.
The internationalization test of EJB is only conducted against BEA Weblogic 8.1
application server.

TIBCO BusinessWorks Release Notes


Internationalization 123
|

File Palette
In the File Poller and Wait for File Change activities, if the value for the Content
as: field is text, the user can now select the encoding in the Encoding field. This
encoding value is used to read the file contents. The Output tab will then show
the encoding for the file contents in the encoding subelement of the fileContent
element.
In the Read File and Write File activities, for text files the encoding to read/write
the file can be specified in the Input tab in the optional Encoding field. The
Output tab will then show the encoding for the file contents in encoding
subelement of the fileContent element.
In JDK 1.3.1, Shift_JIS encoding is closer to MS932 encoding because it covers
more special Japanese characters that are present in MS932. In JDK 1.4.1, Shift_JIS
encoding is closer to SJIS because it no longer covers the special Japanese
characters that are present in MS932.

FTP Palette
FTP palette now support files with both non-ASCII contents and filenames to be
transmitted to and from a remote FTP server. Currently, internationalization
features are tested only on UNIX-based FTP servers.
• FTP Put activity — this activity allows you to transmit files with non-ASCII
data to an FTP server using non-binary mode. The source data could be
retrieved from a file on disk or from process data. If the source data is from
process data, you must specify the encoding for the remote file because the
source data is always in Unicode, or the local system's default encoding is
used for the remote file. Line endings on different operating systems are
handled properly and automatically.
• FTP Get activity — this activity allows you to retrieve files with non-ASCII
content from an FTP server using non-binary mode. The retrieved data could
be written to a file on disk or to process data. In the later case, you must
specify the encoding of the original file on the server so the activity can
perform the conversion from the original encoding to Unicode. Line endings
on different operating systems are handled properly and automatically.
• The activities of the FTP palette can support file names on the remote FTP
server that use a different encoding than the local machine. When this is the
case, the Remote File Name Encoding field in the FTP Connection must be
configured properly.

TIBCO BusinessWorks Release Notes


124 Release Notes
|

HTTP Palette
The activities in the HTTP palette now support non-ASCII data in both GET and
POST requests. Depending upon the configuration of the HTTP Request side, the
encoding scheme of both a GET and POST request could be normally encoded or
URL-encoded (defined in the W3C: Character Model for WWW 1.0). The HTTP
Receiver side must be configured accordingly to accommodate these different
encoding schemes.

Known Issues:
• HTTP Receiver — If the inbound HTTP POST request is URL-encoded and it
contains non-ASCII data, and the HTTP Receiver’s "Parse Post Data Method"
field is unchecked, the Output "PostData" element will contain garbage data.
Workaround: Check the "Parse Post Data Method" checkbox and specify
output parameters for the parameters of the HTTP request. This allows the
HTTP Receiver to properly parse the inbound URL-encoded data. The
"PostData" element also returns the correctly decoded request.
• HTTP Receiver — If the inbound HTTP GET request is URL-encoded and it
contains non-ASCII data, and the HTTP Receiver’s "Parse Post Data Method"
field is unchecked, the Output "QueryString" element will contain garbage
data. Workaround: Specify output parameters for the parameters of the HTTP
request. This allows the HTTP Receiver to properly parse the inbound
URL-encoded data.
• HTTP Receiver — The process starter will not be able to receive and decode a
request submitted by a browser (for example, Internet Explorer or Netscape)
correctly if the request contains any non-Latin1 data. This is because the
current implementations of the major Internet browsers do no include a
Content-Type header in the outbound request. Thus, the HTTP Receiver
always uses ISO8859-1 (Latin-1) encoding to decode the inbound request.
Workaround: Workaround is available from TIBCO Support.

Java Code Activity


Hard-coded, double-byte data is now allowed in Java source code. Also, most
Java locale-sensitive classes and methods are supported.

JDBC Palette
JDBC Query and JDBC Update now support double-byte data in table names,
column names, and column values.

TIBCO BusinessWorks Release Notes


Internationalization 125
|

JDBC internationalization testing is only conducted against the Oracle 8.1.7


server. The server instance character sets that have been tested against include
JA16SJIS, ECUJP, and UTF8. Both Oracle thin JDBC driver and DataDirect Oracle
JDBC driver are tested.

Known Issues:
• The t i b c o s o f t w a r e i n c . j d b c . o r a c l e . O r a c l e D r i v e r (the DataDirect Oracle
JDBC driver) has problems under some circumstances. For example, if the
database's encoding is EUC-JP, ASCII and non-ASCII data cannot be inserted
correctly.

JMS Palette
This release of TIBCO BusinessWorks was tested only using the TIBCO Enterprise
for JMS Server 3.1.0.
The TIBCO Enterprise for JMS server does not support double-byte topic or
queue names.

Mail Palette
Mail Activities now support attachments that use CJK encoding.

RV Palette
RV activities now use the TIBCO Messaging Encoding as the wire encoding. You
have to set the TIBCO Messaging Encoding to UTF-8 when you create a new
project if you want to send/receive CJK characters using RV palette activities. The
default project encoding value is ISO8859-1 that only supports Western
Europeans characters including English. Please refer to TIBCO Messaging
Encoding on page 121.

SOAP Palette
The activities of this palette allow you to send and receive non-ASCII data in
SOAP messages using UTF-8 encoding in document mode and RPC mode for
both Literal and SOAP-Encoded message styles. The message character encoding
is transparent, you do not need to configure the activities to obtain this
functionality.

XML Activities Palette


XML Parse and XML Render activities now support XML files encoded in any
IANA-compliant encodings.

TIBCO BusinessWorks Release Notes


126 Release Notes
|

Due to changes from JDK 1.3.1 to JDK 1.4.x, a shift_jis encoded XML file that
contains special Japanese characters is handled differently by the Parse XML and
Render XML activities. In TIBCO BusinessWorks Release 5.1.3 with JDK 1.4.x,
when you parse shift_jis encoded XML files you should set Parse XML's
forceEncoding value to MS932 or Windows-31J for binary mode, so that special
Japanese characters can be parsed correctly. To render a shift_jis encoded XML file
that contains special Japanese characters, you should use text mode in the Render
XML activity. Then you can map the output xmlString from Render XML to a
Write File activity with encoding value set to MS932 or Windows-31J.

TIBCO BusinessWorks Release Notes


Using Non-Default TIBCO Rendezvous Parameters 127
|

Using Non-Default TIBCO Rendezvous Parameters

When you install TIBCO BusinessWorks 5.3, you can specify non-default TIBCO
Rendezvous parameters for the TIBCO administration domain during
installation.
• If you keep the default parameters, already installed adapter can join the
TIBCO Administration Domain with no problems because both TIBCO
Administrator and the adapter will then use the default TIBCO Rendezvous
parameters.
• If you change the TIBCO Rendezvous parameters, you can use TIBCO
BusinessWorks standalone with the new settings. Any adapters you install
afterwards on the same machine will use the same settings.
If adapters need to join an administration domain using non-default TIBCO
Rendezvous parameters, it is recommended you proceed as follows:
1. Install TIBCO Administrator and the adapter using the default TIBCO
Rendezvous parameters.
2. Using the domain utility, change the TIBCO Rendezvous parameters for
TIBCO Administrator to the desired settings.
3. Using the domain utility, change the TIBCO Rendezvous parameters for the
adapter to the desired settings.
The domain utility and associated documentation is available in the
tra/version/tools folder.

TIBCO BusinessWorks Release Notes


128 Release Notes
|

TIBCO BusinessWorks Release Notes

You might also like