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

  1. In the WebSphere administrative console, expand the Resources list.
  2. Click JMS Provider > Generic.
  3. Select the scope of the resources to be the node, choosing the node on which the EIF WebSphere JMS Provider is installed.
  4. 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