IBM Support

Errors related to HDR files shown in MQ agent log files

Troubleshooting


Problem

Lots of error messages are reported in the log files of the agent.

Symptom

Errors like the following are shown in the RAS1 log file of the MQ agent:

- Error "Unable to open Metafile </opt/IBM/ITM/hpi113/mq/hist/MME015DB/QMQ_LH.hdr>"
- Error opening source file /opt/IBM/ITM/hpi113/mq/hist/MNSLKC0/QMCH_LH.hdr, errno = 2
and
Metafile parser returned error code 3001!

Cause

Specific configuration of TEP and MQ agent plus a design behavior on ITM 6.1 platform, generate this issue.

Diagnosing The Problem

1)
(47554BD9.0000-9:khdxbase.cpp,250,"setError") Error 26/3/0(00000000)/0
(47554BD9.0001-9:khdxbase.cpp,266,"setError") Error "Unable to open Metafile </opt/IBM/ITM/hpi113/mq/hist/MME015DB/QMQ_LH.hdr>"
....
(47554F5D.0000-9:khdxbase.cpp,250,"setError") Error 26/3/0(00000000)/0
(47554F5D.0001-9:khdxbase.cpp,266,"setError") Error "Unable to open Metafile </opt/IBM/ITM/hpi113/mq/hist/MME015DB/QMQ_LH.hdr>"

2)
(47666E2D.0000-6:krabhsco.cpp,621,"KRA_OpenHistoryFiles") Error opening
source file /opt/IBM/ITM/hpi113/mq/hist/MNSLKC0/QMCH_LH.hdr, errno = 2
(47666E2D.0001-6:krarhagt.cpp,321,"SetupSample") Metafile parser returned error code 3001! (47666E2D.0002-6:krarhagt.cpp,983,"TakeSampleConstructor") Error in request setup, table QMCH_LH. Setting error status to 3001.

Resolving The Problem

The product is working as designed overall.

The presence of the messages in the MQ agent log file depends on the combined usage of the History Configuration Panel in TEP and of the HISTORY parameter in the MQ agent configuration file (default mq.cfg).

NOTE: HISTORY(NO) setting only applies to the history collection for those Attribute Groups whose name have *Long-Term_History suffix.

Here is a clear description of the behavior:



- If TEP is NOT set to collect historical data
> HISTORY(NO) at the agent
>> no headerfiles initialized,
>> no data is collected at the agent,
>> no log entries concerning metafiles

> HISTORY(YES) at the agent
>> no headerfiles initialized,
>> no data is collected at the agent,
>> no log entries concerning metafiles

- If TEP is set to collect historical data
> HISTORY(NO) at the agent
>> no headerfiles initialized,
>> no data is collected at the agent,
>> many log entries concerning metafiles

> HISTORY(YES)
>> headerfiles initialized,
>> data is collected at the agent,
>> no log entries concerning metafiles

In case TEP is set to collect historical data once every 15 minutes but HISTORY(NO) is coded in the MQ agent configuration file, then you may have the 2 types of error messages shown below:

1)
"
(47554BD9.0000-9:khdxbase.cpp,250,"setError") Error 26/3/0(00000000)/0
(47554BD9.0001-9:khdxbase.cpp,266,"setError") Error "Unable to open Metafile </opt/IBM/ITM/hpi113/mq/hist/MME015DB/QMQ_LH.hdr>"
....
(47554F5D.0000-9:khdxbase.cpp,250,"setError") Error 26/3/0(00000000)/0
(47554F5D.0001-9:khdxbase.cpp,266,"setError") Error "Unable to open Metafile </opt/IBM/ITM/hpi113/mq/hist/MME015DB/QMQ_LH.hdr>"
"

and F5D - BD9 = 384 (hex) = 900 (decimal) = 15 minutes
So this is the error message that is generated every collection interval that you have set on TEP.

2)
(47666E2D.0000-6:krabhsco.cpp,621,"KRA_OpenHistoryFiles") Error opening source file /opt/IBM/ITM/hpi113/mq/hist/MNSLKC0/QMCH_LH.hdr, errno = 2
(47666E2D.0001-6:krarhagt.cpp,321,"SetupSample") Metafile parser returned error code 3001!
(47666E2D.0002-6:krarhagt.cpp,983,"TakeSampleConstructor") Error in request setup, table QMCH_LH. Setting error status to 3001.

This type of error messages is logged when someone tries to see MQ historical data on the TEP.

This is done from a view for which we are collecting historical data hence a view for which we have a little icon in the top left corner to specify the time span.
When you enable historical data from the Historical Configuration Panel from TEP, you will have that "timespan" icon in the related view and so ITM framework will look for HDR files and actual binary historical data files but since you have set HISTORY(NO), the MQ agent didn't create them, hence the error messages above.

[{"Product":{"code":"SSRLBE","label":"Tivoli OMEGAMON XE for Messaging for Distributed Systems"},"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Component":"--","Platform":[{"code":"PF002","label":"AIX"},{"code":"PF010","label":"HP-UX"},{"code":"PF016","label":"Linux"},{"code":"PF027","label":"Solaris"},{"code":"PF033","label":"Windows"}],"Version":"7.0.1;7.1.0;7.3.0","Edition":"","Line of Business":{"code":"LOB45","label":"Automation"}}]

Document Information

Modified date:
17 June 2018

UID

swg21291618