PI81967: CMAS CONNECTIVITY MESSAGE ENHANCEMENT TO INCLUDE THE ASSOCIATED TASK IDS

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• Over a 4 day time frame, the CMASes within the plex experienced
  connectivity issues which eventually lead to a dump being taken
  on one CMAS out of CLMT and a second dump taken on another CMAS
  out of CPTI.  From the available documentation it was found
  that the underlying issue was one of the CMASes (or its LPAR)
  was suffering from extreme network connectivity problems.
  .
  Over the span of days, there were various messages issued
  within the CMAS(s) such as:
  .
   date time EYUCL0016I CMASA Send Link Task terminated for
   MRO Network connection with CMAS CMASB.
  .
  or the MAS(s) such as:
  .
   date time EYUNL0144W MASA MAS notifications have been lost
   - no free message buckets.
  .
  to indicate there was a problem.  In addition we saw lots of
  AEXY and AZI2 abends occuring within the CMAS indicating
   - the CMAS Send Links tasks were being purged while waiting
     for Service requests to answer, and
   - the CMAS Receive Links tasks were being purged while still
     in SNA RECEIVE state
  .
  The problem CMAS was eventually isolated which required a
  restart of the CMAS.
  .
  In all, it was difficult to tie the actual task instances to
  the messages in the EYULOG.  So this apar is being created to
  include the associated task ids on the CMAS connectivity
  messages.
  .
  .
  .
  Additional Symptom(s) Search Keyword(s): KIXREVGJT
  

Local fix

• n/a
  

Problem summary

• ****************************************************************
  * USERS AFFECTED: All CICSPlex SM V5R2M0, V5R3M0 and V5R4M0    *
  *                 users.                                       *
  ****************************************************************
  * PROBLEM DESCRIPTION: In complex CMAS connection              *
  *                      topologies, it can be difficult to      *
  *                      associate instances of send and         *
  *                      receive tasks between the CPSM          *
  *                      message log and the diagnostic data     *
  *                      available in dumps.                     *
  ****************************************************************
  * RECOMMENDATION: After applying the PTF that resolves this    *
  *                 APAR, all CMASes and MASes must be           *
  *                 restarted.  Note that the restarts do not    *
  *                 need to occur at the same time.              *
  ****************************************************************
  In complex CMAS connection topologies, it can be difficult to
  associate instances of send and receive tasks between the CPSM
  message log and the diagnostic data available in dumps and
  traces since the CPSM EYUCL messages issued by these tasks do
  not contain their CICS TaskIDs.
  

Problem conclusion

• CICSPlex SM has been modified to add the CICS TaskID of send
  and receive tasks to the following messages:
  EYUCL0002I, EYUCL0003I, EYUCL0004I, EYUCL0005I, EYUCL0008I,
  EYUCL0009I, EYUCL0015I, EYUCL0016I, EYUCL0102E, EYUCL0103E,
  EYUCL0104E, EYUCL0105E, EYUCL0113E.
  
  The following CICSPlex SM methods have been modified:
  EYU0CLET (ESSS Initial Contact Transient):
  CICS TaskID has been added to the issued messages EYUCL0002I,
  EYUCL0004I, EYUCL0008I, EYUCL0009I and EYUCL0103E.
  
  EYU0CLER (ESSS Receive Link Manager) and EYU0CLEV (ESSS
  Receive Link Task):
  CICS TaskID has been added to the issued messages EYUCL0003I,
  EYUCL0005I and EYUCL0105E
  
  EYU0CLIN (Protocol Services Initial Method Receiver):
  CICS TaskID has been added to the issued message EYUCL0102E
  and EYUCL0103E.
  
  The following methods:
  EYU0CLRR (CPI-C CMAS-MAS Receive Link Manager)
  EYU0CLRS (CPI-C CMAS-MAS Send Link Manager)
  EYU0CLRV (LU62 CMAS-MAS Receive Link Transient)
  EYU0CLRW (LU62 MAS-CMAS Send Link Task)
  EYU0CLSS (MRO CMAS-MAS Send Link Manager)
  EYU0CLST (MRO CMAS-MAS ICT Receive Task)
  EYU0CLSV (MRO CMAS-MAS Receive Task Transient)
  EYU0CLSW (MRO MAS-CMAS Send Link Task)
  have been modified such that the CICS TaskID has been added to
  the issued messages EYUCL0015I, EYUCL0016I and EYUCL0113E.
  
  The send and receive Link Conversation Blocks (CLCBs), have
  been modified to contain a CICS TaskID field in order to aid
  serviceability.
  
  EYU0CSAC (Assign Logical Connection Method Receiver):
  Initialise the CICS TaskID field of the CLCB for the Send Link
  Manager.
  
  EYU0CLCS (CPI-C CMAS-CMAS Send Link Manager) and
  EYU0CLMS (MRO CMAS-CMAS Send Link Manager):
  The CLCB TaskID field is initialised with the CICS TaskID of
  the task under which the Send Link Manager is running.
  The issued messages EYUCL0015I, EYUCL0016I and EYUCL0113E have
  been updated to include the CICS TaskID.
  
  EYU0CLCT (CPI-C CMAS-CMAS Initial Contact Transient) and
  EYU0CLMT (MRO CMAS-CMAS Initial Contact Transient):
  The CLCB TaskID field is initialised with the CICS TaskID of
  the task under which the Initial Contact Transient or
  Independent Receive Task is running.
  The issued messages EYUCL0015I and EYUCL0113E have been
  updated to include the CICS TaskID.
  
  EYU0CLCU (CPI-C CMAS-CMAS Independent Receive Task) and
  EYU0CLMU (MRO CMAS-CMAS Independent Receive Task):
  Add the CICS TaskID into the previously mentioned EYUCL
  messages EYUCL0016I and EYUCL0113E.
  
  The new modified message texts for each of the changed
  messages are as follows:
  EYUCL0002I: date time applid {ESSS}  Initial Contact Transient
              initiated, TaskID(taskid).
  EYUCL0003I: date time applid {ESSS} {Receive Link Manager |
              Receive Link Task} initiated, TaskID(taskid).
  EYUCL0004I: date time applid {ESSS}  Initial Contact Transient
              terminated, TaskID(taskid).
  EYUCL0005I: date time applid {ESSS} {Receive Link Manager |
              Receive Link Task} terminated, TaskID(taskid).
  EYUCL0008I: date time applid ESSS ICT entered for Attach to
              nodename, TaskID(taskid).
  EYUCL0009I: date time applid ESSS ICT entered for Detach from
              nodename, TaskID(taskid).
  EYUCL0015I: date time applid {Receive Link Task | Send Link
              Task} initiated for {CPI-C | MRO | CPI-C Network |
              MRO Network | LU6.2} connection with {CMAS | RMAS}
              nodename, TaskID(taskid).
  EYUCL0016I: date time applid {Receive Link Task | Send Link
              Task} terminated for {MRO | CPI-C Network | MRO
              Network} connection with {CMAS | RMAS } nodename,
              TaskID(taskid).
  EYUCL0102E: date time applid {ESSS} Initial Contact Transient
              initiation failed, TaskID(taskid).
  EYUCL0103E: date time applid {ESSS} {Receive Link Manager |
              Receive Link Task} initiation failed,
              TaskID(taskid).
  EYUCL0104E: date time applid {ESSS} Initial Contact Transient
              terminated abnormally, TaskID(taskid).
  EYUCL0105E: date time applid {ESSS} {Receive Link Manager |
              Receive Link Task} terminated abnormally,
              TaskID(taskid).
  EYUCL0113E: date time applid {Receive Link Task | Send Link
              Task} terminated abnormally for {CPI-C | MRO |
              CPI-C Network | MRO Network | LU6.2} connection
              with {CMAS | RMAS} nodename, TaskID(taskid).
  
  The CICSPlex SM Knowledge Center has been updated accordingly.
  

Temporary fix

Comments

• ×**** PE18/03/21 FIX IN ERROR. SEE APAR PI95535  FOR DESCRIPTION
  

APAR Information

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

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

  UI49943 UI49944 UI49945

Modules/Macros

• EYU0CLCS EYU0CLCT EYU0CLCU EYU0CLER EYU0CLET EYU0CLEV EYU0CLIN
  EYU0CLMS EYU0CLMT EYU0CLMU EYU0CLRR EYU0CLRS EYU0CLSS EYU0CLST
  EYUMCCLC EYUMCCLE EYUMCCLK
  

Fix information

• Fixed component name

  CICS TS Z/OS V5

• Fixed component ID

  5655Y0400

Applicable component levels

• R00M PSY UI49945

     UP17/09/06 P F709

• R10M PSY UI49944

     UP17/09/07 P F709

• R90M PSY UI49943

     UP17/09/07 P F709

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.