IBM Support

PM63904: DFHLS2WS PROCESSING FAILS WITH MESSAGE DFHPI9031 E WHEN USING CONSECUTIVE FILLER FIELDS.

Subscribe

You can track all active APARs for this component.

APAR status

  • Closed as documentation error.

Error description

  • You are processing a COBOL copy member provided as part of a
    software package.  DFHLS2WS processing fails with message
    DFHPI9031E, indicating that A structure or array is unexpectedly
    empty.  The member includes several consecutive FILLER fields:
          05  FILLER PIC S9(x) ...
          05  FILLER PIC S9(x) ...
          05  FILLER PIC S9(x) ...
    .
    If the fields are uniquely named, DFHLS2WS runs sucessfully.
    KIXREVxxx
    

Local fix

  • Rename FILLER fields with unique names, such as:
          05  FILLER1
          05  FILLER2
          05  FILLER3
    

Problem summary

  • ****************************************************************
    * USERS AFFECTED: All CICS users.                              *
    ****************************************************************
    * PROBLEM DESCRIPTION: msgDFHPI9031 does not contain specific  *
    *                      explanation about the scenario that     *
    *                      COBOL sub-structure consists entirely   *
    *                      of FILLER sub-element.                  *
    *                                                              *
    ****************************************************************
    * RECOMMENDATION:                                              *
    ****************************************************************
    DFHLS2WS is being used to convert a COBOL language structure to
    WSDL. The language structure contains a sub-structure that
    consists of only FILLER fields similar to the following;
    
      03  FINAL-FILLER.
         05  FILLER  PIC S9(5) COMP SYNC.
         05  FILLER  PIC S9(5) COMP SYNC.
         05  FILLER  PIC S9(5) COMP SYNC.
    
    Message DFHPI9031E is issued when this is processed because
    DFHLS2WS is unable to handle empty structures. The message
    explanation do not adequately describe the fact that this
    construct is not supported.
    
    Additional Keywords:
    DFHPI9031  msgDFHPI9031E
    

Problem conclusion

  • CICS Transaction Server for z/OS Version 4 Release 2
    CICS Messages and Codes Vol 2, GC34-7176-01 has been altered
    in DFH messages, DFHPI9031 paragraph. Change the paragraph:
    
    DFHPI9031E A structure or array is unexpectedly
    empty.
    Explanation: DFHLS2WS or DFHLS2SC has
    encountered a problem whilst parsing a language
    structure. It has reached the end of the language
    structure and has either found insufficient closing
    statements to match the number of opening statements
    or has found an empty sub-structure. This message can
    imply an internal processing error has occurred that
    requires a fix from IBM.
    DFHLS2WS or DFHLS2SC is unable to determine
    which line in the language structure starts the
    sub-structure that is empty or unclosed. This message
    is generated as a back-stop condition to prevent an
    erroneous WSBind file being deployed to CICS.
    The conditions under which this message may be
    issued are
    v A field in a PL/I language structure has been
    defined without specifying the data type. In this
    scenario DFHLS2WS and DFHLS2SC may assume
    that the field is the start of an empty sub-structure.
    v A sub-structure exists in the language structure, but
    each entry within the sub-structure is unsupported.
    v DFHLS2WS or DFHLS2SC has failed to understand
    an entry in the language structure. This may be due
    to a spelling mistake in the language structure, or the
    presence of an unsupported keyword.
    System action: The Web services or XML assistant
    continues processing.
    User response: Change the language structure to
    correct any other reported problems. Supply explicit
    definitions for any fields which have been defined with
    default characteristics.
    Ensure that the language structure is well formed.
    Check that the compiler is able to understand the
    language structure.
    If these changes do not resolve the problem then
    contact your IBM support representative for further
    assistance.
    Module: DFHLS2WS, DFHLS2SC
    Destination: SYSPRINT
    
    To:
    
    DFHPI9031E A structure or array is unexpectedly
    empty.
    Explanation: DFHLS2WS or DFHLS2SC has
    encountered a problem whilst parsing a language
    structure. It has reached the end of the language
    structure and has either found insufficient closing
    statements to match the number of opening statements
    or has found an empty sub-structure. Or find a COBOL language
    structure consists entirely of FILLER fields. This message can
    imply an internal processing error has occurred that
    requires a fix from IBM.
    DFHLS2WS or DFHLS2SC is unable to determine
    which line in the language structure starts the
    sub-structure that is empty,FILLER filled or unclosed. This
    message is generated as a back-stop condition to prevent an
    erroneous WSBind file being deployed to CICS.
    The conditions under which this message may be
    issued are
    v A field in a PL/I language structure has been
    defined without specifying the data type. In this
    scenario DFHLS2WS and DFHLS2SC may assume
    that the field is the start of an empty sub-structure.
    v A sub-structure exists in the language structure, but
    each entry within the sub-structure is unsupported.
    v A sub-structure in COBOL consists entirely of FILLER fields.
    v DFHLS2WS or DFHLS2SC has failed to understand
    an entry in the language structure. This may be due
    to a spelling mistake in the language structure, or the
    presence of an unsupported keyword.
    System action: The Web services or XML assistant
    continues processing.
    User response: Change the language structure to
    correct any other reported problems. Supply explicit
    definitions for any fields which have been defined with
    default characteristics.
    Ensure that the language structure is well formed.
    Check that the compiler is able to understand the
    language structure.
    Replace the entire COBOL sub-structure with a single FILLER of
    the same total length.
    If these changes do not resolve the problem then
    contact your IBM support representative for further
    assistance.
    Module: DFHLS2WS, DFHLS2SC
    Destination: SYSPRINT
    

Temporary fix

Comments

APAR Information

  • APAR number

    PM63904

  • Reported component name

    CICS TS Z/OS V4

  • Reported component ID

    5655S9700

  • Reported release

    700

  • Status

    CLOSED DOC

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt

  • Submitted date

    2012-05-03

  • Closed date

    2012-05-14

  • Last modified date

    2013-04-10

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

    PM60643

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

    PM86717

Publications Referenced
GC34717601        

Fix information

Applicable component levels



Document information

More support for: CICS Transaction Server

Software version: 4.2

Reference #: PM63904

Modified date: 10 April 2013


Translate this page: