About locally generated MIBs

You can create a custom MIB on a local device by selecting the CreateMIB menu item from the popup menu on an SnmpNetwork Local Device (see Create a MIB) or by using the SNMP Servlet through a browser connection to your station (see Create a MIB using the SNMP Servlet).

Figure 19. Create a custom MIB using the popup menu on your local device

The generated MIB defines the information that can be exposed for a station running the SnmpNetwork. This custom MIB includes entries for the current MIB objects as well as the export tables. After generating the MIB, save the file under any folder that you have read-write access to, as shown in Figure 20. After compiling the MIB, an SNMP manager application can use the information to read and write data to and from the station.

Figure 20. Viewing a MIB file in Workbench text file editor view

“Standard” MIBs are included in the snmp driver module.

Standard MIBs are those that have been approved by the Internet Architecture Board (IAB). Equipment and software vendors define the private MIBs unilaterally. A branch within the private.enterprises subtree is allocated to each vendor who registers for an enterprise Object Identifier. The distinction between the standard and private MIBs is based on how the variables are defined. The best example of a standard MIB is the RFC1213-MIB (also known as MIB-II).

Compiling the MIB using the SNMP Point Manager view reveals a list of points, as shown in Figure 21. This illustration shows the SNMP Point Manager view displaying five columns. You can show more columns or hide columns, as desired, using the table controls, as described in the NiagaraAX-3.x Users Guide. Refer to About the SNMP point manager view for more information about the SNMP Point Manager view.

Figure 21. SNMP MIB compiled

The following list describes how the individual MIB entries are used:

version (OID: 1.3.6.1.4.1.4131.1.1.0)

this read-only string object exposes the current software version that the station is running.
action (OID: 1.3.6.1.4.1.4131.1.2.0)

this read-write integer object allows the manager to perform certain actions on the Alarm Table. A value of 0 causes no action to be performed on the Alarm Table (remember to always set the value back to 0 after performing any action, otherwise the action will be performed repeatedly on any new alarm entries). A value of 1 causes all of the alarm entries in the Alarm Table to be acknowledged (and also in the Niagara Alarming Service if the SnmpNetwork for the station has the 'Synchronize Alarm Acks' property enabled - see SnmpNetwork Configuration). A value of 2 causes all of the alarms to be cleared (the corresponding alarms in the Niagara Alarming Service will be acknowledged if unacknowledged and if the SnmpNetwork for the station has the 'Synchronize Alarm Acks' property enabled). A value of 3 causes all acknowledged alarms in the Alarm Table to be cleared. Any other value (outside the range of 0-3) is not valid for this object, and will be treated as no action.
alarmTable (OID: 1.3.6.1.4.1.4131.1.3)

this sequence of alarmTableEntries represents the Alarm Table that is dynamically created by the station whenever an alarm is generated in the station and routed to a Alarm Class that has an SnmpRecipient object linked to it. The Alarm Table has a buffer size of 50 alarm entries. Alarm entries that are not cleared from the Alarm Table when the buffer becomes full will be removed on a FIFO (First In, First Out) basis as new alarm entries are added.
alarmTableEntry (OID: 1.3.6.1.4.1.4131.1.3.1)

this represents an entry within the alarmTable containing the following data (all fields of an Alarm Record):
- alarmId (OID: 1.3.6.1.4.1.4131.1.3.1.1)
  
  this read-only integer object exposes the numerical identifier automatically assigned to the alarm entry in the Alarm Table. It is used as an index to address table entries.
- ackState (OID: 1.3.6.1.4.1.4131.1.3.1.2)
  
  this read-write integer object allows the manager to acknowledge and view the acknowledge state of the alarm entry. A value of 1 means that the alarm is unacknowledged. Setting the value to 2 acknowledges the alarm. After setting the value to 2, the manager should re-read the value of this object again to verify that the acknowledgement occurred (the value will be 2 when acknowledged).
- ackRequired (OID: 1.3.6.1.4.1.4131.1.3.1.3)
  
  this read-only integer object exposes whether an acknowledgement is required for this alarm entry. A value of 1 (true) indicates that an acknowledgement is required, while a value of 2 (false) indicates that an acknowledgement is not required.
- timestamp (OID: 1.3.6.1.4.1.4131.1.3.1.4)
  
  this read-only string object exposes the time when the alarm occurred (in the Niagara station's timestamp form).
- recordType (OID: 1.3.6.1.4.1.4131.1.3.1.5)
  
  this read-only string object exposes the type of the Niagara alarm record.
- source (OID: 1.3.6.1.4.1.4131.1.3.1.6)
  
  this read-only string object exposes the path to the station object which generated the alarm.
- alarmFlags (OID: 1.3.6.1.4.1.4131.1.3.1.7)
  
  this read-only string object exposes the flags associated with the alarm.
- alarmData (OID: 1.3.6.1.4.1.4131.1.3.1.8)
  
  this read-only string object exposes the alarm data.
- uuid (OID: 1.3.6.1.4.1.4131.1.3.1.9)
  
  this read-only string object exposes the unique universal identifier of the alarm.
- alarmClass (OID: 1.3.6.1.4.1.4131.1.3.1.10)
  
  this read-only string object exposes the path to the Niagara Alarm Class of the alarm.
- priority (OID: 1.3.6.1.4.1.4131.1.3.1.11)
  
  this read-only integer object exposes the priority of the alarm.
- ackTime (OID: 1.3.6.1.4.1.4131.1.3.1.12)
  
  this read-only string object exposes the time at which the alarm was acked (in the Niagara station's timestamp form). Note that interpretation of this value depends upon the state of the alarm.
- user (OID: 1.3.6.1.4.1.4131.1.3.1.13)
  
  this read-only string object exposes the name of the user who acknowledged the alarm.
inputTable (OID: 1.3.6.1.4.1.4131.1.4)

this sequence of inputTableEntries represents the Input Table that is dynamically created by the station whenever an input-type SnmpAgent proxy point is created in the station under an SnmpAgent.
inputTableEntry (OID: 1.3.6.1.4.1.4131.1.4.1)

represents an entry within the inputTable containing the following data:
- inputIndex (OID: 1.3.6.1.4.1.4131.1.4.1.1)
  
  this read-only integer object exposes the index into the Input Table for a particular input-type SnmpAgent proxy point's value. It is used as an index to address Input Table entries.
- inputName (OID: 1.3.6.1.4.1.4131.1.4.1.2)
  
  this read-only string object exposes the name of the input-type SnmpAgent proxy point supplying the value of this Input Table entry.
- inputValue (OID: 1.3.6.1.4.1.4131.1.4.1.3)
  
  this read-write string object allows the value stored in the corresponding input-type SnmpAgent proxy point to be read or written. All values are read and written as string types, and the input-type SnmpAgent proxy point on the station itself will handle conversions if necessary (i.e. converting from string to integer or boolean type)
outputTable (OID: 1.3.6.1.4.1.4131.1.5)

this sequence of outputTableEntries represents the Output Table that is dynamically created by the station whenever an output-type SnmpAgent proxy point is created in the station.
outputTableEntry (OID: 1.3.6.1.4.1.4131.1.5.1)

represents an entry within the outputTable containing the following data:
- outputIndex (OID: 1.3.6.1.4.1.4131.1.5.1.1)
  
  this read-only integer object exposes the index into the Output Table for a particular output-type SnmpAgent proxy point's value. It is used as an index to address Output Table entries.
- outputName (OID: 1.3.6.1.4.1.4131.1.5.1.2)
  
  this read-only string object exposes the name of the output-type SnmpAgent proxy point supplying the value of this Output Table entry.
- outputValue (OID: 1.3.6.1.4.1.4131.1.5.1.3)
  
  this read-only string object exposes the value stored in the corresponding output-type SnmpAgent proxy point. All values are read as string types, and thus the manager must handle conversions if necessary (i.e. converting from string to integer or boolean type).
exportInputTable (OID: 1.3.6.1.4.1.4131.1.6.1.1)

this sequence of exportInputTableEntries represents the exportInput Table that is dynamically created by the station whenever an exportInput-type SnmpAgent proxy point is created in the station under an SnmpAgent.
exportInputTableEntry (OID: 1.3.6.1.4.1.4131.1.6.1.1.1)

represents an entry within the exportInputTable containing the following data:
- exportInputIndex (OID: 1.3.6.1.4.1.4131.6.1.1.1.1)
  
  this read-only integer object exposes the index into the exportInput Table for a particular exportInput-type SnmpAgent proxy point's value. It is used as an index to address exportInput Table entries.
- exportInputName (OID: 1.3.6.1.4.1.4131.1.6.1.1.1.2)
  
  this read-only string object exposes the name of the exportInput-type SnmpAgent proxy point supplying the value of this exportInput Table entry.
- exportInputValue (OID: 1.3.6.1.4.1.4131.1.6.1.1.1.3)
  
  this read-write string object allows the value stored in the corresponding exportInput-type SnmpAgent proxy point to be read or written. All values are read and written as string types, and the exportInput-type SnmpAgent proxy point on the station itself will handle conversions if necessary (i.e. converting from string to integer or boolean type)
exportOutputTable (OID: 1.3.6.1.4.1.4131.1.6.1.2)

this sequence of exportOutputTableEntries represents the exportOutput Table that is dynamically created by the station whenever an exportOutput-type SnmpAgent proxy point is created in the station.
exportOutputTableEntry (OID: 1.3.6.1.4.1.4131.1.6.1.2.1)

represents an entry within the exportOutputTable containing the following data:
- exportOutputIndex (OID: 1.3.6.1.4.1.4131.1.6.1.1.1.1)
  
  this read-only integer object exposes the index into the exportOutput Table for a particular exportOutput-type SnmpAgent proxy point's value. It is used as an index to address exportOutput Table entries.
- exportOutputName (OID: 1.3.6.1.4.1.4131.1.6.1.1.1.2)
  
  this read-only string object exposes the name of the exportOutput-type SnmpAgent proxy point supplying the value of this exportOutput Table entry.
- exportOutputValue (OID: 1.3.6.1.4.1.4131.1.6.1.1.1.3)
  
  this read-only string object exposes the value stored in the corresponding exportOutput-type SnmpAgent proxy point. All values are read as string types, and thus the manager must handle conversions if necessary (i.e. converting from string to integer or boolean type).
stationAlarm (OID: 1.3.6.1.4.1.4131.1)

this SNMP trap-type defines the form of outgoing SNMPv1 trap messages sent by the station. For more details, see Generating SNMP Traps.