A fix is available
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 number
PM04348
Reported component name
CICSTS V3 Z/OS
Reported component ID
5655M1500
Reported release
50M
Status
CLOSED PER
PE
NoPE
HIPER
NoHIPER
Special Attention
NoSpecatt
Submitted date
2010-01-07
Closed date
2010-01-13
Last modified date
2010-02-01
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.
[{"Business Unit":{"code":"BU058","label":"IBM Infrastructure w\/TPS"},"Product":{"code":"SSGMGV","label":"CICS Transaction Server"},"Component":"","ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"3.2","Edition":"","Line of Business":{"code":"LOB35","label":"Mainframe SW"}},{"Business Unit":{"code":"BU054","label":"Systems w\/TPS"},"Product":{"code":"SG19M","label":"APARs - z\/OS environment"},"Component":"","ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"3.2","Edition":"","Line of Business":{"code":"","label":""}}]
Document Information
Modified date:
01 February 2010