Assignment file for the Uniface Router. You can use the urouter.asn file to specify settings, paths to connectors, and Uniface Server environment definitions, such as USTs.

Default location: UnifaceAPSInstallDir\common\adm

File Sections

The assignment file typically contains the following file sections:

Assignment Settings

The [SETTINGS] section can include the following assignment settings:

UST Switches

UST definitions in the [SERVERS] section can include (but are not limited to) the following command line switches:

These switches can only be set on UST definitions. They cannot be set on the command line of a Uniface Server that is started manually. All switches can start with either / or -.

Example: Typical urouter.asn

This example shows a typical urouter.asn file. The [SETTINGS] and [SERVERS] sections demonstrate the following:

  • USTs (server names) of several Uniface servers, including the default server default, to be used if none is specified by the client.
  • The /ex switch used with the /gates switch. The UST PAYROLL example specifies that, for an exclusive connection requested by the client to the Uniface Server, the port selected for the connection should be in the range 3800 to 3999 (/gates)
  • Working directories (/dir)
  • Assignment files (/asn)
  • Maximum Uniface Application Server instances allowed ($MAXSERVERS and /max)
  • Maximum Uniface Router Monitor instances allowed ($MAXMONS)
  • Maximum requests that can be executed (/maxreq). In a development environment only, maxreq should be set to 1. If this is not done, you will always see the old HTS file.
  • Maximum idle time (/maxidle)
  • When a cloud-served standalone license is configured, $LICENSE_OPTIONS is set to configure the Uniface Router to download the cloud-served license. To disable this in cloud-served environments, remove this setting entirely, or point it to the lservrc file.

Example: Windows

$putmess_log_file = urouter.log
; number of Uniface Application Servers allowed
; number of Uniface Router Monitors allowed

DEFAULT = userver.exe /maxidle=2h /dir=..\home\guest
SALES = userver.exe /max=10 /asn=..\usr\local\sales\asv.asn /dir=..\home\kees
HR = userver.exe /max=50 /maxreq=100 /asn=..\usr\local\hr\asv.asn
PAYROLL = userver.exe /ex /gates=3800-3999 /asn=..\usr\secure\payrollasv.asn

Example: Unix, iSeries

$putmess_log_file = urouter.log
; number of Uniface Application Servers allowed
; number of Uniface Router Monitors allowed

DEFAULT = userver -maxidle=2h -dir=/home/guest
SALES = userver -max=10 -asn=/usr/local/sales/asv.asn -dir=/home/kees
HR = userver -max=50 -maxreq=100 -asn=/usr/local/hr/asv.asn
PAYROLL = userver -ex -gates=3800-3999 -asn=/usr/secure/payrollasv.asn

Related Topics