LICENSE, LIST
*Conan The Librarian (sorry for the slow response - running on an old VAX)
|
VMS Help LICENSE, LIST *Conan The Librarian (sorry for the slow response - running on an old VAX) |
|
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 OpenVMS DCL
Dictionary, displays information from the License Database in
memory.
Format
LICENSE LIST [product-name[,...]]
| 1 - 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.
| 2 - Qualifiers |
2.1 - /AUTHORIZATION
/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.
2.2 - /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.
2.3 - /BRIEF
/BRIEF (default)
Specifies a listing from the License Database that includes only
the license product and producer names.
2.4 - /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.5 - /FULL
Specifies a listing from the License Database that includes a
full display of the specified license or licenses.
2.6 - /HISTORY
Specifies a listing from the License Database that includes the
history records in the License Database for the specified license
or licenses.
2.7 - /ISSUER
/ISSUER=string
Positional qualifier.
Specifies the name of the company (for example, DEC) 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.
2.8 - /OUTPUT
/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.
2.9 - /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.10 - /RELEASE_DATE
/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.
2.11 - /SELECTION_WEIGHT
Produces a full display that includes the current selection
weights assigned to individual PAKs.
2.12 - /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.
2.13 - /TERMINATION_DATE
/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.
2.14 - /VERSION
/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.
| 3 - 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:
o After you enter LICENSE LIST with the /BRIEF qualifier, you
can scroll through the display with the arrow keys on your
keyboard.
o 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.
| 4 - Examples |
1.$ LICENSE LIST/FULL
This command displays a list of the names of product licenses
in the License Database. Note that the LMF Version shown refers
to the software that created the database.
CTRL/Z to exit, PF3-PF4 for Prev-Next Screen, ArrowKeys 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
2.$ LICENSE LIST /HISTORY FORTRAN
This example displays a listing with full information of a
current Fortran license issued by Compaq.
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.
CTRL/Z to exit, PF3-PF4 for Prev-Next Screen, ArrowKeys 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
|
|
