/
OMS_SERVERS - UAG configuration option

OMS_SERVERS - UAG configuration option

Mar 31, 2025

Description

The OMS_SERVERS option specifies the port and network address of the Universal Message Service (OMS) server(s) used for network communication.

Info

You can override this option through a UBROKER command line argument or environment variable. See UAG_OMS_SERVERS - UBROKER Configuration Option.

Usage

Method

Syntax

IBM i

UNIX

Windows

z/OS

Configuration File Keyword

oms_servers port@host[:sni][,port@host[:sni]...]

(tick)

(tick)

(tick)

(tick)

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.

sni is the TLS SNI Hostname to be sent in the TLS ClientHello packet. The value is optional. If not specified, the TLS SNI extension is not included in the TLS ClientHello packet. If TLS SNI Hostname is specified, the Agent will not be able to connect to OMS Servers of versions lower than 7.8.0.0.

Note

If TLS SNI is specified on a z/OS Agent that is configured to use SystemSSL, then only one host can be configured.

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 failover.