IBM Support

PH66610: DFHPI9500 IS ISSUED DURING PARSE OF PIC 9 AND S9 FIELDS WITH 19 TO 31 DIGITS

A fix is available

Subscribe

You can track all active APARs for this component.

 

APAR status

  • Closed as program error.

Error description

  • Backport of fix PH05301 to CICS 5.6
    PH05301 - DFHPI9500 IS ISSUED DURING PARSE OF PIC 9 AND S9
    FIELDS WITH 19 TO 31 DIGITS
    
    Customer is using DFHLS2JS to convert a language structure to
    JSON schema.  The language structure being converted contains
    long PIC 9 fields.
    .
    For example:
    
    01 langStructure.
    03 org           PIC   9(03).
    03 firstField    PIC   9(20).
    
    The conversion fails with the following message.
    
    DFHPI9500E An internal error has occurred.  Please contact IBM
    Support.
    
    The DFHLS2JS job output shows the following:
    
    java.lang.NumberFormatException: For input string:
    "99999999999999999999"  as it parses data description entry:
    03 firstField   PIC   9(20)
    

Local fix

Problem summary

  • ****************************************************************
    * USERS AFFECTED: All CICS users.                              *
    ****************************************************************
    * PROBLEM DESCRIPTION: DFHPI9500E when running DFHLS2JS,       *
    *                      DFHLS2WS, or DFHLS2SC with a Cobol      *
    *                      copybook containing a PIC 9(n) DISPLAY, *
    *                      where 'n' is greater than 18.           *
    ****************************************************************
    DFHLS2JS, DFHLS2SC or DFHLS2WS is run with a Cobol copybook as
    input.  The copybook contains a PIC 9 with usage of DISPLAY (the
    default) that has a total of 19 or more digits.
    The web services assistant attempts to store the maximum value
    for this field in a Java long however the value is too big which
    causes a java.lang.NumberFormatException and DFHPI9500E message.
    

Problem conclusion

  • CICS has been updated to handle Cobol copybooks which contain a
    PIC 9(n) DISPLAY field, where 'n' is greater than 18 in
    DFHLS2JS, DFHLS2SC, and DFHLS2WS conversions.
    

Temporary fix

Comments

APAR Information

  • APAR number

    PH66610

  • Reported component name

    CICS TS Z/OS V5

  • Reported component ID

    5655Y0400

  • Reported release

    300

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt / Xsystem

  • Submitted date

    2025-05-20

  • Closed date

    2025-08-06

  • Last modified date

    2025-08-31

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

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

    UO04417

Modules/Macros

  • DFJ@H176
    

Fix information

  • Fixed component name

    CICS TS Z/OS V5

  • Fixed component ID

    5655Y0400

Applicable component levels

  • R300 PSY UO04417

       UP25/08/07 P F508

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":"BU048","label":"IBM Software"},"Product":{"code":"SSGMGV","label":"CICS Transaction Server"},"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"5.6","Line of Business":{"code":"LOB70","label":"Z TPS"}}]

Document Information

Modified date:
31 August 2025