Readme for IBM MQSeries for AIX Version 5.2 Download PTF U478289 ================================================================ This readme file contains information you need for updating IBM MQSeries for AIX V5.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 PTFs U478289, U478511, U478512, U480560, U480325, U480326, U481004, U481005, U481006, U481072, U481074, U481080, U481081, U481082, U481083, U481084, U481085, U481086, U481087, U481088, U481089, U481090, and U481093 for filesets 'mqm.base.runtime', 'mqm.server.rte', 'mqm.client.rte', 'mqm.dce.server', 'mqm.base.sdk', 'mqm.base.samples', 'mqm.msg.en_US', 'mqm.msg.es_ES', 'mqm.msg.fr_FR', 'mqm.msg.de_DE', 'mqm.msg.ja_JP', 'mqm.msg.it_IT', 'mqm.msg.Es_ES', 'mqm.msg.Fr_FR', 'mqm.msg.De_DE', 'mqm.msg.Ja_JP', 'mqm.msg.It_IT', 'mqm.msg.pt_BR', 'mqm.msg.ko_KR', 'mqm.msg.zh_CN', 'mqm.msg.Zh_CN', 'mqm.msg.zh_TW', and 'mqm.msg.Zh_TW' and it is numbered 03. It will bring your MQSeries for AIX Version 5.2 installation filesets up to the following service levels for CSD03: Fileset Service Level ======= ============= mqm.base.runtime U478289 mqm.server.rte U478511 mqm.client.rte U478512 mqm.dce.server U480560 mqm.base.sdk U480325 mqm.base.samples U480326 mqm.msg.en_US U481004 mqm.msg.es_ES U481005 mqm.msg.fr_FR U481006 mqm.msg.de_DE U481072 mqm.msg.ja_JP U481074 mqm.msg.it_IT U481080 mqm.msg.Es_ES U481081 mqm.msg.Fr_FR U481082 mqm.msg.De_DE U481083 mqm.msg.Ja_JP U481084 mqm.msg.It_IT U481085 mqm.msg.pt_BR U481086 mqm.msg.ko_KR U481087 mqm.msg.zh_CN U481088 mqm.msg.Zh_CN U481089 mqm.msg.zh_TW U481090 mqm.msg.Zh_TW U481093 This PTF can be used to update the MQSeries for AIX V5.2 server. This PTF can be used to update the MQSeries for AIX V5.2 client if you installed the client in one of the following ways: a) From the MQSeries for AIX V5.2 CD-ROM b) From the MQSeries V5.2 client CD-ROM c) By downloading the SupportPac MACL from the web and installing it. How to Download this Corrective Service ======================================= The CSD consists of 23 related PTFs: U478289, U478511, U478512, U480560, U480325, U480326, U481004, U481005, U481006, U481072, U481074, U481080, U481081, U481082, U481083, U481084, U481085, U481086, U481087, U481088, U481089, U481090, and U481093 This set of PTFs forms a complete replacement for any previous CSD that you have applied to your MQSeries for AIX V5.2 installation. These PTFs (U478289, U478511, U478512, U480560, U480325, U480326, U481004, U481005, U481006, U481072, U481074, U481080, U481081, U481082, U481083, U481084, U481085, U481086, U481087, U481088, U481089, U481090, and U481093) contain updates to the following components of MQSeries for AIX: U478289 mqm.base.runtime MQSeries Runtime support for Client and Server U478511 mqm.server.rte MQSeries server U478512 mqm.client.rte MQSeries client for AIX U480560 mqm.dce.server MQSeries support for DCE in server U480325 mqm.base.sdk MQSeries Base Kit for Client and Server U480326 mqm.base.samples MQSeries Samples U481004 mqm.msg.en_US MQSeries Messages - English U481005 mqm.msg.es_ES MQSeries Messages - Spanish U481006 mqm.msg.fr_FR MQSeries Messages - French U481072 mqm.msg.de_DE MQSeries Messages - German U481074 mqm.msg.ja_JP MQSeries Messages - Japanese U481080 mqm.msg.it_IT MQSeries Messages - Italian U481081 mqm.msg.Es_ES MQSeries Messages - Spanish IBM-850 U481082 mqm.msg.Fr_FR MQSeries Messages - French IBM-850 U481083 mqm.msg.De_DE MQSeries Messages - German IBM-850 U481084 mqm.msg.Ja_JP MQSeries Messages - Japanese IBM-932 U481085 mqm.msg.It_IT MQSeries Messages - Italian IBM-850 U481086 mqm.msg.pt_BR MQSeries Messages - Portuguese-Brazilian U481087 mqm.msg.ko_KR MQSeries Messages - Korean U481088 mqm.msg.zh_CN MQSeries Messages - Simplified Chinese U481089 mqm.msg.Zh_CN MQSeries Messages - Simplified Chinese GBK U481090 mqm.msg.zh_TW MQSeries Messages - Traditional Chinese U481093 mqm.msg.Zh_TW MQSeries Messages - Traditional Chinese IBM-950 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 U478289 (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 U478289 ----------- Each of these PTFs supersedes any previous PTF for earlier CSDs for the same component to which it is applicable. If you have installed one or more of the above components on your system then you will require the corresponding PTF for each of the components that you have installed on your system. You do not need a PTF from the above list if you have not installed the corresponding component, but you will not be able to install the CSD if you try to do so without one of the PTFs corresponding to a component that you have previously installed on your system. The PTFs have been processed by the tar program and then compressed. To prepare for installation: 1) download the file U478289.tar.Z to your local drive in binary format 2) uncompress the file: uncompress U478289.tar.Z 3) run the tar program against the uncompressed file: tar -xvf U478289.tar 4) this will create the 5 separate PTFs in this CSD and you should select and install the subset of those PTFs that you need for your installation. 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.aix.tar.Z) for this problem consists of a single compressed tar file which contains replacements for the following libraries in MQSeries for AIX V5.2: libmqmr.a libmqmr_r.a PTF U478289 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.aix.tar.Z file into a temporary directory: uncompress IC32843.aix.tar.Z (3) Expand the IC32843.aix.tar file in the temporary directory: tar -xvf IC32843.aix.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. In particular, run slibclean to remove shared libraries from memory. (7) Take backup copies of the following libraries on your system: libmqmr.a libmqmr_r.a (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.aix.tar.Z) for this problem consists of a single compressed tar file which contains replacements for the following libraries in MQSeries for AIX V5.2: libmqm.a libmqm_r.a PTF U478289 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.aix.tar.Z file into a temporary directory: uncompress IY28347.aix.tar.Z (3) Expand the IY28347.aix.tar file in the temporary directory: tar -xvf IY28347.aix.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. In particular, run slibclean to remove shared libraries from memory. (7) Take backup copies of the following libraries on your system: libmqm.a libmqm_r.a (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 AIX V5.2 --------------------------------------------- These steps will ensure that you are left with files that are installable using the normal install method for your platform. +--- ATTENTION -----------------------------------------+ | | | Do not have any queue managers operating during | | installation of maintenance on MQSeries for AIX V5.2. | | | | Remove any existing MQSeries shared memory and/or | | semaphores before applying or removing maintenance | | updates to MQSeries for AIX 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. | | | | Alternatively, use the command: | | | | ps -ef | grep mq | | | | where | is the pipe symbol. Check that there are | | no processes listed that are running command | | lines commencing "amq" or "runmq". Ignore any | | that start with "amqi". | | | | 3. Issue the IPCS -A command to identify any shared | | memory segments or semaphore sets that were | | created by MQSeries. Remove these using the | | IPCRM command. | | | +-------------------------------------------------------+ B) SPACE REQUIREMENTS ------------------ The installation process for this PTF requires 18MB of disk space for installation. In addition, the installation process requires an additional 18MB of disk space to save the previous level. This allows a PTF to be removed, and the previous level to be automatically restored. C) REMOTE INSTALLATION ------------------- To install MQSeries for AIX on a remote machine, you can use standard AIX techniques. If you are not familiar with these techniques, this is what you have to do. First, you have to create an installation image in backup format, and then use INSTALLP or SMIT to install the product. To be able to do this, you must be logged on to both systems as root. The product CD-ROM must be in the CD-ROM drive of the machine from which you are going to take the copy. Follow this procedure for each target machine on which you want to install the product: 1. Create a "cdrom" file system on the local machine, by issuing the command "smitty crcdrfs". 2. Mount the cdrom file system on the local machine by issuing the command "mount /cdrom". 3. Log on to the remote machine and issue the NFS command "mount local_machine:/cdrom" to mount the cdrom file system that you created. where local_machine is the Id of the machine from which you are installing. 4. Use the standard AIX installation procedures, for example SMIT, to install MQSeries for AIX from the target directory that you specified. D) REINSTALLING MQSERIES FOR AIX ----------------------------- If you reinstall MQSeries for AIX, a check is made to see if the MQSeries configuration file ("mqs.ini") exists. If the file exists, it is kept and used with the newly installed system. If the file does not exist, an empty "mqs.ini" file is placed in the directory "/var/mqm". E) INSTALLING A PTF USING SMIT --------------------------- Installing a PTF (program temporary fix): 1. Log in as root (or use command su) 2. Change the current directory to the directory containing the PTF as an uncompressed tar file. 3. Use SMIT to install the PTF using this sequence of windows: smit Software Installation and Maintenance Install and Update Software Install/Update From All Available Software Alternatively, enter the fastpath command: smitty install_update 4. Type "." (dot to represent the current directory) as the value for the entry field: INPUT device / directory for software 5. Complete the following fields: SOFTWARE to install Enter ALL to install all applicable fileset updates to your installation. NOTE: Although there is an option to apply only selected fileset updates for MQSeries for AIX, this still results in all applicable fileset updates for the PTF being applied. 6. This will apply the PTF, and save a backup copy of the current level of MQSeries for AIX. If, at a later time, you want the chance to choose to commit the PTF updates, or reject the PTF updates and return to the backup level, you MUST ensure that: o The 'COMMIT software updates' value is set to 'no'. o The 'SAVE replaced files' value is set to 'yes'. Press Enter to display a confirmation message, prior to starting the update. The command will run, display progress messages, and should complete without problems. These progress messages terminate with an Installp Summary table, confirming which components of MQSeries for AIX have been updated. If the command does not complete successfully, then a full error log is saved in the file smit.log in your HOME directory. 7. The same process applies to MQI client installations. Refer to Chapter 2 "Preparing for Installation" in the MQSeries Clients book for more information about client installation. F) RESTORING THE PREVIOUS SERVICE LEVEL ------------------------------------ When, after installing a PTF, any component of MQSeries for AIX is in APPLIED state, the PTF can be backed-out and these selectable components can be restored to the previous service/install level. To back-out a PTF: 1. Log in as root (or use command su) 2. To display the appropriate SMIT panel, enter: smit Software Installation and Maintenance Maintain Installed Software Reject Applied Software Updates (Use Previous Version) Alternatively, enter the fastpath command: smitty install_reject 3. Complete the following fields: SOFTWARE name Enter MQM to restore all applicable fileset updates to your installation. NOTE: Although there is an option to restore only selected fileset updates for MQSeries for AIX, this still results in all applicable fileset updates for the PTF being restored. 4. You are recommended to use the displayed default values for all other fields. This will reject the current PTF level and reinstate the previous service or install level. Press ENTER to display a confirmation message, prior to starting the reject. The command will run, display progress messages, and should complete successfully. These progress messages terminate with an Installp Summary table, confirming which components of MQSeries for AIX have been rejected. G) REMOVING THE MQSERIES INTERNET GATEWAY -------------------------------------- After removing the Web server configuration, as described in the MQSeries Internet Gateway User's Guide: 1. Log in as root (or use the command su). 2. To display the appropriate SMIT panel, enter: smit Software Installation and Maintenance Maintain Installed Software Remove Software Products Add the following to the "Remove Software Products" screen: SOFTWARE name dmqgate.runtime PREVIEW only no Leave the other entries with the default settings, and press Enter to remove the product.