IRISLIB database
License Class Reference

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

Inheritance diagram for License:
Collaboration diagram for License:

Public Member Functions

_.Library.Status GetSample ()
 Get routine metric sample. More...
 
_.Library.Status Initialize ()
 Initialize routine metrics.
 

Static Public Member Functions

_.Library.Integer SetAlert (_.Library.Integer Minimum)
 Stores a minimum level of available license units to be checked by the. More...
 

Public Attributes

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

Detailed Description

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.

Member Function Documentation

◆ GetSample()

_.Library.Status GetSample ( )

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.

◆ SetAlert()

_.Library.Integer SetAlert ( _.Library.Integer  Minimum)
static

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.

Member Data Documentation

◆ AvailableDist

AvailableDist

The total number (used and unused) of distributed license units available.

 

◆ AvailableLocal

AvailableLocal

The total number (used and unused) of local license units available.

 

◆ CurrentUsedDist

CurrentUsedDist

The current number of distributed license units used.

 

◆ CurrentUsedLocal

CurrentUsedLocal

The current number of local license units used.

 

◆ MaxUsedDist

MaxUsedDist

A highwater-mark for the maximum number of distributed license units used since InterSystems IRIS was started.

 

◆ MaxUsedLocal

MaxUsedLocal

A highwater-mark for the maximum number of local license units used since InterSystems IRIS was started.