######################################################################## # # # COMPONENT_NAME: MQSeries # # # # FILE: MEMOEFIX # # # # 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. # # # ######################################################################## E-fix Memo for IBM MQSeries for Tandem NonStop Kernel V2.2.0.1 - 3/21/2000 --------------------------------------------------------------------------- This MEMOEFIX file contains information you need for updating IBM MQSeries for Tandem NonStop Kernel V2.2.0.1 with the E-fix for APAR IY09147. This E-fix is provided to correct a problem where outbound channels with a disconnect interval of zero (DISCINT(0)) do not refresh their TM/MP transactions. The problem is only present in installations of MQSeries V2.2.0.1 with PTF U469649 applied. The symptom of the problem is MQRC_UOW_CANCELED (2297) from the channel program as TMF aborts the long running channel transaction in accordance with the TMF Autoabort setting for the system. An MCA (message channel agent) using a disconnect interval of 0 (zero), which signifies never disconnect, should refresh its TM/MP transaction every 10 seconds unless overridden by the MQTRANSACTIONLIFE parameter setting. MQSeries for Tandem NSK V2.2.0.1 installations which do NOT use disconnect intervals of 0 (zero) on channel definitions need NOT apply this maintenance. MQSeries for Tandem NSK V2.2.0.1 installations which do use disconnect intervals of 0 (zero) on channels can workaround this problem by altering the channel definition to use a short disconnect interval and have the channel initiator restart the channel when messages arrive to be sent. Also provided with this e-fix is a replacement of the CMQCH header file. The PTF U469649 version did not contain the IMS bridge definitions for APAR IX89679. Installations that do not use IMS formats do NOT have to apply this maintenance. Installations that use IMS formats have been supplied this version previously and do NOT need to rebuild their applications. ------------------------------------------------------------- ALL INSTALLATIONS: ZMQSLIB files provided with this e-fix: CMQCH NON-NATIVE INSTALLATIONS (MQSeries ZMQSEXE files file code 100): Non-Native Executables provided with this e-fix: MQLQMAG MQLU6RES MQMCACAL MQTCPRES RUNMQCHI To verify that your currently installed NON-NATIVE release is at the correct level, run the Tandem utility VPROC on the MQLQMAG executable for MQSeries, normally found in the ZMQSEXE subvolume. The output should be as follows: $VOL.ZMQSEXE.MQLQMAG Binder timestamp: 24JAN2000 22:35:58 Version procedure: T0085D30_01MAR1999_ZSLIB_2201 Version procedure: T0085D30_05AUG1999_LQMEXE_2201 Version procedure: T0085D30_11OCT1999_LQMLIB_2201 Version procedure: T0085D30_19NOV1999_IPCLIB_2201 Version procedure: T0085D30_27OCT1999_CSLIB_2201 Version procedure: T0085D30_28JUL1999_MQSSLIB_2201 Target CPU: TNS, TNS/R AXCEL timestamp: 25JAN2000 03:16:51 After installation, the VPROC information for the program for NON-NATIVE installations should be updated to: $VOL.ZMQSEXE.MQLQMAG Binder timestamp: 21MAR2000 10:53:59 Version procedure: T0085D30_01MAR1999_ZSLIB_2201 Version procedure: T0085D30_05AUG1999_LQMEXE_2201 Version procedure: T0085D30_19NOV1999_IPCLIB_2201 Version procedure: T0085D30_20MAR2000_LQMLIB_2201 Version procedure: T0085D30_27OCT1999_CSLIB_2201 Version procedure: T0085D30_28JUL1999_MQSSLIB_2201 Target CPU: TNS, TNS/R AXCEL timestamp: 21MAR2000 11:39:42 NATIVE INSTALLATIONS (MQSeries ZMQSEXE files file code 700): Native files provided with this e-fix: MQSRLLIB MQSRLLNK To verify that your currently installed NATIVE release is at the correct level, run the Tandem utility VPROC on the MQSeries private SRL MQSRLLIB, normally found in the ZMQSLIB subvolume. The output should be as follows: $VOL.ZMQSLIB.MQSRLLIB GMT Binder timestamp: 25JAN2000 01:26:09 Version procedure: T0085D30_01MAR1999_MQILIB_2201 Version procedure: T0085D30_01MAR1999_ECBLIB_2201 Version procedure: T0085D30_19NOV1999_ECLIB_2201 Version procedure: T0085D30_01MAR1999_CMDLIB_2201 Version procedure: T0085D30_11OCT1999_LQMLIB_2201 Version procedure: T0085D30_28JUL1999_MQSSLIB_2201 Version procedure: T0085D30_13JAN2000_REMLIB_2201 Version procedure: T0085D30_21SEP1999_ZRLIB_2201 Version procedure: T0085D30_07JUL1999_COMMLIB_2201 Version procedure: T0085D30_01MAR1999_ZSLIB_2201 Version procedure: T0085D30_01MAR1999_ZSTLIB_2201 Version procedure: T0085D30_01MAR1999_DCLIB_2201 Version procedure: T0085D30_19NOV1999_IPCLIB_2201 Version procedure: T0085D30_27OCT1999_CSLIB_2201 Version procedure: T0085D30_04AUG1999_MQSCLIB_2201 Native Mode: runnable file After installation, the VPROC information for the SRL for NATIVE installations should be updated to: $VOL.ZMQSLIB.MQSRLLIB GMT Binder timestamp: 21MAR2000 14:21:29 Version procedure: T0085D30_01MAR1999_MQILIB_2201 Version procedure: T0085D30_01MAR1999_ECBLIB_2201 Version procedure: T0085D30_19NOV1999_ECLIB_2201 Version procedure: T0085D30_01MAR1999_CMDLIB_2201 Version procedure: T0085D30_20MAR2000_LQMLIB_2201 Version procedure: T0085D30_28JUL1999_MQSSLIB_2201 Version procedure: T0085D30_13JAN2000_REMLIB_2201 Version procedure: T0085D30_21SEP1999_ZRLIB_2201 Version procedure: T0085D30_07JUL1999_COMMLIB_2201 Version procedure: T0085D30_01MAR1999_ZSLIB_2201 Version procedure: T0085D30_01MAR1999_ZSTLIB_2201 Version procedure: T0085D30_01MAR1999_DCLIB_2201 Version procedure: T0085D30_19NOV1999_IPCLIB_2201 Version procedure: T0085D30_27OCT1999_CSLIB_2201 Version procedure: T0085D30_04AUG1999_MQSCLIB_2201 Native Mode: runnable file ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ INSTALLATION AND MAINTENANCE INFORMATION ---------------------------------------- This E-fix MUST ONLY be installed on the latest service level of MQSeries, V2.2.0.1, PTF U469649. There is no installation program for this E-fix - you must manually verify that the release you are installing over is at the correct level. A) Applying Maintenance ----------------------- This E-fix is supplied in an archive format. The UNPAK program must be used to extract the updated programs. ** 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 E-fix. * * * **************************************************************** Backup your original MQSeries for Tandem NonStop Kernel executables and files that are being replaced. Ensure that all Queue Managers have been ended. 1. Logon as the user in the MQM group that owns the MQSeries installation that you are updating. 2. Download the pak file to subvolume ZMQSEFIX. You can obtain UNPAK from the World Wide Web. The URL is http://www.bsi.com/DOWNLOAD-FREE.HTML 3. Extract the updated programs from the archive file as follows: UNPAK IY09147, $*.*.*, MAP NAMES $*.*.* TO $.ZMQSEFIX.*, & LISTALL, MYID 4. For NON-NATIVE installations replace the programs in ZMQSEXE (or other location if you are not using the default) with the updated versions. For NATIVE installations replace the MQSeries private SRL and LNK libraries in ZMQSLIB (or other location if you are not using the default) with the updated versions. If MQSRLLIB has not been replaced in the same volume and subvolume you will need to run NMLDEXES located in ZMQSLIB to relink the MQSeries executables to the new SRL location. 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). For ALL installations replace the CMQCH file in ZMQSLIB with the updated version. 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 programs should have the file attributes "NCCC", PROGID (for executables) and be owned by a user in the MQM user group. ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++