The LICENSESTATUS command returns information about the master license keys, temporary keys, and the status of the LICENSESUPPORT library. The command enables the operator to restart the LICENSESUPPORT library.
The LICENSESTATUS command generates daily warnings when the system keys file contains keys that are due to expire in the near future. The warning message is:
<n> temporary license keys will expire within the next <m> days. Use
the LS TEMP system command or License Center to list temporary
keys.where <n> is the number of keys affected and <m> is a configurable number of days.
The LICENSESTATUS system command can be used to configure and display the number of days for which warnings are generated. The syntax of the LICENSESTATUS TEMPORARY option allows you to specify the WARNFACTOR option.
Syntax
<restrictions>
Explanation
LICENSESTATUS TEMPORARY
LS TEMP
LS TEMP <string>
LS TEMP KEYSFILE = <keys file>
LS TEMP: PRINTER
LS TEMP : FILE <file name>
Displays information about temporary keys, which are keys that have expiration dates associated with them. The display contains the following information.
|
Heading |
Description |
|---|---|
|
Key |
Key name |
|
Validity |
Number of days that the key is valid and the number of grace days |
|
Action Date |
Date when the action shown in the Action column takes place. A date in parentheses represents a date in the past. A date in brackets indicates that the grace period is active. If the column is empty, the key has not been activated because the product was never installed or used. |
|
Action |
The action taken when the key expires. Warn—A warning message is generated, but product use is allowed. Deny—The product can no longer be used. |
If the <string> variable is specified, only keys with that prefix are listed. If KEYSFILE is specified, temporary keys in the designated keys file are listed. If PRINTER is specified, output is directed to a printer. If FILE is specified, a file is created unless it already exists.
LICENSESTATUS TEMP WARNFACTOR <number>
LS TEMP WARNFACTOR <number>
Sets the number of days warning prior to key expiration. <number> is a value between 0 and 127. Setting WARNFACTOR to 0 disables the generation of warnings.
When WARNFACTOR is set, a daily warning is generated when the system keys file contains keys that are due to expire in the near future.
LICENSESTATUS TEMP WARNFACTOR −
LS TEMP WARNFACTOR −
Sets the number of days warning prior to key expiration to the default value, which is 30 days.
LICENSESTATUS RESTART
LS RESTART
Terminates linkage to the existing LICENSESUPPORT library and initiates a new copy of the library.
LICENSESTATUS RESTART (RELOCATE = <family name>)
LS RESTART (RELOCATE = <family name>)
Relocates the LICENSESUPPORT databases to the indicated family. The family must be write-enabled.
Two KEYEDIOII databases are associated with SYSTEM/LICENSESUPPORT:
-
SYSTEM/LICENSESUPPORT/DETAIL
-
SYSTEM/LICENSESUPPORT/SUMMARY
These databases are created and maintained on the DL BACKUP family.
You can move these databases to other families to reduce I/O contention on the DL BACKUP family, to resolve disk space issues, or for administrative convenience.
The actual movement of the databases is performed as part of SYSTEM/LICENSESUPPORT termination. A new instance of SYSTEM/LICENSESUPPORT uses the databases on the new family.
LICENSESTATUS RESTART (RELOCATE −)
LS RESTART (RELOCATE −)
Relocates the LICENSESUPPORT databases to the current DL BACKUP family.
| Note: | If the DL BACKUP family is changed, SYSTEM/LICENSESUPPORT continues to use the existing databases, regardless of whether they are on the previous DL BACKUP family or have been relocated. If you want the databases to reside on the new DL BACKUP family, you must move them with the appropriate LS RESTART command. |
LICENSESTATUS COLLECTHISTORY +
LS COLLECTHISTORY +
Enables the collection of license history information in the Licensesupport detail database. If history collection is currently in effect, the command does not cause any changes.
LICENSESTATUS COLLECTHISTORY -
LS COLLECTHISTORY -
Disables the collection of license history information in the Licensesupport detail database. If history collection is currently disabled, the command does not have any effect.
Example
Example 1
LICENSESTATUS
License Support Status
MCN: 710798952
PSN: 717212714
Master Keys: MASTERKEY-20150316-150622
SCN: 7654321 (Valid MCN)
Library is running, mix number is 11287
Databases on SYSTEM
Warnfactor = 30 (default
Example 2
LS RESTART
Restarting LicenseSupport Library
Example 3
LS RESTART (RELOCATE=SITEDATA)
Restarting LicenseSupport Library
Example 4
LS COLLECTHISTORY -
Licensesupport history collection will be disabled
