PH03957: NEW CAPABILTY FOR THE WS-ADDRESSING <TO> ADDRESS TO NOT OVERRIDE TARGET URL FOR THE INVOKE SERVICE COMMAND.

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• Request new capability for the WS-Addressing <To> address
  to not override the target URL for the INVOKE SERVICE command.
  

Local fix

• usermode
  

Problem summary

• ****************************************************************
  * USERS AFFECTED: All CICS users.                              *
  ****************************************************************
  * PROBLEM DESCRIPTION: New capability for the WS-Addressing    *
  *                      <To> address to not override the target *
  *                      URL for the INVOKE SERVICE command.     *
  ****************************************************************
  CICS is acting as a web service requester to use the
  WS-Addressing support. The CICS application issues EXEC CICS
  WSACONTEXT BUILD TOEPR command to create a WS-Addressing
  endpoint reference (EPR) URI which is different from the one
  configured in the WSBIND file. After that, an EXEC CICS INVOKE
  SERVICE command is issued to send the web service request.
  CICS WS-Addressing currently sets the WS-Addressing <To>
  address to the EPR URI, and the target URL for this INVOKE
  SERVICE command is also overwritten by this EPR URI.
  There is no way to change this behaviour.
  

Problem conclusion

• DFHPIA1 has been changed to provide a new capability for the
  WS-Addressing <To> address to not override the target URL if
  container DFHWS-TOEPRHDR is present on the channel used for
  INVOKE SERVICE command.
  
  CICS Transaction Server for z/OS, Using Web Services with CICS,
  Version 5 Release 4, Chapter 2, Section Control containers
  should be changed to add a new container DFHWS-TOEPRHDR as
  follows:
  
  "DFHWS-TOEPRHDR container:
  
  DFHWS-TOEPRHDR is a container that affects the handling of the
  endpoint reference used by WS-Addressing.  The container does
  not have any defined content and can be created as an empty BIT
  or CHAR container.
  
  The container is valid only for a requester mode pipeline. The
  container could be created by the application that issues the
  INVOKE SERVICE command or by a PIPELINE handler program that
  runs before the SOAP handler does.
  
  When the web services addressing handler (DFHWSADH) runs, it
  checks for the presence of the DFHWS-TOEPRHDR container.  If
  present, the endpoint reference is only set in the <wsa:To>
  element within the SOAP header and the target URI held in the
  DFHWS-URI container is unchanged."
  
  The same change should be made to the CICS Transaction Server
  for z/OS, Using Web Services with CICS, Version 5 Release 5,
  Chapter 2, Section Control containers.
  
  
  CICS Transaction Server for z/OS, Using Web Services with CICS,
  Version 5 Release 4, Chapter 2, Section Context containers
  should be changed in the description of DFHWS-URI container to
  add a third item to the list relating to WS-Addressing:
  
  "When the web services addressing handler (DFHWSADH) runs, it
  checks for the presence of the DFHWS-TOEPRHDR container.  If
  present, the endpoint reference is only set in the <wsa:To>
  element within the SOAP header and the target URI held in the
  DFHWS-URI container is unchanged."
  
  The same change should be made to the CICS Transaction Server
  for z/OS, Using Web Services with CICS, Version 5 Release 5,
  Chapter 2, Section Context containers.
  

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:

  UI60880 UI60881

Modules/Macros

• DFHPIA1
  

Fix information

• Fixed component name

  CICS TS Z/OS V5

• Fixed component ID

  5655Y0400

Applicable component levels

• R100 PSY UI60880

     UP19/01/25 P F901

• R200 PSY UI60881

     UP19/01/26 P F901

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.