Skip to main content
Top
Review meshIQ Products (G2.com)

Stream WGS data as activity events

TNT4J-Streams-WGS is licensed under the Apache license version 2.0.

This article covers information specific to the TNT4J-Streams-WGS project. Information on meshIQ Streams Express, which describes the installation and configuration steps required to collect data for analysis by meshIQ, can be found in the meshIQ Streams Express Guide.

Why TNT4J-Streams-WGS?

TNT4J-Streams-WGS is an extension of TNT4J-Streams that enables you to stream WGS subscribed events and messages to XRay as events. Correlated events data from WGS is organized into activities.

WGS prerequisites

You must configure your WGS IBM MQ agent to obtain original IBM MQ statistical events from the SYSTEM.ADMIN.STATISTICS.QUEUE queue by replacing that local queue with an alias queue pointing to the NASTEL.PUBSUB.EVENT.QUEUE local queue.

For TNT4J-Streams-WGS to work, the pubsub.tst agent configuration file must include a section like this:

DEFINE QALIAS(SYSTEM.ADMIN.STATISTICS.QUEUE) +
TARGTYPE(QUEUE) TARGET(NASTEL.PUBSUB.EVENT.QUEUE) +
REPLACE

Running TNT4J-Streams-WGS

You can run TNT4J-Streams-WGS as a standalone application:

  • Create a streams configuration file. Configuration parameters that are specific to TNT4J-Streams-WGS are covered in the Configuring TNT4J-Streams-WGS section below.
  • Configure your loggers.
  • To run the standalone application, use the following, located in the tnt4j-streams-wgs/samples/wgs-statistics-events directory:
    • run.bat  for Windows
    • ./run.sh for Linux

See the sample README.md file in the same directory for more details.

 

Configuring TNT4J-Streams-WGS

This section contains descriptions and examples of the streams configuration file parameters that are specific to WGS. streaming.

Streams configuration

WGS stream parameters

  • Host - WGS host name/IP. (Required)
  • Port - WGS port number. Default - 4010. (Optional)
  • UserName - WGS authentication user name. (Optional)
  • Password - WGS user password. (Optional)
  • StreamReconnectDelay - delay in seconds between WGS reconnection after communication failure. Default value - 10sec. (Optional)
  • Set of PCF parameters used to configure WGS events subscription (Optional):
    • NEXCMD.EXCA_MANAGER_NAME - WGS group manager name. Default - MQM.
    • NEXCMD.EXIA_MON_MSG_TYPE - WGS events to subscribe. Default - NEXCMD.EXMONT_STAT_MQI | NEXCMD.EXMONT_STAT_Q | NEXCMD.EXMONT_STAT_CHL

Configuration sample:

<property name="Host" value="127.0.0.1"/>
<property name="Port" value="4010"/>
<property name="UserName" value="SecretUser"/>
<property name="Password" value="xRNw9FvRtCk="/>
<property name="StreamReconnectDelay" value="15"/> 
<property name="NEXCMD.EXCA_MANAGER_NAME" value="MQM"/>
<property name="NEXCMD.EXIA_MON_MSG_TYPE" value="NEXCMD.EXMONT_STAT_MQI | NEXCMD.EXMONT_STAT_Q | NEXCMD.EXMONT_STAT_CHL"/>

 

Parsers configuration

Activity PcfMQMessage parser

  • TranslateNumValues - indicates that the parser should translate resolved numeric values to corresponding MQ constant names, if possible and if the field/locator data type is String (meaning that the translated value can be assigned to a field). If the value of a particular field should be left as a number (e.g., ReasonCode), use field/locator attribute datatype="Number". Default value - true. (Optional)

Configuration sample:

<property name="TranslateNumValues" value="false"/>