==================================================================== 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 ( /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. ----------------------------------------------------------------------