IBM Enterprise Console User Manual

Page 112

Advertising
background image

The default value is @EventServer.

You can specify multiple server names as a comma-delimited list.
Server names later in the list can be backups for times when the
gateway cannot contact its primary server for an event and the
RetryInterval

has expired without successfully contacting the

primary server. You can specify a host name as you would for a
non-TME adapter, and the events are then forwarded to that host
using the non-TME Tivoli Event Integration Facility. For more
details, see the examples in the ServerPort description.

When the gateway cannot contact the adapter-specified event
server, the server names specified in the list are backups. If
ServerLocation

is not present in the gateway configuration file, the

backup functionality uses the default @EventServer value.

To prevent event delivery to backup servers, set the
ServerLocation

keyword to NONE.

ServerPort

Specifies the port for the event server when sending events using
the non-TME Tivoli Event Integration Facility. This keyword is
ignored if you are not using the non-TME Tivoli Event Integration
Facility.

The default value is zero (0). A value of zero tells the non-TME
Tivoli Event Integration Facility to contact the portmapper on the
specified host to determine where the event server is listening for
incoming event. Note that if you are forwarding events to a Tivoli
Availability Intermediate Manager, you cannot specify zero (0) as
the port because the Tivoli Availability Intermediate Manager does
not register itself with the portmapper.

If you specify a value for ServerPort, the value must be either one
integer value or a comma-delimited list containing the same
number of values as the list of event servers specified in
ServerLocation

. You can use one integer value to apply to all of

the event servers listed in ServerLocation; otherwise, each event
server in ServerLocation requires a corresponding value in
ServerPort

.

The following example shows how to specify multiple server
names to use backup servers in case the primary server fails to
receive events. Suppose you have a Tivoli Availability Intermediate
Manager running on hosts aim.xyz.com and aimbkup.xyz.com, and
ServerLocation

and ServerPort are specified as follows:

ServerLocation=aim.xyz.com,aimbkup.xyz.com,@EventServer
ServerPort=5530,5531,0

This sends events to port 5530 on the host aim.xyz.com using the
non-TME Tivoli Event Integration Facility. If that fails, events are
sent to port 5531 on the host aimbkup.xyz.com. If that also fails,
events are sent directly to the event server using the TME Tivoli
Event Integration Facility. The port value of zero (0) specified for
@EventServer is ignored because port numbers are not needed
with the TME Tivoli Event Integration Facility.

100

IBM Tivoli Enterprise Console: Adapters Guide

Advertising