Configuring the Uniface Router

To configure the Uniface Router, you need to edit its assignment file, where you can define the Uniface Servers that the Uniface Router can start, and their configuration parameters.

To configure the Uniface Router on iSeries, you need *ALLOBJ and *JOBCTL privileges for starting and stopping the subsystem

The default assignment file is urouter.asn, located in the common\adm directory of the Uniface installation.

On iSeries, the assignment file is member UROUTER of physical file ASN in the installation library

  1. In the [SERVERS] section of the Uniface Router assignment file, define the Uniface Server Types (USTs) for the Uniface Servers to be accessed by the Uniface Router.

    Each UST identifies a specific Uniface Server configuration that can be used to start Uniface Servers. For more information, see Uniface Server Types (UST) and [SERVERS].

    For example:

    SRV1 = "c:\Uniface\common\bin\userver.exe" /asn=\usr\sales\sales.asn /maxreq=100
  2. Optionally, in the [PRE_START] section, define Uniface Servers that the Uniface Router should automatically start when the Uniface Router itself is started.

    For more information, see [PRE_START].

  3. Configure the default listener port and constraints.

    The Uniface Router listens on up to four ports, which can be specified on the command line used to start the Uniface Router. A port is specified by its network protocol, the Host ID and the port number, including an optional TLS connection profile. If no port is specified on the command line, or if a part of a definition is omitted, the Uniface Router will use the $DEFAULT_NET assignment file setting to determine the missing value.

    Note:  During Uniface installation, the value for the Uniface Router port is set in $DEFAULT_NET.

    1. If you want to change the Uniface Router port that was specified during installation, change the $DEFAULT_NET assignment setting.

      $DEFAULT_NET only allows you to specify one port number. For example, to change the port number to 14002:

      $DEFAULT_NET = +14002|||

      Note:  Ensure that the port number is also changed in path assignments in any assignment files that map database paths across the network.

      For more information, see $DEFAULT_NET.

    2. Optionally, in the [SETTINGS] section, specify the default settings to constrain the number of clients, Uniface Servers, and Uniface Router Monitors.
  4. Configure the Uniface Router for asynchronous messages.

    For each message arriving at the Uniface Router, it makes a new TCP connection and a new thread to handle that connection. If servers are slow or there is a high volume of messages, it can be useful to change some configuration settings. For more information, see Asynchronous Messaging.

    1. To prevent the Uniface Router from running out of system resources, use the $USE_PMQ setting.

      This causes the Uniface Router to create a queue for each target application. Messages are deposited in the queue and the connection and handling thread are quickly released. Messages are then forwarded from the queue to the target application at the rate that it can read them.

    2. To ensure that TCP sockets close instantly without going to the TIMED_WAIT state, use the TCP connector option nl (no linger).

      USYS$TCP_PARAMS = nl

      This can be useful when there is a high volume of messages.

  5. On Windows, you can install multiple Uniface Routers. For more information, see Install a Uniface Router on Windows.
  6. On Windows and Unix, you can change the way the Uniface Router recovers from unexpected failure. For more information, see Configure Uniface Router Recovery.
  7. Save your changes and restart the Uniface Router. For more information, see Stop and Start the Uniface Router.

Related Topics