IBM Support

IT43580: 'mqconfig' utility reports incorrect required version of AIX forMQ 9.3

Subscribe to this APAR

By subscribing, you receive periodic emails alerting you to the status of the APAR, along with a link to the fix after it becomes available. You can track this item individually or track all items by product.

Notify me when this APAR changes.

Notify me when an APAR for this component changes.

 

APAR status

  • Closed as program error.

Error description

  • An MQ installation was upgraded on AIX from MQ v9.1.0.5 to MQ
    v9.3.0.4.
    
    After the upgrade completed, the 'mqconfig' utility was run to
    validate the system requirements.  The 'mqconfig' utility
    reported the following message:
    
    $ /usr/mqm/bin/mqconfig -v 9.3
      mqconfig: IBM MQ V9.3 requires AIX 7.2 Technology Level 2 or
    later.  This AIX
                7.2 installation is at Technology Level 4.
    
    The system AIX OS level was reported as:
    
    $ oslevel -s
    7200-04-01-1939
    
    indicating that the AIX version reported by 'mqconfig' was
    correctly stated as:
      7.2 installation is at Technology Level 4.
    
    Yet 'mqconfig' also reported that MQ V9.3 requires:
      7.2 installation is at Technology Level 2 or later
    

Local fix

Problem summary

  • ****************************************************************
    USERS AFFECTED:
    Users of MQ v9.3 on AIX 7.2 who are running the 'mqconfig'
    utility while the version of AIX was earlier than:
    
      AIX 7.2 Technology Level 5
    
    
    Platforms affected:
    AIX
    
    ****************************************************************
    PROBLEM DESCRIPTION:
    The minimum version of AIX 7.2 required to use MQ 9.3 is:
    
      AIX 7.2 Technology Level 3
    
    as reported in the IBM MQ 9.2 System Requirements documentation.
    
    
    However the 'mqconfig' utility was coded to report a problem if
    the version of AIX was less than:
    
      AIX 7.2 Technology Level 5
    
    
    Furthermore, if 'mqconfig' reported that your version of AIX 7.2
    did not meet the requirements for MQ 9.3, it would incorrectly
    report that the minimum required version was:
    
      AIX 7.2 Technology Level 2
    

Problem conclusion

  • The 'mqconfig' utility has been updated to check and report that
    the required version of AIX is:
    
      AIX 7.2 Technology Level 3
    
    
    For example, if the version of AIX which MQ 9.3 is installed on
    is:
    
      AIX 7.2 Technology Level 1
    
    then the utility will correctly report:
    
    $ /usr/mqm/bin/mqconfig -v 9.3
    mqconfig: IBM MQ V9.3 requires AIX 7.2 Technology Level 3 or
    later.  This AIX
              7.2 installation is at Technology Level 1.
    
    ---------------------------------------------------------------
    The fix is targeted for delivery in the following PTFs:
    
    Version    Maintenance Level
    v9.3 LTS   9.3.0.20
    v9.4 LTS   9.4.0.0
    
    The latest available maintenance can be obtained from
    'IBM MQ Recommended Fixes'
    https://www.ibm.com/support/pages/recommended-fixes-ibm-mq
    
    If the maintenance level is not yet available information on
    its planned availability can be found in 'IBM MQ
    Planned Maintenance Release Dates'
    https://ibm.biz/mqplannedmaintenance
    
    ---------------------------------------------------------------
    

Temporary fix

Comments

APAR Information

  • APAR number

    IT43580

  • Reported component name

    MQ BASE V9.3

  • Reported component ID

    5724H7291

  • Reported release

    930

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt / Xsystem

  • Submitted date

    2023-04-18

  • Closed date

    2024-03-01

  • Last modified date

    2024-05-14

  • 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 BASE V9.3

  • Fixed component ID

    5724H7291

Applicable component levels

[{"Business Unit":{"code":"BU048","label":"IBM Software"},"Product":{"code":"SSYHRD","label":"IBM MQ"},"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"930","Line of Business":{"code":"LOB67","label":"IT Automation \u0026 App Modernization"}}]

Document Information

Modified date:
14 May 2024