PK42259: DFHWS2LS FAILS WITH RC12 AND MESSAGE STRING INDEX OUT OF RANGE: -2

Obtain the fix for this APAR.

APAR status

• Closed as unreproducible.

Error description

• If the DFHWS2LS utility is run using a WSDL file that does not
  have a binding in it the following error will occur:
  .
  The DFHWS2LS job output will show the following:
  .
  String index out of range: -2
  DFHPI9500E An internal error has occurred. Please contact IBM
  Support.
  .
  The log file on the HFS pointed to by the utility LOGFILE= parm
  will show something like the following
  .
  Error Details:
  --------------
  java.lang.StringIndexOutOfBoundsException: String index out of
  range: -2
  .at java.lang.StringBuffer.replace(StringBuffer.java:774)
  .at
  com.ibm.cics.wsdl.ws2ls.WSDLFile.getBinding(WSDLFile.java:792)
  .at
  com.ibm.cics.wsdl.ws2ls.WSDLFile.getBindingName(WSDLFile.java:23
  9)
  .at com.ibm.cics.wsdl.ws2ls.ws2ls.doStuff(ws2ls.java:234)
  .at com.ibm.cics.wsdl.ws2ls.ws2ls.run(ws2ls.java:130)
  .at com.ibm.cics.wsdl.ws2ls.ws2ls.main(ws2ls.java:218)
  String index out of range: -2
  DFHPI9500E An internal error has occurred. Please contact IBM
  Support.
  .
  A binding would be seen in the WSDL as
    <binding name= xxxxxxxx >
    </binding>
  .
  This has already been fixed in TS 3.2 by defect 16542
  

Local fix

• Correct the WSDL so that it contains a binding.
  

Problem summary

• ****************************************************************
  * USERS AFFECTED: All CICS Users                               *
  ****************************************************************
  * PROBLEM DESCRIPTION: StringOutOfBoundsException occurs       *
  *                      when a WSDL file with no <binding>      *
  *                      elements is supplied to DFHWS2LS        *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  When processing the BINDING parameter, DFHWS2LS tried to issue
  message DFHPI9664E to report that the value specified did not
  match any binding element in the WSDL file. DFHPI9664E includes
  the list of binding elements from the WSDL, separated by a comma
  followed by a blank. When formatting this list, it appends each
  element, then the ", ", then at the end of the list, the
  code removes the final comma and blank. However DFHWS2LS does
  not check if no <binding> elements are supplied in the WSDL.
  If none are specified, a StringOutOfBounds exception is thrown
  when attempting to remove the final ", ", and DFHWS2LS
  terminates without any useful diagnostic message.
  

Problem conclusion

Temporary fix

• FIX AVAILABLE BY PTF ONLY
  

Comments

• DFHWS2LS has been updated to issue message PI9656 when no
  <binding> elements are specified in the WSDL file passed in.
  This message informs the user that DFHWS2LS cannot continue
  because no <binding> elements were found.
  
  The CICS Messages and Codes manual for CICS TS v3.1
  (SRL: GC34-6442-03) is to be updated as follows:
  
  In Chapter 1 (DFH messages), under the 'DFHPInnnn messages'
  section, add the following new message:
  
  DFHPI9656E The WSDL file does not contain any binding elements.
  There must be at least one WSDL binding.
  
  Explanation:
  DFHWS2LS has processed a WSDL document that does not include any
  binding elements. DFHWS2LS requires that there is at least one
  SOAP binding in the WSDL document.
  
  System action:
  The Web services assistant continues processing.
  
  User response:
  Alter the WSDL document so that it does include a WSDL binding.
  
  Module: DFHWS2LS
  

APAR Information

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

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

  UK30836

Modules/Macros

•    DFJ@H176
  

Fix information

• Fixed component name

  CICSTS 3.1 Z/OS

• Fixed component ID

  5655M1500

Applicable component levels

• R40D PSY UK30836

     UP07/11/07 P F711

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.