Configuring JMS Provider
During installation, a Generic JMS Provider resource is created for
the EIF WebSphere JMS Provider at the scope of node on which the EIF WebSphere JMS Provider is
installed. You can view and modify the configuration of the EIF WebSphere JMS Provider resources using the WebSphere administrative console.
To see the EIF WebSphere JMS Provider configuration details, follow these steps
- In the WebSphere administrative console, expand the Resources list.
- Click JMS Provider > Generic.
- Select the scope of the resources to be the node, choosing the node
on which the EIF WebSphere JMS Provider is installed.
- You should see the resource 'EIF JMS Provider' listed.
To see the JMS destination details of the provider, click 'EIF JMS
Provider' >JMS destinations. You should see the resource 'TEC Queue'
with JNDI name 'jms/eif/TECQueue' listed.
To see the JMS connection factory details of the provider, click 'EIF
JMS Provider'>JMS connection factories. You should see the resource
TECQueueConnectionFactory with JNDI name
'jms/eif/TECQueueConnectionFactory' listed. The transport of events to
the Enterprise Console server is configured by specifying values
for Custom Properties of the JMS connection factory. The following
sections explain the details of the properties.
- ServerLocation
- Specifies the name of the host on which the event server or Tivoli
Enterprise Console gateway is installed. The value of this property
must be hostname or IP_address of the event server.
The ServerLocation keyword can contain up to eight values, separated
by commas. The first location is the primary event server, while others
are secondary servers to be used in the order specified when the
primary server is down.
- ServerPort
- Specifies the port number on which the event server or Tivoli
Enterprise Console gateway listens for events. Set this keyword value
to 0, the default value, unless the portmapper is not available on the
event server, which is the case if the event server is running on a
Microsoft Windows system or the event server is a Tivoli Availability
Intermediate Manager (see the following note). If the port number is
specified as zero (0) or it is not specified, the port number is
retrieved using the portmapper.
-
Note:
Portmapper is not supported for reception of
events from EIF WebSphere JMS Provider at the Enterprise Console gateway.
If you are sending events to this gateway, then you must specify the
ServerPort property to match the value in the gwr_ReceptionPort keyword
in the Enterprise Console gateway configuration file.
The ServerPort property can contain up to eight values, separated by
commas. For sending events to a UNIX event server, use the default
value of 0 (only one value of 0, even if multiple UNIX event servers
are specified with the ServerLocation keyword). For sending events to a
Windows event server or a Tivoli Availability Intermediate Manager,
specify one value for each event server defined with the ServerLocation
keyword.
Note:
If the event server is
running on Windows operating system: There is no portmapper
daemon on a Windows system that allows the EIF WebSphere JMS Provider to query the
reception port at run time. The event server listens on a fixed
reception port (tec_recv_agent_port in .tec_config file) for connection
and event input. Set the ServerPort property to the value of the
tec_recv_agent_port entry in the .tec_config file in the
$BINDIR/TME/TEC directory. The default value is 5529. The Tivoli
Availability Intermediate Manager never uses the portmapper; the Tivoli
Availability Intermediate Manager server listens on a fixed port set in
the Tivoli Availability Intermediate Manager graphical user interface.
- BufferEvents
- Specifies whther event buffering is enabled. Valid values are YES
and NO.
- YES
- Stores events in the file specified by the BufEvtPath keyword.
- NO
- Does not store or buffer events.
The value is not case-sensitive. The default value is NO.
- BufEvtPath
- Specify the full path name of the cache file.This is a required
property when the BufferEvents property is set to YES. The default
value is /tmp/<connection factory name>.cache
- LogLevel
- Specifies whether the EIF WebSphere JMS Provider API generates log messages or
not. By default, no messages are generated. Specify ALL
to generate messages. If you specify any other value or no value, the
messages are not generated.
- LogFileName
- Specifies the full path name of the log file for the event
forwarder. The default location for the file is /tmp/<connection
factory name>.log.
- TraceLevel
- Specifies the full path name of the trace file for the Event
Converter. The default location for the file is /tmp/<connection
factory name>.trace.
- TraceFileName
- Specifies whether the EIF WebSphere JMS Provider API generates trace messages
or not. By default, no messages are generated. Specify ALL
to generate messages. If you specify any other value or no value, the
messages are not generated.
Reference
Configuring event group
Configuring EIF WebSphere JMS Provider using
script
Related topics
Changing the forwarding Tivoli
Enterprise Console Server
Selecting the events to forward
Enabling event buffering
Forwarding events to multiple
servers
Modifying the scope of configuration
Modifying Enterprise
Console event class definitions
Parent topic
Administering the EIF WebSphere JMS Provider