PM84365: CMAS AUX TRACE FILLING WITH ENTRIES WITH DEBUG TEXT WDTRAPIE AND INVLAPPL

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• Your CPSM CMAS auxiliary trace dataset has filled up with trace
  entries containing debug text WDTRAPIE and INVLAPPL.
  .
  WDTRAPIE is WDTR_APIERR_ID exception (Error in API) out of WDTR
  INVLAPPL is WAOS_INVLAPPL_ID exception (Invalid AOR_APPLIED)
  out of WAOS
  .
  Abbreviated trace entries would look like:
  .
  MTD  PREV TRAN OBJ LEVL  PT-ID   DEBUG   UOW
  WDTR XLOP XXXX WLM EXCP      11 WDTRAPIE CPSM
  WDTR XLOP XXXX WLM EXCP      11 WDTRAPIE CPSM
  WDTR XLOP XXXX WLM EXCP      11 WDTRAPIE CPSM
  WAOS WASV XXXX WLM EXCP       2 INVLAPPL CPSM
  WAOS WASV XXXX WLM EXCP       2 INVLAPPL CPSM
  WASV WDTR XXXX WLM EXCP       2 WASVWAOS CPSM
  WASV WDTR XXXX WLM EXCP       2 WASVWAOS CPSM
  .
  On the WAOS entries for function AORDESC we are passing a blank
  APPLID which results in the function failing with a
  INVALID_AOR_APPLID.  If a trangroup is dormant (inactive
  status) CICS will use either the default APPLID or SYSID to
  build the Scope Vector.  In WAOS code, we are checking for the
  APPLID first and if it is greater than or equal to blanks, we
  omit checking for the SYSID.  In the TDA control block we can
  see offset x'20' is blanks for the APPLID and x'2C' is a valid
  SYSID. The cause of this problem is due to the fact the
  trangroup was set to dormant.
  Additional Symptom(s) Search Keyword(s): KIXREVSVR
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All CICSPlex SM V4R1M0 and V4R2M0 Users      *
  ****************************************************************
  * PROBLEM DESCRIPTION: The auxtrace datasets for CPSM WLM      *
  *                      routing regions and the CMASes they     *
  *                      connect to may fill with exception      *
  *                      trace records when dynamic route        *
  *                      requests are issued for transactions    *
  *                      that are associated with an installed   *
  *                      transaction group that has a status of  *
  *                      DORMANT.                                *
  *                                                              *
  *                      Examination of the auxtrace datasets    *
  *                      will show the following exceptions:     *
  *                                                              *
  *                        Method  Caller  TPID   Debug text     *
  *                        ------  ------  ----   ----------     *
  *                        WAOS    WASV       2   INVLAPPL       *
  *                        WASV    WDTR       2   WASVWAOS       *
  *                        WDTR    XLOP      11   WDTRAPIE       *
  *                                                              *
  *                      Additionally, if the route is for a     *
  *                      terminal based transaction, the         *
  *                      following error message may be issued   *
  *                      to the terminal:                        *
  *                                                              *
  *                        EYUWR0104E - CPSM Reports an          *
  *                                     unexpected Error on      *
  *                                     FUNCTION SM_SCOPE        *
  ****************************************************************
  * RECOMMENDATION: After applying the PTF that resolves this    *
  *                 APAR, all MASes defined as CPSM WLM routing  *
  *                 regions must be restarted.  Note that the    *
  *                 restarts do not need to occur at the same    *
  *                 time.                                        *
  ****************************************************************
  When a dynamic transaction route request is received in a CPSM
  WLM routing region, CICS provides information about the default
  system for the request in the DFHDYPDS comm area passed to
  EYU9XLOP.  If the routing region is the default system or has a
  connection defined to the default system, then CICS will pass
  the SYSID and the APPLID of the default system.  If the routing
  region is not the default system and does not have a connection
  defined to the default system, then CICS will pass the SYSID of
  the default system and an APPLID of blanks.
  
  For dynamic route requests whose transaction is associated with
  a transaction group that is in an ACTIVE state, method EYU0WASV
  (WASV) is called to create a list of available regions to which
  the route can take place (scope vector).  WASV expands the
  AORSCOPE associated with the transaction group to build the
  scope vector.
  
  For dynamic route requests whose transaction is associated with
  a transaction group that is in a DORMANT state, WASV bypasses
  expanding the AORSCOPE associated with the transaction group,
  and instead calls method EYU0WAOS (WAOS) to retrieve the AOR
  descriptor for the default system.  If the APPLID is present,
  WASV is supposed to pass that to WAOS.  If the APPLID is not
  present, WASV is supposed to pass the SYSID to WAOS.  A logic
  error in WASV causes it to pass the APPLID to WAOS if it is
  present or is blanks.  When WASV passes a blank APPLID to WAOS,
  WAOS fails the request and the trace records are written.
  Additonally, if the route request is terminal based, message
  EYUWR0104E may be written to the terminal.
  

Problem conclusion

• WASV has been updated to only pass an APPLID to WAOS if it is
  non-blank.  Otherwise, it will pass the SYSID to WAOS.
  

Temporary fix

• FIX AVAILABLE BY PTF ONLY
  

Comments

APAR Information

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

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

  PM84406 UK92441 UK92442

Modules/Macros

•    EYU0WASV
  

Fix information

• Fixed component name

  CICS TS Z/OS V4

• Fixed component ID

  5655S9700

Applicable component levels

• R60M PSY UK92441

     UP13/03/15 P F303

• R70M PSY UK92442

     UP13/03/15 P F303

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.