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

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 is sysrouted FROM one or more of the following:

  PM60643

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

  PM86717

Fix information

Applicable component levels