HP OpenVMS License Management Utility Manual
LICENSE CREATE
Creates a License
Database with no license records. Because LMF provides a default License Database
in SYS$COMMON:[SYSEXE]LMF$LICENSE.LDB when OpenVMS is installed, you do not
typically need to use this command.
To use LMF, you must have a License Database file and the appropriate number
of units for your system. On OpenVMS Alpha and VAX, the units are contained
in the License Unit Requirement Table (LURT) file (SYS$COMMON:[SYSEXE]LMF$LURT.DAT),
which comes installed with OpenVMS. On OpenVMS I64, the units are based on
the number of processors and the class of the machine specified in the PAK
you receive with the license.
Format
LICENSE CREATE
Parameters
None.
Qualifier
/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.
Example
|
$ LICENSE CREATE /DATABASE=SYS$MANAGER:LMF$LICENSE.LDB
|
This command creates the License Database named LMF$LICENSE.LDB in the directory
SYS$MANAGER.
LICENSE DELETE
Deletes one or more licenses and all history information for those
licenses from the License Database.
Format
LICENSE DELETE product-name[,...]
Parameter
product-name[,...]
Name or names of products with a license to be removed from the License Database.
You can delete only licenses that have been registered.
Qualifiers
/ALL
Positional qualifier.
Specifies that all licenses with the given product name should be deleted.
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 delete. 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 from which the license or licenses
should be deleted. 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 DELETE displays the name of each license that it deletes.
/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.
/STATUS=[(keyword)[,...]]
Positional qualifier.
Selects licenses to be deleted according to the product-name parameter
specified and one or more license status keywords from the following list:
- ALL (default)---Deletes all specified licenses in the database.
- ACTIVE---Deletes all specified enabled licenses in the database. ACTIVE status
means that the registered license is enabled for loading. For backward
compatibility, the LICENSE LIST command identifies enabled licenses as
having a status of active.
- DISABLED---Deletes all specified disabled licenses in the database.
- EXTINCT---Purges specified license information by deleting all extinct
license records in the database. Extinct records are history records retained
after a license is modified.
- CANCELED---Deletes all specified canceled licenses in the database.
Note that current versions of LMF do not set license status to canceled.
Old licenses may have this status.
If you enter more than one keyword, separate them with commas, and enclose
the list in parentheses. You can abbreviate each option to the minimum number
of characters needed to uniquely identify it.
Description
Use LICENSE DELETE to delete licenses from the License Database.
To tailor your command, use options to the /STATUS qualifier and wildcard characters
in product name strings.
File space is not released following LICENSE DELETE commands. For information
on retrieving Record Management Services (RMS) file space, see the OpenVMS
Record Management Utilities Reference Manual.
Examples
| #1 |
$ LICENSE DELETE FORTRAN
|
This command deletes the Fortran license from the default License Database.
| #2 |
$ LICENSE DELETE FORTRAN, COBOL, PASCAL
|
This command deletes the Fortran, COBOL and Pascal licenses from the default
License Database.
| #3 |
$ LICENSE DELETE FORTRAN /DATABASE=MY$DISK:MYDATA.LDB
|
This command deletes the Fortran license from the MY$DISK:MYDATA.LDB License
Database.
| #4 |
$ LICENSE DELETE FORTRAN /ISSUER=XYLASOFT
|
This command deletes all licenses for the product named Fortran issued by
XYLASOFT from the default License Database. If there are licenses for products
named Fortran issued by companies other than XYLASOFT, they are not deleted.
| #5 |
$ LICENSE DELETE * /STATUS=(EXTINCT)
|
This command deletes all license records with a status of EXTINCT from the
database. This is effectively a purge of all historical information.
LICENSE DISABLE
Disables a license currently registered
in the License Database.
Format
LICENSE DISABLE product-name[,...]
Parameter
product-name[,...]
Name or names of products with a license that you want to disable. You can
disable only licenses that currently exist in the License Database. Enter the
product name exactly as it appears on your Product Authorization Key (PAK).
Qualifiers
/ALL
Positional qualifier.
Specifies that all licenses with the given product name should be disabled.
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 disable.
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 DISABLE displays the name of each license that it
disables.
/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.
Description
LICENSE DISABLE does not immediately affect loaded licenses. To affect
a loaded license, you must first enter a LICENSE UNLOAD command, which unloads
the license, but allows current processes to finish using the product. Note
that to immediately disable all loaded licenses, you must shut down the system.
You cannot use LICENSE LOAD to activate a disabled license; you must first
use LICENSE ENABLE.
LMF does not display error messages when either you or the system attempts
to unload a disabled license.
Example
|
$ LICENSE DISABLE ABCD /PRODUCER=DEC
|
This command disables the license for ABCD software produced by HP. Because
no database is specified, LMF uses the default database.
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 ReplicaIssued by CASPER Issued on 24-FEB-2001 14:23-----------------------------------Issuer: DECAuthorization: ALS-WM-93166-5573Product Name: VOLSHAD Producer: DECUnits: 460Version: 5.4PAK Termination Date: 31-DEC-2001 Availability: EOptions: MOD_UNITSChecksum: 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
|
|
