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:
APAR is sysrouted TO one or more of the following:
PM86717
GC34717601 |
Fix information
Applicable component levels
[{"Business Unit":{"code":"BU058","label":"IBM Infrastructure w\/TPS"},"Product":{"code":"SSGMGV","label":"CICS Transaction Server"},"Component":"","ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"4.2","Edition":"","Line of Business":{"code":"LOB35","label":"Mainframe SW"}},{"Business Unit":{"code":"BU054","label":"Systems w\/TPS"},"Product":{"code":"SG19M","label":"APARs - z\/OS environment"},"Component":"","ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"4.2","Edition":"","Line of Business":{"code":"","label":""}}]
Document Information
Modified date:
10 April 2013