Readme for IBM MQSeries for Windows NT and Windows 2000, Version 5.2.1 Download PTF U200151 ====================================================================== This readme file contains information you need for downloading the PTF from the web and updating either IBM MQSeries for Windows NT and Windows 2000 V5.2.1 (server and/or client) or IBM MQSeries for Windows 95,98 and ME V5.2.1 client, as well as a summary of the contents of the latest CSD and any earlier CSDs. This readme file relates to the first CSD, which is defined as PTF U200151 and is numbered 01. The first CSD will bring your MQSeries for Windows NT and Windows 2000 Version 5.2.1 installation up to service level U200151 (CSD03). This CSD can be used to update the MQSeries for Windows NT and Windows 2000 V5.2.1 server. This CSD can be used to update the MQSeries for Windows NT and Windows 2000 V5.2.1 client if you installed the client in one of the following ways: a) From the MQSeries for Windows NT and Windows 2000 V5.2.1 server product CD-ROM at the same time as you installed the server. b) From the MQSeries for Windows NT V5.2.1 server product CD-ROM without installing the server. c) From the MQSeries V5.2.1 client CD-ROM d) By downloading the SupportPac MACP from the web and installing it. How to Download this Corrective Service ======================================= There are 20 files in all, comprising 10 files for updating the MQSeries for Windows NT and Windows 2000 server, and 10 files for updating the MQSeries Client for Windows NT and Windows 2000. There are 10 files, one for each National Language version of IBM MQSeries for Windows NT and Windows 2000 V5.2.1 as follows, for updating the server and/or the Windows NT and Windows 2000 client if it was installed from the server CD-ROM: U200151A.exe - English language version U200151E.exe - Spanish language version U200151F.exe - French language version U200151G.exe - German language version U200151I.exe - Italian language version U200151J.exe - Japanese language version U200151K.exe - Korean language version U200151O.exe - Portuguese (Brazilian) language version U200151V.exe - Simplified Chinese language version U200151W.exe - Traditional Chinese language version There are 10 files, one for each National Language version of IBM MQSeries for Windows NT and Windows 2000 V5.2.1 as follows, for updating the Windows NT and Windows 2000 client if it was installed from the client CD-ROM or if it was downloaded from the web: V200151A.exe - English language version V200151E.exe - Spanish language version V200151F.exe - French language version V200151G.exe - German language version V200151I.exe - Italian language version V200151J.exe - Japanese language version V200151K.exe - Korean language version V200151O.exe - Portuguese (Brazilian) language version V200151V.exe - Simplified Chinese language version V200151W.exe - Traditional Chinese language version 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 U200151 (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 U200151 ----------- 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 and Windows 2000 Version 5.2.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 IC32843 ------------ After applying V5.2.1 CSD03, installations that use channel send and receive exits have encountered problems (eg. when changing channel definitions with PCF commands). The APAR fix (IC32843.nt521.zip) for this problem consists of a single zip file which contains a replacement for the following file in MQSeries for Windows NT V5.2.1: amqpcsda.dll PTF U200151 is a pre-requisite for this APAR fix. To apply the fix :- (1) Unzip the IC32843.nt521.zip file into a temporary directory on your hard drive. (2) Stop all running queue managers and channel listeners. (3) Rename the existing dll (they will be in the MQSeries for Windows NT V5.2.1 bin directory) so that you have a backup of the original DLL. (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. 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.nt521.zip) for this problem consists of a single zip file which contains replacements for the following files in MQSeries for Windows NT V5.2.1: amqzst.dll mqmc1415.dll mqmc4swi.dll mqmcics.dll mqmcics4.dll mqmenc.dll mqmtux.dll mqmcics.lib mqmcics4.lib mqmenc.lib mqmsom.lib mqmtux.lib README.TXT PTF U200151 is a pre-requisite for this APAR fix. To apply the fix :- (1) Unzip the IY28347.nt521.zip file into a temporary directory on your hard drive. (2) Stop all running queue managers and channel listeners. (3) Rename the existing dll files (they will be in the MQSeries for Windows NT V5.2.1 bin directory) so that you have a backup of the original dll files. (4) Rename the existing libs (they will be in the MQSeries for Windows NT V5.2.1 tools\lib directory) so that you have a backup of the original libs. (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. 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 * * and Windows 2000. * * * * Do not have channel listeners running while you are * * applying or removing maintenance updates to MQSeries for * * Windows NT and Windows 2000. * * * * 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 94MB 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 69MB, and the Windows NT and Windows 2000 client CSD occupies 25MB giving a total of 94B. 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 and Windows 2000 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) Restoring the Previous Backup Version ------------------------------------- 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 Latest 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. C) Querying the Service Level -------------------------- To query the service level on IBM MQSeries for Windows NT and Windows 2000, select "Start", and then select "Programs" and then select "IBM MQSeries", 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.