Disables a license currently registered in the License Database.
Format
LICENSE DISABLE product-name[,...]
1 – 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).
2 – Qualifiers
2.1 /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.
2.2 /AUTHORIZATION
/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.
2.3 /DATABASE
/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.
2.4 /ISSUER
/ISSUER=string
Positional qualifier.
Specifies the name of the company (for example, VSI) 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.
2.5 /LOG
/LOG
/NOLOG (default)
Controls whether LICENSE DISABLE displays the name of each
license that it disables.
2.6 /PRODUCER
/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.
3 – 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 licenses, 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 either you or the system
attempts to unload a disabled license.
4 – Example
$ LICENSE DISABLE ABCD /PRODUCER=DEC
This command disables the license for ABCD software produced
by VSI. Because no database is specified, LMF uses the default
database.