IBM Support

Configuring XML Probe and Gateway for JMS Transport

Technical Blog Post


Abstract

Configuring XML Probe and Gateway for JMS Transport

Body

This blog will cover on JMS (Java Message Service) transport types for XML Probe and Gateway
 
XML Probe and Gateway for JMS Transport

Note: WebSphere MQ was used as the target system in this example

 

1) Create Queue Manager

2) Create Topic under Queue Manager, tick Start JMS wizards to create matching JMS topic

3) Create JMS Administered object:

+Add Initial Context, follow wizard setup

+Create Connection factories->create Topic Connection Factory

+Choose Topic Connection Factory

+Choose MQClient when the MQ and JMS client (Probe) in different host.

4)  Bindings file will be created depending on the directory that you specified. Transfer the bindings file to the machine where the probe resides.

This can be copied into any directory on the probe's machine and this directory has to be specified at “providerURL” in the Probe Transport property file

5) Transfer all jar files below from <MQ_HOME>/java/lib to $OMNIHOME/java/jars :

 CL3Export.jar CL3Nonexport.jar com.ibm.mq.commonservices.jar

com.ibm.mq.defaultconfig.jar com.ibm.mq.headers.jar com.ibm.mq.jar

com.ibm.mq.jmqi.jar com.ibm.mq.jms.Nojndi.jar com.ibm.mq.pcf.jar

com.ibm.mq.postcard.jar com.ibm.mq.soap.jar com.ibm.mq.tools.ras.jar

com.ibm.mqetclient.jar com.ibm.mqjms.jar connector.jar dhbcore.jar

fscontext.jar jndi.jar jta.jar ldap.jar providerutil.jar rmm.jar

 

 

Modify <OMNIHOME>/probe/java/nco_p_xml.env

SIBC_JARS=/space/jyoges/730/netcool/omnibus/java/jars/CL3Export.jar:/space/jyoges/730/netcool/omnibus/java/jars/CL3Nonexport.jar:

/space/jyoges/730/netcool/omnibus/java/jars/com.ibm.mq.commonservices.jar:/space/jyoges/730/netcool/omnibus/java/jars/com.ibm.mq.defaultconfig.jar:

/space/jyoges/730/netcool/omnibus/java/jars/com.ibm.mq.headers.jar:/space/jyoges/730/netcool/omnibus/java/jars/com.ibm.mq.jar:

/space/jyoges/730/netcool/omnibus/java/jars/com.ibm.mq.jmqi.jar:/space/jyoges/730/netcool/omnibus/java/jars/com.ibm.mq.jms.Nojndi.jar:

/space/jyoges/730/netcool/omnibus/java/jars/com.ibm.mq.pcf.jar:/space/jyoges/730/netcool/omnibus/java/jars/com.ibm.mq.postcard.jar:

/space/jyoges/730/netcool/omnibus/java/jars/com.ibm.mq.soap.jar:/space/jyoges/730/netcool/omnibus/java/jars/com.ibm.mq.tools.ras.jar:

/space/jyoges/730/netcool/omnibus/java/jars/com.ibm.mqetclient.jar:/space/jyoges/730/netcool/omnibus/java/jars/com.ibm.mqjms.jar:

/space/jyoges/730/netcool/omnibus/java/jars/connector.jar:/space/jyoges/730/netcool/omnibus/java/jars/dhbcore.jar:

/space/jyoges/730/netcool/omnibus/java/jars/fscontext.jar:/space/jyoges/730/netcool/omnibus/java/jars/jms.jar:

/space/jyoges/730/netcool/omnibus/java/jars/jndi.jar:/space/jyoges/730/netcool/omnibus/java/jars/jta.jar:

/space/jyoges/730/netcool/omnibus/java/jars/ldap.jar:/space/jyoges/730/netcool/omnibus/java/jars/providerutil.jar:/space/jyoges/730/netcool/omnibus/java/jars/jars/rmm.jar

 
 
image  
This is how the MQ interface looks after being configured
 
  

Gateway Transport property file

initialContextFactory=com.sun.jndi.fscontext.RefFSContextFactory

providerURL=file:/space/jyoges/730/netcool/omnibus/java/conf

topicConnectionFactory=XMLProbe

topicName=xmlprobe

username=<username of server where MQ was installed>

password=<username of server where MQ was installed>

 

Example setting for Gateway Transformer File

<?xml version="1.0" encoding="UTF-8"?>

<tns:transformers

xmlns:tns="http://item.tivoli.ibm.com/omnibus/netcool/transformer&#34;

xmlns:xsd="http://www.w3.org/2001/XMLSchema"&gt;

<!-- Northbound (gateway) transformer definitions -->

<tns:transformer name="netcoolEvents" type="northbound" endpoint="xmlprobe" className="com.ibm.tivoli.netcool

.integrations.transformer.EmptyTransformer">

</tns:transformer>

</tns:transformers>

 

Probe Transport property file

initialContextFactory=com.sun.jndi.fscontext.RefFSContextFactory

providerURL=file:/space/jyoges/730/netcool/omnibus/java/conf

topicConnectionFactory=XMLProbe

topicName=xmlprobe

topicName=xmlprobe1

username=<username of server where MQ was installed>

password=<password of server where MQ was installed>

 

Example setting for Probe Transformer file

<?xml version="1.0" encoding="UTF-8"?>

<tns:transformers

xmlns:tns="http://item.tivoli.ibm.com/omnibus/netcool/transformer&#34;

xmlns:xsd="http://www.w3.org/2001/XMLSchema"&gt;

<tns:transformer name="netcool2nvpairs" type="southbound" endpoint="xmlprobe" className="com.ibm.tivoli.netcool.int

egrations.transformer.XSLTTransformer">

<tns:property name="xsltFilename" type="java.lang.String" value="${OMNIHOME}/java/conf/netcool2nvpair

s.xsl" description="XSLT file for converting Netcool events to name/value pairs"/>

</tns:transformer>

</tns:transformers>

 
Acronyms:
JMS - Java Message Service.
HTTP - Hypertext Transfer Protocol.
HTTPS - Hypertext Transfer Protocol Secure.
 
 

[{"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Product":{"code":"","label":""},"Component":"","Platform":[{"code":"","label":""}],"Version":"","Edition":"","Line of Business":{"code":"","label":""}}]

UID

ibm11082013