PI40797: CPSM EYU0MOXT MAY INCORRECTLY CONVERT A QUEUE RECORD. UNPREDICTABLE RESULTS, INCLUDING ABENDS.

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• CPSM EYU0MOXT may incorrectly convert a queue record in some
  circumstances. Base table records are converted to a version
  compatible with the capabilities of the CMAS. If the version of
  a record has changed, MOXT may overlay some of the record being
  processed. Unpredictable results may occur.
  .
  This issue may be exposed and cause a problem if a PTF has been
  applied that causes a version change in a table record, but the
  modules affected by the PTF are not completely rolled into the
  CMAS's load libraries.
  .
  For example, if a PTF affects modules in both SEYUAUTH and
  SEYULOAD, but only the SEYUAUTH dataset changes are rolled into
  the running CMAS's loadlibs (or vice versa,) it might cause an
  abend (SOC1 or ASRA) in another CMAS. That is because when two
  CMASes exchange capabilities at startup, they indicate to each
  other what version of each base record type they are using.
  That information comes from modules in SEYUAUTH. However, when
  those base records actually get built and sent around during
  the running of the CMAS, the modules in SEYULOAD perform that
  function. If the CMAS is indicating to other CMASes through
  SEYUAUTH members that it uses version '1234' of a given record,
  but it builds version '5678' though SEYULOAD members, then
  other CMASes processing those records may encounter
  unpredictable results, including abends. One specific abend
  encountered so far was an intentional ASRA S0C1 out of EYU0TSCJ
  method.
  .
  .
  Additional Symptom(s) Search Keyword(s): KIXREVSVR
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All CICSPlex/SM V3R1M0 Users                 *
  ****************************************************************
  * PROBLEM DESCRIPTION: Abend ASRA/S0C1 may occur in method     *
  *                      EYU0TSCJ (TSCJ) if a topology resource  *
  *                      map (CRESxxxx resource table) is passed *
  *                      between two CPSM V3R1M0 CMASes which    *
  *                      are at different maintenance levels for *
  *                      the CRESxxxx resource table.            *
  *                                                              *
  *                      This can occur when CRESPRGM records    *
  *                      are passed between two CMASes, if one   *
  *                      CMAS has PTF UI21432 or UI19878         *
  *                      applied, and the other CMAS does not.   *
  *                      This problem can also occur if PTF      *
  *                      UI27873 is not applied.                 *
  *                                                              *
  *                      The problem can also occur when a CPSM  *
  *                      V3R1M0 CMAS manages a CICSplex whose    *
  *                      maintenance point (MP) CMAS is running  *
  *                      a higher release of CPSM.               *
  *                                                              *
  *                      In addition to the ASRA/S0C1 abend in   *
  *                      TSCJ, other symptoms include Topology   *
  *                      join failures, and missing records in   *
  *                      get requests issued through the EUI,    *
  *                      WUI or a CPSM API program.  When either *
  *                      of these problems occur, the following  *
  *                      exception trace records may be issued   *
  *                      by CMASes exhibiting these symptoms:    *
  *                                                              *
  *                           Method  TPID  Debug text           *
  *                           ------  ----  ----------           *
  *                           MOXT     106  TAB_VER              *
  *                           XQGQ       1  GETQXCP              *
  *                           TSCJ       8  TSCJXQGQ             *
  ****************************************************************
  * RECOMMENDATION: After applying the PTF that resolves this    *
  *                 APAR, all CMASes must be restarted.  Note    *
  *                 that the restarts do not need to occur at    *
  *                 the same time.                               *
  ****************************************************************
  When a CICS resource that CPSM manages through Topology resource
  maps is added or removed in a MAS, a CRESxxxx record is built in
  the CMAS to which the MAS is connected (for example a CRESPRGM
  record for PROGRAM resources).  The local CMAS uses the record
  to change the resource maps for the MAS, and then ships the
  record to other CMASes in the network in a CPSM queue structure,
  where the record is used to update the MAS's resource maps in
  the receiving CMASes.  The processing of the records in the
  remote CMASes is performed by TSCJ.  These resource maps are
  used by CPSM's single system image (SSI) processing to determine
  where to direct EUI, WUI, API and RTA requests.  If the maps are
  incorrect, then requests may not be directed correctly.
  
  If the CRESxxxx is at a different version in the two CMASes,
  then method EYU0MOXS (MOXS) is called in the CMAS that has the
  later version of the resource table, to convert the record to
  the proper version.  A logic error in MOXS causes the record to
  not be converted properly.  When TSCJ runs in the remote CMAS to
  process the record, it calls method EYU0XQGQ (XQGQ) to read the
  record from the queue.  XQGQ will recognize that the record is
  not at the correct version and will call method EYU0MOXT to
  convert the record properly.  A logic error in MOXT will again
  cause the the record to not be converted properly.  This will
  lead to either the ASRA/S0C1 in TSCJ, or the Topology failure or
  missing records in get requests.
  

Problem conclusion

• Method MOXS has been updated to ensure that CRESxxxx records are
  properly converted when being shipped between CMASes that have
  different versions of the record.  In addition, changes have
  been made to methods MOXT, XQGQ and EYU0XQTQ (XQTQ) to ensure if
  other problems cause MOXS not to convert CRESxxxx records
  properly, that MOXT will convert it when the processing method
  reads it from a CPSM queue structure.
  

Temporary fix

•             *********
              * HIPER *
              *********
  FIX AVAILABLE BY PTF ONLY
  

Comments

APAR Information

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

  PI40266

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

  UI37321

Modules/Macros

•    EYU0MOXS EYU0MOXT EYU0XQGQ EYU0XQTQ EYU9XDPU
  EYU9XDP3 EYU9XDP4
  

Fix information

• Fixed component name

  CPSM CICS 3.1

• Fixed component ID

  5655M1501

Applicable component levels

• R100 PSY UI37321

     UP16/04/28 P F604 Ž

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.