IBM Support

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

Subscribe

You can track all active APARs for this component.

 

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":"BU048","label":"IBM Software"},"Product":{"code":"SSCPQ63","label":"APAR \/ Maintenance"},"Component":"","ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"7.0.1","Edition":"","Line of Business":{"code":"","label":""}}]

Document Information

Modified date:
17 December 2010