Copyright Digital Equipment Corp. All rights reserved.
Examples
1.$ SHOW LICENSE/FULL
Active licenses on node WTPOOH:
DVNETEND
Producer: DEC
Units: 0
Version: 0.0
Release Date: (none)
Termination Date: 31-DEC-2012
Availability: 0
Activity: 100
MOD_UNITS
Product Token:
OPENVMS-ALPHA
Producer: DEC
Units: 0
Version: 0.0
Release Date: (none)
Termination Date: 31-DEC-2012
Availability: 0
Activity: 100
MOD_UNITS
Product Token:
The SHOW LICENSE command in this example displays all the
active licenses on the current Alpha node, WTPOOH.
2.$ SHOW LICENSE/FULL
Active licenses on node MACCHU:
C
Producer: VSI
Units: 3
Version: 0.0
Release Date: (none)
Termination Date: 31-DEC-2012
Availability: 0
Activity: 1
MOD_UNITS
IA64_ALPHA
Product Token:
DVNETEXT
Producer: VSI
Units: 4
Version: 0.0
Release Date: (none)
Termination Date: 31-DEC-2012
Per Core License
Activity: 0
IA64
Product Token:
OPENVMS-I64-BOE
Producer: VSI
Units: 4
Version: 0.0
Release Date: (none)
Termination Date: 31-DEC-2012
Per Core License
Activity: 0
IA64
Product Token:
The SHOW LICENSE command in this example displays all the
active licenses on the current Integrity server node, MACCHU.
3.$ SHOW LICENSE/BRIEF
Active licenses on node WTPOOH:
--- Product ID ---- ---- Rating ----- -- Version --
Product Producer Units Avail Activ Version Release Termination
DVNETEND DEC 0 0 100 0.0 (none) (none)
VAX-VMS DEC 0 0 100 0.0 (none) (none)
The SHOW LICENSE command in this example displays a summary of
all the active licenses on the current VAX node, WTPOOH.
4.$ SHOW LICENSE/OUTPUT=SYS$LOGIN:ACTIVE_LICENSES_OCT30.DAT
The SHOW LICENSE command in this example writes all the active
licenses to the file named SYS$LOGIN:ACTIVE_LICENSES_OCT30.DAT.
5.$ SHOW LICENSE/FULL PERSONAL
Active licenses on node PICCHU:
PERSONAL
Producer: DEC
Units: 100
Version: 0.0
Release Date: (none)
Termination Date: (none)
Availability: 0
Activity: 100
RESERVE_UNITS
Reserve: RANCE
The SHOW LICENSE command in this example displays information
about the product PERSONAL, as well as the name RANCE attached
to the product license (known as the RESERVE list).
6.$ SHOW LICENSE/TERM=10-JAN-2014 test0%
Active licenses on node PICCHU:
--- Product ID ---- ---- Rating ----- -- Version --
Product Producer Units Avail Activ Version Release Termination
TEST01 VSI 0 A 0 0.0 (none) (none)
TEST02 VSI 0 B 0 0.0 10-JAN-2014 12-NOV-2014
TEST03 VSI 0 C 0 0.0 30-DEC-2014 (none)
TEST04 VSI 0 D 0 0.0 (none) 25-AUG-2015
TEST05 VSI 0 E 0 0.0 14-NOV-2016 14-AUG-2016
$ SHOW LICENSE/RELEASE=10-JAN-2014/SINCE test0%
Active licenses on node PICCHU:
--- Product ID ---- ---- Rating ----- -- Version --
Product Producer Units Avail Activ Version Release Termination
TEST02 VSI 0 B 0 0.0 10-JAN-2014 12-NOV-2014
TEST03 VSI 0 C 0 0.0 30-DEC-2014 (none)
TEST05 VSI 0 E 0 0.0 14-NOV-2016 14-AUG-2016
$ SHOW LICENSE/RELEASE=10-JAN-2014/BEFORE test0%
Active licenses on node PICCHU:
--- Product ID ---- ---- Rating ----- -- Version --
Product Producer Units Avail Activ Version Release Termination
TEST01 VSI 0 A 0 0.0 (none) (none)
TEST04 VSI 0 D 0 0.0 (none) 25-AUG-2015
In these examples, the SHOW LICENSE command uses the /TERM,
/RELEASE, /SINCE and /BEFORE qualifiers.
7.$ SHOW LICENSE/UNIT_REQUIREMENTS
VMS/LMF Charge Information for node PICCHU
This is a AlphaServer 8400 5/440, hardware model type 1567
Type: A, Units Required: 2700 (VAX/VMS Capacity or OpenVMS
Unlimited or Base)
Type: B, * Not Permitted * (VAX/VMS F&A Server)
Type: C, * Not Permitted * (VAX/VMS Concurrent User)
Type: D, * Not Permitted * (VAX/VMS Workstation)
Type: E, * Not Permitted * (VAX/VMS System Integrated Products)
Type: F, * Not Permitted * (VAX Layered Products)
Type: G, * Not Permitted * (Reserved)
Type: H, Units Required: 1150 (Alpha Layered Products)
Type: I, Units Required: 1150 (Layered Products)
In this example, the /UNIT_REQUIREMENTS qualifier displays
information in the License Unit Requirement Table (LURT) for
the Alpha node PICCHU.
8.$ SHOW LICENSE/CHARGE_TABLE
OpenVMS I64/LMF Charge Information for node MACCHU
This is an HP rx2600(900MHz/1.5MB), with 2 CPUs active, 2 socket(s)
Type: PPL, Units Required: 2 (I64 Per Processor)
Type: PCL, Units Required: 2 (I64 Per Core)
This example displays the CHARGE_TABLE information for an
Integrity server node MACCHU with two active processor cores.
9.$ SHOW LICENSE/CHAR/CLUSTER
VMS/LMF Cluster License Unit Requirements Information 14-MAR-2010
06:39:41.54
Node A B C D E F G H I PCL
FISH 20 - - - - - - 1050 1050 -
SWORD 15 - - - - - - 1050 1050 -
SALMON 12 - - - - - - 1050 1050 -
MONGER 12 - - - - - - 1050 1050 -
GORDON 15 - - - - - - 1050 1050 -
ARTIST - - - - - - - - - 2
PAINTS - - - - - - - - - 1
Total Cluster Unit Requirements
Type: A, Units Required: 74 (VAX/VMS Capacity or OpenVMS
Unlimited or Base)
Type: B, * Not Permitted * (VAX/VMS F&A Server)
Type: C, * Not Permitted * (VAX/VMS Concurrent User)
Type: D, * Not Permitted * (VAX/VMS Workstation)
Type: E, * Not Permitted * (VAX/VMS System Integrated Products)
Type: F, * Not Permitted * (VAX Layered Products)
Type: G, * Not Permitted * (Reserved)
Type: H, Units Required: 5250 (Alpha Layered Products)
Type: I, Units Required: 5250 (Layered Products)
Type: PPL, Units Required: 3 (I64 Per Processor)
Type: PCL, Units Required: 3 (I64 Per Core)
In this example, the display shows how many license units are
required for each license type (A, B, etc. on Alpha and VAX
and PCL on Integrity servers) on each node in the cluster. If a
row of three asterisks (***) is displayed for a node, it means
that the node is in the process of booting.
10$ SHOW LICENSE/OE
Current Operating Environment on node MACCHU at 8-MAR-2010
16:12:51.72
--------- Operating Environment ---------- ------ Units ------
Name Description Type Level Loaded Total
HAOE High Availability H 5 4 4
This example shows the currently operating environment (HAOE)
on an Integrity server node MACCHU.
11$ SHOW LICENSE/HIER/FULL
Operating Environment Hierarchy
-------------------------------
--------- Operating Environment ---------- ------ Units ------
Name Description Type Level Loaded Total
HAOE High Availability H 5 2 2
GWLM
MCOE Mission Critical H 4 - 2
RTR-SVR
VMSCLUSTER
VMSCLUSTER-CLIENT
EOE Enterprise H 3 - 2
AVAIL-MAN
RMSJNL
VOLSHAD
BOE Base H 2 - 2
DECRAM
OMS
FOE Foundation H 1 - 2
OPENVMS-I64
OPENVMS-USER
DVNETEND
DW-MOTIF
UCX
TDC
X500-ADMIN-FACILITY
X500-DIRECTORY-SERVER
CIFS
This example displays information about the available operating
environments, the hierarchy among them, and the products
contained in each OE on an Integrity servers system.
12$ SHOW LICENSE/OE=BOE/FULL
--------- Operating Environment ---------- ------ Units ------
Name Description Type Level Loaded Total
BOE Base H 2 4 7
DECRAM
OMS
OPENVMS-I64
OPENVMS-USER
DVNETEND
DW-MOTIF
UCX
TDC
X500-ADMIN-FACILITY
X500-DIRECTORY-SERVER
CIFS
This example shows all the products included in the Base
Operating Environment (BOE) on an Integrity server node.
13$ SHOW LICENSE OPENVMS-I64-HAOE
Active licenses on node MACCHU:
------- Product ID -------- ---- Rating ----- -- Version --
Product Producer Units PCL Activ Version Release Termination
OPENVMS-I64-HAOE VSI 4 1 0 0.0 (none) 10-MAR-2011
This example shows licensing information for the HA-OE
environment currently active on an Integrity server node
MACCHU.
14$ SHOW LICENSE/WARNING_INTERVAL=8000 test0%
Active licenses on node PICCHU:
--- Product ID ---- ---- Rating ----- -- Version --
Product Producer Units Avail Activ Version Release Termination
TEST01 VSI 0 A 0 0.0 (none) (none)
TEST02 VSI 0 B 0 0.0 10-JAN-2014 12-NOV-2014
TEST03 VSI 0 C 0 0.0 30-DEC-2014 (none)
TEST04 VSI 0 D 0 0.0 (none) 25-AUG-2015
TEST05 VSI 0 E 0 0.0 14-NOV-2016 14-AUG-2016
%SHOW-I-TERMIMM, 3 licenses will terminate in 8000 days
The /WARNING_INTERVAL qualifier in this example displays three
licenses that will terminate in 8000 days.
15$ SHOW LICENSE/USAGE/FULL DECWRITE-USER
View of loaded licenses from node SLTG24 29-DEC-2001 13:36:22.23
ACTIVITY license DECWRITE-USER usage information:
Pid Process Name Units Username Node
416000E6 MACAHAY 100 MACAHAY SLTG24
416000E7 MACAHIGH 100 MACAHIGH SLTG24
416000E8 ALICE 100 ALICE SLTG24
416000E9 MORGEN 100 MORGEN SLTG24
416000F1 ANGEL 100 ANGEL SLTG24
416000F2 ANGEL_1 100 ANGEL SLTG24
Units loaded: 2000 Units allocated: 600 Units available: 1400
The SHOW LICENSE command in this example lists the current
users of the activity license for the product DECwrite. For
each instance of use of the product, the process identification
(PID), process name, node, and user name are identified. The
units column shows the number of units allocated for each
particular invocation of the product. The last line displays
the units loaded when the LICENSE LOAD command was given, the
total number of units currently allocated, and the total of
unused (available for others to use) units.
16$ SHOW LICENSE/USAGE/FULL TEST_PER
View of loaded licenses from node: SLTG24 30-DEC-2001 15:45:59
PERSONAL USE license VSI TEST_PER usage information:
Units Reserved for:
100 UNCLE
100 AUNT
100 NEPHEW
100 NIECE
Units loaded: 600 Units reserved: 400 Units available: 200
This example shows a personal use license. The VSI TEST_PER
product has enough units for six reservations with 100 units
for each reservation. The license database (LDB) only has
a total of four names in the reserve list attached to this
product. If the license administrator (usually the system
manager) wants to take full advantage of this license and adds
2 more names to the reserve list, he should use the following
commands to update the product information:
$ LICENSE MODIFY TEST_PER/RESERVE=(NAME, ANOTHER_NAME)/ADD
$ LICENSE UNLOAD TEST_PER
$ LICENSE LOAD TEST_PER
If this product is used in a cluster environment, you may use
the SYSMAN utility to unload and load the license.
17$ SHOW LICENSE/USAGE/FULL TEST_CAP
View of loaded licenses from node: SLTG24 30-DEC-2001 15:45:59
Availability license VSI TEST_CAP usage information:
Units Node
10 SLTG24
10 SLTG43
600 TORN8O
600 LTNUP
Units loaded: 620 Units allocated: 1220 Units available: ***
In this example, the number of units allocated appears to be
greater than the total units loaded and the units available
value is three asterisks (***).
When you see three asterisks (***) as the number of units
available, it is generally not a cause for alarm. This
situation might arise when the license database (LDB) has
been updated on disk, but the new information has not been
propagated to the license database in memory on all nodes in
the cluster. This node, SLTG24, happens to be one of the nodes
that has not received the latest LDB information.
To update the information in the license database in memory for
the TEST_CAP product, enter the following commands:
$ LICENSE UNLOAD TEST_CAP
$ LICENSE LOAD TEST_CAP
The next time you issue the SHOW LICENSE/USAGE command the
three asterisks (***) in display should disappear. If,
however, you are using multiple LDB files in a cluster, you
should read the section on the license database in the VSI
OpenVMS License Management Utility Manual.
18$ SHOW LICENSE/UNIT_REQUIREMENT/CLUSTER
VMS/LMF Cluster License Unit Requirements Information 24-DEC-2001
14:05:51.65
Node A B C D E F G H I
KARBO - - - 100 50 10 - - 10
JENJON - - - 100 50 10 - - 10
HELENA 143 - - - 600 2400 - - 2400
SHAKTI - - - 100 50 10 - - 10
Total Cluster Unit Requirements
Type: A, Units Required: 143 (VMS Capacity)
Type: B, * Not Permitted * (VMS Server)
Type: C, * Not Permitted * (VMS Concurrent User)
Type: D, Units Required: 300 (VMS Workstation)
Type: E, Units Required: 750 (System Integrated Products)
Type: F, Units Required: 2430 (Layered Products)
Type: G, * Not Permitted * (VMS Reserved)
Type: H, * Not Permitted * (Alpha Layered Products)
Type: I, Units Required: 2430 (Layered Products)
In this example, the display shows how many license units are
required for each license type (A, B, etc.) on each node in the
cluster. If a row of three asterisks (***) is displayed for a
node, it means that the node is in the process of booting.
19.$ SHOW LICENSE/USAGE
View of loaded licenses from node REDSOX 8-MAR-2010 16:20:11.14
------- Product ID ---- ---- Unit usage information ------
Product Producer Loaded Allocated Available Compliance
C VSI 250 0 250 Yes
DVNETEXT VSI 4 3 1 Yes
OPENVMS-I64-BOE VSI 2 2 0 Yes
OPENVMS-I64-HAOE VSI 20 8 12 Yes
VAXSET VSI 10 8 2 Yes
This example shows how many license units are loaded, how many
are currently allocated, and how many are available on REDSOX,
an Integrity servers system. The last column in the display
shows that are products are in compliance with their license
unit requirements.
20.$ SHOW LICENSE/USAGE
View of loaded licenses from node HOVMS2 8-MAR-2010 08:38:17.13
------- Product ID -------- ---- Unit usage information --------
Product Producer Loaded Allocated Available Compliance
OPENVMS-I64-HAOE VSI Virtual Machine guest, no usage information
Issuing the SHOW LICENSE/USAGE command from an OpenVMS guest
cluster member displays the text "Virtual Machine guest, no
usage information" for PCL licenses loaded on the system. There
is essentially no usage charge against the license units for
OpenVMS guest nodes since multiple guests can run on the same
host using the same license units.