Learning
Documentation
Community
Open Exchange
Global Masters
Home / Class Reference / %SYS namespace / %Monitor.Adaptor
Private  Storage   

%Monitor.Adaptor


abstract class %Monitor.Adaptor extends
%RegisteredObject

Monitor enabling class. Users inherit from this class to register as a Monitor class.

Inventory


Parameters Properties Methods Queries Indices ForeignKeys Triggers
4 5


Summary


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 Shutdown Startup

Subclasses

Parameters


• parameter APPLICATION;
User name for application. Default = Package name
• parameter GROUPNAME;
User name for this group of metrics. Default = classname
• parameter INDEX;
Comma separated list of properties to act as primary key for instances. Default = ""
• parameter SECURITYRESOURCE;
Comma separated list of Resources required to view the CSP page. Default = ""

Methods


• abstract method GetSample() as %Status
USER MUST IMPLEMENT THIS METHOD
This method is called to initialize and populate properties for successive sample instances.
A return code of $$$OK indicates there is a new sample instance.
A return code of 0 indicates there is no sample instance.

NOTE: If an INDEX is specified, i.e. we expect to collect multiple samples for each sampling period, then the System Monitor will loop calling GetSample() until "0" is returned. Users code MUST return "0" when all indexed sample have been collected for a period, in order to terminate the loop.
• method Initialize() as %Status
USER MAY IMPLEMENT THIS METHOD
This method is called to initialize the control for the first sample of a set of sample instances.
A return code of $$$OK indicates there is a new sample instance.
A return code of 0 indicates there is no sample instance.
• method Shutdown() as %Status
USER MAY IMPLEMENT THIS METHOD
This method is called once when the control object is closed at the end of sampling. The user may cleanup the control class.
• method Startup() as %Status
USER MAY IMPLEMENT THIS METHOD
This method is called once when the control object is created at the beginning of sampling. The user may initialize the control class.