$LICENSE_OPTIONS

Set options for the Distributed License Manager (DLM).

$LICENSE_OPTIONS {=} {LM_LICENSE_FILE=LocationList} {,} {LM_NOTIFICATION=NumberOfDays} {,} {LM_TRANSCRIPT=NumberOfDays}{,} {LM_LOAD=uniface | dlm} {,} {HEARTBEAT_INTERVAL=Seconds}

Arguments

  • 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, 7188@license1.mycomp.corp.

    Optionally, you can specify the IP version of the license server as Port@Host#4 for IPv4 or Port@Host#6 for IPv6.

    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 #6 ensures 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 30 is used. If set to a value greater than 100, the maximum value of 100 is 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.

Defaults

Assignment file: application assignment files
Section: [SETTINGS]
Default value: None

Description

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 configuration file.

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 LM_NOTIFICATION and LM_TRANSCRIPT options.

To turn off the notification entirely, set both LM_NOTIFICATION and LM_TRANSCRIPT to 0. For example:

$LICENSE_OPTIONS=LM_LICENSE_FILE=7188@DLMserver, LM_NOTIFICATION=0, LM_TRANSCRIPT=0

DLM Heartbeat

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.

$LICENSE_OPTIONS

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

Uniface Logo A

Send feedback about this topic to Uniface.