HELPLIB.HLB  —  SHOW  LICENSE  Qualifiers

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.

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    /CHARGE_TABLE

    Synonym for the /UNIT_REQUIREMENTS qualifier.

4    /CLUSTER

    Use with the /UNIT_REQUIREMENTS qualifier to display the license
    unit requirements for every node in an OpenVMS Cluster.

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.

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.

7    /HIERARCHY

       /HIERARCHY (Integrity servers only)

    Displays the hierarchy of licenses for operating environments
    active on the current node.

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.

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.

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.

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.

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.

13    /RELEASE_DATE

       /RELEASE_DATE=[date_time]

    Allows listing licenses using release dates as selection
    criteria.

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.

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.

16    /TERMINATION_DATE

       /TERMINATION_DATE=date_time

    Allows listing licenses using termination dates as selection
    criteria.

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.

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.

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.

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.
Close Help