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 [,...]]
1 – 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.
2 – 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.
For a complete description of this utility, see the VSI OpenVMS
License Management Utility Manual.
To display licenses registered in the LICENSE database, use the
LICENSE LIST command.
3 – Qualifiers
3.1 /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.
3.2 /BRIEF
/BRIEF (default)
Displays a summary of information about the specified active
product licenses. Use the /FULL qualifier to obtain a complete
product license listing.
3.3 /CHARGE_TABLE
Synonym for the /UNIT_REQUIREMENTS qualifier.
3.4 /CLUSTER
Use with the /UNIT_REQUIREMENTS qualifier to display the license
unit requirements for every node in an OpenVMS Cluster.
3.5 /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.
3.6 /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 Integrity server
systems, lists the products included in the operating environment
currently active on the system.
3.7 /HIERARCHY
/HIERARCHY (Integrity servers only)
Displays the hierarchy of licenses for operating environments
active on the current node.
3.8 /HIGHLIGHT
/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.
3.9 /OE
/OE[=OE name] (Integrity servers only)
When OE name is specified, displays the settings for the named
operating environment currently active on the node. Valid OE
names are FOE, BOE, EOE, MCOE, and HAOE. When no OE name is
specified, displays the operating environment currently active
on the node.
3.10 /OUTPUT
/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.
3.11 /PAGE
/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, Scroll up one line.
Ctrl/B
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), Get the next page of information.
Return, Enter,
Space
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.
3.12 /PRODUCER
/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.
NOTE
On OpenVMS Alpha systems, the producer is shown as DEC. On
OpenVMS Integrity server systems, the producer displays as
VSI.
3.13 /RELEASE_DATE
/RELEASE_DATE=[date_time]
Allows listing licenses using release dates as selection
criteria.
3.14 /SEARCH
/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.
3.15 /SINCE
/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.
3.16 /TERMINATION_DATE
/TERMINATION_DATE=date_time
Allows listing licenses using termination dates as selection
criteria.
3.17 /UNIT_REQUIREMENTS
On Alpha systems, displays information in the License Unit
Requirement Table (LURT). On Integrity server systems, displays
information about the type of system, the number of active cores,
and the number of sockets. The /UNIT_REQUIREMENTS qualifier is
incompatible with the product-name parameter and with the /BRIEF
and /PRODUCER qualifiers.
3.18 /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. see the VSI
OpenVMS License Management Utility Manual for more information
on license types.
3.19 /WARNING_INTERVAL
/WARNING_INTERVAL=n
NOWARNING_INTERVAL
Displays a warning stating the number of licenses that will
terminate in n days. The default is 30 days.
3.20 /WRAP
/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.
4 – 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 --