PK16639: EMASSICK SICKTYPE CVDA EYUDA EMSTATUS SOSBELOW_TIM SOSABOVE_TIM SOSMVS_TIM API ----- AI -----

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• You are running a CPSM API program that uses the LISTEN-RECEIVE
  on the EMASSICK resource table. When an LMAS goes short on
  storage (SOS), the API checks the SICKTYPE field, expecting to
  get an EYUVALUE.  A CVDA (DFHVALUE) value  SOSBELOW 682 is
  returned.  The CICSPlex SM Resource Tables Reference had the
  SICKTYPE field defined as EYUDA not CVDAS. SOSBELOW, SOSABOVE,
  and SOSMVS return incorrect data type. The other resources give
  the correct value (SYSDUMP TRANDUMP MAXTASK STALLED SOSUDSA
  SOSCDSA SOSEUDSA SOSECDSA SOSERDSA SOSSDSA SOSESDSA SOSRDSA)
  
  AI16639:
  .
  The PTF for CICS APAR PK17917 is required to allow the use
  of the EYUVALUE function with the SOSMVS, SOSBELOW and
  SOSABOVE EYUDA values.
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All CICSPlex/SM V3R1M0 Users                 *
  ****************************************************************
  * PROBLEM DESCRIPTION:    You are running a CPSM API program   *
  *                      that uses the LISTEN and RECEIVE API    *
  *                      commands to retrieve instances of the   *
  *                      EMASSICK resource table.  When an LMAS  *
  *                      goes short on storage (SOS), your API   *
  *                      program checks the SICKTYPE field,      *
  *                      expecting to get an EYUDA (EYUVALUE)    *
  *                      value.  Instead a CVDA (DFHVALUE) value *
  *                      e.g. SOSBELOW=682, is returned.  The    *
  *                      CICSPlex SM Resource Tables Reference   *
  *                      defines the SICKTYPE attribute as EYUDA *
  *                      not CVDA.  For SOSBELOW and SOSABOVE    *
  *                      the wrong data type is returned.  In    *
  *                      all other cases an EYUDA value is re-   *
  *                      turned as expected.                     *
  ****************************************************************
  * RECOMMENDATION: After applying the PTF that resolves this    *
  *                 APAR, all CMASes and MASes must be recycled  *
  *                 to pick up the new code.  Note that the      *
  *                 restarts do not need to be done at the same  *
  *                 time.                                        *
  ****************************************************************
     EYUDA values SOSBELOW=158 and SOSABOVE=159 were not added
  to the Managed Object Services (MOS) tables.  Module EYU0NLXD
  (NLXD - MAS Exit Data Processor) loads the SICKTYPE attribute
  of the EMASSICK, EMASWELL, and EMSTATUS resource tables with
  CVDA values SOSBELOW=683 and SOSABOVE=684 when reporting the
  corresponding Short on Storage conditions.
  

Problem conclusion

•    EYUDA values SOSBELOW=158 and SOSABOVE=159 were added to the
  MOS data value tables.  Modules EYU0NLXD, EYU0PNAN (PNAN - RTA
  Create Event Notification), and EYU0PSMS (PSMS - RTA Handle MAS
  Status Events) were updated to support the new EYUDA values.
  

Temporary fix

• FIX AVAILABLE BY PTF ONLY
  

Comments

APAR Information

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

  PK16664

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

  UK10675

Modules/Macros

•    EMASSICK EMASWELL EMSTATUS EYUCXXRS EYUQXXRC
  EYUTAEYU EYUTBNRC EYUTMOSD EYUTRDIR EYUT2402 EYUT2403 EYUT2507
  EYUUXXRS EYUY2402 EYUY2403 EYUY2507 EYU0DXRC EYU0NLXD EYU0PNAN
  EYU0PSMS EYU0XXRC EYU9XDF1 EYU9XMAL
  

Fix information

• Fixed component name

  CPSM CICS 3.1

• Fixed component ID

  5655M1501

Applicable component levels

• R100 PSY UK10675

     UP06/01/12 P F601

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.