######################################################################## # # # 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 R2.0.1 - 10/29/99 -------------------------------------------------------------------------- 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 IY05417. The E-fix is provided to correct a problem where the Queue Manager agents abend with a Run-time Error 004 Arithmetic fault in function xcsGetUniqueTag. The problem is only present in non-native installations of MQSeries and this e-fix only contains changes for the non-native installations. The abend occurs when a short declared variable exceeds 32767. The variable is used to create a unique LUWID for channels or MSGID for MQPUT, MQPUT1 when MQMI_NONE is used in customer applications or internally in MQSeries for Event processing. The E-fix provided for IY05417 corrects the Arithmetic fault in the Queue Manager agents. The E-fix also contains a correction to the LQMA and MCAs made for APAR IY00352. A summary of this APAR modification follows, with details at the end of this memo: IY00352 - messages out of sequence returned by MQGET ------------------------------------------------------------- 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: 29JAN99 01:15:06 Version procedure: T0085D30_01MAR1999_CSLIB_2201 Version procedure: T0085D30_01MAR1999_IPCLIB_2201 Version procedure: T0085D30_01MAR1999_LQMEXE_2201 Version procedure: T0085D30_01MAR1999_LQMLIB_2201 Version procedure: T0085D30_01MAR1999_MQSSLIB_2201 Version procedure: T0085D30_01MAR1999_ZSLIB_2201 Target CPU: TNS, TNS/R AXCEL timestamp: 29JAN99 06:11:41 After installation, the VPROC information for the program for NON-NATIVE installations should be updated to: $VOL.ZMQSEXE.MQLQMAG Binder timestamp: 29OCT99 14:36:30 Version procedure: T0085D30_01MAR1999_IPCLIB_2201 Version procedure: T0085D30_01MAR1999_LQMEXE_2201 Version procedure: T0085D30_01MAR1999_MQSSLIB_2201 Version procedure: T0085D30_01MAR1999_ZSLIB_2201 Version procedure: T0085D30_05MAR1999_CSLIB_2201 Version procedure: T0085D30_18MAY1999_LQMLIB_2201 Target CPU: TNS, TNS/R AXCEL timestamp: 29OCT99 20:35:33 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ INSTALLATION AND MAINTENANCE INFORMATION ---------------------------------------- This E-fix MUST ONLY be installed on the latest non-native service level of MQSeries, V2 R2.0.1. 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 program. ** 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 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. The correct filesize is 9,866,066 bytes 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 IY05417, $*.*.*, MAP NAMES $*.*.* TO $.ZMQSEFIX.*, & LISTALL, MYID 4. Replace the programs in ZMQSEXE (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 it, if necessary. When properly installed, the programs should have the file attributes "NCCC", PROGID (for executables) and owned by a user in the MQM user group. ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ Included E-fix details ---------------------- The E-fix for APAR IY00352 is provided to correct a problem where MQGET could return messages out of sequence. This is observed when a message batch is completed while the MQGET is reading the locked records of the batch and then encounters an unlocked record. This unlocked record was returned in error. The MQGET has been corrected to return the first message in the unlocked batch. The same behaviour was also noticed for the browse MQGET and corrected. The E-fix provided will correct the message order retrieval for destructive and browse MQGET. Executables are provided for non-native installations.