Description
The UAG_OMS_SERVERS option specifies values to override the Universal Agent's port and network address of the Universal Message Service (OMS) server(s) used for network communication, as specified in the OMS_SERVERS UAG configuration option.
Usage
Method | Syntax | IBM i | UNIX | Windows | z/OS |
| Command Line | -uag_oms_servers port1@host1[,port2@host2...] |
|
| ||
| Environment Variable | UAGOMSSERVERS= port1@host1[,port2@host2...] |
|
Values
port is the TCP port on which the OMS server is listening. The default is 7878.
host is the host name or IP address of the OMS server.
Example
ubroker -uag_oms_servers 7878@hal90000.com;7878@sal90000.com
OMS Failover Configuration
OMS servers may be deployed in a High Availability (HA) cluster, in which there are two or more OMS servers. An HA cluster has one active OMS server and one or more inactive OMS servers. When the active OMS server fails, one of the inactive OMS servers becomes the new active OMS server. UAG will automatically failover to the new active member of the HA cluster.
An OMS server HA cluster is specified as a comma-separated list of OMS servers, where each OMS server specified in the list is a member of the same HA cluster. UAG will connect to the first OMS server in the list. If that OMS server connection fails, UAG will attempt to connect to the next OMS server in the list, and so on, until it has successfully connected. The first OMS server in the list is should be considered the primary OMS server and subsequent OMS servers in the list are backup OMS servers.
Do not specify OMS servers in the comma-separated list that are not part of the same HA cluster, otherwise OMS messages may be lost in the case of fail over.