PI87166: CPSM SVC DUMP FORMATTER ENHANCEMENTS FOR TASKS TIMESTAMPS AND CMAS-MAS SUMMARY IN COM OUTPUT

Obtain the fix for this APAR.

APAR status

• Closed as program error.

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 V5.1, V5.2, V5.3 and         *
  *                 V5.4 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 EYU9D510, EYU9D520, EYU9D530  *
  *                 or EYU9D540 distributed by the 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 is sysrouted FROM one or more of the following:

  PI86690

• APAR is sysrouted TO one or more of the following:

  UI56962 UI56963 UI56964 UI56965

Modules/Macros

• EYU0CLIN EYU0DVAD EYU0DVAF EYU0DVAP 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 EYU9D510
  EYU9D520 EYU9D530 EYU9D540 EYULXCLT EYULXLEV
  

Fix information

• Fixed component name

  CICS TS Z/OS V5

• Fixed component ID

  5655Y0400

Applicable component levels

• R00M PSY UI56964

     UP18/06/30 P F806

• R10M PSY UI56965

     UP18/07/04 P F807

• R80M PSY UI56962

     UP18/07/03 P F807

• R90M PSY UI56963

     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.