====================================================================

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.

----------------------------------------------------------------------