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 VSI OpenVMS DCL
Dictionary and in this help, 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, VSI) 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, VSI) 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 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.
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 /FULL
This example displays a list of the names of product licenses
in the License Database on an OpenVMS Integrity server system.
CTRL/Z to exit, PF3-PF4 for Prev-Next Screen, ArrowKeys 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: VSI
Authorization: USA-1715
Product Name: C
Producer: VSI
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: VSI
Authorization: I64-AB-001
Product Name: DVNETEXT
Producer: VSI
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: VSI
Authorization: I64-AB-004
Product Name: OPENVMS-I64-BOE
Producer: VSI
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 VSI.
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
4.$ LICENSE LIST /FULL
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: VSI
Authorization: I64-AB-001
Product Name: OPENVMS-I64-HAOE
Producer: VSI
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