PI14165: DEFAULT FOR WMQ URI PARAMETER "PERSISTENCE" =0 WHEN SHOULD =MQPER_PERSISTENCE_AS_Q_DEF

Obtain the fix for this APAR.

APAR status

• Closed as unreproducible.

Error description

• Default queue persistence is not being adopted on
  an INVOKE SERVICE with MQ transport.
  Information center topic "The URI for the WebSphere MQ
  transport" details the "persistence" parameter as follows:
  -
  persistence=message_persistence
  Specify one of the following:
  0        Persistence is defined by the default queue
              persistence.
  1        Messages are not persistent.
  2        Messages are persistent.
  If the option is not specified or is specified incorrectly,
  the default queue persistence is used.
  -
  However, the code that implements the "If the option is not
  specified" actually sets the value to 0, when it should set
  it to constant MQPER_PERSISTENCE_AS_Q_DEF which =2
  as per WMQ info center
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All CICS users.                              *
  ****************************************************************
  * PROBLEM DESCRIPTION: Incorrect default set for WebSphere MQ  *
  *                      transport persistence option when       *
  *                      using EXEC CICS INVOKE SERVICE.         *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  If an EXEC CICS INVOKE SERVICE request, that uses WebSphere MQ
  transport, does not explicitly specify the persistence option
  in the URI then CICS sends a value of zero to MQ.
  Zero is the MQ value for MQPER_NOT_PERSISTENT so the message
  is treated as being not persistent rather than taking the
  default value for the queue.
  

Problem conclusion

Temporary fix

•             *********
              * HIPER *
              *********
  FIX AVAILABLE BY PTF ONLY
  

Comments

• CICS is changed to send the value 2, MQPER_PERSISTENCE_AS_Q_DEF,
  if the persistence option is not specified in the URI for an
  EXEC CICS INVOKE SERVICE request that uses MQ transport.
  

APAR Information

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

  PI09218

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

  UI16832

Modules/Macros

• DFHPITQ  DFHPITQ1
  

Fix information

• Fixed component name

  CICS TS Z/OS V4

• Fixed component ID

  5655S9700

Applicable component levels

• R600 PSY UI16832

     UP14/04/23 P F404 ½

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.