IBM Support

ITCAM Agents for WebSphere Messaging Version 7.3.0 Fix Pack 4 readme

Fix Readme


Abstract

This is a cumulative Fix Pack for ITCAM Agents for WebSphere Messaging 7.3.0 Fix Pack 4. This fix pack supports the IBM MQ 9.3 (KMQ agent) and IBM App Connect Enterprise 12.0.10.0 (KQI agent) and resolves the APARs of previous product versions.

Content

Copyright International Business Machines Corporation 2024.
All rights reserved.
============================
Component: ITCAM Agents for WebSphere Messaging 7.3.0 Fix Pack 4
Release ID: 7.3.0-TIV-XEforMsg-FP0004
Date: November 30, 2023
Last modified date: January 24, 2024
============================

1.0 What's new

============================
  • Monitoring support for IBM MQ RDQM HA for the KMQ agent.
    Aha idea - https://automation-management.ideas.ibm.com/ideas/ITMAPM-I-75 )
  • Added IBM iOS support for the KMQ agent.
  • Added ACE 12.0.10.0 support for the KQI agent.
    Note: This release is not compatible with any IIB version since many IIB agent deprecated APIs have been replaced with new ones to support newer ACE server versions (11 and 12.x).

2.0 List of fixes

============================

The following APARs and critical defects are addressed in this fix pack.
 

ITCAM agent for WebSphere MQ

  • IJ42762 - MQ agent 64-bit instances are showing high CPU on Linux on z/os.
  • IJ23108 - KMQ agent can't display AMQ9777E error messages due to new content added in MQ 9.1.X
  • IJ46156 - The error message is not displayed on TEP due to the large length of the 'CommentInsert' attribute in the MQ error log.
  • IJ47205 - MQGET call is failing with MQRC 2080(MQRC_TRUNCATED_MSG_FAILED) error when the MQ message size is larger than the default message buffer size(1024).
  • IJ47294 - MQ Agent is unable to parse the new format and related columns of IBM MQ 9.0.3 or later correctly because a new item about time is added in the MQ error log workspace.
  • IJ46835 - KMQ agent is incorrectly constructing the path of qm.ini required for MaxChannels and MaxActiveChannels attribute on IBM i (OS/400)
  • IJ23052 - Incorrect backup directory path for MQ.CFG file in Tivoli Composite Application Manager for Applications Documentation. For more information, see www.ibm.com/support/pages/node/7103499.

ITCAM agent for WebSphere Message Broker

  • IJ21817 - The variable MQSI_DISABLE_CONVERTER_CACHE is asked to be set by the IIB CMP interface.
  • IJ34161 - KQI memory leak and core dump.
  • IJ30277 - Added "Connection: close" in the HTTP header.                                                     
  • IJ38292 - Added Support ACE 12.0.10.0

3.0 Prerequisites

============================
 Make sure that the following software installed in your environment is compatible with this fix pack.
 

Supported WebSphere MQ

  • WebSphere MQ 7.1
  • WebSphere MQ 7.5
  • IBM MQ 8.0
  • IBM MQ 9.0
  • IBM MQ 9.1
  • IBM MQ 9.2
  • IBM MQ 9.3

Supported IBM broker products

  • WebSphere Message Broker 8.0
  • IBM App Connect Enterprise 11.0
  • IBM App Connect Enterprise 12.0

Supported IBM Tivoli Monitoring

  • IBM Tivoli Monitoring 6.3.0 fix pack 7 or later

4.0 Known issues

============================
  • Upgrading an existing MQ agent on the Windows platform replaces the customized mq.cfg with the default one
    Problem Description: In case of an upgrade scenario on the Windows platform, the customized mq.cfg file is getting replaced with the default one.
    Workaround: Back up the customized mq.cfg file before upgrade, and then replace the default mq.cfg file that is present at <ITMHOME>\TMAITM6_x64 for Win64 or <ITMHOME>\TMAITM6 for Win32 locations with the backed up file.
  • Remote installation of 32-bit KMQ agent on the Windows and xLinux platforms by using TEP GUI installs 64-bit agent.
    Problem Description: Remote installation of 32-bit MQ agent by using GUI by selecting "WebSphere MQ monitoring agent 32/64 bit" option installs 64-bit agent when both 32-bit and 64-bit agent bundles are present.
    Workaround: To install a 32-bit MQ agent remotely, add only 32-bit agent bundles to the depot on ITM.
  • TEMS Configurator (KCF) returns a false result when validating Queue Manager v9.1
    Problem Description: TEMS Configurator (KCF) returns a false result when validating Queue Manager v9.1 since there is an unsupported attribute in IBM MQ 9.1.
    Workaround: Uncheck 'Validate individual property fields' in the Queue Manager Validation section.
  • For Red Hat 8 x86-64, you might need to install some additional 32-bit libraries
    Problem Description: Red Hat 8 is supported on x86-64 but you might need to install some additional 32-bit libraries. 
    Workaround: For more details, see https://www.ibm.com/support/pages/node/1282876.
  • For Windows Environment, the KQI agent fails to start if the correct redistributable is not installed
    Problem Description: The KQI agent does not start on Windows and displays an error, "Faulting module name: MSVCR90.dll".
    Workaround: Install Microsoft Visual C++ 2008 and 2013 redistributable.
  • KQI Agent does not start on X-Linux and Z-Linux after the SP14 SDK addition.
    Problem Description: KQI agent does not start on x-linux and z-linux with ./itmcmd agent start qi.
    Workaround: To start the agent on the x-linux and z-linux environments, you need to provide the instance name in the itmcmd command with the '-o' option. The following is the format of the command. 
    ./itmcmd agent -o <instance_name> start qi

5.0 Known limitations

============================

Some of the operating systems that were supported in fix pack 2 are not included in fix pack 4.
 This fix pack is available for the following platforms:
  • Linux x86-64 (Red Hat and SUSE) 
  • Windows
  • AIX
  • Oracle Solaris sparc
  • Oracle Solaris 10 on x86-64
  • Linux (Red Hat and SUSE) on Power little endian (for the KMQ agent only)
  • IBM i (for the KMQ agent only)
  • Linux on z/OS

6.0 Download location

============================
  1. To download this fix pack, log in to IBM Passport Advantage.
  2. After you have logged in, you can search for part numbers for the individual download packages. The part number of the installation image is M0GKWEN. 
    The M0GKWEN.tar.gz contains the following two installer packages.
    Product - Component Name Platform
    ITCAM_AGENTS_FOR_WS_MSG_7.3_FP4.tar.gz  AIX, Solaris, IBM i, Windows 32-bit and 64-bit, xLinux 32-bit
    ITCAM_AGENTS_FOR_WS_MSG_7.3_FP4_linux64.tar.gz X, Z, and PLinux 64-bit

7.0 Installation information

============================

8.0 Post-installation tasks

============================

WebSphere Message Broker monitoring agent
 
Additional configuration is required if the WebSphere Message Broker agent is upgraded from version 7.3 GA to version 7.3 fix pack 3 and later.
 
If you already installed the WebSphere Message Broker agent of version 7.3 GA and have enabled historical data for Message flow status, complete the following steps after you upgrade the agent to version 7.3 fix pack 3 and later. 
  1. Ensure that you have upgraded application support files on Tivoli Enterprise Monitoring Server and Tivoli Enterprise Portal Server.
  2. Stop the WebSphere Message Broker monitoring agent if it is running.
  3. Remove the following local historical data files.
    Linux or UNIX
    <agent_install_path>/<arch_code>/qi/hist/<AgentId>/KQITMFLS*
    Windows
    32-bit agent: <ITM_HOME>\TMAITM6\logs\History\KQI\<instance ID>\KQITMFLS*
    64-bit agent: <ITM_HOME>\TMAITM6_x64\logs\History\KQI\<instance ID>\KQITMFLS*    
  4. If you upgraded the agent from version 7.3 GA to version 7.3 fix pack 2 and historical data collection is enabled for the Message Flow Status table, check the Message_Flow_Status table and any other related summarization tables.
    In the Message_Flow_Status table with suffixes such as _H, _D, _Y, _Q, _M, _W, in your warehouse database, if the length value of the DFMF_SAOF and DFMF_SSOF columns is 24, change it to 12 by completing any one of the following steps.
    • Drop the table and allow WPA to rebuild it with the correct column definitions.
    • Manually perform ALTER COLUMN for DFMF_SAOF and DFMF_SSOF to specify a length of 12.

9.0 Document change history

============================
Version Date Description of change
1.0 30 Nov 2023 Initial version
2.0 24 Jan 2024 Updated the 'List of fixes' section to include APAR IJ23052
3.0 28 Oct 2024 Updated the 'List of fixes' section to include APAR IJ23108

[{"Type":"MASTER","Line of Business":{"code":"LOB67","label":"IT Automation \u0026 App Modernization"},"Business Unit":{"code":"BU048","label":"IBM Software"},"Product":{"code":"SS3JRN","label":"Tivoli Composite Application Manager for Applications"},"ARM Category":[{"code":"a8m50000000Cm3zAAC","label":"ITCAM-for-AD-\u003EWebSphere Agent"}],"ARM Case Number":"","Platform":[{"code":"PF002","label":"AIX"},{"code":"PF012","label":"IBM i"},{"code":"PF016","label":"Linux"},{"code":"PF027","label":"Solaris"},{"code":"PF033","label":"Windows"}],"Version":"7.3.0"}]

Document Information

Modified date:
31 October 2024

UID

ibm17080053

Page Feedback