/ust

Register a client application or Uniface Server under a symbolic name with a Uniface Router.

/ust=SymbolicName

Parameters

  • SymbolicName—a logical client ID for the Uniface client, or UST for the Uniface Server. In combination with the user name, it uniquely identifies the application process. If omitted, use the /ust command line switch to supply the symbolic name.

    The value is a string that can consist of alphanumeric characters, dashes, and underscores.

    Colons, slashes, dots, brackets, and so on, are not allowed.

Description

For a Uniface client application, the only reason to register with the Uniface Router is to be able to receive postmessages. The combination of user name and symbolic name must be unique; otherwise, the registration will fail.

For an automatically-started Uniface Server, the Uniface Router appends this qualifier to the userver command line when it starts the server. The Uniface Server registers with the Uniface Router to let the Uniface Router know that the startup was successful, that it is available to handle client requests, and that it can receive postmessages.

Once an application or Uniface Server is registered under a client ID or UST, it cannot change its registration.

If a Uniface Server is started manually, /dnp and/or /ust must be supplied on the command line. For more information, see Starting Uniface Servers.

It can also be used to register a started server with another remote Uniface Router.

Server Registration

Use the /ust switch on the command line of a manually-started Uniface Server to register it with the Uniface Router. This enables the Uniface Router to route client requests to this Uniface Server and start additional instances of this server.

If it is omitted, and the UST is not defined in the [SERVERS] section of the Uniface Router assignment file, the Uniface Router uses the default UST definition. If this is not specified, the server will be started with all the normal default settings.

Example: Server Registration

The following example demonstrates starting a Uniface server manually and registering it with the Uniface Router. The /ust command line switch specifies the server name HOME, for which several switches are specified in the Router’s assignment file urouter.asn.

Windows

On the command line: 

userver.exe /ust=HOME

In urouter.asn: 

[SERVERS]
default = c:\usys82\userver.exe /max=10 /maxidle=2h
HOME = c:\usys82\userver.exe /asn=home\home.asn /dir=c:\usys82\project
Unix

On the command line: 

userver /ust=HOME

In urouter.asn: 

[SERVERS]
default = /usys82/userver /max=10 /maxidle=2h
HOME = /usys82/userver /asn=/home/home.asn /dir=/usys82/project

Client Registration

Use the /ust switch on the command line of a Uniface client application to register the client with the Uniface Router. The Uniface Router requires this information to route messages to client applications.

Note:  The client ID in the /ust switch overrides the client ID provided in $DNP, if any.

Examples: Client Registration

The following example starts a Uniface application using the /ust command line switch, which registers the Uniface client with the Uniface Router.

Windows : uniface.exe /ust=unikees appl.aps

Unix: uniface /ust=unikees appl.aps

Related Topics