How to download and install this Corrective Service There are 2 files, one for updating the OS/2 server and one for updating the OS/2 client: The file for updating the server and/or the client if it was installed from the server CD-ROM is: U200121S.zip The file for updating the OS/2 client if it was installed from the client CD-ROM or if it was downloaded from the web as SupportPac MAC1 is: U200121C.zip In addition there is an additional APAR fix provided which may also be downloaded and applied on any installation at service level U200121 (CSD #6). This optional APAR fix is IY17668. The files to be downloaded and the instructions for installing for this APAR fix is specified below. It is recommended that you apply this APAR fix if you connect your V5.1 queue manager to an MQSeries V2 queue manager or you use a zero heartbeat interval. PTF U200121 ----------- Unzip the U200121S.zip or U200121C.zip file into a temporary directory on your hard drive, ensuring that you preserve the directory structure when you do so (PKUNZIP with the -d option, as an example). Point the MQSeries Installation and Maintenance tool at this temp directory. This temporary directory includes soft-copy installation instructions to help you install this PTF. There is a MEMO.PTF file for each National Language version in the appropriate National Language directory within the README directory that contains these instructions. 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-B42-00, IBM MQSeries for OS/2 version 5.1, namely the English version or any of the National Language versions. If after applying this PTF, you experience problems - please contact the IBM Support Center (ISC) at 1-800-237-5511 or an authorized IBM Personal Computer dealer, whichever is applicable. APAR IY17668 ------------ After applying V5.1 CSD06, installations that connected their V5.1 queue managers to MQSeries V2 queue managers and installations that specified a zero heartbeat may have encountered channel time-out conditions that did not occur prior to applying the CSD. The APAR fix (IY17668.zip) for this problem consists of a single zip file which contains replacements for the following files in MQSeries for OS/2 V5.1: amqrdlla.dll amqrmqia.dll PTF U200121 is a pre-requisite for this APAR fix. To apply the fix :- (1) Unzip the IY17668.zip file into a temporary directory on your hard drive. (2) Stop all running queue managers and channel listeners. (3) Rename the existing dlls (they will be in the MQSeries for OS/2 V5.1 bin directory) so that you have a backup of the original DLLs. (4) Detailed instructions for applying the fix are contained in the file README.TXT which is shipped as part of the zip file. Follow these instructions for installing the fix. (5) Restart the queue managers and channel listeners. INSTALLATION AND MAINTENANCE INFORMATION ---------------------------------------- A) Applying Maintenance -------------------- ** Precaution ************************************************** * * * Do not have queue managers running while you are applying * * or removing maintenance updates to MQSeries for OS/2. * * * * Do not have channel listeners running while you are * * applying or removing maintenance updates to MQSeries for * * OS/2. * * * **************************************************************** This PTF requires approximately 28MB of disk space to save the previous level. This allows a PTF to be removed, and the previous level automatically restored. This PTF also requires approximately 20MB of disk space if you choose to copy the CD-ROM to disk, but this is not needed as part of the service process. You can apply the PTF direct from the CD-ROM drive. The server CSD occupies 14MB, and the client CSD occupies 6MB giving a total of 20MB. If you need to apply maintenance updates to your MQSeries product: 1. Ensure all Queue Managers are stopped. 2. Ensure all Channel Listeners are stopped. 3. Insert the maintenance CD-ROM, or connect to the required network drive containing the MQSeries for OS/2 maintenance. 4. Open the MQSeries folder and double-click on the MQSeries Installation and Maintenance icon. 5. Click on 'File'. 6. Select 'Open catalog', and from the sub-menu displayed select 'Drive'. 7. Select the temporary directory containing the MQSeries for OS/2 maintenance from the Drive pulldown. 8. Click on 'Search', and a 'Directory' list will be displayed. 9. If you are applying maintenance to a server installation, or to a client that was installed from the server product, then select and open (eg: mouse select, followed by mouse double-click) the corresponding server product language directory. Next, select 'AMQICAT2.ICF' from the 'File' list and click on 'OK'. Note: Do not select a language directory from the CLIENT directory. The CLIENT directory must only be used for updating the OS/2 client if it was downloaded from the web or it was installed from the MQSeries client CD-ROM. If you are applying maintenance to a client installation that was downloaded from the web or installed from the MQSeries product client CD-ROM then select and open (eg: mouse select, followed by mouse double-click) the 'CLIENT' directory from the 'Directory' list. Then select the corresponding language directory. Next, select 'AMQICCL2.ICF' from the 'File' list and click on 'OK'. Note: You should select a language directory from within the CLIENT directory. Do not select one of the server product language directories. The CLIENT directory must be used for updating the OS/2 client if it was downloaded from the web or it was installed from the MQSeries client CD-ROM. If you select the client catalog file when MQSeries for OS/2 was installed from the server product, or you select the server catalog file when the client was installed from the client CD or downloaded from the World Wide Web then you should expect to see a response beginning with the following: No products are currently available for installation. If so, confirm that you have selected the correct catalog file. Note: You must use an AMQICAT2.ICF file to apply maintenance to the server product or a client that was installed from the MQSeries for OS/2 V5.1 server product. You must use an AMQICCL2.ICF file to apply maintenance to a client that was downloaded from the web or that was installed from the MQSeries product client CD-ROM. 10. You will return to the 'Open drive catalog' window, with the selected catalog file displayed in the 'Filename' list. You may verify your selection by clicking on 'Description'. 11. When you have selected the catalog file which corresponds to the product you have installed, click on 'Open' to open the catalog file. 12. Click on the 'View' choice on the menu bar, and then select 'Current catalogue'; the window should display: 05.01.00 IBM MQSeries for OS/2 13. Click on the 'Details' choice on the menu bar, and then select 'Product description'. This should query the product information from files on the CD-ROM drive or the network drive, and display the product description for 'IBM MQSeries for OS/2'. If this fails, then check that you have selected the correct catalog file in step 7. 14. If you are updating one of the National Language Versions (NLV) of MQSeries for OS/2, then check that the product description displayed in step 11 has been translated into the appropriate language. If not, then make sure that you have selected the correct catalog file that corresponds to the product you have installed (refer to step 7). 15. Click on the 'Action' choice on the menu bar. 16. Click on 'Update' to display the Update window. 17. It is recommended that you save a backup version of your installation when you apply this CSD. You do this by ensuring that the 'save backup version' option is selected. 18. Click on 'Update' in the Update window. 19. During update, a status bar is displayed. On completion, follow the instructions given in the message windows. In particular, if it says to reboot your system then you must do this before continuing with any further use or maintenance of IBM MQSeries for OS/2. B) Restoring the Previous Backup Version ------------------------------------- If you need to restore from backup, to the previous level of maintenance: 1. Ensure all Queue Managers are stopped. 2. Ensure all Channel Listeners are stopped. 3. Open the MQSeries folder and double-click on the MQSeries Installation and Maintenance icon. 4. Click on the 'Action' choice on the menu bar. 5. Click on 'Restore' to display the Restore window. 6. Click on 'Restore' in the Restore window. 7. During restore, a status bar is displayed. On completion, follow the instructions given in the message windows. In particular, if it says to reboot your system then you must do this before continuing with any further use or maintenance of IBM MQSeries for OS/2. Notes: 1. The Restore action is only applicable if, when using the Update action, the option to save a backup copy was selected. 2. The MQSeries folder will be closed and reinitialized. This means that all folder settings will be reset to their default values. 3. All files at the current maintenance level will be overwritten, without requiring confirmation by the user, with corresponding files saved from the previous maintenance level. C) Querying the Service Level -------------------------- After initial installation, service level has the value '0000510'. After one or more updates, service level indicates from which CSD the product was most recently updated. Service level is expressed in terms of the PTF number for a particular CSD. To query the service level: 1. Open the MQSeries folder and double-click on the MQSeries Installation and Maintenance icon. 2. If the current product selected is not IBM MQSeries for OS/2 V5.1 then click on the 'View' choice on the menu bar, and then select 'Installed products'. Now select IBM MQSeries for OS/2 V5.1. 3. Click on Details choice on the menu bar. 4. Click on Product status to display the Product status window. 5. Select one of the currently installed components, and click on Service level to display the Service level window. For the selected component this will show details of Install date, Origin (source from which MQSeries was installed), and Level.