############################################################################### # # COMPONENT_NAME: MQSeries Adapter Kernel for Multiplatforms Version 1.1 CSD 1 # # 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 Multiplatforms Version 1.1 CSD 1 ----------------------------------------------------------------------------- This memo.ptf file contains information you need for updating IBM MQSeries Adapter Kernel for Multiplatforms Version 1.1 by CSD. It also contains a summary of the contents of this CSD and any earlier CSDs on this release level. This memo.ptf file corresponds to the first CSD, which is defined as PTF U200152 and is numbered 01. The first CSD will bring your MQSeries Adapter Kernel for Multiplatforms Version 1.1 installation up to service level U200152. 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 U200152, 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 are supplied as downloads from the World Wide Web. ** Precaution ************************************************** * * * Do not have the Adapter Daemon 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 program for MQSeries Adapter Kernel uses Java to install the product to your workstation. It has been fully tested with IBM 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. The installation of this CSD requires approximately 10MB of disk space for installation of new and updated files and to save a backup of the previous service level. Please note that the CSD installation, backup and restore operations vary for the AS/400 operating environment. The following instructions do not apply to AS/400. For AS/400 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 Adapter Daemon 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 Adapter Daemon has been stopped. 3. Ensure that all source adapters are stopped. 4. On Windows NT or Windows 2000, select MQSeries Adapter Kernel from the Start Menu and then select 'Remove CSD'. On UNIX, use the aqmuninstall.sh shell script that is installed in the kernel base installation directory. For AS/400, please see the section entitled "AS/400 CSD Specific" below. Windows NT and Windows 2000 Specific ==================================== To install on Windows NT and Windows 2000, run the installCSD.bat command file. 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. To work around this problem, use the style manager color utility to modify the system color palette before starting the install. Solaris Specific ================ To install on Solaris run the installCSD.sh shell script. Some users may see an hourglass for the cursor on some of the installation panels. The cursor can still be used to select buttons when displayed as the hourglass. 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. When installing the kernel from a remote X-Window session, font errors may be given that can cause the installation to fail. Installation from a remote Intel-based system is usually successful. AS/400 CSD Specific ================== Note: On the AS/400, the CSD installation process does not automatically backup the previous version of the product. In order to be able to restore the previous version of the product in the event that the CSD needs to be removed, perform the following manual steps before installing the CSD. Step 1 is only required if mqakbackup library was previously created. 1. dltlib lib(mqakbackup) 2. cpylib fromlib(mqak) tolib(mqakbackup) 3. cp -r /qibm/proddata/mqak /qibm/proddata/mqakbackup Instructions for restoring from backup are described below in the section "Uninstall on AS/400." Performing an install to an AS/400 system can be performed either from the AS/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 directory where the installCSDAS400.jar file is located. 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 AS/400 system. The file needs to be either in the IFS directory system, or on a device attached to the AS/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 =================== As described above, 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. The following restore steps assume that you have backed up the previous service level before installing the CSD, as described above in section: "AS/400 CSD Specific:" 1. Uninstall CSD: java -cp uninstallCSDAS400.jar run -os400 2. Restore the files previously backed up. 1. dltlib lib(mqak) 2. cpy fromlib(mqakbackup) tolib(mqak) 3. cp -r /qibm/proddata/mqakbackup/* /qibm/proddata/mqak ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ 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 U200152) ------------------- National Language Support (NLS) testing has indicated problems when using adapters implemented in C. These adapters will not properly handle language characters other than English. ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ SERVICE AND TECHNICAL SUPPORT ----------------------------- A) Service Level Information ------------------------- IBM MQSeries Adapter Kernel for Multiplatforms Version 1.1 CSD 1 is the first PTF for the second 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 U200152) ------------------- This is the first CSD for IBM MQSeries Adapter Kernel for Multiplatforms Version 1.1 from IBM. It is delivered via PTF U200152. Number of APARs in CSD = 0. It contains fixes for all the problems listed below: 0000565 - MQ reason code 2045 on remote queue open. 0000569 - FormatEpicNLSMessage error on message AQM5127. 0000574 - sendRequestResponse fails with useremoteqmgrtosend. 0000577 - EpicTraceClient.writeText(...) null parameter causes exception. 0000594 - EpicNativeAdapter - javadoc links for deprecated fields wrong. 0000608 - Getting an exception on NO_BODY_DATA MQRFH2. 0000609 - Wrong exception object used in AQM5127 message. 0000610 - EpicNativeAdapter - javadoc contains @link text 0000625 - Trace messages corrections. 0000632 - NLS: VerifyInstall works if Qmgr's CCSID is 819 (or SBCS one). 0000634 - NLS: European messages display with corrupted char. 0000648 - Extra characters on ENAHandler trace server messages. 0000651 - AdapterDirectory constructor always instantiates an FSCONTEXT. 0000656 - Formatter and LMS NLS changes for DBCS machines. 0000671 - Extra characters in ENAHandler trace server messages. 0000681 - Missing trace msg ID on Entering and Exiting messages. ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ 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. ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++