(9.0+) Message Bus logging

Message Bus generates the following log files:

  • VHT_Message_Bus Logs

XML configuration file setting is used to configure the following:

  • Where the active files are located
  • What log level to write logs
  • Name of the active log file and folder

Important

When troubleshooting an issue, be sure to set the log level to the appropriate level to capture all the necessary information.

VHT Message Bus logs

These logs show Message Bus connection to Queue Manager during startup. You will also see the processing of PTK messages and queue variable changes.

XML Configuration File Settings

To locate the xml configuration file used by Message Bus you must first locate the installation location of Callback. This can be found in the registry of the server in the following location. The setting will be a file path on the server.

XML Configuration File Location

This can be located on each server in the registry

  • HKEY_LOCAL_MACHINE\SOFTWARE\Virtual Hold
    • InstallationLocation

Here is an example of a common setting: C:\Program Files (x86)\Virtual Hold Technology

The file path will be appended with /PlatformToolKit.

Here is an example of a common file path C:\Program Files (x86)\Virtual Hold Technology\PlatformToolKit

In this location are 2 xml configuration files for Message Bus

XML File Name

  • VHT_Message_Bus_Console.exe.xml
  • VHT_Message_Bus_Console.FQDN -or- Workgroup.exe.xml <- Used only in HA Callback Solutions

Logging section in XML Files

<vhtLogging><application level="5" name="VHT_Message_Bus" logFilePath="C:\Program Files (x86)\Virtual Hold Technology\VHLogs\"></application> </vhtLogging>

DescriptionSettingValuesDefault
File path where active logs should be writtenlogFilePath*Any valid directory path

Missing: C:\VHTPlatform\Logs

Empty: Applications Working Directory

Log level to write active logslevel

**Number

Any value 1-10

Missing of Blank: 5
Size of the active LogN/A8 MB
Name of log foldernameTextMissing or Blank: Name of Applcation file
Name of log filenameTextMissing or Blank: Name of Application file
How long to keep active files in the active directoryControlled by Archive Service
When to start new log fileActive file size exceeds 8MB

*Should always be the root for ALL log files.

**Log level 5 generally provides good information.

Log levelIncluded in logs
0No log
1-4Should never be used. Insufficient logging.
5Default setting, used by most systems.
6Detail relating to processing of each message
7
8
9
10