Event Management Commands › catrapd-Control the catrapd Daemon › Start the catrapd Daemon

Start the catrapd Daemon

Enterprise Management starts and stops catrapd if catrapd was activated during installation.

Valid on Windows

To activate catrapd

1. Click Configuration/Settings in the Enterprise Management folder.
2. Click the Component Activation Tab.
3. Set the SNMP Trap Server Activated (CAIACTRPTSV) option to Yes.

If catrapd is activated on a node where a network manager is active, catrapd automatically detects and interfaces to the manager provided that the network manager was specified during the SNMP component installation and the network manager was started before catrapd was activated. Any received trap is unpacked (decoded) and sent to the Event Management console log where it is recorded. At the console log, the trap is also available for subsequent automatic mapping, interpretation, and action processing as defined by your Event Management policies.

Valid on UNIX/Linux, z/OS

If catrapd is activated on a node that does not have a network manager or when the network manager is not active, catrapd connects directly to the internet service port designated for SNMP-trap (for z/OS, port 161 is customarily used by catrapd to listen for traps). Whatever the number of the port assigned, the protocol for the internet service port must be defined as UDP.

The usual way to start catrapd on zOS is by using the command:

unicntrl start snmp

Uncomment this line in the $CAIGLBL0000/opr/scripts/emstart script in order to start catrapd when the other Event Management components are started.

The catrapd daemon makes use of the system call getservbyname() to determine the actual port number to use. If this service has been modified, catrapd may not be able to locate the correct port. Most operating systems with TCP/IP support use an /etc/services file, which can be consulted to determine the port number reserved for the SNMP trap on that machine. On z/OS the TCP/IP stack's PROFILE file usually contains information on reserved ports. If port 161 is unavailable, you may choose a different port and update file $CAIGLBL0000/snmp/scripts/envset to point to the chosen port as follows:

# port number to listen on

CAICATD00001=9161

export CAICATD0001

Example

As an example, the catrapd daemon receives a trap and presents it to the Event Management function in the following format:

.CATD_I_060 SNMPTRAP:  -c  public  Computer.Associates 999.999.9.999 xyzlhu33 6 1 00:00:00 1 OID: 1.3.6.1.4.1.791.1.4 .iso.org.dod.internet.private.enterprises.791.1.4 VALUE: hello world

Within the Event Management function of Enterprise Management, this message is divided into character "tokens," which can be tested individually or in combination with one another as part of user-defined Event Management policies. The message in the preceding example has 17 tokens. The tokens are: