######################################################################## # # COMPONENT_NAME: MQSeries Adapter Kernel # # FILE: MEMO.PTF # # Program Number 5648-D75 # (C) COPYRIGHT International Business Machines Corp. 1995, 2000 # 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 Kernel for Windows NT** and AIX** Version 1.0 ------------------------------------------------------ This memo.ptf file contains information you need for updating IBM MQSeries Adapter Kernel for Windows NT and AIX V1.0 by CSD, as well as a summary of the contents of the latest CSD and any earlier CSDs. This memo.ptf file corresponds to the first CSD, which is defined as PTF U200143 and is numbered 01. The first CSD will bring your MQSeries Adapter Kernel for Windows NT and AIX Version 1.0 installation up to service level U200143. If your service level is already U200143 then you do not need to install this CSD. The memo.ptf file for this CSD 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. ** Precaution ************************************************** * * * Do not have the AdapterDaemon running while you are * * applying or removing maintenance updates to MQSeries * * Adapter Kernel for Windows NT and AIX. * * * * Do not have source adapters running while you are * * applying or removing maintenance updates to MQSeries * * Adapter Kernel for Windows NT and AIX. * * * **************************************************************** The installation of this PTF requires approximately 10MB 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. If you need to apply maintenance updates to your MQSeries Adapter Kernel product: 1. Ensure you are logged on as an Administrator 2. Ensure that the IBM MQSeries Adapter Kernel's AdapterDaemon has been stopped. 3. Ensure that all source adapters are stopped. 4. The installation process will automatically detect what components you have previously installed on your system, and it will only update those components. 5. You will be presented with the "Welcome" dialog. Select the "Next>" button. 6. Type in or choose the directory where you have installed the base product and then select the "Next>" button. 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 "Next>" button to display the Readme Information. 10. Select the "Exit" button to complete the installation of the CSD. B) Installation Error Message "OleMainThreadWndName: WindowsNativeToolkit.exe" -------------------------------------------------- This error is produced on some NT systems. It occurs at the end of installation while the installation program is updating the registry information with uninstall information. The product has already been successfully installed and this error can be ignored. C) Restoring the Previous Backup Version on Windows NT V4.0 -------------------------------------------------------- If you need to restore from backup, to the previous level of maintenance: 1. Ensure you are logged on as an Administrator 2. Ensure that the IBM MQSeries Adapter Kernel's AdapterDaemon has been stopped. 3. Ensure that all source adapters are stopped. 4. Select MQSeries Adapter Kernel from the Start Menu and then select 'Remove CSD'. D) Querying the Service Level -------------------------- To query the service level on Windows NT Version 4.0, select "Start", and then select "Programs" and then select "MQSeries Adapter Kernel", and finally select "Service Level". This shows the memo.ptf file containing the service level and details of the maintenance applied (PTF number). This file is included in the root directory of the CD-ROM. ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ DOCUMENTATION CHANGES --------------------- In addition to any amendments to the MQSeries Adapter Kernel publications listed in the read.me file on the product CD-ROM, the following changes to the publications should also be made: None at this time. ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ SPECIAL INFORMATION ------------------- A) CSD01 (PTF U200143) ------------------- Feature number 128 - Single phase transaction support for sending and receiving messages. Single phase transaction support was added to the Native Adapter (class com.ibm.epic.adapters.eak.native.EpicNativeAdapter) for sending messages. To start a transaction call begin() on the Native Adapter. To end the transaction call commit() or rollback() on the Native Adapter. The receiveMsg(...) method was modified accordingly for consistency. Previously, receiveMsg(...) always received under transaction control so that a commit had to be done to physically remove the received message from the input. Now to receive under transaction control the method has to be called within a transaction scope. If your code was always calling commit then no code changes are necessary. The sendRequestResponse(...) never operates within transaction scope so that the sent message can be received. Note: transaction support is dependent on the underlying transport system. ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ SERVICE AND TECHNICAL SUPPORT ----------------------------- A) Service Level Information ------------------------- IBM MQSeries Adapter Kernel for Windows NT and AIX V1.0 is the first release of product 5648-D75. 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/txppacs 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) CSD01 (PTF U200143) ------------------- This is the first CSD for IBM MQSeries Adapter Kernel for Windows NT and AIX Version 1.0 from IBM. It is delivered via PTF U200143. Number of APARs in CSD = 0. It contains fixes for all the problems listed below: 0000018 - The trace client incorrectly determines the trace client output 0000022 - EpicNativeAdapter.commit( ) throws NullPointerException. 0000030 - EpicAdapterWorker does not always instantiate a logon 0000037 - RFH2Header.java is throwing wrong exception - throws AQM0113 0000062 - Add function to AQMETCC for writing an AQMRT to trace. 0000064 - AdaptersTraceMessages messageid AQM5204 correction 0000068 - aqmverifyinstall.bat should not permanently change AQMSETUPFILE 0000072 - AQMENAUtC_sendRequestResponse(...) return needs changed. 0000083 - EpicTraceClient writes no messages when in loop. 0000084 - Getting 'Out of memory' errors and javacore dumps on AIX machine 0000086 - Added new methods, addSegment and setSegment, to add/set a segment value and move the cursor to the resulting node. 0000091 - AQMCSRC - add setXMLDecl(...) and setXMLDocTypeDecl(...) 0000092 - AQMXMLIC - createXMLDocumentAllFields fails with NULL's 0000103 - EpicTraceClient - modify for new default configuration. 0000105 - Need to trim trailing blanks from epictrace FILTER value. 0000106 - Bad trace record in getLMSInstanceForApplication(). 0000108 - Incorrect trace msg on EpicAdapterWorker.processMessage exit. 0000111 - AQMENAC_create() should check appName and compName parms for null 0000116 - MQRFH1 and MQRFH2 msg formats don't handle 0 body data 0000118 - Change DOMException error message. 0000119 - Several small memory leaks were fixed in the C interface code. 0000121 - The defaulting of certain Trace configuration parameters has been changed. 0000126 - NullPointer exception in EpicMessage set methods 0000127 - NumberFormatException received when processing RFH2 data 0000128 - Added single phase transaction support for sending and receiving messages. 0000147 - EpicTraceFileHandler tracing not working. 0000191 - AQMXMLIC.c getElementValues needs to handle Boolean return value. 0000207 - Added interim MQSeries support to send/receive Body data only. 0000211 - MQAOXMLIJ.getElementNext(MQAOCSRJ) needs to check if next node is an Element node. ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ 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. ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++