Modifies a license for system management and license-sharing
purposes. Immediately changes data in the License Database, but
your modifications do not affect the running system until you
load the modified license.
Format
LICENSE MODIFY qualifier[,...] product-name[,...]
1 – Parameter
product-name[,...]
Name or names of products with a license to be modified. You
can modify only licenses that currently exist in the License
Database.
2 – Qualifiers
2.1 /ADD
Used with the /INCLUDE or /EXCLUDE qualifier, specifies that the
node names provided are to be added to the previously established
include or exclude lists.
Used with the /RESERVE qualifier, specifies that the user
names provided are to be added to the previously established
reservation lists.
When you use /ADD, you do not need to retype the entire list to
add a new node name or user name.
2.2 /ALL
Positional qualifier.
Modifies all the licenses with the given product name. This
qualifier affects only the product name that immediately precedes
it in the command string.
2.3 /AUTHORIZATION
/AUTHORIZATION=string
Positional qualifier.
Specifies a string that helps identify the license you want to
modify. You must enter the authorization string exactly as it
appears on your PAK. Use this optional qualifier only if you
need it to identify the license. This qualifier affects only the
product name that immediately precedes it in the command string.
2.4 /COMBINE
/COMBINE
/NOCOMBINE
Modifies a PAK by adding or removing the COMBINE option. If the
PAKs are combinable, LMF combines them during license loading.
2.5 /COMMENT
/COMMENT=string
Specifies a string of text. Use this comment field of up to 63
characters to associate information for this transaction with
the license. History records for the license retain this license
information. If you specify more than one word, enclose the text
in quotation marks (""). This qualifier is optional.
The text in the comment field is replaced only when you enter new
comments with another LICENSE MODIFY command. At this point the
old comment text is available as a history record.
2.6 /DATABASE
/DATABASE=filespec
Specifies the location of the License Database. The default file
specification is defined by the logical name LMF$LICENSE, which
points to SYS$COMMON:[SYSEXE]LMF$LICENSE.LDB on an unmodified
OpenVMS system. Use this optional qualifier only if you do not
use the default License Database name and location.
2.7 /EXCLUDE
/EXCLUDE=(node-name[,node-name,...])
Specifies that the named node or nodes in an OpenVMS Cluster
environment cannot access the licensed product. The excluded
nodes cannot load (with a LICENSE LOAD or LICENSE START command)
the license registered in the License Database. Each node-name
argument must be a System Communications Services (SCS) node
name or a system parameter set with the System Generation utility
(SYSGEN). The node name might not be the same as the DECnet node
name. If you specify more than one node name, separate them with
commas, and enclose the list in parentheses. This qualifier is
optional.
To modify previously defined lists without having to retype
all of the node names, use the /ADD or /REMOVE qualifiers with
/EXCLUDE.
You can control license access to nodes with /EXCLUDE and control
user access with /RESERVE, but you cannot use these qualifiers on
the same command line. To use both types of control with the same
license, you must enter separate LICENSE MODIFY commands.
2.8 /INCLUDE
/INCLUDE=(node-name[,node-name,...])
Specifies that the named node or nodes in an OpenVMS Cluster
environment can access the licensed product. Only the included
nodes can load (with a LICENSE LOAD or LICENSE START command)
the license registered in the License Database. Each node-name
argument must be an SCS node name, or a system parameter set with
SYSGEN. The node name might not be the same as the DECnet node
name.
Licenses for the OpenVMS operating system usually specify the
NO_SHARE option on their PAKs. In a cluster environment you must
restrict each of these OpenVMS licenses to a single node. If
you did not do this when registering with VMSLICENSE.COM, enter
LICENSE MODIFY/INCLUDE=node-name, specifying one SCS node name
for each OpenVMS license.
To specify more than one SCS node name for a license that does
not specify NO_SHARE, separate the names with commas, and enclose
the list in parentheses. This qualifier is optional.
To modify previously defined lists without having to retype
all of the node names, use the /ADD or /REMOVE qualifiers with
/INCLUDE.
You can control license access to nodes with /INCLUDE and control
user access with /RESERVE, but you cannot use these qualifiers on
the same command line. To use both types of control with the same
license, you must enter separate LICENSE MODIFY commands.
2.9 /ISSUER
/ISSUER=string
Positional qualifier.
Specifies the name of the company (for example, DEC) that
issued the PAK for the product. Use this qualifier only if it is
required to identify the license. This qualifier affects only the
product name that immediately precedes it in the command string.
2.10 /LOG
/LOG
/NOLOG (default)
Controls whether LICENSE MODIFY displays the name of each license
that it modifies.
2.11 /NO_SHARE
/NO_SHARE
/NONO_SHARE
Specifies whether to add or subsequently remove /NO_SHARE from a
PAK. Adding /NO_SHARE prevents the sharing of the PAK units with
other cluster nodes.
PAKs with /NO_SHARE require you to provide the SCS node name of
the cluster node that will be using this particular license. See
the /INCLUDE qualifier for more information.
Note that if /NO_SHARE is present on your PAK when you register
it, you cannot remove the option using /NONO_SHARE. Only if
you add /NO_SHARE with the MODIFY command, can you subsequently
remove it.
2.12 /PRODUCER
/PRODUCER=string
Positional qualifier.
Specifies the name of the company (for example, DEC) that owns
the product for which you have a license. Use this optional
qualifier only if you need it to identify the license. This
qualifier affects only the product name that immediately precedes
it in the command string.
2.13 /REMOVE
Used with the /INCLUDE or /EXCLUDE qualifier, specifies that
the node names provided are to be removed from the previously
established include or exclude lists.
Used with the /RESERVE qualifier, specifies that the user names
provided are to be removed from the previously established
reservation lists.
When you use /REMOVE, you do not need to retype the entire list
to remove a node name or user name.
2.14 /RESERVE
/RESERVE=(user-name[,user-name,...])
Specifies that the license or licenses are to be reserved for use
by the users listed in the user-name parameter. Users not listed
are denied access to the product. The value applied to user-
name differs from product to product. See your Software Product
Description (SPD) for details.
Most products define user-name to be the user name OpenVMS
maintains for each account. This is the name you type at the
Username prompt during login.
If your PAK specifies the RESERVE_UNITS option, you must assign
one or more users to a reservation list. On OpenVMS Alpha and VAX
systems, the number of user names allowed per list depends on the
number of activity units available and a constant value or the
License Unit Requirement Tables (LURTs). Calculate this number
as you would for any Activity License. For example, a 200-unit
license with a constant value of 100 is a two-user license. On
OpenVMS Integrity server systems, units are expressed in single
units that directly correlate to the constant value listed.
You can also create and modify a reservation list for
Availability and regular Activity Licenses that do not specify
the RESERVE_UNITS option. Because these licenses do not limit
the number of names on the list, you can assign as many names as
you like to the reservation list. All users not on the list are
denied access.
Although you can control license access to nodes with /INCLUDE
and /EXCLUDE qualifiers and control user access with the /RESERVE
qualifier, you cannot use these qualifiers on the same command
line. If you want to use both types of control with the same
license, you must enter separate LICENSE MODIFY commands.
Use the /ADD and /REMOVE qualifiers for further control in
modifying previously established reservation lists.
2.15 /SELECTION_WEIGHT
/SELECTION_WEIGHT=number
Modifies the selection weight. Selection-weight values determine
the order in which LMF checks multiple licenses when a product
makes a license grant request. LMF checks higher-weighted
licenses before lower-weighted ones. Specify arbitrary numbers
between 1 and 1000.
NOTE
You cannot modify selection weights for Availability
Licenses.
To restore the selection weight of a PAK to the default value,
enter the LICENSE MODIFY command with /SELECTION_WEIGHT=0. For
example, you can use either of the following commands:
$ LICENSE MODIFY FORTRAN /SELECTION_WEIGHT=0
$ LICENSE MODIFY FORTRAN /NOSELECTION_WEIGHT
2.16 /TERMINATION_DATE
/TERMINATION_DATE=date
Date at which the product license is to be terminated. If
your PAK supplied a license termination date, LMF uses the
earliest date to determine the termination date. The date must
be presented in the standard OpenVMS format: dd-mmm-yyyy. If
you want to restrict a product from further use today, enter
yesterday's date; LMF terminates the license at the end of the
day specified.
2.17 /UNITS
/UNITS=n
Number of license units you want on a license that includes the
MOD_UNITS option. If your PAK allows you to modify the license
units, use this qualifier to change the value in the License
Database.
2.18 /VIRTUAL
/VIRTUAL
/NOVIRTUAL
Specifies that the modified license must only be loaded on
OpenVMS guests. Virtual licenses are ignored during physical
machine LICENSE LOAD command processing. To see the licenses
that are ignored, use the /LOG qualifier with the LICENSE LOAD
command. Use the /NOVIRTUAL qualifier to remove the virtual
option from the license.
The /VIRTUAL qualifier is valid for licenses with the IA64 and
PCL options.
Licenses that you intend to load on OpenVMS guest cluster members
must be modified with the /VIRTUAL qualifier. It is optional,
but recommended to modify licenses for standalone OpenVMS guest
systems with the /VIRTUAL qualifier.
VSI recommends that you use /INCLUDE or /EXCLUDE lists on your
virtual machine host licenses to define all the OpenVMS guest
cluster members from a host that must load the license. In
future, VSI may limit the usage of a Virtual license to one host,
which is the first host that loads the license.
3 – Description
Use the LICENSE MODIFY command to modify a license. To control
which nodes in a cluster environment have access to what
software, use LICENSE MODIFY with the /INCLUDE or /EXCLUDE
qualifier. For example, you can load licenses for products used
less often or requiring limited access on one node.
If you do not specify which nodes can load a license (with a
LICENSE LOAD or LICENSE START command), LMF loads a license
on a first-come, first-served basis. When your license has
insufficient license units for full cluster environment use,
control product access with an include list.
Because most OpenVMS PAKs use the /NO_SHARE option, in a cluster
environment you must restrict these operating system licenses to
one node. Enter LICENSE MODIFY/INCLUDE=node-name, specifying only
one SCS node name for each OpenVMS license.
To control which users have access to a product, use LICENSE
MODIFY with the /RESERVE qualifier. You can create and modify
a reservation list for any kind of license. Only users on the
reservation lists are allowed access to the product.
If your PAK specifies the RESERVE_UNITS option, you must assign
one or more users to a reservation list. The number of user
names allowed per list depends on the number of activity units
available and a constant value or the License Unit Requirement
Tables (LURTs). Calculate this number as you would for any
Activity License. For example, a 200-unit license with a constant
value of 100 is a two-user license.
Use the /ADD and /REMOVE qualifiers in conjunction with the
/INCLUDE, /EXCLUDE, and /RESERVE qualifiers when you modify
existing include, exclude, and reservation lists.
To add comments about a license in the License Database, use
LICENSE MODIFY with the /COMMENT qualifier.
If your PAK includes the MOD_UNITS option, you can use the /UNITS
qualifier to specify the number of license units you want for
your registered license.
Use the other LICENSE MODIFY command qualifiers only as needed to
identify the correct license.
You can also modify a license record using the VMSLICENSE.COM
command procedure.
List Size Restrictions
Two restrictions apply to the size of lists (reservation lists,
include lists, or exclude lists). These restrictions apply to
PAKs of all license types.
o On any single PAK, the sum of characters contained in all
lists must not exceed 5000 characters.
Because the length of names varies and some overhead is
used for each name, this 5000-character limit cannot be
expressed as an exact number of permissible names. However,
VSI guarantees that at least 400 names, in total, can be
specified in the various types of lists. For example, each
of the following represents the minimally guaranteed number of
names:
- Reservation list with up to 400 user names
- Reservation list with up to 200 user names plus an include
list with up to 200 node names (totaling up to 400)
- Reservation list with up to 200 user names plus an exclude
list with up to 200 node names (totaling up to 400)
- Include list with up to 400 node names
- Exclude list with up to 400 node names
NOTE
If you enter more names than are permitted, LICENSE LIST
might not be able to display all names entered. In this
case, you receive the error message LICENSE-F-CORRUP.
However, the License Database is not actually corrupt,
and the PAKs can still be loaded into memory (though the
names are not displayed).
o The LICENSE LOAD and LICENSE START commands can load into
memory a reservation list with no more than 30,000 characters.
(Include and exclude lists, which are not loaded into memory,
are irrelevant to the 30,000-character limit.)
Because the length of names varies and some overhead is used
for each name, this 30,000-character limit cannot be expressed
as an exact number of permissible names. But VSI guarantees
that, for each product, at least 2000 user names can appear on
reservation lists. In the case of an OpenVMS Cluster, this is
a per-node limit.
Note that, because 2000 user names is a per-product limit and
because there can be more than one PAK per product, the number
of user names on a per-product basis is the sum of the user
names specified on each PAK.
For example, if three activity PAKs for the DECwrite
product were registered on a system and each PAK specified
a reservation list with 200 user names, the total number of
user names for that product is 600. This is safely below the
30,000-character (2000 user name) limit and below the 5000-
character (400 user name) limit.
4 – Examples
1.$ LICENSE MODIFY /EXCLUDE=(DANCE,THEATR) -
_$ /COMMENT="Modified to exclude nodes DANCE & THEATR 10/23/04" -
_$ FORTRAN
This command modifies the Fortran license in the License
Database so that users cannot access Fortran from the nodes
named DANCE and THEATR. A comment is added to the database
record for future reference.
2.$ LICENSE MODIFY /ADD /INCLUDE=(DRAMA) -
_$ /COMMENT="Modified to add node named DRAMA 10/23/04" -
_$ FORTRAN
This command modifies the Fortran license in the License
Database so that users can access Fortran from the node DRAMA
in addition to any nodes previously named in the license
include list.
3.$ LICENSE MODIFY /UNITS=1200 FORTRAN
$ LICENSE LOAD FORTRAN
This command changes the license units on a license with the
MOD_UNITS option.
4.$ LICENSE MODIFY /TERMINATION_DATE=1-JAN-2005 FORTRAN
Unless an earlier termination date exists, this command sets a
new termination date of 1-JAN-2005 for the Fortran license.
5.$ LICENSE MODIFY /EXCLUDE="" FORTRAN
This command removes all nodes from the previously established
exclude list. All nodes now have access to the Fortran license.