How to download and install this Corrective Service There are 30 files in all, comprising 10 files for updating the Windows NT server, 10 files for updating the Windows NT client and 10 files for updating the Windows 95/Windows 98 client. There are 10 files, one for each National Language version of IBM MQSeries for Windows NT V5.1 as follows, for updating the server and/or the Windows NT client if it was installed from the server CD-ROM: U200113A.exe - English language version U200113E.exe - Spanish language version U200113F.exe - French language version U200113G.exe - German language version U200113I.exe - Italian language version U200113J.exe - Japanese language version U200113K.exe - Korean language version U200113O.exe - Portuguese (Brazilian) language version U200113V.exe - Simplified Chinese language version U200113W.exe - Traditional Chinese language version There are 10 files, one for each National Language version of IBM MQSeries for Windows NT V5.1 as follows, for updating the Windows NT client if it was installed from the client CD-ROM or if it was downloaded from the web: V200113A.exe - English language version V200113E.exe - Spanish language version V200113F.exe - French language version V200113G.exe - German language version V200113I.exe - Italian language version V200113J.exe - Japanese language version V200113K.exe - Korean language version V200113O.exe - Portuguese (Brazilian) language version V200113V.exe - Simplified Chinese language version V200113W.exe - Traditional Chinese language version There are 10 files, one for each National Language version of IBM MQSeries for Windows NT V5.1 as follows, for updating the Windows 95/Windows 98 client if it was installed from the client CD-ROM or if it was downloaded from the web: W200113A.exe - English language version W200113E.exe - Spanish language version W200113F.exe - French language version W200113G.exe - German language version W200113I.exe - Italian language version W200113J.exe - Japanese language version W200113K.exe - Korean language version W200113O.exe - Portuguese (Brazilian) language version W200113V.exe - Simplified Chinese language version W200113W.exe - Traditional Chinese language version In addition there are an additional four APAR fixes provided which may also be downloaded and applied on any installation at service level U200113 (CSD #3). These optional APAR fixes are IC22041, APAR IC25870, APAR IC26168, and IC26222 (duplicate of APAR IC26063). The files to be downloaded and the instructions for installing for each of these APAR fixes are specified below. PTF U200113 ----------- Copy the file for your National language version and server/client installation into a temporary directory on your hard drive and execute this file. After installation of this CSD, there is a MEMO.PTF file that contains information relating to this PTF in both the mqm directory and the temporary directory. 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-B43-00, IBM MQSeries for Windows NT 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) or an authorized IBM Personal Computer dealer, whichever is applicable. APAR IC22041 ------------ User applications compiled with the Microsoft Visual C++ compiler that do new/delete on Imq objects can cause problems if the application and MQSeries bindings are using different 'C' runtimes. This can be caused by using different versions of the compiler, compiling the application as debug, using Microsoft Foundation Class (MFC) or statically linking the C-runtime. The problem can manifest itself as a user breakpoint when debugging the application and 'operator delete', of the imq object, is called. The APAR fix (IC22041.zip) for this problem consists of a single zip file which contains replacements for the following files in MQSeries for Windows NT V5.1: imqc23vn.dll imqc23vn.lib imqs23vn.dll imqs23vn.lib imqb23vn.dll imqb23vn.lib imqerr.hpp PTF U200113 is a pre-requisite for this APAR fix. To apply the fix :- (1) Unzip the IC22041.zip file into a temporary directory on your hard drive. (2) Stop all running queue managers and channel listeners. (3) Stop the IBM MQSeries Service (via the 'Services' window). (4) Rename the existing dlls (they will be in the MQSeries for Windows NT V5.1 bin directory) so that you have a backup of the original DLLs. (5) 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. (6) Restart the queue managers and channel listeners. (7) Restart the IBM MQSeries Service. APAR IC25870 ------------ This APAR fix is only relevent to you if you chose to install the MQSeries Web Administation Server when you installed MQSeries for Windows NT V5.1. If you installed the MQSeries Web Administation Server then you may encounter the problem identified by APAR IC25870. On Windows 2000 there is a code trap as soon as you try to run the MQSeries Web Administation Server. On Windows NT version 4.0 a problem would only be noticed if the MQSeries Web Administation Server was being used with a Queue manger with hundreds of object (queues/channels). The APAR fix (IC25870.zip) for this problem consists of a single zip file which contains replacements for two of the dll files in MQSeries for Windows NT V5.1: amqjmqscMS.dll amqjmqscSUN.dll If you did not install the MQSeries Web Administation Server then you should not attempt to apply this APAR fix as these two dll files will not be installed on your system. PTF U200113 is a pre-requisite for this APAR fix. To apply the fix :- (1) Unzip the IC25870.zip file into a temporary directory on your hard drive. (2) Stop all running queue managers and channel listeners. (3) Stop the IBM MQSeries Service (via the 'Services' window). (4) Rename the existing dlls (they will be in the MQSeries for Windows NT V5.1 bin directory) so that you have a backup of the original DLLs. (5) Copy over the new versions of the dlls. (6) Restart the queue managers and channel listeners. (7) Restart the IBM MQSeries Service. APAR IC26168 ------------ Handle and memory leaks may be experienced by some MQSeries applications when executing under the control of an XA compliant transaction manager. The APAR fix (IC26168.zip) for this problem consists of a single zip file which contains a replacement for one of the dll files in MQSeries for Windows NT V5.1: amqzst.dll PTF U200113 is a pre-requisite for this APAR fix. To apply the fix :- (1) Unzip the IC26168.zip file into a temporary directory on your hard drive. (2) Stop all running queue managers and channel listeners. (3) Stop the IBM MQSeries Service (via the 'Services' window). (4) Rename the existing dll (it will be in the MQSeries for Windows NT V5.1 bin directory) so that you have a backup of the original DLL. (5) Copy over the new version of the dll. (6) Restart the queue managers and channel listeners. (7) Restart the IBM MQSeries Service. APAR IC26222 ------------ This APAR fix corrects a locking problem around the tracing functions with the MQSeries Automation Classes for ActiveX interface where there are more than 40 threads in an ActiveX process. The APAR fix (IC26222.zip) for this problem consists of a single zip file which contains replacements for one of the dll files and one of the exe files in MQSeries for Windows NT V5.1: mqaxlev.exe mqax200.dll PTF U200113 is a pre-requisite for this APAR fix. To apply the fix :- (1) Unzip the IC26222.zip file into a temporary directory on your hard drive. (2) Stop all running queue managers and channel listeners. (3) Stop the IBM MQSeries Service (via the 'Services' window). (4) Rename the existing dll (it will be in the MQSeries for Windows NT V5.1 bin directory) so that you have a backup of the original DLL. (5) Copy over the new version of the dll. (6) Rename the existing exe (it will be in the MQSeries for Windows NT V5.1 bin directory) so that you have a backup of the original EXE. (7) Copy over the new version of the exe. (8) Restart the queue managers and channel listeners. (9) Restart the IBM MQSeries Service. 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 Windows NT. * * * * Do not have channel listeners running while you are * * applying or removing maintenance updates to MQSeries for * * Windows NT. * * * * You must also stop the IBM MQSeries Service (via the * * 'Services' window) before applying or removing maintenance. * * * **************************************************************** The installation of this PTF requires approximately 20MB of disk space for all languages other than the Japanese language which requires 30MB 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. This PTF also requires approximately 450MB 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 160MB, the Windows NT client CSD occupies 155MB and the Windows 95 and Windows 98 client CSD occupies 135MB giving a total of 450MB. Each of these CSDs comprises 10 directories, one directory per language supported by this product. If you need to apply maintenance updates to your MQSeries product: 1. Ensure you are logged on as an Administrator 2. Ensure that all Queue Managers are stopped. 3. Ensure that all Channel Listeners are stopped. 4. Ensure that the IBM MQSeries Service has been stopped. 5. If you are installing after downloading the CSD from the World Wide Web then you will have one executable file to run from wherever you downloaded it to. When you run this executable file, you will be presented with a dialog screen on which you can choose to use the default temporary directory or specify your own temporary directory into which you want to unload the executable file. Change the default directory if required and then select the "Next>" button. After the file has been unloaded into the temporary directory, select the "Finish" button to terminate the dialog. The SETUP.EXE file will be run at this time. The installation process will automatically detect whether you have a server or client installation on your system, and it will call the appropriate SETUP.EXE file for your installation. If you are installing from CD then insert the MQSeries for Windows NT maintenance CD into the appropriate drive, and review the memo.ptf file on the root directory. Note: If you have your CD-ROM "autorun" option switched off, or you want to run the installation manually then you should browse the CD-ROM (for example, using Explorer on Windows NT V4.0) and double click on the root directory level SETUP.EXE file at the point where the above instructions state that the SETUP.EXE file will be run. Now follow the remaining installation instructions in this PTF memo. 6. You will be presented with the "Welcome" dialog. Select the "Next>" button. 7. Select the backup directory (it is recommended that you leave the default directory), and then select the "Next>" button. 8. From the "Copy Files" dialog, verify that the information displayed matches the user's requested choices, and then select the "Next>" button to proceed. 9. Select the "Finish" button to complete the installation of the CSD. 10. Now restart the IBM MQSeries Service or reboot to start it automatically. B) Installing the CSD on Windows 2000 ---------------------------------- If you need to install the CSD on a Windows 2000 system then you must stop two additional processes after stopping the IBM MQSeries Services before installing the CSD. The two processes are: 1) amqsvc.exe 2) amqmsrvn.exe These processes must also be killed in the order shown above. First you must kill the process amqsvc.exe and then you must kill the process amqmsrvn.exe. You need to make sure that you do not have any of the IBM MQSeries programs running when attempting to install the CSD, for example, the MMC Explorer or Services snap-ins. C) Restoring the Previous Backup Version on Windows NT V4.0 -------------------------------------------------------- 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 all Queue Managers are stopped. 3. Ensure that all Channel Listeners are stopped. 4. Ensure that the IBM MQSeries Service has been stopped. 5. Select IBM MQSeries from the Start Menu and then select 'Remove CSD'. 6. If any CSDs have been applied with rollback, the user is shown the history log and given the option to rollback the most recent CSD. Using the rollback option will return the installation to the state it was in before the CSD was applied. D) Querying the Service Level -------------------------- To query the service level on Windows NT Version 4.0, select "Start", and then select "Programs" and then select "IBM MQSeries for Windows NT", and finally select "MQSeries 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.