PM19795: CPSM API REQUEST TO CREATE OR UPDATE A DB2CDEF FAILS WITH TABLEERROR DATAERROR. PLANEXITNAME IS X'00'.

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• You are using the CPSM API to create or update a DB2CDEF
  definition. Your program specifies a value for the PLAN field
  but leaves the PLANEXITNAME field as low values, x'00'.  If a
  character field is set to low values, CPSM's Managed Object
  Services (MOS) inserts the default value.  For most character
  fields, the default value is (defaults to) blanks.  In this
  case, though, CICS considers the default value to be 'DSNCUEXT'
  and not blanks.  This causes both PLAN and PLANEXITNAME to be
  specified, and the definition is rejected with
  Response Code 1038 TABLEERROR
  Reason Code 1361 DATAERROR
  .
  To update PLAN, one must set PLANEXITNAME to blanks to prevent
  the default value from being inserted by MOS.
  .
  LOCAL FIX:
  KIXREVSVR
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All CICSPlex SM V4R1M0 Users                 *
  ****************************************************************
  * PROBLEM DESCRIPTION:    You are using the CPSM API to create *
  *                      or update a DB2CDEF definition.  Your   *
  *                      program specifies a value for the PLAN  *
  *                      attribute, but leaves PLANEXITNAME as   *
  *                      low values, x'00'.  The definition is   *
  *                      rejected with API Response=1038         *
  *                      (TABLEERROR), Reason=1361 (DATAERROR).  *
  *                      Analysis of FEEDBACK shows that attri-  *
  *                      butes PLAN and PLANEXITNAME are related *
  *                      to the error.                           *
  ****************************************************************
  * RECOMMENDATION: After applying the PTF that resolves this    *
  *                 APAR, all CMASes must be recycled to pick    *
  *                 up the new code.  Note that the restarts     *
  *                 do not need to be done at the same time.     *
  ****************************************************************
  If a character attribute is set to low values, CPSM's Managed
  Object Services (MOS) inserts a default value.  Unless another
  value is specified in the resource table definition, blanks
  will be inserted.  Attribute PLANEXITNAME was defined with
  default value set to 'DSNCUEXT'.  When creating or updating a
  DB2CDEF resource, setting PLAN and clearing PLANEXITNAME to
  low values causes PLANEXITNAME to be set to the default value
  and the definition is rejected because both PLANEXITNAME and
  PLAN are specified.
  

Problem conclusion

•    The DB2CDEF resource table definition was modified to remove
  the default value for PLANEXITNAME.  If a DB2CDEF resource is
  created or updated, and both PLAN and PLANEXITNAME are blank,
  CICS will set PLANEXITNAME to 'DSNCUEXT' at install time.
  

Temporary fix

• FIX AVAILABLE BY PTF ONLY
  

Comments

APAR Information

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

  PM19770

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

  UK60535

Modules/Macros

•    DB2CDEF  EYUT3817 EYUY3817 EYU0BACW
  

Fix information

• Fixed component name

  CICS TS Z/OS V4

• Fixed component ID

  5655S9700

Applicable component levels

• R60M PSY UK60535

     UP10/10/01 P F009

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.