PI08762: WMQ 710 USING MQSMPO OPTIONS: MQSMPO_SET_PROP_UNDER_CURSOR, MQSMPO_SET_PROP_BEFORE_CURSOR, MQSMPO_SET_PROP_AFTER_CURSOR

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• USING MQSMPO (SET MESSAGE PROPERTIES OPTIONS)
  Results of using MQSMPO options:
  MQSMPO_SET_PROP_UNDER_CURSOR
  MQSMPO_SET_PROP_BEFORE_CURSOR
  MQSMPO_SET_PROP_AFTER_CURSOR
  are incorrect.
  
  
  MQMSGPROP/K
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All users of WebSphere MQ for z/OS Version 7 *
  *                 Release 1 Modification 0.                    *
  ****************************************************************
  * PROBLEM DESCRIPTION: The resulting message properties after  *
  *                      a MQSETMP call with MQSMPO options :    *
  *                      MQSMPO_SET_PROP_UNDER_CURSOR,           *
  *                      MQSMPO_SET_PROP_BEFORE_CURSOR or        *
  *                      MQSMPO_SET_PROP_AFTER_CURSOR are        *
  *                      incorrect when a valid property cursor  *
  *                      is used.                                *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  MQSETMP calls with property cursor related MQSMPO options
  result in incorrect property names. The following behaviour
  occurs :
  
  Using MQSMPO_SET_PROP_UNDER_CURSOR it is expected that the
  property names will remain unchanged after the MQSETMP call.
  However the property name changes, resulting in parts of the
  next property in the structure being used, while the property
  name length remains unchanged.
  
  MQSMPO_SET_PROP_BEFORE_CURSOR and MQSMPO_SET_PROP_AFTER_CURSOR
  should allow a new property to be added, with the property name
  specified on the MQSETMP call, however the call results in
  the new property having the same property name as the current
  location of the property cursor.
  

Problem conclusion

• The MQSETMP call has been changed to correct the behaviour with
  the property cursor and the MQSMPO options
  MQSMPO_SET_PROP_UNDER_CURSOR, MQSMPO_SET_PROP_BEFORE_CURSOR and
  MQSMPO_SET_PROP_AFTER_CURSOR.
  
  --------V710 Infocenter changes--------
  Page: Options (MQLONG)
  Found at:
  WebSphere MQ
  > Reference
   > Developing applications reference
    > MQI applications reference
     > Data types used in the MQI
      > MQSMPO  Set message property options
       > Fields for MQSMPO
  Link:http://pic.dhe.ibm.com/infocenter/wmqv7/v7r1/topic/com.ibm
  .mq.doc/fr42360_.htm
  Change:
  Under sections MQSMPO_SET_PROP_BEFORE_CURSOR and
  MQSMPO_SET_PROP_AFTER_CURSOR
  
  Add the following after the existing paragraphs:
  "If this option is used with a property with a property name
  containing a logical grouping or ".", that is different to
  the group of the current property pointed to by the cursor
  the call fails with MQRC_PROPERTY_NAME_ERROR.
  
  The property being added will be put
  in the same logical grouping as the property pointed to by the
  cursor."
  
  Under section MQSMPO_SET_PROP_UNDER_CURSOR
  
  Change line "Sets the value of the property pointed to by
  the property cursor." to "Sets the value of the property
  pointed to by the property cursor, the name specified on
  the call is not used, and the property name remains
  unchanged."
  
  
  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.ib
  m.mq.doc/fm20150_.htm
  Change:
  
  Add the following bullet point to the list after "...names may
  result in this error:" :
  "The name contains a logical grouping or "." on a MQSETMP call
  specifying MQSMPO_SET_PROP_BEFORE_CURSOR
  or MQSMPO_SET_PROP_AFTER_CURSOR, with a grouping different
  to the cursor location."
  ---------------------------------------
  
  MQMSGPROP/K
  100Y
  CMQZRFPA
  CSQARFPA
  CSQURFPA
  CSQXRFPA
  

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:

  IV60730 UI18268

Modules/Macros

• CMQZRFPA CSQARFPA CSQURFPA CSQXRFPA
  

Fix information

• Fixed component name

  WMQ Z/OS V7

• Fixed component ID

  5655R3600

Applicable component levels

• R100 PSY UI18268

     UP14/08/30 P F408

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.