====================================================================
New Era
of Networks Rules and Formatter Extension for
IBM
WebSphere Message Broker for Multiplatforms,
Version
6.0 Fix Pack 1
March,
2006
Copyright
(c) 2003-2006 New Era of Networks, Inc. All Rights Reserved.
http://www.ibm.com/support/docview.wss?rs=849&uid=swg27006041
====================================================================
This
readme may have updates, which are posted on the web.
For the
latest Readme, go to:
http://www.ibm.com/support/docview.wss?rs=849&uid=swg27006913
====================================================================
How To
Use This Document:
To
Print the Readme file, open the file in Notepad, and then use the
Print
Command on the File menu.
====================================================================
Contents:
Part 1:
General Issues
Part 2:
Rules and Formatter GUI Issues
Part 3:
New Era of Networks Formatter Issues
Part 4:
Documentation Issues
======================================================================
Part 1:
General Issues
======================================================================
CMVC:
15875 inst_db fails on Sybase if NEON user
already exists
QTS: 252522
Problem:
On
Sybase, inst_db fails if NEON user already exists.
Workaround:
This is
actually the design of inst_db configurations. Inst_db is designed
to
handle all of the user generation. If
the user is created using
another
method, remove the user and re-run inst_db.
----------------------------------------------------------------------
PMR: 00109,284 - NNSY sample rules and formats
are not useable on z/OS
CMVC:
35397
QTS: 342732
Problem:
The
sample z/OS rules and format export files will not import.
Resolution:
The
sample files were fixed. They are ASCII
based files designed to be
imported
from the Windows client installation.
----------------------------------------------------------------------
CMVC:
41190
QTS: 414512 Incorrect
installation summary
Problem:
If user
cancels the install the final installation summary window states:
"The
InstallShield Wizard successfully installed Rules & Formatter Runtime
Engine.”
Resolution:
The
"successfully installed" summary is confusing. It only means the install
was
successful in processing the users request, which in this case was a
request
to cancel.
----------------------------------------------------------------------
CMVC:
36418
QTS: 359108 Formatter
GUI unable to export components with spaces in names
Problem:
The
Formatter GUI is unable to export a component that has a space in its name.
Resolution:
The GUI
was modified to handle items with spaces.
----------------------------------------------------------------------
CMVC:
36841 - Availability of nnversion on zOS
QTS: 364541
Problem:
The
tool, nnversion, that tells you the version of the nnsy modules
was not
included in the install.
Resolution:
The
perl script is now being packaged with zO/S.
The user will need to be
sure
perl is installed on the system.
----------------------------------------------------------------------
CMVC:
37808 - inst_db does not clean up temp files.
PMR: 05958,L6Q
QTS: 375994
Problem:
The
inst_db script does not clean up the temp files on exiting.
Resolution:
The
clean up commands were added to the inst_db startup script.
----------------------------------------------------------------------
CMVC:
38924 - Makefile refers to an invalid directory RulFmt40
QTS: 407026
Problem:
Makefile
refers to an invalid directory RulFmt40
Resolution:
Reference
to rulfmt40 directory removed from sample Makefiles.
----------------------------------------------------------------------
CMVC:
38940 - symbol referencing error while compiling User Exit on Solaris
QTS: 385763
Problem:
Symbol
referencing error while compiling User Exit on solaris
Resolution:
The
problem was corrected by adding the NNSY.libext variable to the
SHARED_LINK
definition within the make file.
----------------------------------------------------------------------
CMVC:
40716
QTS: 397208 M:NNSY
inst_db fails on Linux using Oracle 9i
Problem:
Default
values cause NNSY inst_db to fail on Linux using Oracle 9i.
Resolution:
The
default values were changed to work properly with Oracle 9i and 10g.
----------------------------------------------------------------------
APAR:
IY36548 - THE NEON NODE APPEARS TO OVERWRITE RATHER THAN APPEND TO
THE LOCALENVIRONMENT DATA.
PMR: 93933,001
QTS: 302756 RulesEval node does not copy local
environment
Problem:
The
LocalEnvironment, a.k.a. DestinationList is used by the RulesEval node
PutQueue
operation to store destination queues.
The RulesEval
node did not check for the presence of an inbound
LocalEnvironment
message before constructing an outbound variant
with
destination queue names.
Resolution:
Code
was added to check for an inbound LocalEnvironment message and its
contents
are now propagated to the outbound LocalEnvironment message along
with
the destination queue information.
----------------------------------------------------------------------
APAR:
IY68747 - Neonmsg fails to add mqrfh2 header
PMR: 67339.036.724/68384
QTS: 380589/389292 doPropagate does not create
header
Problem:
The
doPropagate does not create an empty header when it did not exist in
the
inbound message. This is different behavior than CSD2.
Resolution:
Added
code to the doPropagate method associated with the rules evaluation
node to
check for pre-existence of RFH and RFH2 header when one was
requested. If the header did not exist the older
functionality of
creating
an empty header is performed otherwise the newer functionality of
copying
the pre-existing header is performed.
----------------------------------------------------------------------
APAR:
IY71814 - AN ERROR IS GENERATED WHEN USING NNFIE AND IMPORTING A
LITERAL WHICH IS ALREADY
DEFINED IN THE DATABASE.
PMR: 15388,344,000
QTS: 382574
Problem:
NNFie
reports errors when overwriting Literal components
Resolution:
The
error handling in NNFie was corrected to only show import errors.
----------------------------------------------------------------------
CMVC:
43082
QTS: 40509 libdvdb41mqi
missing on Linux
Problem:
The
files needed for XA transactions on Linux were not included.
Resolution:
The
files are now included in Linux x86 and Linux zSeries
=====================================================================
Part 2:
Rules and Formatter GUI Issues
=====================================================================
PMR: 36586,999,000
CMVC:
41653
QTS: 356766 Rules
GUI ODBC DSN dropdown empty, for non-Administrator user.
Problem:
Rules
GUI does not display full ODBC list if user does not have admin priviledges
Resolution:
Changed
code to use native ODBC function calls to fill ODBC list.
----------------------------------------------------------------------
CMVC:
42856 - Formatter GUI System Error Number 2
PMR: 74431,L6Q
QTS: 404292
Problem:
In the
Formatter GUI, the user can get a System error when opening an
output
control
Resolution:
The
Formatter GUI's were rebuilt to fix a corrupt build file.
----------------------------------------------------------------------
APAR:
IC37643 - SLOW FORMATTER GUI RESPONSE
PMR: 01771,215
QTS: 327459
Problem:
Slow
Formatter GUI response
Resolution:
Major
changes were made to the GUI to load permissions on demand.
----------------------------------------------------------------------
APAR:
IC46323 - GETITEM ERROR IN FORMATTER GUI WHEN ATTEMPTING TO
DUPLICATE A COMPONENT
PMR: 12604
QTS: 388924 Error when duplicating a format in
the Formatter GUI
Problem:
The
user can get a "GetItem Error" when duplicating a large format.
Resolution:
The
program was changed to handle larger number for formatter items.
======================================================================
Part 3:
Formatter Issues
======================================================================
CMVC:
41656 - SQL retrieving formats fails due to thousand separator in FMT_ID.
PMR: 44767,999,760 <- 27204,999,760
13948,999,760 <- 04619,999,760
PMR: 13948
QTS: 381633
Problem:
On AIX,
when retrieving data from the formatter database the SQL would
fail
due to a comma being formatted into a number.
Resolution:
To
prevent accidental numeric formatting, we switched our code to use
sprinf
instead of OStringStream when the number could be greater than 100.
----------------------------------------------------------------------
CMVC:
41204 - User Exit fails to compile
QTS: 407202
Problem:
User
Exit fails to compile.
Resolution:
As the
Makefile works in its’ current configuration, the implemented solution
to this
defect was to add a README file to the sample build directory
(
<INSTALL_DIRECTORY>/examples/NNSYRF ).
The README file, contains a note
on the
version of the GCC compiler and STLPORT used to build.
----------------------------------------------------------------------
CMVC:
IY33142.1 - Implicit and explicit data conversions for math expressions
PMR: 28356
QTS: 290003
Problem:
The New
Era of Networks Formatter chapter unclearly states:
NOTE: A math expression cannot be preceded by
data type conversion
output operations unless the output data type
is ASCII. For example,
the numeric format International Decimal cannot
be preceded by a
math expression.
Resolution:
The
note should read:
NOTE: If the output data type is not Decimal
US, String, or
Numeric, then you must use a Data
Type/Convert output operation
in your collection and order it after a Math Expression
operation.
----------------------------------------------------------------------
APAR:
IY73019 - MSGTEST CORES ON AIX.
PMR: 12636
QTS: 388925
Problem:
The
Message Broker cores on AIX when loading very large NNSY message
formats
and gives an error #1002 on Windows.
Resolution:
The SQL
query was modified to support a much larger number of rows
returned.
----------------------------------------------------------------------
APAR:
IY77176 - UNEXPECTED BEHAVIOR WITH THE TAGS AND REGULAR EXPRESSIONS
PMR: 30701
QTS: 400673
Problem:
When
using an optional regular expression input control, it was possible
to
parse one message correctly, finding data with the input control, and
then
parse a second message correctly without finding data with the
(optional)
input control. However, an attempt to
parse the first message
again
would yield a different result from the first parse.
Resolution:
This
was caused by corruption by error logging code during the second
parse,
and has been resolved.
----------------------------------------------------------------------
APAR:
IY77444 - Msgtest output debug indentation
PMR: 86334,L6Q,000
QTS: 405508
Problem:
The
level of indentation in a msgtest Output Debug report
continues
to grow, making the output hard to read.
Resolution:
We
changed the indentation logic to fix the instances where we
were
doing an indent with no corresponding unindent.
----------------------------------------------------------------------
APAR:
IY78259 - User exit error handling causing endless looping.
PMR: 74431
QTS: 404286
Problem:
When
the error handling code in the UserExit is called it causes an endless loop.
Resolution:
The
recursive call in the error handling routine was fixed.
----------------------------------------------------------------------
APAR:
PQ60739 - Repeating groups semicolon delimited not processing correctly
when two or more ocurrences
arrive in first repeating group.
PMR: 93308,519
QTS: 272816
Problem:
In the
Formatter, repeating groups semicolon delimited are not processing
correctly
when two or more ocurrences arrive in first repeating group.
Resolution:
The
formatter code dealing with repeating segment logic was fixed.
======================================================================
Part 4:
Documentation Issues
======================================================================
CMVC:
42420
QTS: 404589 R&F
Install Guide only details Windows design-time
Problem:
The
Rules and Formatter install guide does not include Linux design time.
Resolution:
The
install guide was modified to include all the O/S packages available.
----------------------------------------------------------------------
CMVC:
41654 - USE_OLD_NODES_PROCESSING not documented
PMR: 07488,082,000
QTS: 401398
Problem:
The
purpose of the action option USE_OLD_NODES_PROCESSING is not documented.
Resolution:
The use
of the USE_OLD_NODE_PROCESSING option on actions: SetLabel,
Propagate,
and PutQueue, effects serialization of the message in
special
circumstances.
When
USE_OLD_NODE_PROCESSING is enabled, the message is serialized w/o
transformation.
If
USE_OLD_NODE_PROCESSING is not enabled, message transformation is
performed
on serialization if:
· The format element within the message body
is set to Content instead
of
Wireformat
· The MessageType within the message body
does not match the MessageType
in the
header of the message.
----------------------------------------------------------------------
CMVC:
42196 - Document instdb
QTS: 403023
Problem:
The
documentation for inst_db is missing.
Resolution:
The
documentation for inst_db has been put back into the install guide.
----------------------------------------------------------------------