====================================================================
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.
----------------------------------------------------------------------
CMVC: 35397 - NNSY sample rules and formats are not useable on z/OS
PMR: 00109,284
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 - Incorrect installation summary
QTS: 414512
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 successfully in processing the users request, which in
this case was a request to cancel.
----------------------------------------------------------------------
CMVC: 36418 - Formatter GUI unable to export components with spaces
in names
QTS: 359108
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 - inst_db fails on Linux using Oracle 9i
QTS: 397208
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 - Neonmsgfails 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 - libdvdb41mqi missing on Linux
QTS: 40509
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
=====================================================================
CMVC: 41653 - Rules GUI ODBC DSN dropdown list is empty for
non-admin user.
PMR: 36586,999,000
QTS: 356766
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: 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 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 - THE MSGTEST UTILITY DOES NOT PARSE THE DATA CORRECTLY
WITH -DCO OPTIONS.
PMR: 86334,L6Q,000
QTS: 405508 Msgtest output debug indentation
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.
-----------------------------------------------------------------------
APAR IY52037 - SUBSTITUTE OPERATION DOES NOT PRODUCE EXPECTED RESULT
WHEN INPUT FIELD IS EBCDIC DATA
PMR 49144,019
QTS 327970
Problem:
A change introduced in CSD5 exposed a problem where EBCDIC input data
types mapped to String output data types can give unpredictable results.
Solution:
The safest long-term solution to this problem is to change affected
output control data types from String to Not Applicable. This will
result in the same output as before CSD5.
======================================================================
Part 4: Documentation Issues
======================================================================
CMVC: 42420 - R&F InstallGuide only details Windows design-time
QTS: 404589
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 purpose and use of 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.
----------------------------------------------------------------------