Caché System Administration Guide - InterSystems Documentation

4.3.2 Methods to Show License Server Information
The following subroutines dump the contents of license tables maintained by the license server. The
output files are in the indicated directory on the host where the active license server is running.
$System.License.ShowSummary displays a summary of license information at the license server.
The Distributed license use section presents a collective view of license use for all Caché
instances currently supported by the license server. The Local license use section presents a
view of license use for the single Caché instance in which the program is run:
Do $System.License.ShowSummary()
$System.License.DumpServer dumps the license server database information relating to the server
from which you run this routine to the file, dumpserver.txt, on the host running the license server:
Do $System.License.DumpServer()
$System.License.DumpServers dumps the license server database information for all known servers
to the file, dumpservers.txt, on the host running the license server:
Do $System.License.DumpServers()
$System.License.DumpKey dumps the key used by this instance and instances that share it to the
file, dumpkey.txt, on the host running the license server:
Do $System.License.DumpKey()
$System.License.DumpKeys dumps all keys, showing the instances and clients using them to the
file, dumpkeys.txt, on the host running the license server:
Do $System.License.DumpKeys()
Determining License Capacity and Usage
Note:
Be aware that the information displayed by the local license methods is more up-to-date than
the information shown by the license server methods; the license server is only updated
periodically, while the local data is real time.
It is possible to exceed the license limit temporarily because login is controlled locally, but the license
server enforces the limit. Each instance permits or denies logins based on its local license table which
is maintained in instance shared memory. Each instance sends periodic updates to the license server
describing changes to the local license tables. If the combined license use of all instances exceeds the
limit, the license server sends a negative acknowledgement to update messages from each instance.
This negative acknowledgement causes each instance to refuse new logins because no additional license
units are available. A login is considered new when the license user ID of the Caché process attempting
to start does not match the license user ID of any current process. This state persists until the combined
use by all instances falls below the authorized limit, at which point the license server begins sending
Caché System Administration Guide 59