PK20011: WEBSERVICES HOSTED IN CTS 3.1 QUEUE NAME MUST BE HOST NAME. WEBS ERVICES USES UNDERSCORE IN QUEUE NAME, CICS RESTRICTS UNDERSCORE

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• CICS 3.1 Webservices using MQ as the transport.
  FUNCTION(LOCATE_URIMAP)fails with RESPONSE(EXCEPTION) and
  REASON(INVALID_HOSTNAME). The MQ name is must match the cics
  transaction server 3.1 has a restriction.
  "The HOST attribute must be present, and must contain only
  alphanumeric characters, hyphens (-) or periods (.). Hexadecimal
  escape sequences cannot be used in a host name. CICS validates
  thisat define time.The host name can be entered in any case,
  but it is converted to lower case in the URIMAP definition."
  MQ queue name is validly using a underscore as a delimiter.
  But CICS TS 3.1 can not tolerate the underscore as part of the
  HOST  NAME.
  

Local fix

• MQ queue name to a name that does not contain underscore charact
  er and the failure will be resolved
  WB 0901 WBUR  EXIT - FUNCTION(LOCATE_URIMAP) RESPONSE(EXCEPTION)
  REASON(INVALID_HOSTNAME)
   USAGE() URIMAP() HOST(24B0191C , 00000022 , 00000000)
   PATH(24B01950 , 0000000D , 00000000) PIPELINE_NAME()
  WEBSERVICE_NAME()
  

Problem summary

• ****************************************************************
  * USERS AFFECTED: All.                                         *
  ****************************************************************
  * PROBLEM DESCRIPTION: MsgDFHPI0112 may be issued when using   *
  *                      Web services with MQ Transport.         *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  When using CICS Web services with Websphere MQ as the transport,
  the service provider Queue Name is passed to CICS. Since DFHWBUR
  has no way to distinguish between a HTTP URIMAP and a MQ queue
  name, the MQ Queue Name is validated according to HTTP rules. In
  this case the name contained the underscore character which is
  an illegal character according to the current rules.
  These requests are rejected with message DFHPI0112.
  .
  Queue Names that do not contain underscores pass through
  validation and match with URIMAPs which have a setting of
  HOST=*. This is the expected behavior of those with underscores.
  .
  Additional keywords: MSGDFHPI0112 PI0112
  

Problem conclusion

• DFHPILSQ has been changed to pass a new parameter, MQ(YES/NO),
  on the DFHWBURM locate_urimap call. This parameter is checked in
  routine locate_urimap and if set to YES then validation
  appropriate for MQ Transport Queue Names is employed.
  

Temporary fix

• FIX AVAILABLE BY PTF ONLY
  

Comments

APAR Information

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

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

  UK15549

Modules/Macros

•    DESPILSQ DESWBUR  DFHPILSQ DFHWBUR  DFHWBURA
  DFHWBURC DFHWBURM DFHWBURT
  

Fix information

• Fixed component name

  CICSTS 3.1 Z/OS

• Fixed component ID

  5655M1500

Applicable component levels

• R400 PSY UK15549

     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.