######################################################################## # # COMPONENT_NAME: MQSeries # # # FILE: MEMOPTF # # Program Number 5697-A17 # # (C) COPYRIGHT International Business Machines Corp. 1993, 1997 # # All Rights Reserved # Licensed Material - Property of IBM # # # US Government Users Restricted Rights - Use, duplication or # # disclosure restricted by GSA ADP Schedule Contract with IBM Corp. # # ######################################################################## PTF Memo for IBM MQSeries for Tandem NonStop Kernel V2.2.0.1 - 3/24/99 ------------------------------------------------------------------------ This MEMOPTF file contains information you need for updating IBM MQSeries for Tandem NonStop Kernel, as well as a summary of the contents of the latest PTF, latest CSD and any earlier CSDs. This is a non-cumulative service distribution, corresponding to PTF U463805. It requires that the latest GA maintenance release V2.2.0.1 be installed. It will NOT WORK with earlier levels of the product. It will bring your MQSeries for Tandem NonStop Kernel V2.2.0.1 installation up to service level U463805. This PTF is required for MQSeries NATIVE installations only which are running with Tandem NonStop Kernel Release D45 and later, or G05 and later. Non-NATIVE installations or NATIVE installation on OS's prior to D45 or G05 may install the service to remain current but it will have no effect. The MEMOPTF file is divided into the following sections: o Installation and maintenance information o Documentation changes o Special information o Service and technical support o CSD history ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ INSTALLATION AND MAINTENANCE INFORMATION ---------------------------------------- A) Applying Maintenance ----------------------- Maintenance updates can be downloaded from the World Wide Web. Upon request, updates can be supplied on 3480 cartridge, DAT, or reel to reel tape. ** Precaution ************************************************** * * * Do not have queue managers running while you are applying * * or removing maintenance updates to MQSeries for Tandem * * NonStop Kernel. * * * * It is NOT necessary to delete any Queue Managers that were * * created prior to the installation of this PTF. * * * * It is essential that MQSeries NATIVE executables be updated * * with the replacement private SRL, ZMQSLIB.MQSRLLIB. If you * * built your own MQSeries private SRL, for MQSeries exits for * * example, you will need to rebuild it and relink the * * MQSeries executables and user applications. * * * * It is recommended that any applications built using the * * MQSeries NATIVE libraries, ZMQSLIB.MQMLIBN* be relinked * * with the new libraries. * * * **************************************************************** Backup your original MQSeries for Tandem NonStop Kernel executables and libraries that are being replaced. Ensure that all Queue Managers have been ended. Ensure that you have up to date copies of the configuration scripts (RUNMQSC command files) that were used to create any existing Queue Managers. If installing from an archive (pak file): 1. Logon as user-id MQM.MANAGER 2. Move the pak file to subvolume ZMQSPTF. Ensure that the UNPAK utility is in the default program search path for MQM.MANAGER. You can obtain UNPAK from the World Wide Web. The URL is http://www.bsi.com/DOWNLOAD-FREE.HTML 3. Verify that your currently installed release is at the correct level. Run the Tandem utility VPROC on the MQSRLLIB library normally found in the ZMQSLIB subvolume. The output should be as follows: $VOL.ZMQSLIB.MQSRLLIB Binder timestamp: 28JAN99 17:57:36 Version procedure: T0085D30_01MAR1999_MQILIB_2201 Version procedure: T0085D30_01MAR1999_ECBLIB_2201 Version procedure: T0085D30_01MAR1999_ECLIB_2201 Version procedure: T0085D30_01MAR1999_CMDLIB_2201 Version procedure: T0085D30_01MAR1999_LQMLIB_2201 Version procedure: T0085D30_01MAR1999_MQSSLIB_2201 Version procedure: T0085D30_01MAR1999_REMLIB_2201 Version procedure: T0085D30_01MAR1999_ZRLIB_2201 Version procedure: T0085D30_01MAR1999_COMMLIB_2201 Version procedure: T0085D30_01MAR1999_ZSLIB_2201 Version procedure: T0085D30_01MAR1999_ZSTLIB_2201 Version procedure: T0085D30_01MAR1999_DCLIB_2201 Version procedure: T0085D30_01MAR1999_IPCLIB_2201 Version procedure: T0085D30_01MAR1999_CSLIB_2201 Version procedure: T0085D30_01MAR1999_MQSCLIB_2201 Native Mode: runnable file 4. Extract the updated Native Mode files from the archive file as follows: UNPAK U463805, $*.*.*, MAP NAMES $*.*.* TO $.ZMQSPTF.*, & LISTALL, MYID 5. Replace the private SRL, LNK and MQM libraries in ZMQSLIB (or other location if you are not using the default) with the updated versions. Ensure that the new files are secured with exactly the same attributes as before. Use the FUP utility to resecure them, if necessary. When properly installed, the files should have the file attributes "NCNC" and be owned by a user in the MQM user group. 6. Change the MQSeries executables to use the updated SRL with the script NMLDEXES located in ZMQSLIB. A fully qualified path to the SRL is required. For example, NMLDEXES $DATA1.ZMQSLIB.MQSRLLIB ZMQSEXE If a new version of the private SRL is used, for exits as an example, recreate the SRL (MAKEPSRL) and relink all MQSeries applications (NMLDEXES). 7. After installation, the VPROC information for the SRL, LNK, and MQM Native libraries for this PTF will be updated to: $VOL.ZMQSLIB.MQSRLLIB Binder timestamp: 04MAR99 12:11:42 Version procedure: T0085D30_01MAR1999_MQILIB_2201 Version procedure: T0085D30_01MAR1999_ECBLIB_2201 Version procedure: T0085D30_01MAR1999_ECLIB_2201 Version procedure: T0085D30_01MAR1999_CMDLIB_2201 Version procedure: T0085D30_01MAR1999_LQMLIB_2201 Version procedure: T0085D30_01MAR1999_MQSSLIB_2201 Version procedure: T0085D30_05MAR1999_REMLIB_2201 Version procedure: T0085D30_01MAR1999_ZRLIB_2201 Version procedure: T0085D30_01MAR1999_COMMLIB_2201 Version procedure: T0085D30_01MAR1999_ZSLIB_2201 Version procedure: T0085D30_01MAR1999_ZSTLIB_2201 Version procedure: T0085D30_01MAR1999_DCLIB_2201 Version procedure: T0085D30_01MAR1999_IPCLIB_2201 Version procedure: T0085D30_05MAR1999_CSLIB_2201 Version procedure: T0085D30_01MAR1999_MQSCLIB_2201 Native Mode: runnable file $VOL.ZMQSLIB.MQSRLLNK Binder timestamp: 04MAR99 12:17:09 Version procedure: T0085D30_01MAR1999_MQILIB_2201 Version procedure: T0085D30_01MAR1999_ECBLIB_2201 Version procedure: T0085D30_01MAR1999_ECLIB_2201 Version procedure: T0085D30_01MAR1999_CMDLIB_2201 Version procedure: T0085D30_01MAR1999_LQMLIB_2201 Version procedure: T0085D30_01MAR1999_MQSSLIB_2201 Version procedure: T0085D30_05MAR1999_REMLIB_2201 Version procedure: T0085D30_01MAR1999_ZRLIB_2201 Version procedure: T0085D30_01MAR1999_COMMLIB_2201 Version procedure: T0085D30_01MAR1999_ZSLIB_2201 Version procedure: T0085D30_01MAR1999_ZSTLIB_2201 Version procedure: T0085D30_01MAR1999_DCLIB_2201 Version procedure: T0085D30_01MAR1999_IPCLIB_2201 Version procedure: T0085D30_05MAR1999_CSLIB_2201 Version procedure: T0085D30_01MAR1999_MQSCLIB_2201 Native Mode: Not runnable file $VOL.ZMQSLIB.MQMLIBNC Binder timestamp: 04MAR99 13:31:19 Version procedure: T0085D30_01MAR1999_MQILIB_2201 Version procedure: T0085D30_01MAR1999_ZSTLIB_2201 Version procedure: T0085D30_01MAR1999_DCLIB_2201 Version procedure: T0085D30_01MAR1999_IPCLIB_2201 Version procedure: T0085D30_05MAR1999_CSLIB_2201 Native Mode: Not runnable file $VOL.ZMQSLIB.MQMLIBNT Binder timestamp: 04MAR99 13:31:58 Version procedure: T0085D30_01MAR1999_ZSTLIB_2201 Version procedure: T0085D30_01MAR1999_DCLIB_2201 Version procedure: T0085D30_01MAR1999_IPCLIB_2201 Version procedure: T0085D30_05MAR1999_CSLIB_2201 Native Mode: Not runnable file ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ DOCUMENTATION CHANGES --------------------- There are no changes to the documentation that are relevant for MQSeries for Tandem NonStop Kernel V2.2.0.1 other than the amendments to the MQSeries publications listed in the readme file on the product cartridge. ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ SPECIAL INFORMATION ------------------- This PTF is required for MQSeries NATIVE installations running Tandem NonStop Kernel Release D45 and later, and G05 and later. It is essential to update the MQSeries private SRL. Perform step 5 of the Installation and Maintenance procedure above if not previously done. The MQSeries private SRL, LNK and MQM libraries used by NATIVE applications required modification to correct an undocumented change to the NATIVE C Runtime library rand function. It is recommended to relink your NATIVE applications. ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ SERVICE AND TECHNICAL SUPPORT ----------------------------- A) Service Level Information ------------------------- IBM MQSeries for Tandem NonStop Kernel V2.2.0.1 is a maintenance release of product 5697-A17 and supercedes V2.2 and its corresponding PTFs. o After initial installation of this release, it is recommended that you update IBM MQSeries for Tandem NonStop Kernel to the latest service level. IBM MQSeries for Tandem NonStop Kernel V2.2 is the first release of product 5697-A17. o After initial installation of this release, it is recommended that you update IBM MQSeries for Tandem NonStop Kernel to the latest service level. B) Service Support Available from the Internet ------------------------------------------- The MQSeries support page is located at: http://www.software.ibm.com/ts/mqseries/support From the MQSeries support page, you can obtain the latest information about the following topics: IBM Transaction Processing SupportPacs Closed APARs Fix Packages Frequently Asked Questions Tips and Techniques Device Drivers Forums Related Links C) Preventive Service Planning --------------------------- If you do not have access to the World Wide Web then you should see whether there is any Preventive Service Planning (PSP) information that you should know. To do this, check with your IBM Support Center. ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ CSD HISTORY ----------- A) PTF U463805 ----------- This is a non-cumulative service distribution for IBM MQSeries for Tandem NonStop Kernel V2.2.0.1. It is delivered via PTF U463805 for APAR IX88482. The latest maintenance V2.2.0.1 MUST be installed prior to installation of this PTF. A case was opened with Tandem , 990301-0522, to document the change to the NATIVE C Runtime library rand function. B) IBM MQSeries for Tandem NonStop Kernel V2.2.0.1 supercedes V2.2 and is a cumulative maintenance service distribution. MQSeries V2.2.0.1 contains several new features that were not available in MQSeries V2.2: MQSeries Status Server (MQSS) for statistics handling Native version of MQSeries for D4x and G0x operating systems RDF Compatibility enhancements MQSeries Principal Support Support for Euro code pages and changing the queue manager's CCSID Number of APARS = 9 It contains fixes for all the problems listed below: IX78322 - Receiver channel "connection info" error IX79086 - DLQ abend error when exiting, Qdepth count incorrect after processing IX80305 - Setting of MQMC QM panel performance event Y displays N, alias queue GET Enabled IX82148 - 2058 returned with files secured improperly. Should be 2063 IX74874 - When a file open fails the FFST does not tell which file IX83310 - MQMC channel Userid & Password update error IX84142 - CPU down Process-Getinfo error 5 IX85516 - Number of queues with like names limited to 256 IX85831 - No FFST generated for IO error - Enhanced protection of the queue manager from unwanted TM/MP transactions for MQI operations C) PTF U456615 ----------- This is a non-cumulative service distribution for IBM MQSeries for Tandem NonStop Kernel V2.2. It is delivered via PTF U456615 for APAR IX76882. The latest CSD, PTF U454165 MUST be installed prior to installation of this PTF. Any applications that use the MQGET with the MQGMO_SET_SIGNAL option must be recompiled to use the correct definition of the MQIPC structure. Any applications that were coded expecting the prior, wrong, definition of the MQIPC signal message must be changed to use the correct definition, since the Queue Manager Agent has also been corrected to generate the correct message. Number of APARs in PTF = 5. It contains fixes for all the problems listed below: IX76650 - MQGET with Msgid/Correlid retrieves wrong message IX76649 - MQRC_NO_MSG_AVAILABLE incorrectly returned on waited MQGET for shared queue IX76905 - EC Boss recovery failure for CPU down IX75646 - MQGET with SET_SIGNAL random delay between message arrival and notification message to application IX75441 - MQCLOSE or MQDISC hangs if MQGET with SET_SIGNAL is still outstanding 531 - Problem with browse of queue with expired messages 467 - Channel Initiator stops serving initiation queue - Transaction problems with channels on disk downing - CMQCH definition for the MQIPC structure corrected to align with the TAL and COBOL85 definitions - MQLQMAG updated to generate correct MQIPC signal message - Addition of new IMS definitions to CMQCH to bring up to latest Version 2 Release 2 service level D) PTF U454165 ----------- This is the second CSD for IBM MQSeries for Tandem NonStop Kernel V2.2. It is delivered via PTF U454165 for APAR IX73908. This PTF introduces support for all G0x versions of the Tandem NonStop Kernel operating system. Number of APARs in CSD = 6. It contains fixes for all the problems listed below: IX73908 - Cumulative maintenance #2 for IBM MQSeries for Tandem NonStop Kernel V2.2. IX73139 - CRTMQM requires MQM.MANAGER to exist IX73141 - Long response on 1st PUT last GET IX74165 - Errors after long period of inactivity on channels IX74527 - CLEAR QLOCAL and STRMQM problem on large queues IX74888 - Deleting Queue or Process object of same name as Queue Manager can corrupt database 471 - Queue Manager losing track of responders 473 - Message gains 32k of zeros 489 - EC failure during stress tests 462 - Stress test p199 only runs for 44/48 hours 389 - Start channel usability for responders 465 - Channel Initiator triggers channels needlessly 420 - Security - OAM 12 character userid limitation 477 - FFST from runmqchi on endmqm 411 - Runmqlsr already running confuses qmgr and clients 483 - Channel cannot start to return a report message 509 - DLQ processing delayed 492 - Qmgr recovery restored messages to queue after clear ql 501 - Listener ends when connecting a number of clients 502 - Can't start channel (xmitq in use) after trans abort 506 - unable to MQPUT1 to stress qmgr after 48 hours 508 - QMgrs cannot be deleted in P121 stress test - EC agent re-use algorithm broken (note that agent processes will be re-used more efficiently in this release, leading to fewer process starts and stops and lower memory usage) - Reset channel retry counts on successful batch transfer - addition of new Data Conversion support for CCSIDs 1252, 1275 and 65024 E) PTF U452253 ----------- This is the first CSD for IBM MQSeries for Tandem NonStop Kernel V2.2. It is delivered via PTF U452253 for APAR IX72027 Number of APARs in CSD = 1. It contains fixes for all the problems listed below: IX72027 - Cumulative Maintenance #01 for IBM MQSeries for Tandem NonStop Kernel V2.2 (HIPER PTF) 380 - Channel initiator CPU usage increasing gradually over time 485 - Channel problems, alter qlocal not processed correctly if channel initiator running 491 - Performance enhancements 487 - Application hung in waited get 488 - Channel sequence number reset by qmgr 464 - Message contention on transmission queue between putting application and MCA 416 - EMS message formating 472 - Sample exit bind, bexite does not search MQMLIBC 468 - Unable to re-start qmgr occasionally after system IPL during operation 476 - Channel hungs when receiving channel attempting to use dead letter queue 466 - Alter queue local not reflected on subsequent queue display 245 - Channel status BYTSSENT/RCVD fields incorrect 377 - Message sequence number status problems on display chstatus 470 - 1092 received from MQM panels 448 - Delete channel not removing channel statistics 439 - Sequence number error after endmqm -p on remote qmgr 481 - Error in channel exit sample program ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ TRADEMARKS ---------- The following terms are trademarks of the IBM Corporation in the United States or other countries or both: AIX CICS IBM MQSeries SupportPac NonStop Kernel is a trademark of Tandem Computers Inc. # ------- end of file MEMOPTF -----------------------------------------