Icwri Monitor for IBM TXSeries (abbr. as Icwri Monitor) is a super lightweight web based monitor and a group of services based on Icwri script to help TXSeries administration. The user interface can be easily customized because the tool is based on scripting language. Nothing is required to be installed into the TXSeries machine. So it is a non-intrusive monitor. The only prerequisite is CICS Transaction Gateway (abbr. as CTG).
You can install Icwri Monitor into a machine with CTG installed. And let Icwri Monitor visit CTG by UNIX IPC. This is called CTG local gateway mode. You can also install Icwri Monitor into a machine without CTG. And let Icwri Monitor connect to CTG gateway by network. This is called CTG remote gateway mode.
Note: Icwri is a lightweight service oriented Java built-in script by Liu Rui. Icwri can run on any system (UNIX/Linux, Windows, Mac, …) with JDK/JRE 1.5 or above installed.
1) Extract the package into a machine with CTG installed
$ cd /opt
$ gzip -d ic_tx_0.552.tar.gz
$ tar vxf ic_tx_0.552.tar
2) Set environment variables
CLASSPATH=/opt/ic_tx_0.552/icwri.jar:/opt/ic_tx_0.552/ic_tx.jar:/opt/ic_tx_0.552/ic_web.jar:/opt/IBM/cicstg/classes/ctgclient.jar:/opt/IBM/cicstg/classes/ctgserver.jar
export CLASSPATH
3) Run Icwri Monitor:
java lr.icwri.app.RunScript -f /opt/ic_tx_0.552/samples/testMon.icw -s !testMon1
Note:
"-s" argument specifies the service name.
"-f" argument specifies the script file.
1) Extract the package into a machine with or without CTG installed
$ cd /opt
$ gzip -d ic_tx_0.552.tar.gz
$ tar vxf ic_tx_0.552.tar
2) Set environment variables
Note:
Copy ctgclient.jar to /opt/ic_tx_0.552 from a CTG machine, the default one is not always workable
CLASSPATH=/opt/ic_tx_0.552/icwri.jar:/opt/ic_tx_0.552/ic_tx.jar:/opt/ic_tx_0.552/ic_web.jar:/opt/ic_tx_0.552/ctgclient.jar
export CLASSPATH
3) Run Icwri Monitor (make sure the CTG gateway is already started), input host IP and port of the CTG gateway:
java lr.icwri.app.RunScript -f /opt/ic_tx_0.552/samples/testMon.icw -s !testMon2
Note:
"-s" argument specifies the service name.
"-f" argument specifies the script file.
1) Extract the package to directory, for example: c:\ic_tx_0.552
2) Set environment variables(suppose the CTG path is "c:\ctg")
set CLASSPATH=c:\ic_tx_0.552\icwri.jar;c:\ic_tx_0.552\ic_tx.jar;c:\ic_tx_0.552\ic_web.jar;c:\ctg\classes\ctgclient.jar;c:\ctg\classes\ctgserver.jar
set PATH=%PATH%;c:\ctg\bin
3) Run Icwri Monitor
java lr.icwri.app.RunScript -f c:\ic_tx_0.552\samples\testMon.icw -s !testMon1
Note:
"-s" argument specifies the service name.
"-f" argument specifies the script file.
1) Extract the package to directory, for example: c:\ic_tx_0.552
2) Set environment variables
Note:
Copy ctgclient.jar to c:\ic_tx_0.552 from a CTG machine, the default one is not always workable
set CLASSPATH=c:\ic_tx_0.552\icwri.jar;c:\ic_tx_0.552\ic_tx.jar;c:\ic_tx_0.552\ic_web.jar;c:\ic_tx_0.552\ctgclient.jar
set PATH=%PATH%;c:\ctg\bin
3) Run Icwri Monitor (make sure the CTG gateway is already started), input host IP and port of the CTG gateway:
java lr.icwri.app.RunScript -f c:\ic_tx_0.552\samples\testMon.icw -s !testMon2
Note:
"-s" argument specifies the service name.
"-f" argument specifies the script file.
Open a Web browser with URL like "http://<Icwri Monitor IP Address>"/.
Choose a TXSeries server, then you can see the monitor user interface:
Coding, testing, helping to answer questions and making documents are all appreciated. Welcome to contact liurui@lrsolution.com to report defects and tell your suggestions.
-- Liu Rui