############################################################################### # # COMPONENT_NAME: IBM MQSeries Adapter Builder Version 1.0.1 # # FILE: memo.ptf # # Program Number 5639-L40 # (C) COPYRIGHT International Business Machines Corp. 1995, 2001 # All Rights Reserved # Licensed Material - Property of IBM # # US Government Users Restricted Rights - Use, duplication or # disclosure restricted by GSA ADP Schedule Contract with IBM Corp. # ############################################################################### PTF Memo for IBM MQSeries Adapter Builder Version 1.0.1 CSD03 ------------------------------------------------------------------------------- This memo.ptf file corresponds to release 1.0 mod level 1 with the third CSD, which is defined as PTF U200177 and is numbered 03. The third CSD will bring your MQSeries Adapter Builder Version 1.0.1 installation up to service level U200177. All previous CSD corrections for release 1.0 have already been incorporated in release 1.0 mod level 1 with no CSD's. This CSD contains additional corrections or features as documented in the "CSD HISTORY" section. This memo.ptf file will be updated whenever a cumulative service PTF is made available. It will be updated to contain information that you will need for updating IBM MQSeries Adapter Builder Version 1.0.1, as well as a summary of the contents of the latest CSD and any earlier CSDs. This file is divided into the following sections: o Installation and maintenance information o Documentation changes o Special information o Service and technical support o CSD history +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ INSTALLATION AND MAINTENANCE INFORMATION ---------------------------------------- Maintenance updates can be supplied on CD-ROM, or they can be downloaded from the World Wide Web. The installation of this PTF requires approximately 20MB of disk space to do the PTF installation and to save the previous level. Some of this disk space is used to keep copies of the previous levels of the parts updated by this PTF so that the PTF can be removed, and the previous level automatically restored. Installing CSD03 ---------------- If you need to apply maintenance updates to your MQSeries Adapter Builder product: 1. Shut down the IBM MQSeries Adapter Builder Control Center. 2. Ensure you are logged on as an Administrator 3. Run setup.exe 4. You will be presented with the "Welcome" dialog. Select the "Next>" button. 5. Accept the license agreement and then select the "Next>" button. 6. Enter the User Name, Organization and Installation Type then select the "Next>" button to continue. 7. From the "Ready to Install" dialog, verify that the installed components are correct and then select the "Next>" button to proceed. 8. Verify the installation was successful on the "Installation Summary" dialog. 9. Select the "Finish" button to complete the installation of the CSD. Installing MQAOJFramework CSD03 ------------------------------- The file MQAOJFramework.jar should be copied to each machine that will be running generated Java Service Adapters. After copying the file to the target machine, running aqmjfversion should indicate build level mqab1.0.1c_1127. Restoring the Previous Backup Version ------------------------------------- If you need to restore from backup, to the previous level of maintenance: 1. Shut down the IBM MQSeries Adapter Builder Control Center. 2. Ensure you are logged on as an Administrator 3. Select MQSeries Adapter Builder v1.0.1 CSD03 from Add/Remove Programs then select 'Remove'. Note: uninstalling the CSD will return MQSeries Adapter Builder to the previous level. +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ DOCUMENTATION CHANGES --------------------- In addition to any amendments to the MQSeries Adapter Builder publications listed in the read.me file on the product CD-ROM, the following updates to the Builder Help system were also made: A description was added for the new TDC and non-TDC interfaces that are generated for a EJB Interface adapter type. A description of the system-supplied components (messages, transaction, classes, data contexts, microflow templates) was added to provide an introduction to these components and a link to the more detailed documentation in the Kernel's Java API Reference. +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ SPECIAL INFORMATION ------------------- New functionality: XML, OAG and Java Reimport (C Reimport is not supported). XML or OAG reimporter: Steps 1. Export the original workspace for backup. 2. Right click the appropriate message set, and select “Import to Message Set” and then “DTD Reimport” (or “OAG Reimport”) 3. Browse to the desired file on the displayed panel, select it and press Finish. Remarks o Unlike the importer, the reimporter does not prompt for specific messages. Rather, it automatically selects suitable messages from the original import. o Close and save after each reimport. o A “deep checkout” is performed automatically on each message (and its children). However, the user may have to manually checkout the message set itself prior to reimport. Java reimporter: The Java importer retains its original functionality, that is, if extra methods are required after the initial scan, simply use the importer to add the additional methods to the model. If, however, the attributes of the class of been altered, either by deleting some, adding new ones or changing properties of existing ones, the reimporter must be invoked to reflect these changes. As an example, consider this scenario: First you import a class and choose some of its methods. Next you change the attributes in the class, but instead of reimporting you first perform an import to add an additional method to your system. You will not get the changed class attributes. That is to say, when you import the new method, it finds the old attributes and uses them as is. To get the new attributes you must use the reimport. Steps 1. Export the original workspace for backup. 2. Right click the appropriate message set, and select “Import to Message Set” and then “Bean Reimport” 3. Browse to the desired file on the displayed panel, select it and press Finish. Remarks o Unlike the importer, the reimporter does not prompt for specific methods. The Java reimporter works only with class attributes. o Close and save after each reimport. o A “deep checkout” is performed automatically on the object (and its children). However, the user may have to manually checkout the message set itself. Restrictions When changing an attribute type but keeping the same name, as, for example, when changing int aName to MyType aName, the following considerations should be kept in mind (note that in this case we are neither removing nor adding an attribute – rather, we are changing the type on an existing attribute): o Changing primitive to primitive (int x --> float x) This will work with mapping integrity maintained (unless the Mapping used the Advanced SQL option). o Changing object to object (MyType aName --> MyOtherType aName) The reimporter will update the type correctly but mappings to aName or its children will become invalid. o Changing object to primitive (MyType aName --> double aName) The reimporter will update the type correctly but mappings to aName or its children will become invalid. o Changing primitive to object (char aName --> MyType aName) Currently not supported. Note that java.lang.* object equivalents of primitives are considered primitives in the tool. Thus, changing int aName to Integer aName is considered a primitive to primitive conversion rather than primitive to object. * New functionality: Added ability for C Adapters to fail immediately when XML parsing errors occur. To enable this new behavior, the user must update the following files: o mqab.bat: add -DfailOnParse to the Java command starting MQAB, for example, in the :NODEBUG section of mqab.bat, the command would be added as: start javaw.exe -cp "%MQAB_CLASSPATH%" -DfailOnParse -Xmx... ------------- IMPORTANT: An adapter must be regenerated with this option set to exhibit the new behavior. o aqmsetup (MQAK file): add the following line to aqmsetup to end the adapter if the document to parse is not well-formed: C_ADAPTERS_FAIL_ON_PARSE_ERROR=1 For full validity checking to occur when parsing the document, add the additional line to aqmsetup: XML_PARSE_VALIDATION_STATE=FULL This setting (in tandem with C_ADAPTERS_FAIL_ON_PARSE_ERROR=1) will cause the adapter to fail if the document to be parsed is not valid based on its DTD. Note, this option will increase the processing time required to parse the document. +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ SERVICE AND TECHNICAL SUPPORT ----------------------------- A) Service Level Information ------------------------- IBM MQSeries Adapter Builder V1.0.1 CSD 03 is the third PTF for the second release of product 5639-L40. B) Service Support Available from the Internet ------------------------------------------- You can find additional information on the MQSeries Web site, located at: http://www.ibm.com/software/ts/mqseries/ For SupportPacs(TM) related to MQSeries Adapter Offering, see the following Web page on the MQSeries Web site: http://www.ibm.com/software/ts/mqseries/adapter/information For current information on known problems and available fixes please see the Support option on the MQSeries Web site at: http://www.ibm.com/software/ts/mqseries/support From the MQSeries support page, you can obtain the latest information about the following topics: IBM Transaction Processing SupportPacs Closed APARs Fix Packages Frequently Asked Questions Tips and Techniques Device Drivers Forums Related Links +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ CSD HISTORY ============ A) CSD03 (PTF U200177) ------------------- This is the third CSD for IBM MQSeries Adapter Builder Version 1.0.1 from IBM. It is delivered via PTF U200177. It contains fixes for all the problems listed below: 0001126 - Java Generation: Duplicate variable decl when mapping from two Response terminals 0001127 - XML Cursor map more than 1 level deep may fail 0001128 - C Generation: Mapping to a large char array may result in a memory fault 0001129 - Java Generation: Long generation time with recursive Java classes 0001130 - C Generation: when mapping to a BOOLEAN, code is missing ) 0001131 - Unable to generate code using XCBL messages 0001132 - Incorrect name created when importing a method whose name is contained in the package. 0001133 - Same Decision node in multiple flows causes bad C Generation. 0001134 - Decision node that uses different properties of a class in decision branches fails. 0001136 - Java Generation: Exceptions not proprogated through iterations 0001137 - Improper handling of '-' in XML root names 0001138 - No exception thrown on parse error in C code 0001139 - Framework: "Object" is not set into response message after the first call to the ClassFC B) CSD02 (PTF U200173) ------------------- This is the second CSD for IBM MQSeries Adapter Builder Version 1.0.1 from IBM. It is delivered via PTF U200173. It contains fixes for all the problems listed below: 00001109 - Creating source file message info is wrong 00001113 - Framework is using wrong trace levels for tracing 00001116 - C Generation: Invalid code generated for a Command if the return is a simple pointer 00001117 - Java Generation: an incomplete decision object could be generated if the decision is used multiple times in the flow 00001118 - Java Generation: Invalid Java code generated if an XML name has an invalid character for a Java Identifier (such as .) 00001119 - Root element containing special characters doesn't generate properly when used in an iteration. 00001121 - Proper handling of NLS characters in the repository and in code generation. 00001123 - C Generation: DecisionNode condition referencing a compound type generates invalid code. C) CSD01 (PTF U200164) ------------------- This is the first CSD for IBM MQSeries Adapter Builder Version 1.0.1 from IBM. It is delivered via PTF U200164. It contains fixes for all the problems listed below: 0000636 - Import of C-header file with windows.h appears to cause tool to hang 0000743 - No msgs created when importing OAG and selecting all elements 0000914 - StackOverflowExc for flow with a Decision wired back to itself 0000989 - Bean importer allows reimport of a method resulting in duplicates 0001003 - Failure in CAST(CURRENT_TIMESTAMP AS CHAR) 0001005 - Problem setting CURRENT_TIMESTAMP into fields. 0001007 - Can't start a connection after doing a hide ports on a terminal 0001008 - Data context referencing message from message set not currently in the Workspace gives nullptrexception in generation 0001029 - Additional simple java types added to Base Java messageset. 0001035 - "Duplicate" elements created when reimporting DTDs 0001037 - Microflow XML file is still open after generating adapter 0001040 - OAG Importer does not support extensions 0001042 - EJB adapter may not provide useful exception info 0001043 - Modifying a decision node that is being used in a flow that is not checked out appears to hang the tool 0001044 - Generated code using an imported class with no package will not compile 0001048 - Unable to set bodytype/category into reply message 0001051 - Invalid type created when importing a class with a constructor that throws a java... exception. 0001054 - Long directory+package+classname results in nullPtrException 0001056 - Code Generation Error for ESQL "string IS NOT NULL" 0001059 - Improper boolean instantiation in ESQL 0001060 - Unable to import using non-English locale 0001067 - A ClassFC referenced in a flow but not in workspace is not exported 0001068 - Error in C Importer when file is added using text-entry field 0001069 - String Data Context does not hold data 0001070 - OutOfMemory Exceptions during generate are not reported to the user, tool appears to hang. 0001073 - ArrayIndexOutOfBoundsException when user doesn't specify a Bean 0001079 - Export may report complete before the zip is closed 0001080 - Using a node other than a navigator in LinkListIteration causes generic Exception rather the correct error message. 0001085 - Generated code for XML Elements with only Attribute children may be missing. 0001086 - Add defaulted XML attributes automatically in Java code. 0001087 - Java method may still be imported after removing it from the selection dialog. 0001092 - Add tooling build number to generated code 0001093 - Generated map code should not create a target XML Element if the source data is null 0001094 - Java import should only allow public methods to be imported. 0001095 - Improve error reporting in MQAK Command Interface. 0001097 - Improper logic generated for suppress doctype, xmldecl in Java. 0001100 - Generation optimization for nested flows. 0001104 - Simple Adapter should not refer to EJB package. +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ TRADEMARKS ---------- The following terms are trademarks of the IBM Corporation in the United States or other countries or both: IBM AIX MQSeries Windows is a trademark of Microsoft Corporation. +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++