######################################################################### # # # 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 - 1/31/2000 ------------------------------------------------------------------------ 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 cumulative service distribution, corresponding to PTF U469649. 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 U469649. 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 NOT required to recompile and relink / rebind your * * MQSeries applications except if you wish to have the C or * * TAL header file updates incorporated in your application. * * * * It is required for Native installations that use their own * * MQSeries private SRL, for exits as an example, be rebuilt * * and all MQSeries applications and user applications be * * relinked to the new PSRL. * * * * For users who wish to use Native Mode COBOL (NMCOBOL), the * * installation of Tandem IPM T8107AAO is required to correct * * problems with the linking of the MQSeries MQI library * * MQMLIBNT with a NMCOBOL application. Tandem begins support * * for NMCOBOL with OS releases D45 and G06. * * * **************************************************************** 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 This URL is outside IBM’s control and may change. If you are unable to download a copy of UNPAK, log a support call and the service team will send you a copy. 3. Restore the install program (instmqm), memoptf and readme from the archive file as follows: UNPAK U469649, $*.INSTALL.*, MAP NAMES $*.*.* TO & $.ZMQSPTF.*, LISTALL, MYID 4. Invoke the install program 5. Answer the prompts which follow with the assistance of the MQSeries for Tandem NonStop Kernel System Management Guide If installing from a 3480 cartridge, replace step 3 above as follows: 3. Restore the install program (instmqm), memoptf and readme from the cartridge device as follows: RESTORE $MARA1, $*.INSTALL.*, MAP NAMES $*.*.* TO & $.ZMQSPTF.*, LISTALL, MYID, NOUNLOAD NOTE: We do not recommend that you replace the original INSTMQM (located by default in ZMQSEXE) with the one restored from the PTF as they have slightly different functionality. NOTE: The VPROC information has been updated for the files replaced by this PTF. Library: Version procedure: T0085D30_07JUL1999_COMMLIB_2201 Version procedure: T0085D30_27OCT1999_CSLIB_2201 Version procedure: T0085D30_21JAN2000_ECBLIB_2201 Version procedure: T0085D30_19NOV1999_ECLIB_2201 Version procedure: T0085D30_19NOV1999_IPCLIB_2201 Version procedure: T0085D30_11OCT1999_LQMLIB_2201 Version procedure: T0085D30_04AUG1999_MQSCLIB_2201 Version procedure: T0085D30_28JUL1999_MQSSLIB_2201 Version procedure: T0085D30_13JAN2000_REMLIB_2201 Version procedure: T0085D30_21SEP1999_ZRLIB_2201 Executable: Version procedure: T0085D30_02JUL1999_AUREXE_2201 (ALTMQUSR) Version procedure: T0085D30_06OCT1999_CRDEXE_2201 (CLEANRDF) Version procedure: T0085D30_23NOV1999_CMQEXE_2201 (CRTMQM) Version procedure: T0085D30_02JUL1999_DUREXE_2201 (DSPMQUSR) Version procedure: T0085D30_19NOV1999_CSVEXE_2201 (MQCMDSVR) Version procedure: T0085D30_09AUG1999_ECEXE_2201 (MQEC) Version procedure: T0085D30_05AUG1999_LQMEXE_2201 (MQMQMAG) Version procedure: T0085D30_28JUL1999_MQSSEXE_2201 (MQSSSVR) Version procedure: T0085D30_19NOV1999_CHIEXE_2201 (RUNMQCHI) Version procedure: T0085D30_19NOV1999_TCLEXE_2201 (RUNMQLSR) Version procedure: T0085D30_19NOV1999_TRGEXE_2201 (RUNMQTRM) ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ 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 latest readme file located in the INSTALL and ZMQSSYS subvolumes of the product installation. ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ SPECIAL INFORMATION ------------------- It is NOT required, to recompile and relink / rebind your applications except if you wish to incorporate the C and TAL header file corrections. A replacement MQMLIBNT MQI library for Native Mode Cobol support is supplied, otherwise no new libraries are supplied for this PTF. It is required for Native installations that use their own MQSeries private SRL, for exits as an example, be rebuilt and all MQSeries applications and user applications be relinked to the new PSRL. For users who wish to use Native Mode COBOL (NMCOBOL), the installation of Tandem IPM T8107AAO is required to correct problems with the linking of the MQSeries MQI library MQMLIBNT with a NMCOBOL application. New sample build scripts are provided for compiling (NCOBSAMP)and linking (NMLDCOB) NMCOBOL applications. The BLDNMCOB script is provided to build all sample COBOL applications in Native Mode. Tandem support for Native Mode COBOL starts with OS releases D45 and G06. ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ 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 U469649 ----------- This is a cumulative service distribution for IBM MQSeries for Tandem NonStop Kernel V2.2.0.1. It is delivered via PTF U469649 for APAR IY07278. Number of APARS = 20 It contains fixes for all the problems listed below: IX86823 - Incorporate V2.2 changes for MQLQMAG memory usage. Some variables using miniscule amounts of memory were not released when exiting the functions in which they were allocated. IX86876 - On a reset channel sequence number if no messages are sent the TM/MP transaction remains active. IX88783 - Switching a channel from SNA to TCP and back to SNA again caused a channel in use condition. IX89679 - C header file CMQCH distributed in V2.2.0.1 was not the latest. Headers for IMS bridge and a correction to MQAT_DEFAULT made under V2.2 maintenance were missing. IY00352 - MQGET messages out of sequence. Messages could be retrieved out of order when MQGET processing scanned uncommitted records while the MQPUT message batch committed. The MQGET returned the next record found. It should retry and return the first committed record. IY00636 - The Channel Status times are incorrect for systems using a DST table and non-native code. IY01197 - MQSS Server does not update the open counts when a CPU fails. IY01678 - MQPUT using default transmission queue produces FFSTs. IY01828 - MQLU6RES process abends when SNAX/APC IPC error is being reported. IY01893 - ALTMQUSR cannot remove a principal. IY02080 - MQMCACAL abends when it reads more then 1024 locked records (uncommitted messages) from the transmission queue. IY02083 - MQMCACAL abends when an initialization error occurs during channel startup which bypasses the channel status data initialization. IY02211 - ICE channel with 8 character LocalLu and Userid fails with invalid file name. IY02971 - Channel Status not correct when the transmission queue name is changed for a channel. IY03340 - MQGET browse starts a TM/MP(TMF)transaction. IY04417 - CLEANRDF utility native version doesn’t work. IY04812 - MQLQMAG error 30 received from DP2 process when over 4000 opens for queues are requested. IY05417 - Processes abend with Runtime Error 4 Arithmetic fault in function xcsGetUniqueTag. IY07261 - EMS event timestamps are incorrect for systems using Native code. IY07399 - Channel STOP MODE(FORCE) does not always stop channel. - SNA return code error processing not putting in the correct detail code for an unexpected return code. - The MQSS Server does not start if the backup cpu is down. - The MQSS Server does not run on one cpu if a backup cpu is not available. - Ping channel destroys channel retry values. - Add MQACT^NONE to CMQTAL header. - Strmqm does not display serverclass name for a START SC failure. - Initialization messages for the EC do not reflect the correct EC sequence number assigned by the ECBOSS. - AMQ9240 Snax communications error message missing from MSGESES (Spanish) message file. - Sending channels report sent sequence number incorrectly on message sequence number mismatch. - Strmqm and other MQ commands displayed "Error getting PARMERR from SPI response: -8" when MQ processed a Pathway error. - Return MQRC_SECURITY_ERROR (2063), on a message file open failure for Tandem error 48. - Report Runtime file create error in crtmqm. - EC recovery from ECBOSS failure improvements. - Channel initiator sending of trigger messages during the opening of the initiation queue in process initialization improvement. - Support for Native Mode COBOL (NMCOBOL). Requires the installation of Tandem IPM T8107AAO for resolution of a linking problem with the MQSeries MQI library MQMLIBNT. Tandem case 990714-6174 documents this problem and solution. B) 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. C) 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 = 17 It contains fixes for all the problems listed below: IX74874 - xgcFileOpen FFST does not show file name IX78322 - Panels receiver connection info problem IX78837 - FFST on Waited GET on shared queue IX79086 - DLQ Handler behavior IX79237 - RDF compatibility problems with STRMQM IX79977 - No DLQ channel behavior problem IX80305 - Performance event field problem in Panels IX80975 - No COBOL or TAL IMS definitions IX81219 - Multiple MQGET with SET_SIGNAL produces FFST IX82148 - MQCONN 2058 returned instead of 2063 for improperly secured INI files IX82163 - MQDISC corrupts callers stdin file descriptor IX82505 - Deadlock on COD report generation using default xmit queue IX83310 - SNA channel userid and password fields not incorrectly displayed IX84142 - For CPU down situation get PROCESS_GETINFO_ error 5 IX84308 - MQCONN and Native mode library 2059 intermittently 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 D) 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 E) 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 F) 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 formatting 472 - Sample exit bind, bexite does not search MQMLIBC 468 - Unable to re-start qmgr occasionally after system IPL during operation 476 - Channel hangs 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 the Tandem Division of Compaq. # ------- end of file MEMOPTF -----------------------------------------