PK22271: SOAP DOES NOT HONOR OR USE THE CORRELID PASSED IN ON A MQ/SOAP REQUEST AND INSTEAD MOVES THE MSGID TO THE CORRELID ON OUTPUT.

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• DFHPITQ does not act on the MQRO_PASS_CORREL_ID flag when it
  sends a response. It returns the Msgid instead of the Correlid
  in the output Correlid field.
  It will respect the option on report messages.
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All CICS Users                               *
  ****************************************************************
  * PROBLEM DESCRIPTION: When passing a CORREL-ID field within   *
  *                      a SOAP message and the report option    *
  *                      MQRO-PASS-CORREL-ID flag is set, the    *
  *                      output CORREL-ID will contain the       *
  *                      input MSG-ID field and not the input    *
  *                      CORREL-ID as expected.                  *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  A client using Websphere MQ as the transport for a SOAP
  application will see unexpected behavior when using the
  MQRO-PASS-CORREL-ID report option. This may result in the
  client being unable to match responses because the correlation
  id is not as expected.
  DFHWSTIQ does not check if the MQRO-PASS-CORREL-ID flag is set
  when populating the outbound MQMD-CORREL-ID field.This causes
  the value from the inbound MQMD-MSG-ID field to be copied which
  is the expected behavior if MQRO-PASS-CORREL-ID is not set.
  

Problem conclusion

• DFHPITQ checks if the MQRO-PASS-CORREL-ID flag has been set,
  and if so copies the input MQMD-CORRELID to the output field.
  Otherwise the default action of copying the input MQMD-MSGID
  to the output correlation id field is performed.
  
  The CICS Transaction Server for z/OS CICS Web Services Guide,
  Version 3 Release 1 (SC34-6458-03) will be updated in Section
  6.2.1 Configuring your CICS system for Web services - The
  WebSphere MQ transport.
  
  The following paragraph:
  
  'In both cases, CICS and WMQ require configuration to define
  the necessary resources and queues.'
  
  will be appended with:
  
  'When constructing a response to a SOAP message received via
  Websphere MQ, the correlation id field will be populated with
  the message id of the input message unless the report option
  MQRO_PASS_CORREL_ID has been set. In which case the correlation
  id will be propagated from the input message to the response.'
  

Temporary fix

• FIX AVAILABLE BY PTF ONLY
  

Comments

APAR Information

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

  PK17336

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

  UK15478

Modules/Macros

•    DESPITQ  DFHPITQ  DFHPITQ1
  

Fix information

• Fixed component name

  CICSTS 3.1 Z/OS

• Fixed component ID

  5655M1500

Applicable component levels

• R400 PSY UK15478

     UP06/06/23 P F606

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.