HP OpenVMS Systems Documentation
HP OpenVMS License Management Utility Manual
If the information is incorrect, enter N.
When the procedure displays the following question, enter Y:
If you entered all the information correctly, the procedure displays the following message:
If you entered some information incorrectly but did not choose YES to make corrections, the procedure may display the following message:
If you enter an incorrect checksum string, the procedure responds as follows:
Enter the correct checksum at the prompt.
If you registered the PAK on a standalone system and you want to make the software available (active) immediately, enter Y. If you registered the license in an OpenVMS Cluster environment but do not want to make it available (active) on the current node, enter N. After you exit this procedure, you can enter the LICENSE LOAD command to load the license on the desired node.
If you enter Y and the license is successfully loaded, the procedure displays the following informational message and prompt:
22.214.171.124 Using Data Files with VMSLICENSE.COM
You can use VMSLICENSE.COM in batch mode as well as interactively. Instead of entering the PAK data interactively from your terminal or workstation, you can create a VMSLICENSE data file with an editor and enter data obtained from your product PAKs (Example 5-2 shows sample PAK data). You can then invoke VMSLICENSE.COM, specifying the name of the new VMSLICENSE data file as a parameter on the same command line. The procedure displays the license data and performs the requested operation or operations using data only from the VMSLICENSE data file.
You can create a file that registers multiple licenses. VMSLICENSE.COM
exits only when it reaches the end of the VMSLICENSE data file.
To pass a VMSLICENSE data file to VMSLICENSE.COM, use the following format:
When you invoke VMSLICENSE with a data file, you must specify REGISTER as the license-option. You cannot use data files with any of the other options that are available when using VMSLICENSE interactively.
You can specify a License Database on the command line or in the data file. Any License Database you specify in the data file overrides a License Database you specify on the command line.
For example, you can pass the data in the sample VMSLICENSE data file, shown in Example 5-2, with the following command line:
126.96.36.199 Creating VMSLICENSE Data Files
When you create a VMSLICENSE data file to be processed by VMSLICENSE.COM, you must follow these rules (refer to Example 5-2):
188.8.131.52 Using VMSLICENSE.COM Default Value Rules
If you do not specify a value for a parameter in a VMSLICENSE data file, VMSLICENSE substitutes default values. The current default values are ISSUER=DEC and PRODUCER=DEC on OpenVMS Alpha and VAX systems and HP on OpenVMS Integrity server systems. All other license parameters have null values until you specify a value.
After you specify a license parameter in the VMSLICENSE data file, the parameter becomes the new default value until the next occurrence of the parameter sets a new default value. To set or reset the value of a parameter to null, use a line of the following form:
For example, if the most recent PAK data set the INCLUDE_NODE parameter to a specific node, reset the parameter to null for the current and subsequent PAKs by entering the following:
You can directly register (and load) a license with LICENSE commands. For example:
After you successfully register a license in the License Database (the default file specification is SYS$COMMON:[SYSEXE]LMF$LICENSE.LDB), you can enter the LICENSE LIST/FULL command to display the data in the database (see Example 5-3).
When a license is successfully loaded with VMSLICENSE.COM or the
LICENSE LOAD command, LMF displays an informational message.
To display information from the License Database about specific licenses, enter the LICENSE LIST command.
To display information in memory about loaded licenses, enter the SHOW
LICENSE command. This command displays licenses loaded on the current
node, and displays any reservation list associated with each license.
To allow users to access a product, you must load each registered license. Loading a license transfers data from the on-disk License Database into system memory. The following table shows the methods of license loading for LMF:
Figure 5-4 illustrates the license loading process for a standalone system. Whether the license manager enters the LICENSE LOAD command or the system automatically loads all registered licenses during startup, the license information is transferred to the system memory of node ART.
Figure 5-4 Loading a License
5.5.1 Loading Licenses in an OpenVMS Cluster Environment
In an OpenVMS Cluster environment, multiple nodes load licenses from a single common database. LMF provides this capability to let you share licenses as well as control access to a product on a node-by-node basis (provided this is allowed by the terms and conditions of the license).
Typically, any node can load a license registered in the common License Database. For predictability, security, performance, or economic reasons, you can limit which nodes can access a product license intended to be shared among nodes. In an OpenVMS Cluster environment, you control access by modifying the license's include list. Use the LICENSE MODIFY command and either the /INCLUDE or /EXCLUDE qualifier to specify which cluster nodes can load the license. By changing the include list, you can create the effect of moving a product from node to node. Section 5.6.2 describes the process in detail. Note that you cannot share licenses that have the NO_SHARE option. They must be assigned to a single node.
You can also control which users in an OpenVMS Cluster environment can access a product license. Control access by modifying the license's reservation list. Use the LICENSE MODIFY command with the /RESERVE qualifier to specify which users can access the license.
In an OpenVMS Cluster environment, license loading involves transferring, or loading, license information from the on-disk License Database into system memory of the current node. The number and combination of licenses for an OpenVMS Cluster environment can be complex, which in turn makes the loading process complex and sometimes confusing. The general rule is that nodes specified on include lists or not specified on exclude lists of the LICENSE MODIFY command can load a registered license. As each system starts up, it loads any licenses to which it has access. If you need to load a license for all assigned nodes of a running cluster, you can use the OpenVMS System Management utility (SYSMAN), which is described in the HP OpenVMS System Manager's Manual. Figure 5-5 illustrates the loading process in an OpenVMS Cluster environment.
Figure 5-5 Loading a License in an OpenVMS Cluster Environment
After you register licenses, you can manage them. While system managers can perform these tasks, managers of cluster environments and large multiple-user systems may also have an interest in managing products and product licenses.
For example, a cluster manager can use LMF to control which nodes can access a database product using important data (see Section 5.6.2). All system managers, however, may want to monitor license data using LICENSE commands.
VMSLICENSE.COM, LICENSE commands, and the DCL command SHOW LICENSE can perform most license management tasks, including:
The quickest method to restrict access to products registered in the License Database is to unload the license with a LICENSE UNLOAD command. The product becomes unavailable to new users and unavailable to all users when the last process using the product finishes. The product remains inaccessible until either you or the system reloads the license.
Although LICENSE UNLOAD is fast, it is not permanent. Typically, at
system startup, LMF loads all the licenses registered in the License
Database. In addition, a license that is loaded remains loaded until
either the system is shut down or you intervene.
The following commands control license loading, which restricts product access. However, they do not unload loaded licenses or alter in-memory license data. For loaded licenses, use LICENSE UNLOAD.