Class Reference
IRIS for UNIX 2019.2
InterSystems: The power behind what matters   
Documentation  Search
  [ENSLIB] >  [%Monitor] >  [System] >  [License]
Private  Storage   

class %Monitor.System.License extends %Monitor.System.Adaptor

This class can sample the status of the License Units, both local and distributed, and provide values for each Property listed.

It may also be used to create an alert based on the results. The simplest way to create an alert is to set a minimum level using the SetAlert() class method. Then use %MONAPPMGR to 'activate' this class in the %SYS namespace. When the Application Manager calls the GetSample() method to sample the license counts, if they fall below the minimum level the method will generate an entry in the cconsole.log file (which may then be emailed via the System Monitor). See the SetAlert() method for more details.

Users may also use this Class and the sampled Property values to create an Alert with the %Monitor.Alert Class. This allows for more complex checks and/or generating more specific alerts.

Inventory

Parameters Properties Methods Queries Indices ForeignKeys Triggers
6 3


Summary

Properties
AvailableDist AvailableLocal CurrentUsedDist CurrentUsedLocal
MaxUsedDist MaxUsedLocal

Methods
%AddToSaveSet %ClassIsLatestVersion %ClassName %ConstructClone
%DispatchClassMethod %DispatchGetModified %DispatchGetProperty %DispatchMethod
%DispatchSetModified %DispatchSetMultidimProperty %DispatchSetProperty %Extends
%GetParameter %IsA %IsModified %New
%NormalizeObject %ObjectModified %OriginalNamespace %PackageName
%RemoveFromSaveSet %SerializeObject %SetModified %ValidateObject
GetSample Initialize SetAlert Shutdown
Startup


Properties

• property AvailableDist as %Monitor.Integer;
The total number (used and unused) of distributed license units available.
• property AvailableLocal as %Monitor.Integer;
The total number (used and unused) of local license units available.
• property CurrentUsedDist as %Monitor.Integer;
The current number of distributed license units used.
• property CurrentUsedLocal as %Monitor.Integer;
The current number of local license units used.
• property MaxUsedDist as %Monitor.Integer;
A highwater-mark for the maximum number of distributed license units used since InterSystems IRIS was started.
• property MaxUsedLocal as %Monitor.Integer;
A highwater-mark for the maximum number of local license units used since InterSystems IRIS was started.

Methods

• method GetSample() as %Status
Get routine metric sample. Fetches current license unit values for each Property and may generate an entry in cconsole.log if the unused License Units fall below a minimum value (see SetValue method).

A return code of $$$OK indicates there is a new sample instance.
A return code of 0 indicates there is no sample instance.
• method Initialize() as %Status
Initialize routine metrics.
• classmethod SetAlert(Minimum As %Integer) as %Integer
Stores a minimum level of available license units to be checked by the GetSample() method.

If the value of (AvailableLocal - CurrentUsedLocal) or (AvailableDist - CurrentUsedDist) falls below this value, then the GetSample method will log an error in the cconsole.log, which will trigger an alert by the System Monitor. Note that the %Monitor.System.License Class must be "activated" in the Application Monitor (run ^%MONAPPMGR in the %SYS namespace).

A value of "0" will disable this alert.

Returns the previous value. If Minimum="", it returns the current value but does not change it.


Copyright (c) 2019 by InterSystems Corporation. Cambridge, Massachusetts, U.S.A. All rights reserved. Confidential property of InterSystems Corporation.