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: U200115A.exe - English language version U200115E.exe - Spanish language version U200115F.exe - French language version U200115G.exe - German language version U200115I.exe - Italian language version U200115J.exe - Japanese language version U200115K.exe - Korean language version U200115O.exe - Portuguese (Brazilian) language version U200115V.exe - Simplified Chinese language version U200115W.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: V200115A.exe - English language version V200115E.exe - Spanish language version V200115F.exe - French language version V200115G.exe - German language version V200115I.exe - Italian language version V200115J.exe - Japanese language version V200115K.exe - Korean language version V200115O.exe - Portuguese (Brazilian) language version V200115V.exe - Simplified Chinese language version V200115W.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: W200115A.exe - English language version W200115E.exe - Spanish language version W200115F.exe - French language version W200115G.exe - German language version W200115I.exe - Italian language version W200115J.exe - Japanese language version W200115K.exe - Korean language version W200115O.exe - Portuguese (Brazilian) language version W200115V.exe - Simplified Chinese language version W200115W.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 U200115 (CSD #4). These optional APAR fixes are IC22041, IC26222, IC26566, and IC27299. The files to be downloaded and the instructions for installing for each of these APAR fixes are specified below. PTF U200115 ----------- 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 U200115 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 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 U200115 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) 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. (6) 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. (7) Restart the queue managers and channel listeners. (8) Restart the IBM MQSeries Service. APAR IC26566 ------------ This APAR fixes a problem when trying to start a sender channel on MQSeries for Windows NT V5.1, where an FDC with probe id XY176001 was received from component xcsLoadFunction with return code xecU_S_LOAD_FAILED and error message AMQ6175. The system could not dynamically load the library MQS_EXIT. The system return code was 13372000. The queue manager would continue without this module. In the MQSeries error log the return code was 14682720. The APAR fix (IC26566.zip) for this problem consists of a single zip file which contains replacements for one of the dll files in MQSeries for Windows NT V5.1: amqxcs2.dll PTF U200115 is a pre-requisite for this APAR fix. To apply the fix :- (1) Unzip the IC26566.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) 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 IC27299 ------------ This APAR fix provides the files necessary to enable the operation of MQSeries as an XA transaction manager with Oracle 8.1.5 on Windows NT. Before trying to use this APAR fix, please read the general information in the "Transactional Support" chapter of the MQSeries System Administration book. The APAR fix (IC27299.zip) for this problem consists of a single zip file which contains four new samples for MQSeries for Windows NT V5.1: xaswit.mak xaswiti.mak oraswit.c oraswit.def PTF U200115 is a pre-requisite for this APAR fix. To apply the fix :- (1) Unzip the IC27299.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) 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) Detailed instructions for customising the fix after installation of the fix are also contained in the file README.TXT which is shipped as part of the zip file. Follow these instructions for customising the fix for your installation. (6) Restart the queue managers and channel listeners. (7) 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 453MB 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 165MB, the Windows NT client CSD occupies 155MB and the Windows 95 and Windows 98 client CSD occupies 133MB giving a total of 453MB. 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) Installation Error Message "AMQXCS2.DLL is locked" -------------------------------------------------- This error is produced if you have tried to install the CSD while processes using AMQXCS2.DLL are still running. You can check which processes are still running by using the Windows NT Task Manager. The likely processes are listed below: AMQSVC.EXE - Either issue the command 'net stop "IBM MQSeries"' from a command prompt, or stop the service via the Control Panel/Services window. AMQSRVN.EXE - If the MQSeries taskbar icon is available, right click on it and select 'Stop IBM MQSeries' from the list. Alternatively, follow the instructions for AMQSVC.EXE above. MONBASE.EXE - End MONBASE.EXE from the task manager or by using a kill command. If all else fails, you can issue a kill command for these processes from a command line. They should be killed in the order specified above. D) 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. E) 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.