HP OpenVMS DCL Dictionary


Previous Contents Index


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.

For a complete description of this utility, see the HP OpenVMS License Management Utility Manual.

To display licenses registered in the LICENSE database, use the LICENSE LIST command.


Qualifiers

/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 products included in the operating environment 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 OE name is specified, displays the settings for the named operating environment currently active on the node. 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.

Note

On OpenVMS VAX and Alpha systems, the producer is shown as DEC. On OpenVMS I64 systems, the producer displays 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 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.

/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 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-2004 
        Availability: 0 
        Activity: 100 
        MOD_UNITS 
        Product Token: 
 
OPENVMS-ALPHA 
        Producer: DEC 
        Units: 0 
        Version: 0.0 
        Release Date: (none) 
        Termination Date: 22-OCT-2004 
        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: HP 
        Units: 3 
        Version: 0.0 
        Release Date: (none) 
        Termination Date: 25-DEC-2004 
        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-2005 
        Per Processor License 
        Activity: 0 
        IA64 
        Product Token: 
 
OPENVMS-I64-FOE 
        Producer: HP 
        Units: 2 
        Version: 0.0 
        Release Date: (none) 
        Termination Date:  25-DEC-2004 
        Per Processor License 
        Activity: 0 
        MOD_UNITS 
        IA64 
        Product Token: 
      

The SHOW LICENSE command in this example 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 IPL31
This is an HP rx2600  (900MHz/1.5MB), with 2 cores active.
This platform supports up to 2 processor socket(s)
Type: PPL,   Units Required: 2  (I64 Per Processor)
Type: PCL,   Units Required: 2  (I64 Per Core) 
      

In this example, the CHARGE_TABLE information for an I64 node IPL31 with 2 active cores is displayed; one PPL and one PCL.

#6

$ SHOW LICENSE/CHAR/CLUSTER
 
VMS/LMF Cluster License Unit Requirements Information    1-APR-2004 
 
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: PPL, 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 
 
----- Operating Environment ---------- ---- Units ----- Compliance 
Name  Description           Type Level Loaded     Total  (Yes/No) 
MCOE  Mission Critical        H    2        1         1     No 
      

This example shows the currently operating environment (MCOE) on an I64 node MACCHU.

#8

$ SHOW LICENSE/HIER/FULL
                     Operating Environment Hierarchy 
                     ------------------------------- 
 
-------- Operating Environment ---------- ---- Units ----- Compliance 
Name     Description           Type Level Loaded     Total  (Yes/No) 
MCOE     Mission Critical        H    2        1         1     No 
  RTR-SVR 
  VMSCLUSTER 
  VMSCLUSTER-CLIENT 
EOE      Enterprise              H    1        -         1     No 
  DECRAM 
  RMSJNL 
  AVAIL_MAN 
  VOLSHAD 
  SYSMGT 
FOE      Foundation              H    0        2         3    Yes 
  OPENVMS-I64 
  OPENVMS-USER 
  DVNETEND 
  DW-MOTIF 
      

This example displays information about the currently active 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 ----- Compliance 
Name     Description           Type Level Loaded     Total  (Yes/No) 
FOE      Foundation              H    0        2         3    Yes 
  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 PPL   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.


Previous Next Contents Index