Readme for IBM MQSeries for AIX Version 5.2 Download PTF U478292 ================================================================ This readme file contains information you need for updating IBM MQSeries for Linux Version 5.2 (server and/or client), as well as a summary of the contents of the latest CSD and any earlier CSDs. This is the third CSD, corresponding to PTF U478292, and it is numbered 03. It will bring your MQSeries for Linux Version 5.2 installation up to service level U478292 (CSD03). This PTF can be used to update the MQSeries for Linux V5.2 server. This PTF can be used to update the MQSeries for Linux V5.2 client if you installed the client in one of the following ways: a) From the MQSeries for Linux V5.2 CD-ROM b) From the MQSeries V5.2 client CD-ROM c) By downloading the SupportPac MACI from the web and installing it. After installation of this CSD, there is a MEMO.PTF file that contains information relating to this PTF. You are advised to read this file which contains: o installation instructions for applying maintenance o a summary of the current and superseded service levels o Special Information which may be mandatory for complete resolution of one or more of the APAR fixes shipped by this PTF. This PTF is applicable to ALL releases of product 5639-I84-00, IBM MQSeries for Linux Version 5.2, namely the English version or any of the National Language versions. How to Download this Corrective Service ======================================= The corrective service files in this directory are of the form: U4xxxxx.tar.Z This means that they have been processed by the tar program and then compressed. The latest PTF (U478292) supersedes all previous PTFs for MQSeries for Linux V5.2 and it contains updates to the following components of MQSeries for Linux: MQSeriesRuntime-5.2.0-3.i386.rpm MQSeries Runtime support for external applications MQSeriesSDK-5.2.0-3.i386.rpm MQSeries base kit for client and server MQSeriesServer-5.2.0-3.i386.rpm MQSeries server support for client connections MQSeriesClient-5.2.0-3.i386.rpm MQSeries client libraries for Linux MQSeriesSamples-5.2.0-3.i386.rpm MQSeries Samples MQSeriesMsg_de-5.2.0-3.i386.rpm MQSeries Messages - English MQSeriesMsg_es-5.2.0-3.i386.rpm MQSeries Messages - Spanish MQSeriesMsg_fr-5.2.0-3.i386.rpm MQSeries Messages - French MQSeriesMsg_it-5.2.0-3.i386.rpm MQSeries Messages - Italian MQSeriesMsg_ja-5.2.0-3.i386.rpm MQSeries Messages - Japanese MQSeriesMsg_ko-5.2.0-3.i386.rpm MQSeries Messages - Korean MQSeriesMsg_pt-5.2.0-3.i386.rpm MQSeries Messages - Portuguese-Brazilian MQSeriesMsg_Zh_CN-5.2.0-3.i386.rpm MQSeries Messages - Simplified Chinese MQSeriesMsg_Zh_TW-5.2.0-3.i386.rpm MQSeries Messages - Traditional Chinese In addition there are two additional APAR fixes provided which if applicable to your installation should also be downloaded and applied on any installation at service level U478292 (CSD #3). These optional APAR fixes are IC32843 and IY28347. The files to be downloaded and the instructions for installing for these APAR fixes are specified below. It is recommended that you apply hiper APAR fix IC32843 if you use channel send and receive exits. It is recommended that you apply hiper APAR fix IY28347 if you use CICS, Encina or Tuxedo XA applications with MQSeries. PTF U478292 ----------- To use the latest PTF file, perform the following steps: 1) download the file to your local system in binary mode 2) gunzip -fv U478292.tar.gz. 3) tar -xvf U478292.tar APAR IC32843 ------------ After applying V5.2 CSD03, installations that use channel send and receive exits have encountered problems (eg. when changing channel definitions with PCF commands). The APAR fix (IC32843.linux.tar.Z) for this problem consists of a single compressed tar file which contains replacements for the following libraries in MQSeries for Linux V5.2: libmqmr.so libmqmr_r.so PTF U478290 is a pre-requisite for this APAR fix. To apply the fix :- (1) Ensure you are logged in as root. You must be a superuser to apply this efix. (2) Uncompress the IC32843.linux.tar.Z file into a temporary directory: uncompress IC32843.linux.tar.Z (3) Expand the IC32843.linux.tar file in the temporary directory: tar -xvf IC32843.linux.tar (4) Stop all MQ channels. (5) End all queue managers and MQ processes on the target machine. (6) Ensure that any shared resources are deleted. (7) Take backup copies of the following libraries on your system: libmqmr.so libmqmr_r.so (8) Copy over the two libraries from the temporary directory to replace the existing libraries. (9) Restart the queue managers. (10) Log off as root and log on as mqm before starting the queue manager. APAR IY28347 ------------ After applying V5.2 CSD03, installations that use CICS, Encina or Tuxedo XA applications have encountered problems where the transactions fail to start. The APAR fix (IY28347.linux.tar.Z) for this problem consists of a single compressed tar file which contains replacements for the following libraries in MQSeries for Linux V5.2: libmqm.so libmqm_r.so PTF U478290 is a pre-requisite for this APAR fix. To apply the fix :- (1) Ensure you are logged in as root. You must be a superuser to apply this efix. (2) Uncompress the IY28347.linux.tar.Z file into a temporary directory: uncompress IY28347.linux.tar.Z (3) Expand the IY28347.linux.tar file in the temporary directory: tar -xvf IY28347.linux.tar (4) Stop all MQ channels. (5) End all queue managers and MQ processes on the target machine. (6) Ensure that any shared resources are deleted. (7) Take backup copies of the following libraries on your system: libmqm.so libmqm_r.so (8) Copy over the two libraries from the temporary directory to replace the existing libraries. (9) Restart the queue managers. (10) Log off as root and log on as mqm before starting the queue manager. Installation and Maintenance Information ======================================== A) Applying Maintenance to MQSeries for Linux V5.2 ----------------------------------------------- These steps will ensure that you are left with files that are installable using the normal install method for your platform. +--- PRECAUTIONS ---------------------------------------+ | | | Do not have any queue managers operating during | | installation of maintenance on MQSeries for Linux | | V5.2. | | | | Remove any existing MQSeries shared memory and/or | | semaphores before applying or removing maintenance | | updates to MQSeries for Linux V5.2. | | | +-------------------------------------------------------+ | | | To end all running queue managers: | | | | 1. End the queue manager by issuing the command: | | | | endmqm -i QMgrName | | | | 2. Check that the queue manager has ended. | | | | Use the command: | | | | endmqm -w QMgrName | | | | The message returning should show that the queue | | manager is not available. | | | +-------------------------------------------------------+ B) SPACE REQUIREMENTS ------------------ This PTF requires 5MB hard disk space for installation. In addition, the installation process requires up to an identical amount of 5MB disk space to save the previous level. Files updated by a PTF installation are kept in a backup directory. This allows a PTF to be removed and the previous level to be automatically restored. Previous levels are stored in the directory /opt/mqm/ptf_backup. Do not delete or move these directories and files. C) APPLYING THE MAINTENANCE INFORMATION ------------------------------------ To apply the maintenance information in the PTF: 1. Change to the directory where the CSD is saved. 2. Install the software in the following sequence: MQSeriesRuntime-5.2.0-3.i386.rpm MQSeriesSDK-5.2.0-3.i386.rpm MQSeriesServer-5.2.0-3.i386.rpm MQSeriesClient-5.2.0-3.i386.rpm MQSeriesSamples-5.2.0-3.i386.rpm 3. Install each PTF by entering and executing the following commands: rpm -i --replacefiles MQSeriesRuntime-5.2.0-3.i386.rpm rpm -i --replacefiles MQSeriesSDK-5.2.0-3.i386.rpm rpm -i --replacefiles MQSeriesServer-5.2.0-3.i386.rpm rpm -i --replacefiles MQSeriesClient-5.2.0-3.i386.rpm rpm -i --replacefiles MQSeriesSamples-5.2.0-3.i386.rpm 4. Install any required MQSeries message files: MQSeriesMsg_de-5.2.0-3.i386.rpm MQSeriesMsg_es-5.2.0-3.i386.rpm MQSeriesMsg_fr-5.2.0-3.i386.rpm MQSeriesMsg_it-5.2.0-3.i386.rpm MQSeriesMsg_ja-5.2.0-3.i386.rpm MQSeriesMsg_ko-5.2.0-3.i386.rpm MQSeriesMsg_pt-5.2.0-3.i386.rpm MQSeriesMsg_Zh_CN-5.2.0-3.i386.rpm MQSeriesMsg_Zh_TW-5.2.0-3.i386.rpm 5. Install each required MQSeries message file by entering and executing the following commands: rpm -i --replacefiles MQSeriesMsg_de-5.2.0-3.i386.rpm rpm -i --replacefiles MQSeriesMsg_es-5.2.0-3.i386.rpm rpm -i --replacefiles MQSeriesMsg_fr-5.2.0-3.i386.rpm rpm -i --replacefiles MQSeriesMsg_it-5.2.0-3.i386.rpm rpm -i --replacefiles MQSeriesMsg_ja-5.2.0-3.i386.rpm rpm -i --replacefiles MQSeriesMsg_ko-5.2.0-3.i386.rpm rpm -i --replacefiles MQSeriesMsg_pt-5.2.0-3.i386.rpm rpm -i --replacefiles MQSeriesMsg_Zh_CN-5.2.0-3.i386.rpm rpm -i --replacefiles MQSeriesMsg_Zh_TW-5.2.0-3.i386.rpm For further information on using rpm to install software packages, see your Linux documentation. D) RESTORING THE PREVIOUS SERVICE LEVEL ------------------------------------ To restore the previous service level: 1.Log in as root or use the command su. 2.Enter the rpm command to remove the latest PTF from your system.(For example, to remove a service update, enter the command: rpm -e MQSeriesServer-5.2.0-3 Details of the rpm command can be found in your Linux documentation, or by entering the man rpm command.