ITListener.pl

Use the ITListener.pl script to listen to messages being passed between processes on the message bus.

Usage

Many Network Manager processes communicate through a message bus. For example, ncp_model broadcasts topology updates on the message bus. Each process broadcasts on a different subject. For example, ncp_model broadcasts on the subject MODEL. The ITListener.pl script listens to messages on the message bus and prints them to screen.

Listening for topology change notifications

The following example command line listens for topology change notifications on the NCOMS domain.

$NCHOME/precision/bin/ncp_perl $NCHOME/precision/scripts/perl/scripts/ITListener.pl -domain NCOMS -process Model -messageClass NOTIFY

Listening for updates from DNCIM to NCIM

The following example listens for updates from the discovery database DNCIM to the NCIM database.

$NCHOME/precision/bin/ncp_perl $NCHOME/precision/scripts/perl/scripts/ITListener.pl -domain NCOMS -process DNCIM2NCIM -messageClase NOTIFY

Listening for Network Manager status events

The following example listens for events regarding the status of the Network Manager product.

$NCHOME/precision/bin/ncp_perl $NCHOME/precision/scripts/perl/scripts/ITListener.pl -domain NCOMS -process ITNMSTATUS -messageClass NOTIFY

Command-line options

The following table describes the command-line options for the script.

Table 1. ITListener.pl command-line options
Command-line option	Description
-debug `debug`	The level of debugging output (0-4, where 4 represents the most detailed output).
-domain `DomainName`	Mandatory. The discovery domain on which to listen.
-help	Displays the command line options. Does not start the component even if used in conjunction with other arguments.
-subject	The specific subject to listen to. If you specify a subject, the -domain argument is ignored, and the script listens on all domains. If you specify a subject you do not need to specify a messageClass and process. All subjects begin `\'ITNM/\'` and have the domain appended. For example, the ncp_model notify subject for domain `TESTDOMAIN` is `/ITNM/MODEL/NOTIFY/TESTDOMAIN`.
-process	The process to listen to. Valid options are: Model - ncp_model Class - ncp_class Config - ncp_config Ctrl - ncp_ctrl Disco - ncp_disco PingFinder - ncp_f_ping ITNMSTATUS - status events DNCIM2NCIM - events passed from the DNCIM discovery database to the NCIM database If you specify a messageClass and process you do not need to specify a subject.
-messageClass	The class of messages to listen for. Not all processes support all classes. Classes are: NOTIFY QUERY STATUS If you specify a messageClass and process you do not need to specify a subject.