HP OpenVMS Systems Documentation
OpenVMS License Management Utility Manual
Order Number: AA--PVXUF--TK
This manual describes the use of the License Management Facility (LMF), the software license management tool for the OpenVMS operating system.
Revision/Update Information: This is a revised manual. This manual supersedes OpenVMS License Management Utility Manual, OpenVMS AXP Version 7.1 and OpenVMS VAX Version 7.1.
Software Version: OpenVMS Alpha Version 7.3 OpenVMS VAX Version 7.3
Compaq Computer Corporation
© 2001 Compaq Computer Corporation
Compaq, VAX, VMS, and the Compaq logo Registered in U.S. Patent and Trademark Office.
OpenVMS is a trademarks of Compaq Information Technologies Group, L.P. in the United States and other countries.
All other product names mentioned herein may be trademarks of their respective companies.
Confidential computer software. Valid license from Compaq required for possession, use, or copying. Consistent with FAR 12.211 and 12.212, Commercial Computer Software, Computer Software Documentation, and Technical Data for Commercial Items are licensed to the U.S. Government under vendor's standard commercial license.
Compaq shall not be liable for technical or editorial errors or omissions contained herein. The information in this document is provided "as is" without warranty of any kind and is subject to change without notice. The warranties for Compaq products are set forth in the express limited warranty statements accompanying such products. Nothing herein should be construed as constituting an additional warranty.
The Compaq OpenVMS documentation set is available on CD-ROM.
The License Management Facility (LMF) is the software license management tool for the OpenVMS operating system. To run any software product on OpenVMS systems, you must register and load its license. To perform these tasks, use LMF.
This manual is for managers of licenses for software products that run on the OpenVMS operating system. Typically, the system manager has this responsibility.
This manual consists of the following parts:
The following manuals contain information related to the License Management utility:
For information about installing software, see the following documentation:
For additional information about Compaq OpenVMS products and services, access the Compaq website at the following location:
Compaq welcomes your comments on this manual. Please send comments to either of the following addresses:
How To Order Additional Documentation
Use the following World Wide Web address to order additional documentation:
If you need help deciding which documentation best meets your needs, call 800-282-6672.
The following conventions are used in this manual:
The terms and conditions of your license agreement determine your legal use of software.
LMF is a management tool that can help you comply with your license agreement, but use of LMF does not indemnify you against noncompliance with the terms and conditions of your software license agreements. In other words, LMF offers options for many kinds of license agreements, but using some of these options may not be authorized by your specific license agreement. You must read your license carefully to determine which LMF options you can use legally.
This document describes some features of LMF that Compaq Computer Corporation does not currently authorize. Compaq may in the future authorize the use of some features described herein but makes no commitment beyond the current Software Business Practices.
To use a software product that requires a license, you must perform the following steps:
LMF provides additional features to modify licenses to satisfy specific requirements of individual sites.
To manage software product licenses for OpenVMS layered software, you need to understand the following information about licenses and the tool to manage them on OpenVMS systems:
The License Management utility (LICENSE) is the command line interface of the License Management Facility (LMF). Use LICENSE commands to interactively manage the licenses of OpenVMS layered software products and, in many cases, by third-party vendors.
LICENSE is a system-level tool that you use at the DCL prompt.
This example shows a LICENSE MODIFY command line at the DCL prompt. The command modifies the license for the Encryption for OpenVMS product in the License Database so that users can encrypt files from the node DRAMA.
$ LICENSE MODIFY ENCRYPTION - _$/ADD /INCLUDE=(DRAMA) - _$ /COMMENT="Modified to add node DRAMA 23-OCT-2000" -
The License Database is a collection of information stored in a file called the License Database on a disk that contains information about each license on your system. The default database file is SYS$COMMON:[SYSEXE]LMF$LICENSE.LDB, which is created by LMF when you install the OpenVMS software.
In addition, LMF enters data and keeps records. The collection of data fields representing a license at any one time is called a record. When you first register a license, you create the first record with data specified in your PAK. If you later modify the license, LMF creates a new record to define the modified terms of the license, and includes a notation that the license was modified.
Figure 1-1 illustrates the relationship between the LMF, the LUR and the License Database.
Figure 1-1 The Licensing Model
LMF keeps track of the licensing activity on your system by writing a history record to the License Database every time you modify a PAK. Each history record contains an exact copy of the following:
The history record also logs the username of the person who made the
changes to the PAK. For information about viewing and purging these
records, see Section 2.2.2.
1.4 License Units and License Unit Requirement Tables
A license unit is a measurement of the authorization granted for use of a product. License units define the size of each license. Each license has a size, specified in license units. Each processor has a series of license unit requirements, also specified in license units.
The license unit requirements of a processor are expressed in a rating. LMF contains ratings (in license units) for all available and appropriate processors in a table called the License Unit Requirement Table (LURT). There is a LURT for each category of software products as identified on the PAK. The PAK contains two fields, the Activity Table Code and the Availability Table Code, that contain information to identify the category of the software product. Typically, processors that provide more performance have greater license unit requirements, but ratings may be unrelated to performance.
The size of a software product license must be large enough to support the number of either users or processes using the product and the processor on which the product is to run. LMF compares the size of a registered license to the rating of the current processor and authorizes product use when a license supplies sufficient license units.
A copy of each LURT is published in either the OpenVMS release notes or in the installation documentation. Use the following command to determine the license unit requirements of your system:
$ SHOW LICENSE/UNIT_REQUIREMENTS
LMF compares the size of a registered license to the license unit requirement for the current processor and authorizes product use when a license supplies sufficient license units.
Table 1-1 shows an example of a License Unit Requirement Table. See either the OpenVMS release notes or the installation documentation for current LURTs.
|System Marketing Model||Number of License Units Required|
The number of license units registered with any license should match or exceed the number of license units required for the specified product to run on the specified processor. For example, when you obtain a license for Compaq Pascal to run on a VAXstation 3100 system, that Pascal license must specify at least the same number of license units as the LURT requires for a VAXstation 3100 system. The same Pascal license may not provide enough license units to authorize use of Pascal on a VAX 9000 system. The size of the license to run a software product on an OpenVMS Cluster environment must reflect the total number of concurrent users or processes and the processors on which the product will run.
Not all licenses have a specific number of units. Some licenses specify
zero units, which is equivalent to unlimited units.
LMF provides the command procedure VMSLICENSE.COM to register, manage,
and track software licenses. VMSLICENSE.COM provides a menu-driven
interface that allows you to easily register and load your licenses.
VMSLICENSE.COM executes LICENSE commands, which you can also issue
manually. See Appendix A for a full description of each LICENSE
1.6 Types of Licenses
Different types of software product licenses enable you to allow access to each product in ways that range from access for a specific user on a specific processor to general access for all users on all processors with in an OpenVMS Cluster. Table 1-2 describes the licenses that LMF supports.
|Type||Identification on PAK||License by||See|
|Availability||Availability Table Code has a nonzero value.||Processor type (Requires Key Option ALPHA or VAX_ALPHA to load on Alpha processor.)||Section 1.6.1|
|Activity||Activity Table Code has a nonzero value.||Concurrent uses (not users)||Section 1.6.2|
|User||Activity constant and Key Options: USER.||Concurrent users (not uses)||Section 1.6.4|
|Personal Use||Activity constant and Key Options: RESERVE_UNITS.||Named user||Section 1.6.3|
The license descriptions that follow provide information to help you understand and manage the product authorization process on VAX or Alpha computers using LMF, rather than to help you order software licenses. Compaq provides licenses in many ways that may not always correspond to the examples in this manual. Check with your Compaq support representative for ordering information, and check the terms and conditions of your license contracts for restrictions.