Define licensing policies

The administrator can define a licensing policy by writing rules that allow, restrict or forbid license actions to particular entities.

BORROW_LOWWATER Command

This rule sets the number of licenses that cannot be borrowed for a given application. The purpose of the command is to guarantee that there is always a pool of licenses that are available for online users. The syntax of the command is:

BORROW_LOWWATER product_code type list num_lic

Examples of the command are:

BORROW_LOWWATER 500 * * 1

This command sets one license for the application with product code 500 that no entity can borrow.

BORROW_LOWWATER 200 GROUP Operators 5

This command sets five licenses for the application with product code 200 that no member of the group Operators can borrow.

EXCLUDE Command

This rule prohibits one or more entities from using the license.

The EXCLUDE command overrides the INCLUDE command. If an entity appears in both INCLUDE commands and EXCLUDE commands for a given license, the entity is prohibited from using the license. The syntax of the command is:

EXCLUDE product_code type list

Examples of the command are:

#First Define the group engineers

GROUP engineers cynisca thais Stephen.Gordon

#

#Prevent the users cynisca, thais and Stephen.Gordon from

# using the PRO/II license from any computer on the network.

EXCLUDE 500 GROUP engineers

#

#Prevent the user Jerghiz.Khan from using the PRO/II license

# from any computer on the network.

EXCLUDE 500 USER Jerghiz.Khan

#

#Prevent any user logged in to a host with an IP address in the

# range 123.123.123.0 through 123.123.123.255 from using the

# license for the application with the code 200.

EXCLUDE 200 HOST 123.123.123.*

In this example, the two EXCLUDE statements combine to create a list of four users who are forbidden to use the PRO/II license.

These commands together allow all other users, as long as they are not on the excluded IP addresses, and they are not a member of the engineers group, and they are not Jerghiz.Khan, to use the PRO/II license.

The administrator might have added Jerghiz.Khan to the group engineers, and then would not have had to write a separate rule for Jerghiz.Khan. However, the administrator may want to write a rule that applies to cynisca, thais and Stephen.Gordon but not to Jerghiz.Khan. To allow this, the license administrator chose to handle Jerghiz.Khan as a special case.

EXCLUDEALL Command

This rule prohibits one or more entities from using any licenses that this license server handles. The EXCLUDEALL command overrides the INCLUDEALL command. If an entity appears in both INCLUDEALL commands and EXCLUDEALL commands for a given license, the entity is prohibited from using the license. The syntax of the command is:

EXCLUDEALL type list

Examples of the command are:

EXCLUDEALL USER Walladah.alMustakfi

This command prohibits the user Walladah.alMustakfi from using any licenses that this license server handles.

EXCLUDEALL HOST chaos

This command prohibits any user on the computer chaos from using any licenses that this license server handles.

EXCLUDEALL HOST_GROUP zombies

This command prohibits any user on any computer in the host group zombies from using any licenses that this license server handles.

EXCLUDE_BORROW Command

This rule prohibits one or more entities from borrowing licenses for a given product. The EXCLUDE_BORROW command overrides the INCLUDE_BORROW command. If an entity appears in both INCLUDE_BORROW commands and EXCLUDE_BORROW commands for a given license, the entity is prohibited from borrowing the license. The syntax of the command is:

EXCLUDE_BORROW product_code type list

An example of the command is:

EXCLUDE_BORROW 500 USER Celestina.Giulia Junko.Kamishima

This command prohibits the users Celestina.Giulia and Junko.Kamishima from borrowing licenses for the application with product code 500. These users can still use the application through online licenses.

INCLUDE Command

This command allows an entity to request licensing actions for an application. An entity that does not appear in an INCLUDE statement is not allowed to request licensing actions for the application.

The EXCLUDE command overrides the INCLUDE command. If an entity appears in both INCLUDE commands and EXCLUDE commands for a given license, the entity is prohibited from using the license. The syntax of the command is:

INCLUDE product_code type list

Examples of the command are:

INCLUDE 500 USER Grace.Makutsi Aigong.Chen

This command allows the users Grace.Makutsi and Aigong.Chen to request licensing actions for the application with product code 500.

INCLUDE 500 USER Freyja.Njörðrsdottir

INCLUDE 500 GROUP Trainers

INCLUDE 500 HOST HongMao

These three commands allow the user Frejya.Njororsdottir to use the PRO/II license from any computer on the network, allow all members of the user group Trainers to use the PRO/II license from any computer on the network, and allow all users logged in to the host computer HongMao to use the PRO/II license. At the same time, these commands deny the use of the PRO/II license to everyone who is not Frejya.Njororsdottir and not a member of group Trainers and not logged in to host HongMao.

INCLUDEALL Command

This command allows an entity to use all licenses that this license server handles. The EXCLUDEALL command overrides the INCLUDEALL command. If an entity appears in both INCLUDEALL commands and EXCLUDEALL commands for a given license, the entity is prohibited from using the license. The syntax of the command is:

INCLUDEALL type list

Examples of the command are:

INCLUDEALL USER jane.eyre

This command allows the user jane.eyre to request licensing actions for any application that this license server handles.

INCLUDEALL HOST_GROUP DrillSites

This command allows all users on all hosts in the host group DrillSites to request licensing actions for any application that this license server handles.

INCLUDE_BORROW Command

This rule allows one or more entities to borrow licenses for a given product. An entity that does not appear in an INCLUDE_BORROW statement may not borrow licenses for the application.

The EXCLUDE_BORROW command overrides the INCLUDE_BORROW command. If an entity appears in both INCLUDE_BORROW commands and EXCLUDE_BORROW commands for a given license, the entity is prohibited from borrowing the license. The syntax of the command is:

INCLUDE_BORROW product_code type list

An example of the command is:

INCLUDE_BORROW 500 GROUP Trainees Visitors

This command allows all members of the user groups Trainees and Visitors to borrow licenses for the application with product code 500.

MAX Command

This command limits usage for a group or user. The syntax of the command is:

MAX num_lic product_code type list

Examples of the command are:

MAX 6 200 HOST Ilocano

This command allows no more than six users logged in to the host Ilocano to request licensing actions at one time for the application with product code 200.

MAX 2 * USER Hildegard.vonBingen

This command allows the user Hildegard.vonBingen to request no more than two licenses at a time for any application.

MAX 1 500 USER ALL_USERS

This command allows each user to checkout no more than one seat of the PRO/II (500) license.

MAX_BORROW_HOURS Command

The license certificate for an application specifies the maximum period of time for which any user can borrow a license for the application. This command changes the maximum period. The syntax of the command is:

MAX_BORROW_HOURS product_code num_hours

The new time period must be shorter than that specified in the license certificate. If two or more MAX_BORROW_HOURS commands appear in the options file, only the last one applies to the application.

An example of the command is:

MAX_BORROW_HOURS 200 24

This command allows an entity to borrow a license, for no more than 24 hours, for the application with product code 200.

RESERVE Command

This command reserves a number of licenses for a specific entity. The syntax of the command is:

RESERVE num_lic product_code type list

Examples of the command are:

RESERVE 1 500 USER matekoni

This example reserves one license seat of the application with product code 500 for the exclusive use of user matekoni.

RESERVE 5 200 HOST 242.07.611.23

This example reserves five license seats of the application with product code 200 for any users on host computer 242.07.611.23.

RESERVE 25 200 GROUP SalesTeam

This example reserves twenty-five license seats of the application with product code 200 for all members of the user group SalesTeam.

Reserved licenses are dedicated to the named entity. Even when that user, host or group is not actively using the licenses, the licenses are not available to anyone else.