 |
HP OpenVMS License Management Utility Manual
LICENSE UNLOAD
Unloads a license, making the product unavailable from the current
node. The product license or licenses must be registered in the License
Database and must have been previously loaded with an interactive or
automatic LICENSE LOAD command. Running processes are allowed to
continue to completion.
To use this command, you need CMKRNL, SYSNAM, and SYSPRV privileges.
Format
LICENSE UNLOAD product-name[,...]
Parameter
product-name[,...]
Name of the product to be unloaded. You can unload only licenses that
have been loaded. Enter each product name exactly as it appears on its
Product Authorization Key (PAK). You cannot use wildcard characters for
product-name.
Qualifiers
/LOG
/NOLOG (default)
Controls whether LICENSE UNLOAD lists the name of each unloaded license.
/PRODUCER=string
Positional qualifier.
Specifies the name of the company (for example, DEC) that owns the
product for which you have a license. The default string for this
qualifier on Alpha and VAX is DEC. On I64, the default string
is HP. If DEC or HP is not the producer of the product, you must use
this qualifier to identify the product. This qualifier affects only the
product name that immediately precedes it in the command string.
Wildcard characters are not allowed.
Description
LICENSE UNLOAD affects all units for a single product even if the
loaded units are combined from multiple licenses. In such a case, you
cannot unload the units from a single license. You must unload all the
units.
You are not required to unload a loaded license before modifying data
in the License Database. To maximize product availability, modify
licenses in the License Database first, and then load the changes by
entering a LICENSE UNLOAD command followed by a LICENSE LOAD command.
Examples
| #1 |
$ LICENSE UNLOAD /PRODUCER=DEC FORTRAN
|
This command unloads the HP Fortran license on the node from which it
is entered.
| #2 |
$ LICENSE UNLOAD PASCAL,FORTRAN
|
This command unloads the HP Pascal and HP Fortran licenses on the node
from which it is entered.
SHOW LICENSE
Displays software product licenses active on the current node and lists
the names attached to a license (known as the RESERVE list). The SHOW
LICENSE command displays the license database information currently in
your system's memory. Use the License Management utility command,
LICENSE LIST, when you want to view the license database information
that is on disk.
Format
SHOW LICENSE [product-name [,...]]
Parameter
product-name
Specifies the name or names of activated software product licenses to
display. The asterisk (*) and the percent sign (%) wildcard characters
are allowed. If you do not specify a product name, information is
displayed about all active product name licenses. The
product-name parameter is incompatible with the
/UNIT_REQUIREMENTS qualifier.
Description
The DCL command SHOW LICENSE displays software product licenses active
on the current node. An active license is one that has been registered
in the LICENSE database and has been loaded into system
memory. To register and activate software product licenses, use the
License Management utility (LICENSE) or VMSLICENSE.COM. Some licenses
are registered automatically during product installation.
To display licenses registered in the LICENSE database, use the LICENSE
LIST command.
Qualifiers
/ALL
(IA64 only) Use with /HIERARCHY to display all OE licenses defined in
the LMF database
/BEFORE
Use with /TERMINATION_DATE and /RELEASE_DATE qualifiers. 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)
Displays a summary of information about the specified active product
licenses. Use the /FULL qualifier to obtain a complete product license
listing.
/CHARGE_TABLE
Synonym for the /UNIT_REQUIREMENTS qualifier.
/CLUSTER
Use with the /UNIT_REQUIREMENTS qualifier to display the license unit
requirements for every node in an OpenVMS Cluster.
/EXACT
Use with the /PAGE=SAVE and /SEARCH qualifiers to specify a search
string that must match the search string exactly and must be enclosed
with quotation marks (" ").
If you specify the /EXACT qualifier without the /SEARCH qualifier,
exact search mode is enabled when you set the search string with the
Find (E1) key.
/FULL
Displays a summary of information about the specified active product
licenses, including Product Authorization Key (PAK) options and the
reserve list (if any). On I64 systems, lists the licenses for OEs
currently active on the system.
/HIERARCHY - I64 only
Displays the hierarchy of licenses for operating environments active on
the current node.
/HIGHLIGHT[=keyword]
Use with the /PAGE=SAVE and /SEARCH qualifiers to specify the type of
highlighting you want when a search string is found. When a string is
found, the entire line is highlighted. You can use the following
keywords: BOLD, BLINK, REVERSE, and UNDERLINE. BOLD is the default
highlighting.
/OE[=OE name] - I64 only
When an OE name is specified, displays the contents the of named
operating environment. Currently, valid OE names are FOE, EOE, and
MCOE. When no OE name is specified, displays the operating environment
currently active on the node.
/OUTPUT[=filespec]
/NOOUTPUT
Controls where the output of the SHOW LICENSE command is sent. By
default, the output of the SHOW LICENSE command is sent to the current
SYS$OUTPUT device (usually your terminal). To send the output to a
file, use the /OUTPUT qualifier followed by a file specification.
The asterisk (*) and the percent sign (%) wildcard characters are not
allowed in the file specification. If you enter a partial file
specification (for example, specifying only a directory), SHOW is the
default file name and .LIS is the default file type.
If you enter the /NOOUTPUT qualifier, output is suppressed.
/PAGE[=keyword]
/NOPAGE (default)
Controls the display of license information on the screen.
You can use the following keywords with the /PAGE qualifier:
|
CLEAR_SCREEN
|
Clears the screen before each page is displayed.
|
|
SCROLL
|
Displays information one line at a time.
|
|
SAVE[=
n]
|
Enables screen navigation of information, where
n is the number of pages to store.
|
The /PAGE=SAVE qualifier allows you to navigate through screens of
information. The /PAGE=SAVE qualifier stores up to 5 screens of up to
255 columns of information. When you use the /PAGE=SAVE qualifier, you
can use the following keys to navigate through the information:
| Key Sequence |
Description |
|
Up arrow key, Ctrl/B
|
Scroll up one line.
|
|
Down arrow key
|
Scroll down one line.
|
|
Left arrow key
|
Scroll left one column.
|
|
Right arrow key
|
Scroll right one column.
|
|
Find (E1)
|
Specify a string to find when the information is displayed.
|
|
Insert Here (E2)
|
Scroll right one half screen.
|
|
Remove (E3)
|
Scroll left one half screen.
|
|
Select (E4)
|
Toggle 80/132 column mode.
|
|
Prev Screen (E5)
|
Get the previous page of information.
|
|
Next Screen (E6), Return, Enter, Space
|
Get the next page of information.
|
|
F10, Ctrl/Z
|
Exit. (Some utilities define these differently.)
|
|
Help (F15)
|
Display utility help text.
|
|
Do (F16)
|
Toggle the display to oldest/newest page.
|
|
Ctrl/W
|
Refresh the display.
|
The /PAGE qualifier is not compatible with the /OUTPUT qualifier.
/PRODUCER=producer-name
Displays software product licenses active on the current node and
supplied by the specified producer. The asterisk (*) and the percent
sign (%) wildcard characters are allowed for the producer-name
parameter. You cannot use the /PRODUCER qualifier with the
/UNIT_REQUIREMENTS qualifier.
For HP Products
Only
On OpenVMS VAX and Alpha systems, the producer is shown as DEC. On
OpenVMS I64 systems, the producer is shown as HP.
|
/RELEASE_DATE=[date_time]
Allows listing licenses using release dates as selection criteria.
/SEARCH="string"
Use with the /PAGE=SAVE qualifier to specify a string that you want to
find in the information being displayed. Quotation marks are required
for the /SEARCH qualifier, if you include spaces in the text string.
You can also dynamically change the search string by pressing the Find
key (E1) while the information is being displayed. Quotation marks are
not required for a dynamic search.
/SINCE(default)
Use with the /TERMINATION_DATE and /RELEASE_DATE qualifiers. Selects
only those licenses whose times are on or after the time specified with
the other qualifiers.
The /SINCE qualifier cannot be used with the /BEFORE qualifier.
/TERMINATION_DATE=date_time
Allows listing licenses using termination dates as selection criteria.
/UNIT_REQUIREMENTS
On Alpha and VAX systems, displays information in the License Unit
Requirement Table (LURT). On I64 systems, displays information about
the type of system, the number of processor cores active, and the
number of sockets. The /UNIT_REQUIREMENTS qualifier is incompatible
with the product-name parameter and with the /BRIEF and
/PRODUCER qualifiers.
/USAGE
Tells you how many license units are loaded, how many are currently
allocated, and how many are currently available, as well as the license
type for each product on the system. Use with the /FULL qualifier to
display complete information---including the PID, process name, node,
or user name---for each instance of use of the product. You need group
privilege to see the list of users in your group who have allocated
license units; you need world privilege to see the list of users in all
groups.
In an OpenVMS Cluster, if you own multiple license types for a single
product, you are limited to viewing the usage information for the
license type loaded on the node from which you are executing the SHOW
LICENSE/USAGE command. To find out the usage of the other license type
loaded on another node, issue the command on that node. You can also
use the System Management (SYSMAN) utility to do this.
In an OpenVMS Cluster, usage information is limited to the local
license type. For example, VAX and Alpha availability licenses are
considered by LMF to be different license types. If you are running
both VAX and Alpha systems in a cluster, usage information for
availability licenses is limited to the local system type. For example,
if you have DEC C installed on all nodes in your OpenVMS Cluster, you
can display DEC C license allocation on all the VAX nodes in the
cluster from any VAX node with DEC C installed, but you cannot display
the DEC C license allocation on the Alpha nodes.
Usage information is not available for unlimited licenses (a license
with 0 units). Clusterwide usage information is not available for
personal use or NO_SHARE licenses. Refer to the HP OpenVMS License Management Utility Manual for more
information on license types.
/WARNING_INTERVAL=n
NOWARNING_INTERVAL
Displays a warning stating the number of licenses that will terminate
in n days. The default is 30 days.
/WRAP
/NOWRAP (default)
Use with the /PAGE=SAVE qualifier to limit the number of columns to the
width of the screen and to wrap lines that extend beyond the width of
the screen to the next line.
The /NOWRAP qualifier extends lines beyond the width of the screen and
can be seen when you use the scrolling (left and right) features
provided by the /PAGE=SAVE qualifier.
Examples
| #1 |
$ SHOW LICENSE/FULL
Active licenses on node WTPOOH:
DVNETEND
Producer: DEC
Units: 0
Version: 0.0
Release Date: (none)
Termination Date: 25-DEC-2007
Availability: 0
Activity: 100
MOD_UNITS
Product Token:
OPENVMS-ALPHA
Producer: DEC
Units: 0
Version: 0.0
Release Date: (none)
Termination Date: 22-OCT-2007
Availability: 0
Activity: 100
MOD_UNITS
Product Token:
|
In this example, the SHOW LICENSE command displays all the active
licenses on the current Alpha node, WTPOOH.
| #2 |
$ SHOW LICENSE/FULL
Active licenses on node MACCHU:
C
Producer: HP
Units: 3
Version: 0.0
Release Date: (none)
Termination Date: 25-DEC-2007
Availability: 0
Activity: 1
MOD_UNITS
IA64_ALPHA
Product Token:
DVNETEXT
Producer: HP
Units: 20
Version: 0.0
Release Date: (none)
Termination Date: 6-FEB-2008
Per Core License
Activity: 0
IA64
Product Token:
OPENVMS-I64-FOE
Producer: HP
Units: 2
Version: 0.0
Release Date: (none)
Termination Date: 25-DEC-2007
Per Core License
Activity: 0
IA64
Product Token:
|
In this example, the SHOW LICENSE command displays all the active
licenses on the current I64 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/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.
| #5 |
$ SHOW LICENSE/CHARGE_TABLE
OpenVMS I64/LMF Charge Information for node MACCHU
This is an HP rx2600 (900MHz/1.5MB), with 2 processor cores active, 2 socket(s)
Type: PCL, Units Required: 2 (I64 Per Processor)
|
This example displays the CHARGE_TABLE information for an I64 node
MACCHU with 2 active processor cores.
| #6 |
$ SHOW LICENSE/CHAR/CLUSTER
VMS/LMF Cluster License Unit Requirements Information 1-APR-2004 13:56:45.61
Node A B C D E F G H I PPL
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: PCL, Units Required: 3 (I64 Per Processor)
|
In this example, the display shows how many license units are required
for each license type (A, B, etc. on Alpha and VAX and PPL on I64) 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.
| #7 |
$ SHOW LICENSE/OE
Current Operating Environment on node MACCHU at 1-APR-2004 14:00:09.70:
--------- Operating Environment ---------- ------ Units ------
Name Description Type Level Loaded Total
MCOE Mission Critical H 2 1 1
|
This example shows the currently operating environment (MCOE) on an I64
node MACCHU.
| #8 |
$ SHOW LICENSE/HIER/FULL
Operating Environment Hierarchy
-------------------------------
--------- Operating Environment ---------- ------ Units ------
Name Description Type Level Loaded Total
MCOE Mission Critical H 3 2 2
RTR-SVR
VMSCLUSTER
VMSCLUSTER-CLIENT
EOE Enterprise H 2 - 2
DECRAM
RMSJNL
AVAIL_MAN
VOLSHAD
SYSMGT
FOE Foundation H 2 2 4
OPENVMS-I64
OPENVMS-USER
DVNETEND
DW-MOTIF
|
This example displays information about the available operating
environments, the hierarchy among them, and the products contained in
each OE on an I64 system.
| #9 |
$ SHOW LICENSE/OE=FOE/FULL
--------- Operating Environment ---------- ------ Units ------
Name Description Type Level Loaded Total
FOE Foundation H 1 2 3
OPENVMS-I64
OPENVMS-USER
DVNETEND
DW-MOTIF
UCX
TDC
DCOM-MIDL
X500-ADMIN-FACILITY
|
This example shows all the products included in the Foundation
Operating Environment (FOE) on an I64 node.
| #10 |
$ SHOW LICENSE OPENVMS-I64-MCOE
Active licenses on node MACCHU:
------- Product ID -------- ---- Rating ----- -- Version --
Product Producer Units PCL Activ Version Release Termination
OPENVMS-I64-MCOE HP 20 1 0 0.0 (none) 6-FEB-2005
|
This example shows licensing information for the MCOE environment
currently active on an I64 node MACCHU.
Qualifiers
/WARNING_INTERVAL=n
NOWARNING_INTERVAL
Displays a warning stating the number of licenses that will terminate
in n days. The default is 30 days.
/WRAP
/NOWRAP (default)
Use with the /PAGE=SAVE qualifier to limit the number of columns to the
width of the screen and to wrap lines that extend beyond the width of
the screen to the next line.
The /NOWRAP qualifier extends lines beyond the width of the screen and
can be seen when you use the scrolling (left and right) features
provided by the /PAGE=SAVE qualifier.
Description
The DCL command SHOW LICENSE displays software product licenses active
on the current node. An active license is one that has been registered
in the LICENSE database and has been loaded into system
memory. To register and activate software product licenses, use the
License Management utility (LICENSE) or VMSLICENSE.COM. Some licenses
are registered automatically during product installation.
To display licenses registered in the LICENSE database, use the LICENSE
LIST command.
Examples
| #1 |
$ SHOW LICENSE/FULL
Active licenses on node WTPOOH:
DVNETEND
Producer: DEC
Units: 0
Version: 0.0
Date: (none)
Termination Date: (none)
Availability: E (System Integrated Products)
Activity: 0
MOD_UNITS
VAX-VMS
Producer: DEC
Units: 0
Version: 0.0
Date: (none)
Termination Date: (none)
Availability: A (VMS Capacity)
Activity: 0
MOD_UNITS
NO_SHARE
|
In this example, the SHOW LICENSE command displays all the active
licenses on the current node, WTPOOH.
| #2 |
$ SHOW LICENSE/BRIEF
Active licenses on node WTPOOH:
--- Product ID ---- ---- Rating ----- -- Version --
Product Producer Units Avail Activ Version Release Termination
DVNETEND DEC 0 E 0 0.0 (none) (none)
VAX-VMS DEC 0 A 0 0.0 (none) (none)
|
The SHOW LICENSE command in this example displays a summary of all the
active licenses on the current node, WTPOOH.
| #3 |
$ 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.
| #4 |
$ 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).
| #5 |
$ 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 DEC 0 A 0 0.0 (none) (none)
TEST02 DEC 0 B 0 0.0 10-JAN-2014 12-NOV-2014
TEST03 DEC 0 C 0 0.0 30-DEC-2014 (none)
TEST04 DEC 0 D 0 0.0 (none) 25-AUG-2015
TEST05 DEC 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 DEC 0 B 0 0.0 10-JAN-2014 12-NOV-2014
TEST03 DEC 0 C 0 0.0 30-DEC-2014 (none)
TEST05 DEC 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 DEC 0 A 0 0.0 (none) (none)
TEST04 DEC 0 D 0 0.0 (none) 25-AUG-2015
|
In these examples, the SHOW LICENSE command uses the /TERM, /RELEASE,
/SINCE and /BEFORE qualifiers.
| #6 |
$ SHOW LICENSE/UNIT_REQUIREMENTS
VMS/LMF Charge Information for node PICCHU
This is a VAX 6000-420, hardware model type 160
Type: A, Units Required: 93 (VMS Capacity)
Type: B, * Not Permitted * (VMS Server)
Type: C, * Not Permitted * (VMS Concurrent User)
Type: D, * Not Permitted * (VMS Workstation)
Type: E, Units Required: 400 (System Integrated Products)
Type: F, Units Required: 1200 (Layered Products)
Type: G, * Not Permitted * (VMS Reserved)
Type: H, * Not Permitted * (Alpha Layered Products)
Type: I, Units Required: 1200 (Layered Products)
|
In this example, the /UNIT_REQUIREMENTS qualifier displays information
in the License Unit Requirement Table (LURT).
| #7 |
$ SHOW LICENSE/WARNING_INTERVAL=8000 test0%
Active licenses on node PICCHU:
--- Product ID ---- ---- Rating ----- -- Version --
Product Producer Units Avail Activ Version Release Termination
TEST01 DEC 0 A 0 0.0 (none) (none)
TEST02 DEC 0 B 0 0.0 10-JAN-2014 12-NOV-2014
TEST03 DEC 0 C 0 0.0 30-DEC-2014 (none)
TEST04 DEC 0 D 0 0.0 (none) 25-AUG-2015
TEST05 DEC 0 E 0 0.0 14-NOV-2016 14-AUG-2016
%SHOW-I-TERMIMM, 3 licenses will terminate in 8000 days
|
|
