######################################################################### # # # 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 - 10/13/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 U473441. 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 U473441. 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 memory * * leak correction for MQCONN or correction for comments in the * * INI files implemented (APARs IY10446 and IY07877). * * * * 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. * * * * It is necessary to change all channel synchronization files * * located in the qmS subvolume to be audited expect for the * * SYNCHIDX file. * * * **************************************************************** 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 the user-id in the MQM group owning the MQSeries Installation, for example MQM.MANAGER. 2. Move the pak file to subvolume ZMQSPTF. Ensure that the UNPAK utility is in the default program search path for the MQSeries Installation owner, for example MQM.MANAGER. You can obtain UNPAK from the World Wide Web. The URL is http://www.bsi2.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 files from the archive file as follows: UNPAK U473441, $*.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 6. Change all channel synchronization files located in the qmS subvolume for each queue manager to audited except for SYNCHIDX. Issue a FUP ALTER , AUDIT for all files in the qmS subvolume except for the SYNCHIDX file. 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_16MAR2000_CMDLIB_2201 Version procedure: T0085D30_21FEB2000_COMMLIB_2201 Version procedure: T0085D30_11MAY2000_CSLIB_2201 Version procedure: T0085D30_03MAY2000_DCLIB_2201 Version procedure: T0085D30_10AUG2000_ECBLIB_2201 Version procedure: T0085D30_23AUG2000_ECLIB_2201 Version procedure: T0085D30_02JUN2000_IPCLIB_2201 Version procedure: T0085D30_17JUL2000_LQMLIB_2201 Version procedure: T0085D30_19JUN2000_MQSCLIB_2201 Version procedure: T0085D30_31MAR2000_MQSSLIB_2201 Version procedure: T0085D30_06SEPT2000_REMLIB_2201 Version procedure: T0085D30_19JUN2000_ZRLIB_2201 Executable: Version procedure: T0085D30_02JUL1999_AUREXE_2201 (ALTMQUSR) Version procedure: T0085D30_03MAY2000_CRDEXE_2201 (CLEANRDF) Version procedure: T0085D30_23NOV1999_CMQEXE_2201 (CRTMQM) Version procedure: T0085D30_02JUL1999_DUREXE_2201 (DSPMQUSR) Version procedure: T0085D30_14MAR2000_DTREXE_2201 (DSPMQTRC) Version procedure: T0085D30_05JUN2000_CSVEXE_2201 (MQCMDSVR) Version procedure: T0085D30_09AUG2000_ECEXE_2201 (MQEC) Version procedure: T0085D30_10AUG2000_ECBEXE_2201 (MQECBOSS) Version procedure: T0085D30_05JUN2000_LQMEXE_2201 (MQLQMAG) Version procedure: T0085D30_31AUG2000_LU6EXE_2201 (MQLU6RES) Version procedure: T0085D30_31AUG2000_CALEXE_2201 (MQMCACAL) Version procedure: T0085D30_21JUN2000_MQMEXE_2201 (MQMSVR) Version procedure: T0085D30_31MAR2000_MQSSEXE_2201 (MQSSSVR) Version procedure: T0085D30_31AUG2000_TCREXE_2201 (MQTCPRES) Version procedure: T0085D30_30JUN2000_CHIEXE_2201 (RUNMQCHI) Version procedure: T0085D30_21FEB2000_TCLEXE_2201 (RUNMQLSR) Version procedure: T0085D30_19NOV1999_TRGEXE_2201 (RUNMQTRM) Version procedure: T0085D30_12JUL2000_SAUEXE_2201 (SETMQAUT) Version procedure: T0085D30_05JUN2000_SMQEXE_2201 (STRMQM) ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ 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 MQCONN memory leak or comments in INI file corrections. Replacement MQI libraries are supplied for this PTF which include these changes. 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. The support for use of multiple TCPIP process names per queue manager has been implemented in this PTF. No change in channel definitions is required to use the current default of a single TCPIP process name per queue manager configuration. See the README file for details on modifications to MQSeries for multiple TCPIP process support. It is necessary to change all channel synchronization files located in the qmS subvolume for each queue manager to audited except for SYNCHIDX. Issue: FUP ALTER , AUDIT for all files in the qmS subvolume except for the SYNCHIDX file. ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ 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 U473441 ----------- This is a cumulative service distribution for IBM MQSeries for Tandem NonStop Kernel V2.2.0.1. It is delivered via PTF U473441 for APAR IY13355. Number of APARS = 18 It contains fixes for all the problems listed below: IY07775 - Pathway error 1003 from STRMQM when applications issue a MQCONN during queue manager startup. IY07877 - Comment lines in INI files cause excessive memory usage. IY08093 - RUNMQSC abends when deleting a stopped channel. IY08297 - The channel initiator would timeout with a Pathway error 40 during endmqm when using the default QMINI MaxTries and MaxTriesInterval settings and a channel is in retry status. IY08856 - Temporary dynamic queues with duplicate names could be created. RUNMQSC did not continue processing DIS Q ALL when a object not found was reported. No FFST was generated detailing the unknown object by the MQSSSVR process. Timing of the update of the open count of a temporary dynamic queue caused the queue not to be deleted by the MQCLOSE of the queues creator. IY09147 - Outbound channels with a disconnect interval of zero (DISCINT(0)) do not refresh their TM/MP transactions. IY09184 - The CLEANRDF utility does not duplicate a non-default MQSINI. The CLEANRDF utility reports "An unexpected error was encountered by a command." when processing completes normally. IY09383 - Data conversion from DBCS to SBCS did not convert FFST and MQERRLG1 comment data. IY09861 - The message overflow file becoming 100% full could result in message corruption. IY10446 - MQCONN when issued to an inactive queue manager increases application memory utilization. The Command Server memory utilization increases gradually when processing many PCF requests. The MQLQMAG process can exhibit a slow memory leak over a period of 2-3 hours. The MQLQMAG memory utilization increases when using an MQOPEN input of a non-triggered queue or MQOPEN input of a model queue. IY11176 - The ECBOSS sometimes exits on EC failure. The ECBOSS does not stop channel agents waiting on network IO (LU62 Responders) when the agent's EC fails. Idle MCA agents do not handle updates to the QMGR object. This could under rare circumstances cause a EC failure. IY11413 - Resolve Channel abends with an illegal address. Resolve Channel in-doubt logic checking incorrect. IY11381 - The Channel Initiator started a manually stopped channel. The Channel Initiator / EC did not set an outbound channels status to RETRY when the MCA process did not exist and Channel status was running. This caused channels not to restart on a ECBOSS / EC failure. The Channel Initiators processing of messages on the Initiation queue was delayed as more channels started. IY11496 - The Channel synchronization record and message batch updates are not coordinated (see special instructions for auditing the channel synchronization files). IY11594 - The QSVCIEV queue attribute is corrupted when a performance event such as queue depth high is reported. IY11846 - CLEAR QLOCAL curdepth reset can be undone after queue manager restart. A non-zero curdepth is shown despite no physical presence of messages. IY11988 - OAM Tandem Administration group / File sharing group not validating Principal. This also causes the MQLQMAG to abend with an illegal address in zutUnloadPriDB. SETMQAUT using a principal or group larger then 12 characters abends with an illegal address. IY12901 - Receiver channel data conversion capability logic for ccsids with no data conversion tables but with a listed ccsid in ZMQSSYS.CCSID is not working. Conversion not supported is returned instead of negotiating whether the sender is capable of converting the data prior to transmission. - Support for Multiple TCP/IP processes per queue manager (see README file for instructions on using this functionality). - Native COBOL library MQMLIBT requires symbols. - C header file did not contain IMS bridge definitions. - MQMSVR loops when exiting MQMC panels if more than 250 queues are defined. - MQMSVR did not recover from a connection broken. Repeating the request will reconnect to the queue manager. Previously MQMC had to be exited and re-entered to reconnect. - Native version of DSPMQTRC abends. - The DIS CHS JobName field data now displays the process name of the channel agent currently running the channel. - The EC did not restart a failed Autostart LU62 Responder listening on the network for a channel start. - If a corrupt channel status record is found the code will now FFST and continue processing. A process finding a bad record will FFST a maximum of 10 times and disable further reporting. Previously the queue manager required recycling to enable channels to start when a corrupt status record was encountered. - The DIS CHS StopRequest field was not being set. - The TCPIP socket error number was being reported as zero in some AMQ messages. - Updates to the queue manager object may cause idle MCAs to exit with a "Error return code received" message with return code 8429576. - Response to a DIS Q(*) request on a heavily loaded queue manager was long due an read lock request of OBJCAT records. - If a data conversion file (ZMQSCONV) cannot be opened due to a security restriction an FFST will be generated. B) 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. C) 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. D) 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 E) 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 F) 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 G) 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 -----------------------------------------