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: U200122A.exe - English language version U200122E.exe - Spanish language version U200122F.exe - French language version U200122G.exe - German language version U200122I.exe - Italian language version U200122J.exe - Japanese language version U200122K.exe - Korean language version U200122O.exe - Portuguese (Brazilian) language version U200122V.exe - Simplified Chinese language version U200122W.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: V200122A.exe - English language version V200122E.exe - Spanish language version V200122F.exe - French language version V200122G.exe - German language version V200122I.exe - Italian language version V200122J.exe - Japanese language version V200122K.exe - Korean language version V200122O.exe - Portuguese (Brazilian) language version V200122V.exe - Simplified Chinese language version V200122W.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: W200122A.exe - English language version W200122E.exe - Spanish language version W200122F.exe - French language version W200122G.exe - German language version W200122I.exe - Italian language version W200122J.exe - Japanese language version W200122K.exe - Korean language version W200122O.exe - Portuguese (Brazilian) language version W200122V.exe - Simplified Chinese language version W200122W.exe - Traditional Chinese language version In addition there is an additional APAR fix provided which may also be downloaded and applied on any installation at service level U200122 (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 U200122 ----------- 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 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 Windows NT V5.1: amqrdlla.dll amqrmqia.dll PTF U200122 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 Windows NT 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 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 262MB 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 178MB, the Windows NT client CSD occupies 53MB and the Windows 95 and Windows 98 client CSD occupies 31MB giving a total of 262MB. 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.