HP OpenVMS License Management Utility Manual
LICENSE ENABLE
Enables an existing license in the License Database so that you can
load it with LICENSE LOAD. This command cancels the effect of LICENSE
DISABLE, LICENSE COPY, and LICENSE ISSUE, which leave the license
disabled. Newly registered licenses are enabled by default.
Format
LICENSE ENABLE product-name[,...]
Parameter
product-name[,...]
Name or names of products with a license to enable. You can enable only
licenses that currently exist in the License Database. Enter the
product name exactly as it appears on your PAK.
Qualifiers
/ALL
Positional qualifier.
Specifies that all licenses with the given product name should be
enabled. This qualifier affects only the product name that immediately
precedes it in the command string.
/AUTHORIZATION=string
Positional qualifier.
Specifies a string that helps identify the license you want to enable.
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.
/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.
/ISSUER=string
Positional qualifier.
Specifies the name of the company (for example, HP) that issued the PAK
for the product. 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.
/LOG
/NOLOG (default)
Controls whether LICENSE ENABLE displays the name of each license that
it enables.
/PRODUCER=string
Positional qualifier.
Specifies the name of the company (for example, HP) 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.
Description
Use LICENSE ENABLE to reestablish disabled licenses as available for
loading with a LICENSE LOAD command.
Enabled licenses can combine with other licenses when loaded for use.
Do not enable a license that has expired, and be sure that all include,
exclude, and reservation lists are up to date.
Use LICENSE LIST to inspect each license before you enable it. Use
LICENSE MODIFY to change include, exclude, and reservation lists.
Because errors do not occur until enabled licenses are loaded, consider
entering LICENSE LOAD immediately to load each newly enabled license on
each appropriate node in an OpenVMS Cluster. If another combinable
license for the same product is already loaded, first unload it with
LICENSE UNLOAD. Use the DCL command SHOW LICENSE to see which licenses
are currently active on your system. After you unload the other
license, enter LICENSE LOAD to load the combination of the newly
enabled license and the previously active license.
Example
|
$ LICENSE ENABLE DECSET /PRODUCER=DEC
|
This command enables the license for DECset software. Because no
database is specified, LMF uses the default database. Next, load the
license with LICENSE LOAD.
LICENSE ISSUE
Produces a replica of a Product Authorization Key (PAK) that is sent to
a file or displayed on your terminal (the default). If the terms and
conditions of your license contract allow it, you can then enter this
PAK replica in the License Database of another processor. When you
enter LICENSE ISSUE, LMF disables the license in the current License
Database and marks the license DISABLED. To enable a license that has
been marked ISSUED, enter LICENSE ENABLE.
For License Databases connected to a network, consider using LICENSE
MOVE.
Format
LICENSE ISSUE product-name[,...]
Parameter
product-name[,...]
Name or names of products with a license to be issued. You can issue
only licenses that currently exist in the License Database. Enter the
product name exactly as it appears on your PAK.
Qualifiers
/ALL
Positional qualifier.
Specifies that all licenses with the given product name should be
issued. This qualifier affects only the product name that immediately
precedes it in the command string.
/AUTHORIZATION=string
Positional qualifier.
Specifies a string that helps identify the license you want to issue.
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.
/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.
/ISSUER=string
Positional qualifier.
Specifies the name of the company (for example, HP) that issued the PAK
for the product. 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.
/LOG
/NOLOG (default)
Controls whether LICENSE ISSUE displays the name of each license that
it issues.
/OUTPUT[=filespec]
Specifies the name of the file to which your PAK replica is written. If
you do not specify the /OUTPUT qualifier, or if you do not supply a
file specification with this qualifier, the output is sent to
SYS$OUTPUT.
If you specify a file name that already exists, this command creates a
new version of the file. If you specify a complete file name and
version that already exists, this command appends the PAK replica to
the existing file.
/PROCEDURE
/NOPROCEDURE (default)
Specifies that the PAK replica is to be written in the form of a DCL
command procedure. Use /PROCEDURE with the /OUTPUT qualifier to create
a command procedure in a file. Then you can invoke the procedure to
register the PAK replica in the License Database of another processor.
If you do not specify the /OUTPUT qualifier with /PROCEDURE, or if you
do not supply a file specification with the /OUTPUT qualifier, the
procedure is sent to SYS$OUTPUT.
/PRODUCER=string
Positional qualifier.
Specifies the name of the company (for example, HP) 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.
Description
If your license contract allows it, use LICENSE ISSUE to move a license
from a License Database on one processor (or OpenVMS Cluster
environment) to a License Database on another processor. To move a
license, enter LICENSE ISSUE, including enough PAK information to
clearly identify the license. LICENSE ISSUE automatically disables the
current license but does not immediately unload it; LMF does not
terminate any active processes. To unload the license, enter a LICENSE
UNLOAD command.
After you issue the PAK replica, read the information, and register it
on the new processor as you would any PAK, or, if you used the
/PROCEDURE qualifier with the /OUTPUT qualifier, invoke the new DCL
command procedure to register the license.
Note that the PAK replica includes only PAK information registered with
a LICENSE REGISTER command. The replica does not include any changes
made with other LICENSE commands.
Examples
| #1 |
$ LICENSE ISSUE /OUTPUT=SYS$MANAGER:FORTRAN.PAK -
_$ /PRODUCER=DEC FORTRAN
|
This command issues a PAK replica, which you can use to register the
Fortran license on a new processor (or OpenVMS Cluster environment),
and puts it into the file named FORTRAN.PAK. The next step is to print
the file, read the information, and, using a LICENSE REGISTER command
or VMSLICENSE.COM, enter the correct information in the License
Database of the new processor. The Fortran license in the current
License Database is marked ISSUED and is disabled.
| #2 |
$ LICENSE ISSUE /PRODUCER=DEC VOLSHAD
|
This command displays, at the current terminal, a PAK replica with the
information from the VOLSHAD (Volume Shadowing) license. This display
is reproduced below. The license registered in the current License
Database is marked ISSUED and is disabled. You can register the data
from this replica of a PAK in the License Database of another processor
using either VMSLICENSE.COM or LICENSE REGISTER.
Software Product Authorization Key Replica
Issued by CASPER
Issued on 24-FEB-2001 14:23
-----------------------------------
Issuer: DEC
Authorization: ALS-WM-93166-5573
Product Name: VOLSHAD
Producer: DEC
Units: 460
Version: 5.4
PAK Termination Date: 31-DEC-2001
Availability: E
Options: MOD_UNITS
Checksum: 1-ADEB-DOCJ-NENC-KDBM
|
| #3 |
$ LICENSE ISSUE /PROCEDURE /OUTPUT=FORTRAN-USA10.COM -
_$FORTRAN /AUTHORIZATION=USA-10
|
This command generates a DCL command procedure such as the following to
be used for registering the specified license in a License Database:
$! Software Product Authorization Key Replica
$! Issued by CASPER
$! Issued on 23-Oct-2001 14:23
$ LICENSE REGISTER FORTRAN -
/ISSUER=DEC -
/PRODUCER=DEC -
/AUTHORIZATION=USA-10 -
/UNITS=400 -
/VERSION=5.4 -
/AVAILABILITY=F -
/CHECKSUM=1-HIDN-INDA-COMP-DAHH
|
LICENSE LIST
Displays information from the License Database on disk about the
specified license or licenses. Use one or more qualifiers to control
the form, content, and location of information displayed.
The SHOW LICENSE command, described in the HP OpenVMS DCL Dictionary and in this
appendix, displays information from the License Database in memory.
Format
LICENSE LIST [product-name[,...]]
Parameter
product-name[,...]
Name or names of products with a license that you want to list. You can
list only licenses that currently exist on disk in the License
Database. You can specify one product name or use wildcard characters
to display licenses. The product-name parameter is optional;
the default is to display all of the licenses.
Qualifiers
/AUTHORIZATION=string
Positional qualifier.
Specifies a string that helps identify the license you want to list.
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.
/BEFORE
Used with /TERMINATION_DATE and /RELEASE_DATE, selects only those
licenses whose times are before the time specified with the other
qualifiers.
The /BEFORE qualifier cannot be used with the /SINCE qualifier.
/BRIEF (default)
Specifies a listing from the License Database that includes only the
license product and producer names.
/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.
/FULL
Specifies a listing from the License Database that includes a full
display of the specified license or licenses.
/HISTORY
Specifies a listing from the License Database that includes the history
records in the License Database for the specified license or licenses.
/ISSUER=string
Positional qualifier.
Specifies the name of the company (for example, HP) that issued the PAK
for the product. 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.
/OUTPUT[=filespec]
Specifies the name of the file to which your list is written. If you do
not specify the /OUTPUT qualifier, or if you do not supply a file
specification with this qualifier, the output is sent to SYS$OUTPUT.
/PRODUCER=string
Positional qualifier.
Specifies the name of the company (for example, HP) 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.
/RELEASE_DATE=date
Used with /BEFORE or /SINCE, specifies a listing from the License
Database that includes only licenses with a release date on or after
the date specified. The date must be presented in the standard OpenVMS
format: dd-mmm-yyyy. The default value is /SINCE
/RELEASE_DATE=TODAY.
/SELECTION_WEIGHT
Produces a full display that includes the current selection weights
assigned to individual PAKs.
/SINCE
Used with /TERMINATION_DATE and /RELEASE_DATE, selects only those
licenses whose times are after the time specified with the other
qualifiers.
/SINCE cannot be used with /BEFORE.
/TERMINATION_DATE[=date]
Used with /BEFORE or /SINCE, specifies a listing from the License
Database that includes only licenses with a termination date on or
after the date specified. The date must be presented in the standard
OpenVMS format: dd-mmm-yyyy. The default value is /SINCE
/TERMINATION_DATE=TODAY.
/VERSION=nn.nn
Positional qualifier.
Specifies the version number of the product for which you have a
license. Versions use the format integer.integer. You can
specify wildcard syntax as *.* but not * alone. 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.
Description
LICENSE LIST displays license records as they appear on disk in the
License Database. LICENSE LIST /BRIEF does not produce a display with
history records. You can control the displays as follows:
- After you enter LICENSE LIST with the /BRIEF qualifier, you can
scroll through the display with the arrow keys on your keyboard.
- After you enter LICENSE LIST with the /FULL or /HISTORY qualifier,
which displays the first LICENSE record, you can see the other records
one at a time by pressing Return. You can also scroll through the
license records using the Previous Screen key (or PF3) and the Next
Screen key (or PF4).
For any LICENSE LIST display, use the arrow keys to scroll vertically
or horizontally one line at a time. Press Ctrl/Z to exit from the
display.
Note that a LICENSE LIST command may display the status of a registered
license as Active. This means the registered license is
enabled for loading; it has not been disabled. It does not necessarily
mean the license was loaded with a LICENSE LOAD command. The LICENSE
LIST command displays only information on disk in the License Database;
enter SHOW LICENSE to determine all active licenses on the current
system.
You can also list licenses using the VMSLICENSE.COM command procedure.
Examples
This example displays a list of the names of product licenses in the
License Database on an OpenVMS Alpha system.
Note that the LMF Version shown refers to the software that created the
database.
Use CTRL/Z to exit, PF3-PF4 for Previous-Next Screen, Arrow Keys to scroll.
License Management Facility V1.2
License Database File: WORK2:[BACKUP]LMF$LICENSE.LDB;1
Created on: 20-JUL-2000
Created by user: USER_1
Created by LMF Version: V1.1
-----------------------------------
Issuer: DEC
Authorization:
Product Name: OPENVMS-ALPHA
Producer: DEC
Units: 500
Version: 0.0
Release Date: 4-MAY-2001
PAK Termination Date: (none)
Availability: 0
Activity: 000000100
Options: MOD_UNITS
Product Token:
Hardware ID:
Revision Level: 1
Status: Active
Command: REGISTER
|
This example displays a list of the names of product licenses in the
License Database on an OpenVMS Integrity server system.
Use CTRL/Z to exit, PF3-PF4 for Previous-Next Screen, Arrow Keys to scroll.
License Management Facility V2.0
License Database File: SYS$COMMON:[SYSEXE]LMF$LICENSE.LDB;1
Created on: 11-MAR-2010
Created by user: SYSTEM
Created by LMF Version: V2.0
-----------------------------------
Issuer: HP
Authorization: USA-1715
Product Name: C
Producer: HP
Units: 3
Version: 0.0
Release Date: (none)
PAK Termination Date: 31-DEC-2012
Availability: 0
Activity: 000000001
Options: IA64_ALPHA
Product Token:
Hardware ID:
Revision Level: 1
Status: Active
Command: REGISTER
Modified by user: SYSTEM
Modified on: 11-MAR-2010 12:18:59.95
-----------------------------------
Issuer: HP
Authorization: I64-AB-001
Product Name: DVNETEXT
Producer: HP
Units: 20
Modified Units: 4
Version: 0.0
Release Date: (none)
PAK Termination Date: 31-DEC-2012
Options: IA64, PCL
Product Token:
Hardware ID:
Revision Level: 2
Status: Active
Command: MODIFY
Modified by user: SYSTEM
Modified on: 11-MAR-2010 12:29:42.18
-----------------------------------
Issuer: HP
Authorization: I64-AB-004
Product Name: OPENVMS-I64-BOE
Producer: HP
Units: 2
Version: 0.0
Release Date: (none)
PAK Termination Date: 31-DEC-2012
Options: IA64, PCL
Product Token:
Hardware ID:
Revision Level: 1
Status: Active
Command: REGISTER
Modified by user: SYSTEM
Modified on: 11-MAR-2010 12:33:26.19
|
| #3 |
$ LICENSE LIST /HISTORY FORTRAN
|
This example displays a listing with full information of a current
Fortran license issued by HP.
The first screen, shown here, displays the most recent license record
for the Fortran license. To see the history records one screen at a
time, press Return. The revision level of the displayed record is 2,
and the status is Active. The next screen would display the previous
license record with a revision level of 1 and a status of Extinct.
Use CTRL/Z to exit, PF3-PF4 for Previous-Next Screen, Arrow Keys to scroll.
License Management Facility V1.2
License Database File: ART::SYS$COMMON:[SYSEXE]LMF$LICENSE.LDB
Created on: 17-AUG-2000
Created by user: USER_2
Created by LMF Version: V1.2
-----------------------------------------------------
Issuer: DEC
Authorization: USA-2468
Product Name: FORTRAN
Producer: DEC
Units: 0
Modified Units: 2000
Version: 5.4
Release Date: (none)
PAK Termination Date: 31-DEC-2000
Modified Termination Date: 30-NOV-2001
Availability: F (Layered Products)
Activity: 0
Options: MOD_UNITS
Hardware ID:
Revision Level: 2
Status: Active
Command: MODIFY
Modified by user: DEGAS
Modified on: 19-AUG-2000 14:32:23.41
Include: ART
|
This example displays the full listing of a license that has been
modified using the /VIRTUAL qualifier, for an OpenVMS guest system.
License Management Facility V2.0
License Database File: SYS$COMMON:[SYSEXE]LMF$LICENSE.LDB;1
Created on: 1-MAR-2010
Created by user: SYSTEM
Created by LMF Version: V2.0
-----------------------------------
Issuer: HP
Authorization: I64-AB-001
Product Name: OPENVMS-I64-HAOE
Producer: HP
Units: 4
Version: 0.0
Release Date: (none)
PAK Termination Date: 10-MAR-2011
Options: IA64, PCL, VIRTUAL
Product Token:
Hardware ID:
Revision Level: 2
Status: Active
Command: MODIFY
Modified by user: SYSTEM
Modified on: 8-MAR-2010 16:45:00.32
|
| 
