IC72003: APPLICID CONTAINING AN ENVIRONMENT VARIABLE GETS EXPANDED TO MQTMC2.APPLID, BUT OVERFLOWS INTO REMAINING MQTMC2 STRUCTURE.

WebSphere MQ V7.0 Fix Pack 7.0.1.5
WebSphere MQ V7.0.1 for i5/OS Fix Pack 7.0.1.5

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 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