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

Obtain the fix for this APAR.

APAR status

• Closed as program 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

• The CICS Transaction Server for z/OS Messages and Codes
  Version 3 Release 2, GC34-6827-04 has been altered in Chapter 1
  DFH messages, DFHPI9031 paragraph. Change the paragraph:
  
  DFHPI9031E A structure or array is unexpectedly
  empty.
  Explanation: DFHLS2WS 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. Usually this implies an internal processing
  error has occurred that requires a fix to DFHLS2WS.
  DFHLS2WS 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 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 has failed to understand an entry in the
  language structure. This may perhaps be due to a
  spelling mistake in the language structure, or the
  presence of an unsupported keyword.
  System action: The Web services 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
  Destination: SYSPRINT
  
  To:
  DFHPI9031E A structure or array is unexpectedly
  empty.
  Explanation: DFHLS2WS 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. Usually this implies an internal
  processing error has occurred that requires a fix to DFHLS2WS.
  DFHLS2WS 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 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 has failed to understand an entry in the
  language structure. This may perhaps be due to a
  spelling mistake in the language structure, or the
  presence of an unsupported keyword.
  System action: The Web services 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
  Destination: SYSPRINT
  

Temporary fix

• FIX AVAILABLE BY PTF ONLY
  

Comments

APAR Information

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

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

  PM63031 PM63904 UK78751

Modules/Macros

•    DFHMEPIE DFH60643
  

Fix information

• Fixed component name

  CICSTS V3 Z/OS

• Fixed component ID

  5655M1500

Applicable component levels

• R500 PSY UK78751

     UP12/05/19 P F205

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.