A fix is available
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 number
PI08762
Reported component name
WMQ Z/OS V7
Reported component ID
5655R3600
Reported release
100
Status
CLOSED PER
PE
NoPE
HIPER
NoHIPER
Special Attention
NoSpecatt / Xsystem
Submitted date
2013-12-27
Closed date
2014-07-23
Last modified date
2014-09-03
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.
[{"Business Unit":{"code":"BU054","label":"Systems w\/TPS"},"Product":{"code":"SG19M","label":"APARs - z\/OS environment"},"Component":"","ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"7.1","Edition":"","Line of Business":{"code":"","label":""}}]
Document Information
Modified date:
03 September 2014