PM04348: CICSRGN, CICSDSA AND CMAS RECORDS DON'T MATCH API COPYBOOKS.

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• When an API request is made for CICSRGN, CICSDSA or CMAS records
  from a program that maps the records with the CPSM distributed
  copybooks, the returned records will not match the copybook if
  the connect level and copybook level is for CPSM V3R2M0 or
  greater.
  
  The length specified in the copybook will be greater than the
  actual length of returned records, and the offsets of some
  attributes within the returned records will not match the
  copybook offsets.
  
  For CICSRGN, the offsets for the following attributes will be
  incorrect:
  
    MEMLIMIT
    SOSABOVEBAR
    SOSABOVELINE
    SOSBELOWLINE
    LDGLBSOU
    LDGLWSOU
    LDGLSORT
  
  For CICSDSA, the offsets for the following attributes will be
  incorrect:
  
    MEMLIMIT
    GETSTORSIZE
    ASACTIVE
    HWMASACTIVE
    GDSAACTIVE
    HWMGDSAACTIV
    ATBCUSHRELS
    ATBCUSHLIMIT
  
  For CMAS, the offsets for the following attributes will be
  incorrect:
  
    MEMLIMIT
    SOSABOVEBAR
    SOSABOVELINE
    SOSBELOWLINE
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All CICSPlex SM V3R2M0 Users                 *
  ****************************************************************
  * PROBLEM DESCRIPTION: When an API request is made for         *
  *                      CICSRGN, CICSDSA or CMAS records from a *
  *                      program that maps the records with the  *
  *                      CPSM distributed copybooks, the         *
  *                      returned records will not match the     *
  *                      copybook if the connect level and       *
  *                      copybook level is for CPSM V3R2M0 or    *
  *                      greater.                                *
  *                                                              *
  *                      The length specified in the copybook    *
  *                      will be greater than the actual length  *
  *                      of returned records, and the offsets of *
  *                      some attributes within the returned     *
  *                      records will not match the copybook     *
  *                      offsets.                                *
  *                                                              *
  *                      For CICSRGN, the offsets for the        *
  *                      following attributes will be incorrect: *
  *                                                              *
  *                        MEMLIMIT                              *
  *                        SOSABOVEBAR                           *
  *                        SOSABOVELINE                          *
  *                        SOSBELOWLINE                          *
  *                        LDGLBSOU                              *
  *                        LDGLWSOU                              *
  *                        LDGLSORT                              *
  *                                                              *
  *                      For CICSDSA, the offsets for the        *
  *                      following attributes will be incorrect: *
  *                                                              *
  *                        MEMLIMIT                              *
  *                        GETSTORSIZE                           *
  *                        ASACTIVE                              *
  *                        HWMASACTIVE                           *
  *                        GDSAACTIVE                            *
  *                        HWMGDSAACTIV                          *
  *                        ATBCUSHRELS                           *
  *                        ATBCUSHLIMIT                          *
  *                                                              *
  *                      For CMAS, the offsets for the following *
  *                      attributes will be incorrect:           *
  *                                                              *
  *                        MEMLIMIT                              *
  *                        SOSABOVEBAR                           *
  *                        SOSABOVELINE                          *
  *                        SOSBELOWLINE                          *
  ****************************************************************
  * 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.                               *
  *                                                              *
  *                 Note that the solution to the problem is for *
  *                 the returned records to match the previously *
  *                 distributed copybooks, so no user action is  *
  *                 required other than to restart all CMASes    *
  *                 with the updated code.                       *
  ****************************************************************
  During development of CPSM V3R2M0, the process that creates the
  API copybooks for CPSM resource tables was changed to add an
  alignment factor for coded numeric 8 bytes fields.  This
  affected only the CICSRGN, CICSDSA and CMAS table MEMLIMIT
  attribute.  However, the process that builds the records was not
  changed to match the copybook change.  As a result,  the records
  built for these tables do not match the updated copybooks.
  

Problem conclusion

• The Managed Object Services (MOS) tables that define the
  external table lengths for the CICSRGN (EYUY0001), CICSDSA
  (EYUY0002) and CMAS (EYUY2451) tables have been updated to
  specify the correct table length to match the distributed
  copybooks.
  
  The code that builds the records for CPSM resource tables, a
  common routine within module EYU0MOCM that is included in
  methods EYU0MOFB, EYU0MOFL and EYU0MOTS and module EYU9MOTL, has
  been updated to correctly build the CICSRGN, CICSDSA and CMAS
  records to match the distributed copybooks.
  

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:

  PM04349 UK53373

Modules/Macros

•    DYU0MOCM DYU0MOFB DYU0MOFL DYU0MOTS DYU9MOTL
  EYUTAB2L EYUTAB2M EYUY0001 EYUY0002 EYUY2451 EYU0MOFB EYU0MOFL
  EYU0MOTS EYU9MOTL
  

Fix information

• Fixed component name

  CICSTS V3 Z/OS

• Fixed component ID

  5655M1500

Applicable component levels

• R50M PSY UK53373

     UP10/01/18 P F001

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.