IBM Support

IT38635: VARIOUS ENVIRONMENT VARIABLES MAY REFERENCE THE INSTALLATION MULTIPLE TIMES AFTER SETMQENV IS USED TO SOURCE IT.

Subscribe

You can track all active APARs for this component.

 

APAR status

  • Closed as program error.

Error description

  • Various environment variables may reference the installation
    multiple times after setmqenv is used to source it.
    
    Should the evironment variables have grown too long, FFSTs
    with like:
    MQM Function Stack
      amqzxma0
      zxcExecutionController
      zxcStartupLogic
      nssPersistEnvironment
      cs_pa_WritePropertyMQ
      cs_pa_WriteProperty
      xcsFFST
    
    and FFST data
     Major Errorcode   :- Unknown(15)
    
     Minor Errorcode   :- OK
    
     Probe Type        :- INCORROUT
    
     Probe Severity    :- 4
    
     Probe Description :- AMQ6125: An internal IBM MQ error has
                          occurred.
     FDCSequenceNumber :- 0
    
     Arith1            :- 21 (0x15)
    
     Comment1          :- PUT_WRITEX
    
     Comment2          :- Operation on property file failed.
    
    
    may be seen. In this particular case the environment
    variable dump on the end of the FDC file may hint to
    the environment being too long.
    

Local fix

  • Remove MQ related references from the environment and
    source the installation's environment via var/mqm/mqprofile
    

Problem summary

  • crtmqenv which is used by setmqenv does not remove existing
    references to its local installation within the environment.
    

Problem conclusion

  • crtmqm has been changed to remove references to its local
    installation.
    ---------------------------------------------------------------
    The fix is targeted for delivery in the following PTFs:
    
    Version    Maintenance Level
    v8.1       8.1.0.9
    The latest available maintenance can be obtained from
    'Recommended Fixes for IBM MQ'
    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 'IBM MQ planned
    maintenance release dates'
    http://www-1.ibm.com/support/docview.wss?rs=171&uid=swg27006309
    ---------------------------------------------------------------
    

Temporary fix

  • Use var/mqm/mqprofile to set the environment instead of
    setmqenv/crtmqenv.
    

Comments

APAR Information

  • APAR number

    IT38635

  • Reported component name

    MQ FOR HPE NS O

  • Reported component ID

    5724A3903

  • Reported release

    810

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt / Xsystem

  • Submitted date

    2021-10-07

  • Closed date

    2021-10-15

  • Last modified date

    2021-10-15

  • 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

    MQ FOR HPE NS O

  • Fixed component ID

    5724A3903

Applicable component levels

  • R810 PSY

       UP

[{"Business Unit":{"code":"BU059","label":"IBM Software w\/o TPS"},"Product":{"code":"SSYHRD","label":"IBM MQ"},"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"810","Line of Business":{"code":"LOB45","label":"Automation"}}]

Document Information

Modified date:
08 November 2021