A fix is available
APAR status
Closed as new function.
Error description
The following IPCS VERBEXIT enhancements are being made to the CPSM SVC dump formatter EYU9D### where '###' is the CPSM release (420, 510, 520, 530 or 540.) . The VERBX EYU9D### 'TASKS' output lists the CPSM-related tasks running at the time of the dump, along with each CPSM method in the task's calling chain. It is often useful to have the timestamps that each method in that chain was called. The timestamp is stored in the method's stack. The fix for this APAR will format the STCK value and list it as in the following sample: (note, several columns removed to fit into the APAR text without wrapping.) . . Task Meth Load-Pt ... MOEB Stack Timestamp (LOCAL) 100 XLOP 000A6F28 (several 13F43120 N/a 100 BMLT 16573810 columns 167AD820 04/19/17 07:36:52.963159 100 XSWX 15BB7718 removed) 000CCBC0 04/19/17 07:37:00.041201 . . . Additionally, a new CMAS to MAS communications summary table in the output from VERBX EYU9D### 'COM' will be produced listing the MASes connected to a CMAS that includes the qdepth (number of messages in the queue to be sent to a given MAS) along with the timestamp of the first/last messages in that queue. . . Additional Symptom(s) Search Keyword(s): KIXREVSVR
Local fix
Problem summary
**************************************************************** * USERS AFFECTED: All CICSPlex SM V4.2 Users * **************************************************************** * PROBLEM DESCRIPTION: Not enough detail is provided by the * * CICSPlex SM IPCS dump formatter when * * using the "TASKS" command to report * * each method's call chain. Although the * * current summary report does include * * many critical control block addresses, * * there is no indication of when the * * methods are driven. * * * * The summary report provided to report * * on the connectivity states and queue * * depths that a CMAS has to other CMASes * * is an important problem diagnosis time * * saving tool. A similar report would * * also be beneficial to report on the * * connection states that a CMAS has to * * its managed address spaces (MASes). * **************************************************************** * RECOMMENDATION: After applying the PTF that resolves this * * APAR, restart any IPCS sessions pointing to * * the version of EYU9D420 distributed by this * * PTF. * * * * To enable the full dump reporting * * capability of this PTF, you are recommended * * to restart all MASes at the soonest * * convenient opportunity. Until a MAS is * * restarted, and thus executing the new COM * * initialisation code, then the MAS "Sysid" * * column of the "CMAS-MAS connection summary" * * report will contain blank spaces. * **************************************************************** The CICSPlex SM supplied IPCS dump formatter EYU9Dnnn (where nnn is the CPSM version of the dump being investigated) is an effective mechanism for the reporting of control block structures in an MVS system dump of a CMAS. However, when the dump relates to certain kinds of slowdown resulting from a suspended CPSM process, then the problem diagnosis can be time consuming to determine which tasks have been started for any given period of time. CPSM stores the starting time of every called CPSM method in that method's stack header, and this datum would be a considerable aid to speeding up the problem diagnosis time when trying to determine which task was being held up. When a dump relates to certain kinds of network slowdown, then the CMAS-to-CMAS connection summary report is a significant time-saving aid when trying to determine which CMAS is not responding to its connected partner CMASes. When a dump relates to a slowdown between a MAS and its owing CMAS, a similar connection summary report would also save problem diagnosis time.
Problem conclusion
To assist the diagnosis of these conditions, the dump formatter processing for the "COM" component has been modified to locate the Source MAL Transmission Buffers (SMTBs) that flow between a CMAS and its MASes, and to walk their chains to determine their depth for each MAS. The data gathered is used to format a "CMAS-MAS connection summary" report, which identifies each MAS, and associated CICSplex name, connected to a CMAS, along with details of the control block locations and queue depths for those linkages. To each MAS SYSID to be included into the report, the COM component initialisation process was updated to include to local MAS SYSIDNT to be included in the Conversation link block for the MAS's connection to its CMAS. In addition, if the service engineer specifies "COM=4" for the command parameter, then every SMTB buffer will be included in the formatted report. The Kernel Linkage task summary report has had the Timestamp from each method's stack header appended to each row of the formatted report. A modified version of the dump formatter date/time routine was created, which allows the reporting of timestamps down to six decimal places of sub-second precision. Within the Dump Formatter program changes were applied to the "COM" component processor module (EYU0DVOF) and the Kernel Linkage reporter module (EYU0DVKF). To support the new dump formatter reporting functions, changes were also made to the COM Protocol Services Initialisation processor module (EYU0CLIN), and the Conversation Link Block structure (EYURCLCB). During the process of extending EYU0CLIN with this new function, it was converted for extended addressability. Finally, to aid problem diagnosis with the Dump Formatter program itself, some of the program's component modules were updated to include an eyecatcher near the beginning of the dynamic storage stack frame. This allows improved clarity when trying to determine the module owner of the stack frame.
Temporary fix
Comments
APAR Information
APAR number
PI86690
Reported component name
CICS TS Z/OS V4
Reported component ID
5655S9700
Reported release
70M
Status
CLOSED PER
PE
NoPE
HIPER
NoHIPER
Special Attention
NoSpecatt / Xsystem
Submitted date
2017-08-31
Closed date
2018-06-29
Last modified date
2018-08-02
APAR is sysrouted FROM one or more of the following:
APAR is sysrouted TO one or more of the following:
PI87166 UI56961
Modules/Macros
EYU0CLIN EYU0DVAD EYU0DVAF EYU0DVBF EYU0DVCF EYU0DVCL EYU0DVDF EYU0DVEF EYU0DVHF EYU0DVJF EYU0DVKF EYU0DVKW EYU0DVLQ EYU0DVMF EYU0DVML EYU0DVMP EYU0DVNF EYU0DVNT EYU0DVOF EYU0DVQD EYU0DVQF EYU0DVQL EYU0DVRC EYU0DVRF EYU0DVRP EYU0DVSF EYU0DVSR EYU0DVST EYU0DVTF EYU0DVWF EYU0DVWI EYU0DVWJ EYU0DVWT EYU9D420 EYULXCLT EYULXLEV
Fix information
Fixed component name
CICS TS Z/OS V4
Fixed component ID
5655S9700
Applicable component levels
R70M PSY UI56961
UP18/07/07 P F807
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.2","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.2","Edition":"","Line of Business":{"code":"","label":""}}]
Document Information
Modified date:
02 August 2018