PH54446: SETTING FILEDEF-DATABUFFERS OVERRIDE VALUE IN STANDARDS ENFORCEMENT EXIT POINT RANACS01 RESULTS IN CICS ERROR: "DFHCA5224 E THE

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• The standards enforcement CSD exit point RANACS01 is used to set
  an override value for the FILE definition attribute
  DATABUFFERS.
  
  The override value is within the permissible range of values.
  However, CICS error DFHCA5224 occurs, stating that the value is
  outside the valid range.  This is due to how the fields were
  defined.
  
  The alphanumeric form is left justified with trailing blanks,
  whereas the numeric forms are right justified with leading
  zeros.
  
  This means that fields like:  FILEDEF-DABUFFERS are stored as
  
     "123     " not "00000123".
  
  The problem also occurs for other attributes, such as FILE
  attributes INDEXBUFFERS and STRINGS.
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All users of CICS Configuration Manager.     *
  ****************************************************************
  * PROBLEM DESCRIPTION: Setting FILEDEF-DATABUFFERS override    *
  *                      value in standards enforcement exit     *
  *                      point RANACS01 results in CICS error:   *
  *                      "DFHCA5224 E The value of 00000031 is   *
  *                      outside the valid range for             *
  *                      DATABUFFERS."                           *
  ****************************************************************
  The standards enforcement CSD exit point RANACS01 is used to set
  an override value for the FILE definition attribute DATABUFFERS.
  The override value is within the permissible range of values.
  However, CICS error DFHCA5224 occurs, stating that the value is
  outside the valid range. The problem also occurs for other
  attributes, such as FILE attributes INDEXBUFFERS and STRINGS.
  

Problem conclusion

• CICS Configuration Manager is corrected.
  The SCCVSAMP standard enforcement samples like CCVX610C describe
  the layout of the definition's OBJECT-IOAREA including field
  lengths and data type. These incorrectly defined the
  FILEDEF-DATABUFFERS and other attributes as COBOL PIC 9 numeric
  data, whereas they are in COBOL PIC X alphanumeric form. The
  storage format affects data processing, resulting in the CICS
  error condition.
  The correction includes:-
    (1) changes to the SCCVSAMP samples to define the affected
        attributes as COBOL PIC X alphanumeric.
    (2) enhancement to the SCCVSAMP sample CCVXPRA standards
        enforcement program to perform alphanumeric-to-numeric or
        numeric-to-alphanumeric conversions, thereby enabling
        numeric compares and computations.
  

Temporary fix

Comments

APAR Information

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

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

  UI92022

Modules/Macros

• CCVX540C CCVX550C CCVX560C CCVX610C CCVXPRA
  

Fix information

• Fixed component name

  CICS CONFIG MGR

• Fixed component ID

  5697CIC00

Applicable component levels

• R540 PSY UI92022

     UP23/06/02 P F306

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.