%SYS
SNMP Class Reference

System class methods to support SNMP. More...

Inheritance diagram for SNMP:
Collaboration diagram for SNMP:

Static Public Member Functions

_.Library.Status CreateMIB (_.Library.String AppName, _.Library.String Namespace, _.Library.Integer EntID, _.Library.Integer AppID, _.Library.String Company, _.Library.String Prefix, _.Library.String CompanyShort, _.Library.String MIBname, _.Library.String Contact, _.Library.Boolean List)
 Create a MIB file (and an internal SNMP reference structure) for. More...
 
_.Library.Status DeleteMIB (_.Library.Integer EntID, _.Library.Integer AppID)
 Delete the internal representation of the MIB for an Extension Application. More...
 

Detailed Description

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.

Member Function Documentation

◆ CreateMIB()

_.Library.Status CreateMIB ( _.Library.String  AppName,
_.Library.String  Namespace,
_.Library.Integer  EntID,
_.Library.Integer  AppID,
_.Library.String  Company,
_.Library.String  Prefix,
_.Library.String  CompanyShort,
_.Library.String  MIBname,
_.Library.String  Contact,
_.Library.Boolean  List 
)
static

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()

_.Library.Status DeleteMIB ( _.Library.Integer  EntID,
_.Library.Integer  AppID 
)
static

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).