############################################################################### # # COMPONENT_NAME: MQSeries Adapter Kernel for Multiplatforms Version 1.1.1 # # FILE: memo.ptf # # Program Number 5648-D75 # (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 Kernel for Multiplatforms Version 1.1.1 CSD02 ------------------------------------------------------------------------------- This memo.ptf file corresponds to release 1.1 mod level 1 with the second CSD, which is defined as PTF U200159 and is numbered 02. The second CSD will bring your MQSeries Adapter Kernel for Multiplatforms Version 1.1.1 installation up to service level U200159. To determine your current service level, you may run aqmversion.bat (Windows systems) or aqmversion.sh (UNIX and AS/400) in the kernel bin directory. This will display the version number of the kernel. If your service level is already U200159 then you do not need to install this CSD. All previous CSD corrections for release 1.1 have already been incorporated in release 1.1 mod level 1 with CSD1, defined as PTF U200160. 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 Kernel for Multiplatforms Version 1.1.1, as well as a summary of the contents of the latest CSD and any earlier CSDs. The memo.ptf file for this release 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 Multiplatforms. * * * * Do not have source adapters running while you are * * applying or removing maintenance updates to MQSeries * * Adapter Kernel for Multiplatforms Version. * * * **************************************************************** 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. The procedure for OS/400 is different compared to other platforms. The following instructions are generic and do not apply to OS/400. For OS/400 specific instructions, please refer to "AS/400 Specific" section. 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 "Finish" button to complete the installation of the CSD. Restoring the Previous Backup Version ------------------------------------- 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'. Querying the Service Level -------------------------- To query the service level on Windows NT Version 4.0 and Windows 2000 , 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. NOTE: This file does not contain all information necessary for installation. See the MQSeries Adapter Kernel for Multiplatforms Quick Beginnings book for detailed information on how to install on a specific platform. The installation program for MQSeries Adapter Kernel for the various platforms uses Java to install the product to your workstation. It has been fully tested with Java Development Kit 1.1.8 and 1.2.2. Other versions of the Java Development Kit may work but are not directly supported. During installation, installation status messages are written to the log.txt file in the kernel's root directory. If a problem occurs during installation, you can examine this file. Windows NT and Windows 2000 Specific ==================================== The read only attribute of the memo.ptf and the readme.txt files needs to be changed to write. In a command window change into the MQSeries Adapter Kernel installation directory and enter: attrib -r memo.ptf To install on Windows NT and Windows 2000, run the installCSD.bat command file. On Windows 2000 the memo.ptf and readme.txt files are not replaced by the installation of the CSD. You must copy these files from the Win\W2K\ directory on the web to the MQSeries Adapter Kernel installation directory. AIX Specific ============ To install on AIX run the installCSD.sh shell script. On some AIX systems the installation directory entry field within the installation program displays as white text on a white background. Use the style manager color utility to modify the system color pallette before starting the install. Solaris Specific ================ To install on Solaris run the installCSD.sh shell script. Some users may see an hour glass for the cursor on some of the installation panels. The cursor can still be used to select buttons when displayed as the hour glass. HP-UX Specific ============== To install on HP-UX run the installCSD.sh shell script. At the end of the log.txt file there may be two messages: one indicating date and time could not be changed and the second indicating the file permissions could not be changed. These messages can be ignored. With some X-Windows managers, font errors may be given that can cause the installation to fail. Installation from a remote Intel-based system is usually successful. AS/400 Specific =============== To install on OS/400 use the installCSDAS400.jar file. java -cp installCSDAs400.jar run -os400 Before installing on the AS/400 create a user profile named MQAKSRV using the CRTUSRPRF command. Performing an install to an OS/400 system can be performed either from the OS/400 system or from an attached client. We recommend using the attached client method, it is the easiest and it has the best overall performance. AS/400 attached client ====================== On the workstation, open a command prompt and change to the AS400 directory of the MQSeries Adapter Kernel installation media (either local area network or CD-ROM). If the workstation is running JDK 1.1.8, enter the following command: jre -cp installCSDAS400.jar run -os400 If the workstation is running JDK 1.2.2 or higher, enter the following command: java -cp installCSDAS400.jar run -os400 AS/400 Remote AWT ================= Start Remote AWT on your client workstation by changing to the directory where you copied the RAWTGui.jar file and typing 'java -jar RAWTGui.jar'. The installAS400.jar file needs to be accessible to the OS/400 system. The file needs to be either in the IFS directory system, or on a device attached to the OS/400 system. If the file is on an attached device, you need to use the Create Link (CRTLINK) command to create a symbolic link to the file. You can significantly increase the performance of the install by running Create Java Program (CRTJVAPGM) against the installCSDAS400.jar file. On some machines the running of the CRTJVAPGM can be very time consuming. Call the Run Java (RUNJVA) command, supplying the TCP/IP address of the client that is running Remote AWT: RUNJVA CLASS(run) CLASSPATH('/installCSDAS400.jar') PROP((os400.class.path.rawt 1) (RmtAwtServer 'x.x.x.x') (java.version 1.2)) Uninstall on AS/400 =================== The uninstall CSD function on the AS/400 does not restore the previous version of the code as is done on other platforms. When the CSD is uninstalled, the installation of the kernel is destroyed. As a result, in order to restore the previous version of the code on the AS/400 platform, follow the following steps: 1. Uninstall CSD: java -cp uninstallCSDAS400.jar run -os400 2. Uninstall MQ Series Adapter V1.1: java -cp uninstallAS400.jar run -os400 3. Re-Install MQ Series Adapter V1.1. java -cp installAs400.jar run -os400 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ 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: In the Kernel's installation root directory under directory "documentation" there are language specific directories de, es, fr, it, ja, ko, pt_BR, zh_CN, and zh_TW. These directories should not be there and their html files do not contain valid links. Quick Beginings Book -------------------- Appendix C. Message headers - Table 13.MQSeries Adapter Kernel Header - Under column "Header name" value "RespondToLogicalID" The "Meaning or usage" description should be "Used for responses." - Under column "Header name" value "ProcessingCategory" The "Meaning or usage" description should be "Reserved use." - Under column "Header name" value "DeliveryCategory" The "Meaning or usage" description should be "Reserved use." - Under column "Header name" value "SessionID" The "Meaning or usage" description should be "Reserved use." Problem Determination Guide --------------------------- Chapter 2: Problem "Queue depth exceeded" The first response should be "Response: Set the maximum queue depth for the queue appropriately." ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ SPECIAL INFORMATION ------------------- A) CSD01 (PTF U200160) feature 1036 -------------------------------- 1) Audit Logging criteria has been changed from using the application id used for instantiating the NativeAdapter to: a) Using the SourceLogicalID meta-data value of the Message being sent. b) Using the ApplicationID of ENAService object being used to receive a message. 2) Two new Audit Logging API's are now used for Audit Logging: a) writeSentMsg(EpicMessage) when sending a message. b) writeRetrievedMsg(EpicMessage) when retrieving a message. If either of these two methods do not exist then the current writeAudit(EpicMessage) will be used. Use of the new API's still require Websphere Business Integrator product 5724-A78 version 2.1 plus CSD01 or later. B) CSD02 (PTF U200159) ------------------- 1) feature 15275 If a process is running without WebSphere Business Integrator (WSBI) installed, an exception message is issued indicating that the Exception Log client class cannot be found. Now, the following exception message is issued only for the first occurrence of the flow: "Putting a message to an error queue". 2) feature 15213 The support for C Adapters is now fully NLS enabled. ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ SERVICE AND TECHNICAL SUPPORT ----------------------------- A) Service Level Information ------------------------- IBM MQSeries Adapter Kernel for Multiplatforms Version 1.1.1 CSD 02 is the second PTF for the third 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 additional information 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) CSD01 (PTF U200160) ------------------- This is the first CSD for IBM MQSeries Adapter Kernel for Multiplatforms Version 1.1.1 from IBM. It is delivered via PTF U200160. Number of APARs in CSD = 1. It contains fixes for all the problems listed below: APAR IC30330 ------------ 0001061 - JMSNMRFH2Formatter doesn't set DestinationLogicalID. 0001063 - RelatedSubjectID missing from JMS Formatter processing. Non-APAR ------------ 0001036 - NativeAdapter - Use new Logging API's and log by appid criteria. 0001046 - AdapterExceptionMessages.properties messageid corrections. 0001049 - AdapterExceptionMessages.properties messageid corrections. 0001055 - Installation language corrections. 0001076 - Updated NLS message files. 0001096 - MQNMBDFormatter requires epicdestids in target application configuration on EpicNativeAdapter sendRequestResponse. B) CSD02 (PTF U200159) ------------------- This is the second CSD for IBM MQSeries Adapter Kernel for Multiplatforms Version 1.1.1 from IBM. It is delivered via PTF U200159 and includes all fixes from CSD01. Number of APARs in CSD = 0. It contains fixes for all the problems listed below: Non-APAR ------------ 0015215 - Two Exception Message issues 0015217 - Builder-generated adapter gets NullPointer Exception calling toString 0015218 - MQAOXMLIJ.copyContents problem with comments and PIs 0015219 - Passing in null to ENA.receiveMsg gives NullPointerException 0015220 - AdapterDirectory::getDirectoryServices - EpicMessage in message 0015226 - No TraceDaemon output if TraceServer ePICTrace = false 0015229 - Alias Queues don't work with the AdapterDaemon 0015275 - Suppress repeated exception traces if WSBI is not installed. 0015295 - Sample does not compile without the epicDirectory.jar ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ 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. ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++