IBM Support

IT08513: AFTER APPLYING FIXPACK 8.0.0.2 ON IBM MQ EXPLORER V8 FOR LINUX, ERROR MESSAGES ARE OBSERVED ON THE CONSOLE OUTPUT

Subscribe

You can track all active APARs for this component.

 

APAR status

  • Closed as program error.

Error description

  • After applying IBM MQ fixpack v8.0.0.2 on the Linux (x86-64)
    platform, error messages of the following form are seen on the
    console when the MQ Explorer is started:
    
    Attribute 265(unknown)missing from type table (2) for object
    MyQMGR
    Attribute 262(MQIA_DISPLAY_TYPE)missing from type table (176)
    for object 176/414d51206170706c65514d20202020200c3ca25606000010
    Attribute 262(MQIA_DISPLAY_TYPE)missing from type table (176)
    for object 176/414d51206170706c65514d2020202020163ca25607100020
    Attribute 1644(unknown)missing from type table (25) for object
    SYSTEM.DEF.AMQP
    Attribute 1522(MQIACH_PORT)missing from type table (25) for
    object SYSTEM.DEF.AMQP
    Attribute 1629(MQIACH_USE_CLIENT_ID)missing from type table (25)
    for object SYSTEM.DEF.AMQP
    
    In addition, some of the panels in the MQ Explorer are blank.
    
    The problem happened after connecting to a queue manager which
    had had its command level updated to the 801 level.
    

Local fix

  • Run the MQ Explorer Eclipse initialization routines, using the
    command as the root user:
    
      /opt/mqm/bin/MQExplorer -initialize
    
    
    Alternatively, download the MQ Explorer supportPac MS0T which is
    not affected by this issue.
    
    Note that this supportPac on Linux does not permit a BINDINGs
    mode connection, so may require the creation of additional
    channels to connect to the queue manager over TCP/IP.
    

Problem summary

  • ****************************************************************
    USERS AFFECTED:
    Users of the IBM MQ Explorer v8.0 running on Linux (x86 and
    x86-64) who are connecting to a queue manager which is using a
    higher command level than the default for IBM MQ v8.0.
    
    
    Platforms affected:
    Linux on x86, Linux on x86-64
    
    ****************************************************************
    PROBLEM DESCRIPTION:
    When a fix pack is installed on a IBM v8 MQ Linux installation
    which includes the MQ Explorer package, the Eclipse
    initialisation routines should be run in order to ensure that
    Eclipse picks up the latest version of the plugins within its
    installation directories.
    
    However, this initialisation can also delete files which causes
    the IBM MQ Linux .rpm packages problems when it comes to removal
    of a fix pack.  For that reason, the initialization routine was
    not invoked during the installation of the fix pack.
    
    The consequence of this was that when a fix pack was applied on
    Linux, the MQ Explorer plugins would not be initialized, and the
    new code as part of the fix pack would not be used during the
    running of the MQ Explorer.
    
    As of MQ 8.0.0.2, if a queue manager was run with the updated
    command level, for example by running the command:
    
      strmqm -e CMDLEVEL=801 "myQmgrName"
    
    then the new code within the plugins is required to comprehend
    the additional attributes of the queue manager objects.  If the
    updated plugins were not in use (which was the default), then
    the console would report the missing attributes with messages of
    the form:
    
    Attribute 265(unknown)missing from type table (2) for object
    MyQMGR
    
    each time one of the unknown attributes was encountered, and the
    MQ Explorer panels may not behave as they are designed to, for
    example displaying blank panels.
    
    
    A local work around to resolve this problem is to manually run
    the initialization step.  This is achieved using the command:
    
      /opt/mqm/bin/MQExplorer -initialize
    
    which will cause Eclipse to re-asses what plugins it has
    available to it, resulting in the newer code being used at
    runtime.  Note that if you use this option, you may find when
    you come to remove the fix pack that the uninstall of the
    MQExplorer component will fail, with an error message of the
    form:
    
    
    WARNING:  File
    /opt/mqm/mqexplorer/eclipse/features/com.ibm.mq.explorer.feature
    _7.5.0.201504241540/feature_cs.properties is missing.
              This file belongs to this maintenance pack.
              Uninstallation will continue.
    mv: cannot stat
    `/opt/mqm/mqexplorer/eclipse/features/com.ibm.mq.explorer.featur
    e_7.5.0.201504241540/feature_cs.properties': No such file or
    directory
    ERROR:  Unable to move a file back to its install location:
    
    "/opt/mqm/maintenance/7.5.0.5/MQSeriesExplorer/opt/mqm/mqexplore
    r/eclipse/features/com.ibm.mq.explorer.feature_7.5.0.20150424154
    0"
            This maintenance package cannot be uninstalled at this
    time
            Aborting uninstallation.
    error: %preun(MQSeriesExplorer-U200533-7.5.0-5.x86_64) scriptlet
    failed, exit status 1
    
    
    This error message can be circumvented by using the rpm
    uninstall option "--noscripts", for example:
    
    rpm -ev --noscripts MQSeriesExplorer-U8002-8.0.0-2.x86_64
    
    If this is done, the installation of MQ MUST be fully removed
    after completion of the command - and no attempt should be made
    to use the MQ Explorer until the complete MQ installation has
    been removed and reinstalled.  Once all the MQ components for
    the installation have been removed, the /opt/mqm directory (if
    using the default installation location) should be cleared prior
    to reinstalling, as it will contain remnants of the old
    installation which were not removed by the uninstallation
    scripts.
    
    
    Note that the standalone MQ Explorer obtained by the SupportPac
    MS0T is NOT affected by this problem, because it runs the
    initialization step as part of its install, and fix packs cannot
    be applied on this standalone package.
    

Problem conclusion

  • The mechanism by which the MQ Explorer is updated by the Linux
    MQ Explorer fix pack .rpm packages has been updated such that
    the initialization step is now undertaken by the fix pack
    install scripts, without preventing the MQ Explorer .rpm
    component from being uninstalled if files are deleted.
    
    Note that this fix applies only to fix packs which contain the
    code change for this APAR.  The behaviour of previous fix pack
    versions are not altered by this APAR.  For example, consider
    the following install order where the APAR is assumed to be
    included in the 8.0.0.5 fix pack:
    
      Install 8.0.0.0
      Install 8.0.0.2
      Install 8.0.0.5
      Uninstall 8.0.0.5
    
    would leave the MQ Explorer in the same state as before the
    8.0.0.5 fix pack was installed - eg. without the new function
    being enabled.
    
    ---------------------------------------------------------------
    The fix is targeted for delivery in the following PTFs:
    
    Version    Maintenance Level
    v8.0       8.0.0.5
    
    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

    IT08513

  • Reported component name

    WMQ BASE MULTIP

  • Reported component ID

    5724H7251

  • Reported release

    800

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt / Xsystem

  • Submitted date

    2015-04-23

  • Closed date

    2016-01-29

  • Last modified date

    2016-01-29

  • 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 BASE MULTIP

  • Fixed component ID

    5724H7251

Applicable component levels

  • R800 PSY

       UP

[{"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Product":{"code":"SSYHRD","label":"IBM MQ"},"Component":"","ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"8.0.0.0","Edition":"","Line of Business":{"code":"LOB45","label":"Automation"}}]

Document Information

Modified date:
29 January 2016