Options File Syntax

The following is an overview of the available options. See Options File Examples for examples and additional information. Each line of the file controls one option.

Option Keywords

Option Keyword	Description
AUTOMATIC_REREAD	Turn off automatic reread of licenses at midnight.
ACTIVATION_LOWWATER	Controls the number of licenses that cannot be borrowed or transferred.
ACTIVATION_ EXPIRY_DAYS	Controls the activation request based on the expiration dates mentioned in options file during activation.
BORROW_LOWWATER	Set the number of BORROW licenses that cannot be borrowed.
DAEMON_SELECT_TIMEOUT	Define the vendor daemon’s timeout limit.
DEBUGLOG	Write debug log information for this vendor daemon to the specified file (version 8.0 or later vendor daemon).
EXCLUDE	Deny a user access to a feature.
EXCLUDE_BORROW	Deny a user the ability to borrow BORROW licenses.
EXCLUDE_ENTITLEMENT	Deny a user the ability to activate licenses held in a fulfillment record in trusted storage.
EXCLUDEALL	Deny a user access to all features served by this vendor daemon.
EXCLUDEALL_ENTITLEMENT	Deny a user the ability to activate all licenses held in a fulfillment record in trusted storage.
FQDN_MATCHING	Set the level of host name matching.
GROUP	Define a group of users for use with any options.
GROUPCASEINSENSITIVE	Set case sensitivity for user lists specified in GROUP keywords.
HOST_GROUP	Define a group of hosts for use with any options (version 4.0 or later).
INCLUDE	Allow a user to use a feature.
INCLUDE_BORROW	Allow a user to borrow BORROW licenses.
INCLUDE_ENTITLEMENT	Allow a user to activate licenses held in a fulfillment record in trusted storage.
INCLUDEALL	Allow a user to use all features served by this vendor daemon.
INCLUDEALL_ENTITLEMENT	Allow a user to activate all licenses held in a fulfillment record in trusted storage.
LINGER	Allow a user to extend the linger time for a feature beyond its check in.
MAX	Limit usage for a particular user/group—prioritizes usage among users.
MAX_BORROW_HOURS	Change the maximum borrow period for the specified feature.
MAX_CONNECTIONS	Configures the maximum number of connections to the vendor daemon at any point in time.
MAX_OVERDRAFT	Limit overdraft usage to less than the amount specified in the license.
NOLOG	Turn off logging of certain items in the debug log file.
REPORTLOG	Specify that a report log file suitable for use by the FlexNet Manager license usage reporting tool be written.
RESERVE	Reserve licenses for a user or group of users/hosts.
TIMEOUT	Specify idle timeout for a feature, returning it to the free pool for use by another user.
TIMEOUTALL	Set timeout on all features.

Comments

Include comments in your options file by starting each comment line with the hash symbol, #.

Specifying Features

When used within an options file entry, the feature name can be modified with an optional keyword-value pair to fully qualify it. This notation is used for distinguishing a particular group of licenses when there are multiple FEATURE lines for a single feature. The following syntax is used:

feature:keyword=value

For example:

f1:VERSION=2.0

specifies the version 2.0 pool of licenses for feature f1.

The following option keywords are used as feature name modifiers to denote a specific group of licenses:

•

VERSION=

•

HOSTID=

•

EXPDATE=

•

ENTITLEMENT= (to be used only with the keywords INCLUDE or EXCLUDE)

•

KEY=

•

SIGN=

•

ISSUER=

•

NOTICE=

•

VENDOR_STRING= (if configured by the publisher as a pooling component)

•

dist_info=

•

user_info=

•

asset_info=

If the USER_BASED or HOST_BASED keywords appear in a FEATURE line, this feature specification syntax must be used to qualify the feature.

Using a package name in place of a feature name applies the option to all of the components in the package.

Note:A colon (:) is a valid feature name character. If colons are in your feature names, specify a group of licenses with the following alternative syntax using quotation marks and spaces:
           "feature keyword=value"

Specifying License Restrictions Using Type

Some option keywords restrict who may use licenses or where licenses may be used. These options take a type argument that specifies what the restriction is based on.

When using the option keywords EXCLUDE, EXCLUDE_ENTITLEMENT, EXCLUDEALL, EXCLUDEALL_ENTITLEMENT, EXCLUDE_BORROW, INCLUDE, INCLUDE_ENTITLEMENT, INCLUDEALL, INCLUDEALL_ENTITLEMENT, INCLUDE_BORROW, MAX, and RESERVE, the following values can be used for type:

•

USER—User name of the user executing the FlexEnabled application. User names are case sensitive and cannot contain spaces.

For the MAX option, you can also specify ALL_USERS as a value for the USER type. See MAX for details.

Note:For all the option keywords except MAX, The ALL_USERS value for the USER type is not supported.

•

GROUP—Name of the group of users executing the FlexEnabled application. (Before you can restrict an option by a specific group, the options file must also include a GROUP option that defines the group.)

For the MAX option, you can also specify ALL_GROUPS as a value for the GROUP type. See MAX for details.

•

HOST—System host name or IP address where the application is executing. Host names are not case sensitive. The IP address can contain wildcard characters.

When using the option keywords EXCLUDE, EXCLUDEALL, EXCLUDE_BORROW, INCLUDE, INCLUDEALL, INCLUDE_BORROW, MAX, and RESERVE, the following values can be used for type:

•

DISPLAY—Display where the application is displayed. On UNIX, DISPLAY is /dev/ttyxx (which is always /dev/tty when an application is run in the background) or the X-Display name. On Windows, it is the system name or, in the case of a terminal server environment, the terminal server client name. Display names are case sensitive.

•

INTERNET—IP address of the system where the application is executing.

•

PROJECT—LM_PROJECT environment variable set by the user who is executing the FlexEnabled application. Project names are case sensitive. See Environment Variables, for more information about this variable.

On Windows (without terminal server), the HOST and DISPLAY names are both set to the system name. For licenses that allow checkouts from a terminal server (TS_OK keyword in the FEATURE line), the USER, HOST, and DISPLAY names can be different from one another.

The types listed above take a single member. For example:

EXCLUDE coolsoft USER joe

To specify a list of users or hosts, first define the list using the GROUP or HOST_GROUP option lines, then use the GROUP or HOST_GROUP type to specify the group name. For example:

GROUP stars joe barbara susan
EXCLUDE coolsoft GROUP stars

Note:Changes in the Options file:

•

IP address as a HOST specification introduced in version 8 vendor daemon.

•

Colons in feature names introduced in version 8 vendor daemon.