Technical Blog Post
Abstract
Configuring XML Probe and Gateway for JMS Transport
Body
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
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"
xmlns:xsd="http://www.w3.org/2001/XMLSchema">
<!-- 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"
xmlns:xsd="http://www.w3.org/2001/XMLSchema">
<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>
HTTP - Hypertext Transfer Protocol.
HTTPS - Hypertext Transfer Protocol Secure.
UID
ibm11082013