A fix is available
APAR status
Closed as new function.
Error description
APAR raised to exploit new function being introduced in MQ/CICS bridge in MQ v7.
Local fix
Problem summary
**************************************************************** * USERS AFFECTED: All CICSPlex SM V4R1M0 Users. * **************************************************************** * PROBLEM DESCRIPTION: The MQCON and MQCONN resource tables * * and the EYUSTARTMQCON and * * EYUSTARTMQCONN Web User Interface * * (WUI) viewsets need to provide * * information related to enhancements * * made in WebSphere MQ Version 7. * **************************************************************** * RECOMMENDATION: If the CPSM V4R1M0 environment to which the * * PTF that resolves this APAR will be applied * * contains CICS V6R5M0 MASes, then the PTF * * that resolves CICS V6R5M0 APAR PK66866 must * * be applied to those systems before applying * * the PTF that resolves this APAR. * * * * After applying the PTF that resolves * * this APAR, all CMASes and Web User * * Interface servers need to be restarted * * to pick up the changes. Note that the * * restarts need not occur at the same * * time. * * * * Additionally, users of the CICSPlex SM * * supplied starter set viewsets and menus * * must re-import the updated starter set * * viewset and menu definitions into each * * Web User Interface (WUI) server's * * repository in order to pick up the * * changes. * * * * The starter set viewsets and menus can * * be re-imported either via the * * AUTOIMPORTDSN and AUTOIMPORTMEM WUI * * server initialization parameters or the * * IMPORT (from a dataset) function of the * * COVC WUI transaction. * * * * If COVC is used to re-import the * * starter set, ensure that the OVERWRITE * * import option is specified if the WUI * * server's repository previously * * contained that starter set viewsets and * * menus. * * * * For details on the COVC IMPORT function * * see 'The CICSPlex SM Web User Interface * * transaction (COVC)' in the CICS * * Transaction Server for z/OS Version 4 * * Release 1 CICSPlex SM Web User * * Interface Guide (SC34-7045). * * * * The updated starter set member names * * that need to be imported are: * * * * Views: EYUxA04F * * EYUxA054 * * * * Replace x with the required language * * version to be imported: E - English, K * * - Japanese, S - Chinese. * * * * Insure that the import references the * * SEYUVIEW dataset that was updated by * * the PTF that resolves this APAR. * * * * The PTF that resolves this APAR * * provides additional information for * * WebSphere MQ Version 7 users. The CICS * * PTFs that resolve APARs PK89844 (CICS * * R660) and PK66866 (CICS R650) before * * the new information will be returned. * * * * If these CICS PTFs are not installed, * * no data will be returned for the new * * attributes. * * * **************************************************************** WebSphere MQ Version 7 provides support for new API commands for message properties, publish/subscribe and asynchronous consume. CICS APARs PK89844 (CICS R660) and PK66866 (CICS R650) provide CICS support for WebSphere MQ Version 7, that includes additional statistical information. The CICSPlex SM Web User Interface (WUI) views: EYUSTARTMQCON.DETAIL1 EYUSTARTMQCON.DETAIL3 EYUSTARTMQCONN.DETAIL1 EYUSTARTMQCONN.DETAIL3 need to be updated to show this new information.
Problem conclusion
Temporary fix
FIX AVAILABLE BY PTF ONLY
Comments
The EYUSTARTMQCON and EYUSTARTMQCONN Web User Interface viewsets have been updated as follows: - The DETAIL1 views now include the attributes: MQGTCB - The total number of times the MQCB command was issued MQGTCTL - The total number of times the MQCTL command was issued MQGTSUB - The total number of times the MQSUB command was issued MQGTSUBRQ - The total number of times the MQSUBRQ command was issued MQGTSTAT - The total number of times the MQSTAT command was issued MQGTCRTMH - The total number of times the MQCRTMH command was issued MQGTDLTMH - The total number of times the MQDLTMH command was issued MQGTSETMP - The total number of times the MQSETMP command was issued MQGTINQMP - The total number of times the MQINQMP command was issued MQGTDLTMP - The total number of times the MQDLTMP command was issued MQGTMHBUF - The total number of times the MQMHBUF command was issued MQGTBUFMH - The total number of times the MQBUFMH command was issued - The DETAIL3 views now include the attribute: MQGTCONSUME - Number of messages consumed The new attributes added to the MQCON and MQCONN views already exist in the corresponding CICSPlex SM V4R1M0 Resource table, so no CICSPlex SM API programs that use the V4R1M0 copybooks needs to be recompiled. The CICSPlex SM short descriptions for the MQCON and MQCONN MGTCONSUME attribute and the help for the MQGTBUFMH attribute has changed. This requires documentation updates: - The following changes will be made to the CICS Transaction Server for z/OS Version 4 Release 1 CICSPlex SM Resource Tables Reference (SC34-7032-00): - In section 'MQCON Resource Table' change table 'MQCON resource table attributes' so that the 'Description' column of the 'MQGTCONSUME' contains: Number of messages consumed - In section 'MQCONN Resource Table' change table 'MQCONN resource table attributes' so that the 'Description' column of the 'MQGTCONSUME' contains: Number of messages consumed - The following changes will be made to the CICS Transaction Server for z/OS Version 4 Release 1 CICSPlex SM Operations Views Reference (SC34-7006-00): - In chapter 'DB2, DBCTL and WebSphere MQ operations views', section 'WebSphere MQ connections - MQCON', update table 'Fields in MQCON views' so that the 'Field' column of the MQGTCONSUME row contains: Number of messages consumed - In chapter 'DB2, DBCTL and WebSphere MQ operations views', section 'WebSphere MQ connections - MQCON', update table 'Fields in MQCON views' so that the 'Description' column of the MQGTBUFMH row contains: The total number of times the MQBUFMH command was issued - In chapter 'DB2, DBCTL and WebSphere MQ operations views', section 'WebSphere MQ connection statistics - MQCONN', update table 'Fields in MQCONN views' so that the 'Field' column of the MQGTCONSUME row contains: Number of messages consumed - In chapter 'DB2, DBCTL and WebSphere MQ operations views', section 'WebSphere MQ connection statistics - MQCONN', update table 'Fields in MQCONN views' so that the 'Description' column of the MQGTBUFMH row contains: The total number of times the MQBUFMH command was issued ž**** PE09/12/16 PTF IN ERROR. SEE APAR PM03697 FOR DESCRIPTION
APAR Information
APAR number
PK89845
Reported component name
CICS TS Z/OS V4
Reported component ID
5655S9700
Reported release
60M
Status
CLOSED UR1
PE
NoPE
HIPER
NoHIPER
Special Attention
YesSpecatt / New Function
Submitted date
2009-06-25
Closed date
2009-12-08
Last modified date
2010-01-05
APAR is sysrouted FROM one or more of the following:
APAR is sysrouted TO one or more of the following:
UK52659
Modules/Macros
EYUA0159 EYUA0184 EYUC0159 EYUC0184 EYUEA04F EYUEA054 EYUE0159 EYUE0184 EYUKA04F EYUKA054 EYUK0159 EYUK0184 EYUL0159 EYUL0184 EYUP0159 EYUP0184 EYUQ0159 EYUQ0184 EYUR0159 EYUR0184 EYUSA04F EYUSA054 EYUS0159 EYUS0184 EYUTNAGB EYUTNAGC EYUT0159 EYUT0184 EYUY0159 EYUY0184 EYU0NAG0 EYU0NQGR MQCON MQCONN
| SC34703200 | SC34700600 |
Fix information
Fixed component name
CICS TS Z/OS V4
Fixed component ID
5655S9700
Applicable component levels
R60M PSY UK52659
UP09/12/15 P F912
Fix is available
Select the PTF appropriate for your component level. You will be required to sign in. Distribution on physical media is not available in all countries.
[{"Business Unit":{"code":"BU058","label":"IBM Infrastructure w\/TPS"},"Product":{"code":"SSGMGV","label":"CICS Transaction Server"},"Component":"","ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"4.1","Edition":"","Line of Business":{"code":"LOB35","label":"Mainframe SW"}},{"Business Unit":{"code":"BU054","label":"Systems w\/TPS"},"Product":{"code":"SG19M","label":"APARs - z\/OS environment"},"Component":"","ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"4.1","Edition":"","Line of Business":{"code":"","label":""}}]
Document Information
Modified date:
05 January 2010