PH31595: DFHWS2LS SPLITS COMMENT LINES WHEN GENERATING COBOL COPYBOOKS CAUSING ERRORS.

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• Using DFHWS2LS to generate COBOL COPYBOOKS is splitting the
  comment lines. Sometimes to 2 lines or more. In doing so, it is
  doing it incorrectly.
  .
  DFHWS2LS generates a x'15' character
  for newline in the comment of the WSDL.
  
  It doesn't cause an
  error with the COBOL compiler if directly generated in a PDS
  but if generated in a USS directory then the same problem
  happens as in IDz and comments appears on multiple lines:
  .
   *
  '/EKOWS1Operation/dfhcommarea/ekoreqi'.
   * is a test
  
                                              with multiple
                                             lines.
   * XML data type:
  'string'.
   * XML 'whiteSpace' facet value: 'preserve'.
  .
  The
  compilation fails with the copybooks generated from IDz and
  transferred to MVS.
  .
  The ones generated from JCL DFHWS2LS do
  not fail even though they do contain x'15' characters on the
  comment line:
  
  
   000051C *
  '/EKOWS1Operation/dfhcommarea/ekoreqi'.
   000052C * is a test
                                              with multiple
                                              lines.
   000053C * XML data
  type: 'string'.
  .
  Compilation fails with error:
  
  
   000051C *
  '/EKOWS1Operation/dfhcommarea/ekoreqi'.
   000052C * is a test
  
  000053C                                     with multiple
  
  ==000053==> IGYDS0002-E A
  character other than "*", "D", "/" or "-" was found in column
  7. A
   blank was assumed.
  
  PP 5655-EC6 IBM Enterprise COBOL for
  z/OS 6.3.0 P190821 EKOWS1 Date 11/02/2020 Time 12:27:23 Page
  5
  

Local fix

• n/a
  

Problem summary

• ****************************************************************
  * USERS AFFECTED: All CICS Users.                              *
  ****************************************************************
  * PROBLEM DESCRIPTION: Multi-line <xsd:documentation> comments *
  *                      within a WSDL may create an invalid     *
  *                      copybook when used with DFHWS2LS.       *
  ****************************************************************
  Within a WSDL schema document there is an <xsd:documentation>
  element that contains a multi-line comment, for example:
  
  <xsd:element name="ID" type="xsd:string" minOccurs="0">
      <xsd:annotation>
          <xsd:documentation>This is a
              multi
              line
              comment
          </xsd:documentation>
      </xsd:annotation>
  </xsd:element>
  
  DFHWS2LS is used to convert the WSDL schema into a COBOL
  language structure which is written to zFS instead of a PDS.
  When a COBOL program that uses the generated structure is
  compiled, the compile will fail because the comment section at
  the head of the file has been incorrectly formated and does not
  contain comment markers on every line that requires one.
  

Problem conclusion

• DFHWS2LS has been updated to handle multi-line comments
  correctly and output a language structure that will compile.
  

Temporary fix

Comments

APAR Information

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

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

  010PC2Ÿ UI74184 010PC2Ÿ

Modules/Macros

• DFJ@H176
  

Fix information

• Fixed component name

  CICS TS Z/OS V5

• Fixed component ID

  5655Y0400

Applicable component levels

• R300 PSY UI74184

     UP21/03/02 P F103

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.