Skip to main content

MonitorTools.SNMP

Class MonitorTools.SNMP Extends %RegisteredObject [ System = 4 ]

System class methods to support SNMP. Allow users to extend the InterSystems IRIS MIB and use the SNMP agent for their own MIBs, using the definitions created by the %Monitor framework.

Methods​

CreateMIB​

ClassMethod CreateMIB(AppName As %String = "IRIS", Namespace As %String = "%SYS", EntID As %Integer = 16563, AppID As %Integer = 1, Company As %String = "intersystems", Prefix As %String = "iris", CompanyShort As %String = "isc", MIBname As %String = "ISC-IRIS", Contact As %String = "1 Memorial Drive, Cambridge MA 02142, Subject: ISC-IRIS.mib", List As %Boolean = 1) As %Status

Create a MIB file (and an internal SNMP reference structure) for an Extension Application, based on the Monitor Framework metadata.

All MIB definitions are modeled after the InterSystems IRIS MIB. That is, the standard iso.org.dod.internet.private.enterprises subtree (i.e. 1.3.6.1.4.1), followed by the enterprise specific hierarchy entID.appID.objects.table.row.item.config.index. For example, the size of a database would be encoded as: 1.3.6.1.4.1.16563.4.1.3.1.6.4.84.69.83.84.1 iso.org.dod.internet.private.enterprises.intersystems.iscIRIS .objects.DBtab.DBrow.DBsize.TEST(config).1(DBindex)

Note that most of the default parameter values reflect the actual InterSystems IRIS MIB. They are supplied as examples and should not be used for Extension Applications.

Parameters are:

AppName - the Application name as defined in the Monitor Framework. Used as the MIB Module name, it must begin with an uppercase letter and contain no punctuation.
Namespace - the namespace where the application exists
EntID - the company ID number as assigned by the IANA
AppID - the application ID number as assigned by the company
Company - the company name (lower case and no spaces or punctuation) associated with the IANA number. This is used as the identifier for the 'enterprises' object.
Prefix - a short, 3 to 5 character, lower case (no spaces or punctuation) prefix to be used for all SNMP objects
CompanyShort - a short, lower case (no spaces or punctuation) prefix for the company name. This is appended to the AppName to create a product OID name
MIBname - the name of the MIB. This is also used as the file name (with .mib)
Contact - comma-delimited string(s) containing address and contact info.
List - flag which causes progress information to be output.

DeleteMIB​

ClassMethod DeleteMIB(EntID As %Integer, AppID As %Integer) As %Status

Delete the internal representation of the MIB for an Extension Application. This will cause the InterSystems IRIS SNMP agent to no longer register and support the MIB for this application.

Parameters are:

EntID - the IANA enterprise ID number for the company (e.g. 16536 for Intersystems)

AppID - the application ID number assigned by the company (e.g. 1 for InterSystems IRIS).

Debug​

ClassMethod Debug(Flag As %Integer) As %Integer [ Internal ]

Turn on debug mode for InterSystems IRIS SNMP sub-agent Output detailed transaction messages to the SNMP log file Normal value should be 1, but a higher value (2) will show some more detail. Return value is previous value of debug flag.

Ask​

ClassMethod Ask() As %Status [ Internal ]

Prompt for input and run CreateMIB