Set options for the Distributed License Manager (DLM).
LM_LICENSE_FILE—specifies one or more locations, separated by semicolons (;), where the DLM is to check the Uniface licenses. These locations can include a local license file, license server, or both. The complete path to the file or DLM License Server must be provided.
Note: The values for LocationList are case sensitive. If the path to a local license file contains embedded spaces, the path name must be surrounded by quotation marks.
For a DLM License Server, the format is Port
@Host, for example,
If you use DLM 9.2 or higher, you can specify the IP version of the license server as Port
#4for IPv4 or Port
If the IP version is omitted, the client tries to connect with the license server over IPv4 first, and if that fails over IPv6. If the license server listens on IPv6, adding
#6ensures that a connection is made one or two seconds faster because no attempt is made to first try IPv4. The faster connection could be important for Uniface Servers.
LM_NOTIFICATION—when the application starts, displays a license expiration message in a dialog (which the user must confirm), starting the NumberOfDays before the date the license expires.
LM_TRANSCRIPT—when the application starts, displays a license expiration message in the transcript window (and log file), starting the NumberOfDays before the date the license expires.
- NumberOfDays—any value from
0(license expiration message is never displayed) through to
100. If omitted or set to a value less than
0, the default value of
30is used. If set to a value greater than
100, the maximum value of
100is used. Any other value generates an error message and informs the user that the value will be set to the default.
LM_LOAD—attempt to load the DLM DLLs from the specified location:
uniface—load from the \common\bin directory in the Uniface installation
dlm—load from the DLM installation directory
HEARTBEAT_INTERVAL—the frequency with which a client application notifies the DLM license server that a license is still in use. The interval can be from 15 to 300 seconds. If not set, the default is 300.
application assignment files
If specified, this assignment file setting
overrides the similar setting (except
HEARTBEAT_INTERVAL) specified in the DLM. The DLM appends the setting to its license
The implementation of DLM for Uniface does not support the following:
- Remote license administration
- Rolling trial license
For more information on functionality for redundant or multiple license servers, see the DLM License Installation Guide.
License Expiry Notification
By default, when a Uniface license will expire
within 30 days, a dialog is displayed when the application starts, informing the user that the
license will soon expire. The message is also displayed in the transcript window (and log file).
You can control where and for how long this notification is displayed using the
To turn off the notification entirely, set both
$LICENSE_OPTIONS=LM_LICENSE_FILE=7188@DLMserver, LM_NOTIFICATION=0, LM_TRANSCRIPT=0
When using a DLM license server, the Uniface application notifies the license server at regular intervals that checked out features are still in use. This is known as the heartbeat. If a heartbeat notification is not received by the license server within that time, it checks in the license, making it available for other applications. By default, the heartbeat interval is set to 300 seconds (5 minutes), but you can set it to as little as 15 seconds. Setting it to a shorter interval enables an application to be restarted more quickly if it crashes, but increases the network and server load.
You can use $LICENSE_OPTIONS to set the
HEARTBEAT_INTERVAL in the Uniface application's assignment file, but you should do this only if you have multiple Uniface applications and you do not want all of them to use the same heartbeat interval.
You can set the heartbeat interval for all Uniface applications in the DLM client's config.xml file. For more information, consult the DLM documentation.
Note: If the heartbeat interval is set in the DLM client's config.xml file, the setting in the assignment file is ignored.
In the following example, both a local license file and a license server are specified. In addition, the default license expiry notification (in a dialog) is turned off and the message is added to the transcript window, starting 15 days before the license expires. The frequency with which the application notifies the license server that a license is checked out is set to 1 minute.
$LICENSE_OPTIONS=LM_LICENSE_FILE="c:\DLM\license.xml";7188@DLMserver, LM_NOTIFICATION=0, LM_TRANSCRIPT=15, HEARTBEAT_INTERVAL=60