PM96938: WMQ BATCH JOB FAILS WITH MQRC 2442 WHEN USING MQCMHO OPTION (MQCMHO_NO_VALIDATION)

APAR status

• Closed as documentation error.

Error description

• Change Team determined that the code for zrfSetProperty
  is not honouring MQCMHO_NO_VALIDATION and is invoking
  zrfKnownNameFncs which results in MQRC_PROPERTY_NAME_ERROR
  being returned in this situation.
  .
  The customer reporting the issue was testing the MQCMHO
  option (MQCMHO_NO_VALIDATION) but finds that validation
  appears to be taking place as their batch job fails with
  MQRC 2442 ( MQRC_PROPERTY_NAME_ERROR ).
  .
  Additional keywords:
  MQMSGPROP/K
  

Local fix

• n/a
  

Problem summary

• ****************************************************************
  * USERS AFFECTED: All users of WebSphere MQ for z/OS Version 7 *
  *                 Release 1 Modification 0.                    *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  The infocenter incorrectly describes the function of validation
  for message properties set using the MQSETMP API call.
  

Problem conclusion

• The following infocenter changes will be made -
  
  Page : Options (MQLONG)
  Found at :  WebSphere MQ
     > Reference
      > Developing applications reference
       > MQI applications reference
        > Data types used in the MQI
         > MQCMHO  Create message handle options
          > Fields
  Link : http://pic.dhe.ibm.com/infocenter/wmqv7/v7r1/topic/com.i
  bm.mq.doc/fr42080_.htm
  Changes :
  Change section MQCMHO_NO_VALIDATION from "No validation on the
  property name occurs." to "The property name is checked against
  restricted names, no other validation occurs." Followed by a
  link to the page http://pic.dhe.ibm.com/infocenter/wmqv7/v7r1/
  topic/com.ibm.mq.doc/fg20140_.htm
  
  
  Page : Property name restrictions
  Found at :  WebSphere MQ
     > Developing applications
      > Application development concepts
       > WebSphere MQ messages
        > Message properties
         > Property names
  Link : http://pic.dhe.ibm.com/infocenter/wmqv7/v7r1/topic/com.i
  bm.mq.doc/fg20140_.htm
  Changes :
  
  Change "Property names are validated when setting a property
  using the MQSETMP call, if validation was requested when the
  message handle was created" to "Property names are validated
  when setting a property using the MQSETMP call, if validation
  was requested when the message handle was created. Property
  names are always checked for restricted names when setting a
  property using the MQSETMP call, regardless if validation was
  requested when the message handle was created".
  
  
  Page : 2442 (098A) (RC2442): MQRC_PROPERTY_NAME_ERROR
  Found at :  WebSphere MQ
     > Troubleshooting and support
      > Reason codes
       > API completion and reason codes
        > API reason codes
  Link : http://pic.dhe.ibm.com/infocenter/wmqv7/v7r1/topic/com.i
  bm.mq.doc/fm20150_.htm
  Changes : Change line "An attempt was made to set a property
  with an invalid name." to An attempt was made to set a property
  with an invalid or restricted name."
  
  Also change "Using any of the following settings results in this
  error:" to "With validation any of the following property names
  may result in this error. With validation off, only restricted
  names will result in this error."
  
  Add the following bullet to the list : "* The name is a
  restricted name (see Property name restrictions)" With "Property
  name restrictions" linking to http://pic.dhe.ibm.com
  /infocenter/wmqv7/v7r1/topic/com.ibm.mq.doc/fg20140_.htm
  

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:

Fix information

Applicable component levels