$LICENSE_OPTIONS

Set one or more license management options, according to your Sentinel license type.

$LICENSE_OPTIONS {=} Option{, Option}n

where Option is one of:

Defaults

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

Description

Uniface makes use of the Sentinel Rights Management System (RMS) to manage licensing. For more information, see Uniface License Management.

For existing Uniface Enterprise Edition users, it is still possible to use the Uniface Distributed License Manager (DLM) in version 10.3.03. If no Sentinel options are selected, DLM is used by default.

For DLM license configuration, see $LICENSE_OPTIONS (DLM).

Sentinel

The Uniface Community Edition uses the Sentinel Cloud Server for license management. The Uniface Enterprise Edition also supports the Sentinel RMS License Manager (or Server) to enforce and manage licensing in a multi-user environment.

Sentinel relies on the LM_LICENSE_FILE option or environment variables to locate licenses.

License Expiry Notifications

30 days before a license expires, Uniface starts sending warning messages about the upcoming expiration:

  • License for feature FeatureName will expire in nn days.
  • License for feature FeatureName expires today.

By default, these messages are displayed in a dialog box and transcript window (in a desktop application), or in the application's log file.

You can set the length of the notification period for the notification message and the transcript window, or even suppress these messages, using the LM_NOTIFICATION and LM_TRANSCRIPT options. For example:

$LICENSE_OPTIONS=LM_LICENSE_FILE=D:\MyLicenses\myUnifaceLicense.xml, LM_NOTIFICATION=15, LM_TRANSCRIPT=15

If set to 0, no warning messages are sent.

You can customize the messages and the way they are displayed by defining this behavior in the receiveMessage trigger of the application. To instruct Uniface to redirect the notification message to this trigger, set the option LM_NOTIFICATION_POSTMESSAGE. This sends the message as an asynchronous message (postmessage) instead of displaying it in a dialog box.

License Renewal Notifications

By default, 3 days before a Sentinel license lease must be renewed, Uniface starts sending warning messages:

  • Connect to the internet within nn days to renew the lease for license feature FeatureName.
  • Connect to the internet today to renew the lease for license feature FeatureName.

You can set the length of the notification period, using the LM_RENEWAL_NOTIFICATION. If set to 0, no warning messages are sent.

By default, these messages are displayed in a dialog box. You can customize the messages and the way they are displayed by defining this behavior in the receiveMessage trigger of the application. To instruct Uniface to redirect the notification message to this trigger, set the option LM_NOTIFICATION_POSTMESSAGE. This sends the message as an asynchronous message (postmessage) instead of displaying it in a dialog box.

Maintenance Expiry Notifications

A Sentinel license for a Uniface feature may have an maximum release date, which indicates when the maintenance contract expires.

You can turn on warning messages for the maintenance expiry using the LM_MAINTENANCE_NOTIFICATION option. By default, this is turned off.

When turned on, Uniface sends the following messages:

  • The maximum release date for feature X will be reached in nn days. Contact your Uniface sales representative.
  • The maximum release date for feature X has been reached. Contact your Uniface sales representative.

If it is past the maintenance expiry date, Uniface displays the following message:

  • The maximum release date for feature X has been exceeded. Contact your Uniface sales representative.

Note: Uniface continues to work past the maximum release date, but new patches or versions of Uniface cannot be installed.

By default, these messages are displayed in a dialog box and transcript window (in a desktop application), or in the application's log file.

You can set the length of the notification period for the notification message and the transcript window using the LM_MAINTENANCE_NOTIFICATION and LM_TRANSCRIPT options. For example:

$LICENSE_OPTIONS=LM_LICENSE_FILE=D:\MyLicenses\myUnifaceLicense.xml, LM_MAINTENANCE_NOTIFICATION=30, LM_TRANSCRIPT=30

You can customize the messages and the way they are displayed by defining this behavior in the receiveMessage trigger of the application. To instruct Uniface to redirect the notification message to this trigger, set the option LM_NOTIFICATION_POSTMESSAGE, using the $msgdata:UnifaceList property: REASON maintenance or no_more_maintenance. This sends the message as an asynchronous message (postmessage) instead of displaying it in a dialog box.

Options