Document revision date: 19 July 1999
[Compaq] [Go to the documentation home page] [How to order documentation] [Help on this site] [How to contact us]
[OpenVMS documentation]

OpenVMS License Management Utility Manual


Previous Contents Index

LICENSE DISABLE

Disables a license currently registered in the License Database.

Format

LICENSE DISABLE product-name[,...]


Parameter

product-name[,...]

Name or names of products with a license that you want to disable. You can disable only licenses that currently exist in the License Database. Enter the product name exactly as it appears on your Product Authorization Key (PAK).

Qualifiers

/ALL

Positional qualifier.

Specifies that all licenses with the given product name should be disabled. This qualifier affects only the product name that immediately precedes it in the command string.

/AUTHORIZATION=string

Positional qualifier.

Specifies a string that helps identify the license you want to disable. You must enter the authorization string exactly as it appears on your PAK. Use this optional qualifier only if you need it to identify the license. This qualifier affects only the product name that immediately precedes it in the command string.

/DATABASE=filespec

Specifies the location of the License Database. The default file specification is defined by the logical name LMF$LICENSE, which points to SYS$COMMON:[SYSEXE]LMF$LICENSE.LDB on an unmodified OpenVMS system. Use this optional qualifier only if you do not use the default License Database name and location.

/ISSUER=string

Positional qualifier.

Specifies the name of the company (for example, DEC) that issued the PAK for the product. Use this optional qualifier only if you need it to identify the license. This qualifier affects only the product name that immediately precedes it in the command string.

/LOG

/NOLOG (default)

Controls whether LICENSE DISABLE displays the name of each license that it disables.

/PRODUCER=string

Positional qualifier.

Specifies the name of the company (for example, DEC) that owns the product for which you have a license. Use this optional qualifier only if you need it to identify the license. This qualifier affects only the product name that immediately precedes it in the command string.


Description

LICENSE DISABLE does not immediately affect loaded licenses. To affect a loaded license, you must first enter a LICENSE UNLOAD command, which unloads the license, but allows current processes to finish using the product. Note that to immediately disable all loaded licences, you must shut down the system.

You cannot use LICENSE LOAD to activate a disabled license; you must first use LICENSE ENABLE.

LMF does not display error messages when you or the system attempts to unload a disabled license.


Example


$ LICENSE DISABLE ABCD /PRODUCER=DEC
      

This command disables the license for ABCD software produced by Digital. Because no database is specified, LMF uses the default database.

LICENSE ENABLE

Enables an existing license in the License Database so that you can load it with LICENSE LOAD. This command cancels the effect of LICENSE DISABLE, LICENSE COPY, and LICENSE ISSUE, which leave the license disabled. Newly registered licenses are enabled by default.

Format

LICENSE ENABLE product-name[,...]


Parameter

product-name[,...]

Name or names of products with a license to enable. You can enable only licenses that currently exist in the License Database. Enter the product name exactly as it appears on your PAK.

Qualifiers

/ALL

Positional qualifier.

Specifies that all licenses with the given product name should be enabled. This qualifier affects only the product name that immediately precedes it in the command string.

/AUTHORIZATION=string

Positional qualifier.

Specifies a string that helps identify the license you want to enable. You must enter the authorization string exactly as it appears on your PAK. Use this optional qualifier only if you need it to identify the license. This qualifier affects only the product name that immediately precedes it in the command string.

/DATABASE=filespec

Specifies the location of the License Database. The default file specification is defined by the logical name LMF$LICENSE, which points to SYS$COMMON:[SYSEXE]LMF$LICENSE.LDB on an unmodified OpenVMS system. Use this optional qualifier only if you do not use the default License Database name and location.

/ISSUER=string

Positional qualifier.

Specifies the name of the company (for example, DEC) that issued the PAK for the product. Use this optional qualifier only if you need it to identify the license. This qualifier affects only the product name that immediately precedes it in the command string.

/LOG

/NOLOG (default)

Controls whether LICENSE ENABLE displays the name of each license that it enables.

/PRODUCER=string

Positional qualifier.

Specifies the name of the company (for example, DEC) that owns the product for which you have a license. Use this optional qualifier only if you need it to identify the license. This qualifier affects only the product name that immediately precedes it in the command string.


Description

Use LICENSE ENABLE to reestablish disabled licenses as available for loading with a LICENSE LOAD command.

Enabled licenses can combine with other licenses when loaded for use. Do not enable a license that has expired, and be sure that all include, exclude, and reservation lists are up to date.

Use LICENSE LIST to inspect each license before you enable it. Use LICENSE MODIFY to change include, exclude, and reservation lists.

Because errors do not occur until enabled licenses are loaded, consider entering LICENSE LOAD immediately to load each newly enabled license on each appropriate node in an OpenVMS Cluster. If another combinable license for the same product is already loaded, first unload it with LICENSE UNLOAD. Use the DCL command SHOW LICENSE to see which licenses are currently active on your system. After you unload the other license, enter LICENSE LOAD to load the combination of the newly enabled license and the previously active license.


Example


$ LICENSE ENABLE DECSET /PRODUCER=DEC
      

This command enables the license for DECset software. Because no database is specified, LMF uses the default database. Next, load the license with LICENSE LOAD.

LICENSE ISSUE

Produces a replica of a Product Authorization Key (PAK) that is sent to a file or displayed on your terminal (the default). If the terms and conditions of your license contract allow it, you can then enter this PAK replica in the License Database of another processor. When you enter LICENSE ISSUE, LMF disables the license in the current License Database and marks the license DISABLED. To enable a license that has been marked ISSUED, enter LICENSE ENABLE.

For License Databases connected to a network, consider using LICENSE MOVE.


Format

LICENSE ISSUE product-name[,...]


Parameter

product-name[,...]

Name or names of products with a license to be issued. You can issue only licenses that currently exist in the License Database. Enter the product name exactly as it appears on your PAK.

Qualifiers

/ALL

Positional qualifier.

Specifies that all licenses with the given product name should be issued. This qualifier affects only the product name that immediately precedes it in the command string.

/AUTHORIZATION=string

Positional qualifier.

Specifies a string that helps identify the license you want to issue. You must enter the authorization string exactly as it appears on your PAK. Use this optional qualifier only if you need it to identify the license. This qualifier affects only the product name that immediately precedes it in the command string.

/DATABASE=filespec

Specifies the location of the License Database. The default file specification is defined by the logical name LMF$LICENSE, which points to SYS$COMMON:[SYSEXE]LMF$LICENSE.LDB on an unmodified OpenVMS system. Use this optional qualifier only if you do not use the default License Database name and location.

/ISSUER=string

Positional qualifier.

Specifies the name of the company (for example, DEC) that issued the PAK for the product. Use this optional qualifier only if you need it to identify the license. This qualifier affects only the product name that immediately precedes it in the command string.

/LOG

/NOLOG (default)

Controls whether LICENSE ISSUE displays the name of each license that it issues.

/OUTPUT[=filespec]

Specifies the name of the file to which your PAK replica is written. If you do not specify the /OUTPUT qualifier, or if you do not supply a file specification with this qualifier, the output is sent to SYS$OUTPUT.

If you specify a file name that already exists, this command creates a new version of the file. If you specify a complete file name and version that already exists, this command appends the PAK replica to the existing file.

/PROCEDURE

/NOPROCEDURE (default)

Specifies that the PAK replica is to be written in the form of a DCL command procedure. Use /PROCEDURE with the /OUTPUT qualifier to create a command procedure in a file. Then you can invoke the procedure to register the PAK replica in the License Database of another processor.

If you do not specify the /OUTPUT qualifier with /PROCEDURE, or if you do not supply a file specification with the /OUTPUT qualifier, the procedure is sent to SYS$OUTPUT.

/PRODUCER=string

Positional qualifier.

Specifies the name of the company (for example, DEC) that owns the product for which you have a license. Use this optional qualifier only if you need it to identify the license. This qualifier affects only the product name that immediately precedes it in the command string.


Description

If your license contract allows it, use LICENSE ISSUE to move a license from a License Database on one processor (or OpenVMS Cluster environment) to a License Database on another processor. To move a license, enter LICENSE ISSUE, including enough PAK information to clearly identify the license. LICENSE ISSUE automatically disables the current license but does not immediately unload it; LMF does not terminate any active processes. To unload the license, enter a LICENSE UNLOAD command.

After you issue the PAK replica, read the information, and register it on the new processor as you would any PAK, or, if you used the /PROCEDURE qualifier with the /OUTPUT qualifier, invoke the new DCL command procedure to register the license.

Note that the PAK replica includes only PAK information registered with a LICENSE REGISTER command. The replica does not include any changes made with other LICENSE commands.


Examples

#1

$ LICENSE ISSUE /OUTPUT=SYS$MANAGER:FORTRAN.PAK -
_$ /PRODUCER=DEC FORTRAN
                                         
      

This command issues a PAK replica, which you can use to register the Fortran license on a new processor (or OpenVMS Cluster environment), and puts it into the file named FORTRAN.PAK. The next step is to print the file, read the information, and, using a LICENSE REGISTER command or VMSLICENSE.COM, enter the correct information in the License Database of the new processor. The Fortran license in the current License Database is marked ISSUED and is disabled.

#2

$ LICENSE ISSUE /PRODUCER=DEC VOLSHAD
      

This command displays, at the current terminal, a PAK replica with the information from the VOLSHAD (VAX Volume Shadowing) license. This display is reproduced below. The license registered in the current License Database is marked ISSUED and is disabled. You can register the data from this replica of a PAK in the License Database of another processor using either VMSLICENSE.COM or LICENSE REGISTER.


Software Product Authorization Key Replica
Issued by CASPER      
Issued on 24-FEB-1996 14:23
-----------------------------------
Issuer:             DEC
Authorization:      ALS-WM-93166-5573
Product Name:       VOLSHAD   
Producer:           DEC
Units:              460
Version:            5.4
PAK Termination Date:   31-DEC-1996 
Availability:       E
Options:            MOD_UNITS
Checksum:           1-ADEB-DOCJ-NENC-KDBM

#3

$ LICENSE ISSUE/PROCEDURE /OUTPUT=FORTRAN-USA10.COM -
_$FORTRAN /AUTHORIZATION=USA-10
 
      

This command generates a DCL command procedure such as the following to be used for registering the specified license in a License Database:


$! Software Product Authorization Key Replica 
$! Issued by CASPER 
$! Issued on 23-Oct-1991 14:23 
$ LICENSE REGISTER FORTRAN - 
 /ISSUER=DEC - 
 /PRODUCER=DEC - 
 /AUTHORIZATION=USA-10 -                       
 /UNITS=400 - 
 /VERSION=5.4 - 
 /AVAILABILITY=F - 
 /CHECKSUM=1-HIDN-INDA-COMP-DAHH 
 

LICENSE LIST

Displays information from the License Database on disk about the specified license or licenses. Use one or more qualifiers to control the form, content, and location of information displayed.

The SHOW LICENSE command, described in the OpenVMS DCL Dictionary, displays information from the License Database in memory.


Format

LICENSE LIST [product-name[,...]]


Parameter

product-name[,...]

Name or names of products with a license that you want to list. You can list only licenses that currently exist on disk in the License Database. You can specify one product name or use wildcard characters to display licenses. The product-name parameter is optional; the default is to display all of the licenses.

Qualifiers

/AUTHORIZATION=string

Positional qualifier.

Specifies a string that helps identify the license you want to list. You must enter the authorization string exactly as it appears on your PAK. Use this optional qualifier only if you need it to identify the license.

This qualifier affects only the product name that immediately precedes it in the command string.

/BEFORE

Used with /TERMINATION_DATE and /RELEASE_DATE, 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)

Specifies a listing from the License Database that includes only the license product and producer names.

/DATABASE=filespec

Specifies the location of the License Database. The default file specification is defined by the logical name LMF$LICENSE, which points to SYS$COMMON:[SYSEXE]LMF$LICENSE.LDB on an unmodified OpenVMS system. Use this optional qualifier only if you do not use the default License Database name and location.

/FULL

Specifies a listing from the License Database that includes a full display of the specified license or licenses.

/HISTORY

Specifies a listing from the License Database that includes the history records in the License Database for the specified license or licenses.

/ISSUER=string

Positional qualifier.

Specifies the name of the company (for example, DEC) that issued the PAK for the product. Use this optional qualifier only if you need it to identify the license. This qualifier affects only the product name that immediately precedes it in the command string.

/OUTPUT[=filespec]

Specifies the name of the file to which your list is written. If you do not specify the /OUTPUT qualifier, or if you do not supply a file specification with this qualifier, the output is sent to SYS$OUTPUT.

/PRODUCER=string

Positional qualifier.

Specifies the name of the company (for example, DEC) that owns the product for which you have a license. Use this optional qualifier only if you need it to identify the license.

This qualifier affects only the product name that immediately precedes it in the command string.

/RELEASE_DATE=date

Used with /BEFORE or /SINCE, specifies a listing from the License Database that includes only licenses with a release date on or after the date specified. The date must be presented in the standard OpenVMS format: dd-mmm-yyyy. The default value is /SINCE /RELEASE_DATE=TODAY.

/SELECTION_WEIGHT

Produces a full display that includes the current selection weights assigned to individual PAKs.

/SINCE

Used with /TERMINATION_DATE and /RELEASE_DATE, selects only those licenses whose times are after the time specified with the other qualifiers.

/SINCE cannot be used with /BEFORE.

/TERMINATION_DATE[=date]

Used with /BEFORE or /SINCE, specifies a listing from the License Database that includes only licenses with a termination date on or after the date specified. The date must be presented in the standard OpenVMS format: dd-mmm-yyyy. The default value is /SINCE /TERMINATION_DATE=TODAY.

/VERSION=nn.nn

Positional qualifier.

Specifies the version number of the product for which you have a license. Versions use the format integer.integer. You can specify wildcard syntax as *.* but not * alone. Use this optional qualifier only if you need it to identify the license. This qualifier affects only the product name that immediately precedes it in the command string.


Description

LICENSE LIST displays license records as they appear on disk in the License Database. LICENSE LIST /BRIEF does not produce a display with history records. You can control the displays as follows: For any LICENSE LIST display, use the arrow keys to scroll vertically or horizontally one line at a time. Press Ctrl/Z to exit from the display.

Note that a LICENSE LIST command may display the status of a registered license as Active. This means the registered license is enabled for loading; it has not been disabled. It does not necessarily mean the license was loaded with a LICENSE LOAD command. The LICENSE LIST command displays only information on disk in the License Database; enter SHOW LICENSE to determine all active licenses on the current system.

You can also list licenses using the VMSLICENSE.COM command procedure.


Examples

#1

$ LICENSE LIST/FULL
 
      

This command displays a list of the names of product licenses in the License Database. Note that the LMF Version shown refers to the software that created the database.


 
Use CTRL/Z to exit, PF3-PF4 for Previous-Next Screen, Arrow Keys to scroll. 
 
 
 License Management Facility  V1.2 
 
 License Database File:       WORK2:[BACKUP]LMF$LICENSE.LDB;1 
 Created on:                  20-JUL-1995 
 Created by user:             USER_1 
 Created by LMF Version:      V1.1 
 
 ----------------------------------- 
 Issuer:                      DIGITAL-IM&T 
 Authorization:               
 Product Name:                C 
 Producer:                    DEC 
 Units:                       500 
 Version:                     0.0 
 Release Date:                 4-MAY-1996 
 PAK Termination Date:        (none) 
 Availability:                0 
 Activity:                     000000100 
 Options:                     MOD_UNITS 
 Product Token:               
 Hardware ID: 
 
 Revision Level:              1 
 Status:                      Active 
 Command:                     REGISTER 

#2

$ LICENSE LIST /HISTORY FORTRAN
      

This example displays a listing with full information of a current Fortran license issued by Digital.

The first screen, shown here, displays the most recent license record for the Fortran license. To see the history records one screen at a time, press Return. The revision level of the displayed record is 2, and the status is Active. The next screen would display the previous license record with a revision level of 1 and a status of Extinct.


                   
 
Use CTRL/Z to exit, PF3-PF4 for Previous-Next Screen, Arrow Keys to scroll. 
 
 
 
 License Management Facility  V1.2
 
 License Database File:   ART::SYS$COMMON:[SYSEXE]LMF$LICENSE.LDB 
 
 Created on:                  17-AUG-1995
 Created by user:             USER_2
 Created by LMF Version:      V1.2
 -----------------------------------------------------
 Issuer:                      DEC
 Authorization:               USA-2468
 Product Name:                FORTRAN
 Producer:                    DEC
 Units:                       0
 Modified Units:              2000
 Version:                     5.4
 Release Date:                (none)
 PAK Termination Date:        31-DEC-1997
 Modified Termination Date:   30-NOV-1998
 Availability:                F (Layered Products)
 Activity:                    0
 Options:                     MOD_UNITS
 Hardware ID:
 Revision Level:              2
 Status:                      Active 
 Command:                     MODIFY  
 Modified by user:            DEGAS
 Modified on:                 19-AUG-1996 14:32:23.41
 Include:                     ART   

LICENSE LOAD

Loads licenses, making them available for product authorization on the current node. The product licenses must be registered and current in the License Database. That is, they must not have been disabled or issued.

If the license is already loaded, LMF returns an informational message, unloads the license, and then loads the license.

To use this command, you need CMKRNL, SYSNAM, and SYSPRV privileges.


Format

LICENSE LOAD [product-name][,...]


Parameter

[product-name][,...]

Name or names of products with a license to be loaded. You can load only licenses that are currently registered and enabled in the License Database. Enter the product name exactly as it appears on your Product Authorization Key (PAK). If you do not specify a product name, LICENSE LOAD loads all of the products that are registered and enabled.

You cannot use wildcard characters for product-name.


Qualifiers

/AUTHORIZATION=string

Positional qualifier.

Specifies a string that helps identify the license you want to register. You must enter the authorization string exactly as it appears on your PAK. This qualifier affects only the product name that immediately precedes it in the command string.

/DATABASE=filespec

Location of the License Database. The default file specification is defined by the logical name LMF$LICENSE, which points to SYS$COMMON:[SYSEXE]LMF$LICENSE.LDB on an unmodified OpenVMS system. Use this optional qualifier only if you do not use the default License Database name and location.

/ISSUER=string

Positional qualifier.

Name of the company (for example, DEC) that issued the PAK for the product. Use this optional qualifier only if you need it to identify the license.

This qualifier affects only the product name that immediately precedes it in the command string.

/LOG (default)

/NOLOG

Controls whether or not LICENSE LOAD displays a message to acknowledge the loading of each license.

/PRODUCER=string

Positional qualifier.

Name of the company that owns the product for which you have a license. Use this optional qualifier only if you need it to identify the license. This qualifier affects only the product name that immediately precedes it in the command string.

/UNLOAD (default)

/NOUNLOAD

When requested to load a license that is currently loaded, LMF first automatically unloads it and then loads the latest license.

You can specify /NOUNLOAD to verify whether or not there is already a license loaded; LMF issues the warning LICENSE-W-ALREADYLOADED and does not load the license. To then load the license, follow these steps:

  1. Manually unload the current license with the LICENSE UNLOAD command.
  2. Reissue the LICENSE LOAD command.

Description

The LICENSE LOAD command loads licenses registered in the License Database. To use a licensed product, ensure that the system loads the registered license. When you register a license with VMSLICENSE.COM, you can confirm an option to load the license, whereas if you register a license with LICENSE REGISTER, you must also load it with LICENSE LOAD.

Use LICENSE LOAD only after you register a new license; LMF automatically loads all registered licenses at each subsequent system startup. You can enter LICENSE LOAD at other times to load modifications made with other LICENSE commands.

You can enter one LICENSE LOAD command without product-name to load all the available registered licenses.

Note

Registered licenses are enabled for loading by default. You can, however, disable a registered license to prevent loading.

A LICENSE START command entered interactively or when the system reboots also loads all licenses that are registered and enabled.

If you register multiple licenses for a single product, LICENSE LOAD loads all of the matching licenses. You do not typically load individual licenses, and you cannot unload individual licenses for a product. The Availability, Activity, Personal Use, and User license units of the multiple licenses work in concert to provide more product availability.

In an OpenVMS Cluster environment, each system loads licenses when it reboots. If you need to load a license for all assigned nodes of a running cluster, you can do one of the following:


Previous Next Contents Index

  [Go to the documentation home page] [How to order documentation] [Help on this site] [How to contact us]  
  privacy and legal statement  
4584PRO_005.HTML