Fixes are available
APAR status
Closed as program error.
Error description
When an environment variable is used in the APPLICID field of a process object, a triggered application may find that some of the fields in the MQTMC2 structure passed to the application are corrupt. The fields that are likely to be corrupt are MQTMC2.EnvData, MQTMC2.UserData and MQTMC2.QMgrName. A workaround for this problem is to avoid using environment variables in process definitions, or to use a batch or script file in order to run the trigger process.
Local fix
Instead of using %CLASSPATH% variable in the APPLICID field of the process definition, use a script or batch file to start the Java application. The scripted Java command can be passed the %CLASSPATH% variable.
Problem summary
**************************************************************** USERS AFFECTED: Users who use triggering and have process definitions containing environment variables in the APPLICID field. Platforms affected: All Distributed (iSeries, all Unix and Windows) **************************************************************** PROBLEM SUMMARY: When an environment variable is used in the APPLICID field of a process object, it gets copied to the MQTMC2.ApplId field. When the operating system expands the environment variable, the value for the MQTMC2.ApplId property can overflow into subsequent fields in the MQTMC2 structure. Expansion by the operating system of environment variables in trigger data might lead to corruption of the fields following the MQTMC2.ApplId.
Problem conclusion
In order to fix this problem, the runmqtrm code was changed so that percent/dollar characters are escaped by double quotes or a backslash. This change causes the expansion of environment variables by the operating system to be suppressed. For example, if an APPLICID were defined to be "java cp %CLASSPATH% TriggerApp", then this would be changed to "java cp "%"CLASSPATH"%" TriggerApp" when constructing the MQTMC2. The percent/dollar characters are not manipulated for the purposes of launching the trigger application, only for the MQTMC2 structure that is passed in as an argument to the trigger application. With this change, applications would no longer receive an expanded version of the environment variable and would instead have to use alternative means of expanding the variable if its contents are important. --------------------------------------------------------------- The fix is targeted for delivery in the following PTFs: v7.0 Platform Fix Pack 7.0.1.5 -------- -------------------- Windows U200324 AIX U839183 HP-UX (PA-RISC) U839621 HP-UX (Itanium) U839626 Solaris (SPARC) U839622 Solaris (x86-64) U839628 iSeries tbc_p700_0_1_5 Linux (x86) U839623 Linux (x86-64) U839627 Linux (zSeries) U839624 Linux (Power) U839625 The latest available maintenance can be obtained from 'WebSphere MQ Recommended Fixes' http://www-1.ibm.com/support/docview.wss?rs=171&uid=swg27006037 If the maintenance level is not yet available, information on its planned availability can be found in 'WebSphere MQ Planned Maintenance Release Dates' http://www-1.ibm.com/support/docview.wss?rs=171&uid=swg27006309 ---------------------------------------------------------------
Temporary fix
Comments
APAR Information
APAR number
IC72003
Reported component name
WMQ WINDOWS V7
Reported component ID
5724H7220
Reported release
701
Status
CLOSED PER
PE
NoPE
HIPER
NoHIPER
Special Attention
NoSpecatt
Submitted date
2010-10-20
Closed date
2010-12-17
Last modified date
2010-12-17
APAR is sysrouted FROM one or more of the following:
APAR is sysrouted TO one or more of the following:
Fix information
Fixed component name
WMQ WINDOWS V7
Fixed component ID
5724H7220
Applicable component levels
R701 PSY
UP
[{"Business Unit":{"code":"BU059","label":"IBM Software w\/o TPS"},"Product":{"code":"SSDEZSF","label":"IBM WebSphere MQ Managed File Transfer for z\/OS"},"Component":"","ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"7.0.1","Edition":"","Line of Business":{"code":"LOB45","label":"Automation"}}]
Document Information
Modified date:
31 March 2023