draft-ietf-disman-event-mib-05.txt   draft-ietf-disman-event-mib-06.txt 
Event MIB Event MIB
7 October 1998 22 February 1999
draft-ietf-disman-event-mib-05.txt draft-ietf-disman-event-mib-06.txt
Bob Stewart Bob Stewart
Cisco Systems, Inc. Cisco Systems, Inc.
bstewart@cisco.com bstewart@cisco.com
Status of this Memo Status of this Memo
This document is an Internet-Draft. Internet-Drafts are working This document is an Internet-Draft and is in full conformance with all
documents of the Internet Engineering Task Force (IETF), its areas, and provisions of Section 10 of RFC2026.
its working groups. Note that other groups may also distribute working
documents as Internet-Drafts. Internet-Drafts are working documents of the Internet Engineering Task
Force (IETF), its areas, and its working groups. Note that other groups
may also distribute working documents as Internet-Drafts.
Internet-Drafts are draft documents valid for a maximum of six months Internet-Drafts are draft documents valid for a maximum of six months
and may be updated, replaced, or obsoleted by other documents at any and may be updated, replaced, or obsoleted by other documents at any
time. It is inappropriate to use Internet- Drafts as reference material time. It is inappropriate to use Internet- Drafts as reference material
or to cite them other than as ``work in progress.'' or to cite them other than as ``work in progress.''
To view the entire list of current Internet-Drafts, please check the The list of current Internet-Drafts can be accessed at
"1id-abstracts.txt" listing contained in the Internet-Drafts Shadow http://www.ietf.org/ietf/1id-abstracts.txt
Directories on ftp.is.co.za (Africa), ftp.nordu.net (Northern Europe),
ftp.nis.garr.it (Southern Europe), munnari.oz.au (Pacific Rim),
ftp.ietf.org (US East Coast), or ftp.isi.edu (US West Coast).
Distribution of this document is unlimited. Please send comments to the Distribution of this document is unlimited. Please send comments to the
Distributed Management Working Group, <disman@nexen.com>. Distributed Management Working Group, <disman@nexen.com>.
Copyright Notice Copyright Notice
Copyright (C) The Internet Society (1998). All Rights Reserved. Copyright (C) The Internet Society (1999). All Rights Reserved.
1. Abstract 1. Abstract
This memo defines an experimental portion of the Management Information This memo defines an experimental portion of the Management Information
Base (MIB) for use with network management protocols in the Internet Base (MIB) for use with network management protocols in the Internet
community. In particular, it describes managed objects used for community. In particular, it describes managed objects used for
managing monitoring of MIB objects and taking action through events. managing monitoring of MIB objects and taking action through events.
The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT", The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT",
"SHOULD", "SHOULD NOT", "RECOMMENDED", "MAY", and "OPTIONAL" in this "SHOULD", "SHOULD NOT", "RECOMMENDED", "MAY", and "OPTIONAL" in this
skipping to change at page 4, line 7 skipping to change at page 4, line 7
translations. The resulting translated MIB must be semantically translations. The resulting translated MIB must be semantically
equivalent, except where objects or events are omitted because no equivalent, except where objects or events are omitted because no
translation is possible (use of Counter64). Some machine readable translation is possible (use of Counter64). Some machine readable
information in SMIv2 will be converted into textual descriptions in information in SMIv2 will be converted into textual descriptions in
SMIv1 during the translation process. However, this loss of machine SMIv1 during the translation process. However, this loss of machine
readable information is not considered to change the semantics of the readable information is not considered to change the semantics of the
MIB. MIB.
3. Overview 3. Overview
With network sizes well beyond the ability of people to management their With network sizes well beyond the ability of people to management them
networks directly automated, distributed management is vital. An directly, automated, distributed management is vital. An important
important aspect of such management is the ability of a system to aspect of such management is the ability of a system to monitor itself
monitor itself or for some other system to monitor it. or for some other system to monitor it.
The Event MIB provides the ability to monitor MIB objects on the local The Event MIB provides the ability to monitor MIB objects on the local
system or on a remote system and take simple action when a trigger system or on a remote system and take simple action when a trigger
condition is met. condition is met.
All of these components must suit either a relatively powerful manager The MIB is intended to suit either a relatively powerful manager or
or mid-level manager, as well as a somewhat more limited self-managing mid-level manager, as well as a somewhat more limited self-managing
system. system.
4. Relationship to Other MIBs 4. Relationship to Other MIBs
The Event MIB is based on extensive experience with the RMON MIB [16] The Event MIB is based on extensive experience with the RMON MIB [16]
and its alarm and event groups and is intended as a replacement for and its alarm and event groups and is intended as a replacement for
those groups. The Event MIB calls "triggers" what the RMON MIB called those groups. The Event MIB calls "triggers" what the RMON MIB called
"alarms," but the concepts are the same. Event MIB triggers maintain "alarms," but the concepts are the same. Event MIB triggers maintain
the RMON handling of thresholds and add the concept of booleans. Event the RMON handling of thresholds and add the concept of booleans. Event
MIB events maintain the RMON concept of sending an SNMP notification in MIB events maintain the RMON concept of sending an SNMP notification in
response to a trigger and add the concept of setting a MIB object. response to a trigger and add the concept of setting a MIB object.
The Event MIB is the successor and update to SNMPv2's Manager-to-Manager The Event MIB is the successor and update to SNMPv2's Manager-to-Manager
MIB [17] which was declared Historic pending this work. MIB [17] which was declared Historic pending this work.
The Event MIB depends on the services of the SNMPv3 Management Target The Event MIB depends on the services of the SNMPv3 Management Target
and Notification MIBs [14]. and Notification MIBs [14].
The Event MIB is nicely complemented by the Distributed Management The Event MIB is nicely complemented by the Distributed Management
Expression MIB [18], which is the expected source of boolean objects to Expression MIB [18], which is the expected source of boolean objects to
monitor. monitor. Note that there is considerable overlap between the wildcard
and delta sample capabilities of the Event and Expression MIBs. A
carefully-planned implementation might well use common code to provide
the overlapping functions.
5. MIB Sections 5. MIB Sections
The MIB has three sections, triggers, events, and notifications. The MIB has four sections: triggers, objects, events, and notifications.
Triggers define the conditions that lead to events. Events may cause Triggers define the conditions that lead to events. Events may cause
notifications. notifications.
The trigger table lists what objects are to be monitored and how and The trigger table lists what objects are to be monitored and how and
relates each trigger to an event. In the same section the trigger relates each trigger to an event. It has supplementary, companion
tables for additional objects that depend on the type of test done for
the trigger.
object table lists trigger-related objects that can be added to The objects table lists objects that can be added to notifications based
notifications either for a trigger or for an event. on the trigger, the trigger test type, or the event that resulted in the
notification.
The event table defines what happens when an event is triggered, sending The event table defines what happens when an event is triggered, sending
a notificaiton, setting a MIB object or both. a notification, setting a MIB object or both. It has supplementary,
companion tables for additional objects that depend on the action taken.
The notification section defines a set of generic notifications to go The notification section defines a set of generic notifications to go
with the events and for Event MIB error handlling, and it defines a set with the events and for Event MIB error handling, and it defines a set
of objects to put in those notifications. of objects to put in those notifications.
6. Operation 6. Operation
The Event MIB is instrumentation for a distributed management The Event MIB is instrumentation for a distributed management
application that monitors MIB objects. In its simplest form this application that monitors MIB objects. In its simplest form this
application monitors individual, local MIB objects, just as an RMON application monitors individual, local MIB objects, just as an RMON
probe fulfills the functions implied by RMON's alarm and event probe fulfills the functions implied by RMON's alarm and event
operation. Additionally the application can monitor remote objects and operation. Additionally the application can monitor remote objects and
wildcarded groups of objects. wildcarded groups of objects.
Remote monitoring uses the tag service of the Management Target MIB to Remote monitoring uses the tag service of the Management Target MIB to
select and access remote systems as an ordinary SNMP-based management select and access remote systems as an ordinary SNMP-based management
application. Local monitoring may be be a more intimate, local application. Local monitoring may be via a more intimate, local
interface which may, for example, bypass SNMP formatting but otherwise interface which may, for example, bypass SNMP encoding but otherwise is
is functionally identical to remote SNMP operation. A self-management functionally identical to remote SNMP operation, including the
only system may not implemenet remote monitoring. application of access control. A self-management only system may not
implement remote monitoring.
Wildcards indicate that the application should use a GetNext-type Wildcards indicate that the application should use a GetNext-type
operation to find the zero or more instances implied by a truncated operation to find the zero or more instances implied by a truncated
object identifier, just like an ordinary SNMP-based management object identifier, just like an ordinary SNMP-based management
application. application. Each instance of a wildcard is treated as if it were a
separate entry, that is the instances of a wildcarded object are
independent of one another. For example, a wild-carded object may
trigger an event and result in the setting of another wildcarded object.
The instance that satisfied the trigger function is used to perform the
set function. All of this takes place independently of any additional
instances that may fill the wildcard.
Error handling is by notification, which at first thought violates the Error handling is by notification, which at first thought violates the
principle that notifications may be lost or become a crippling burden, principle that notifications may be lost or become a crippling burden,
but the intent is that such error notifications be enabled only for the but the intent is that such error notifications be enabled only for the
diagnosis of problems indicated by error counters and if the diagnosis of problems indicated by error counters and if the
notifications are being lost they be directed to the log as described in notifications are being lost they be directed to the log as described in
the Notification Log MIB [19]. the Notification Log MIB [19]. Note that this does not mean the
Notification Log MIB is required, since in fact notifications usually
are not lost, but that the Notification Log MIB can be helpful with this
as well as other MIBs that include notifications.
7. Security 7. Security
Security of Event MIB entries depends on SNMPv3 access control for the Security of Event MIB entries depends on SNMPv3 access control for the
entire MIB or for subsets based on substrings of trigger and event entire MIB or for subsets based on substrings of trigger and event
names. names.
Security of monitored objects for remote access depends on the Security of monitored objects for remote access depends on the
Management Target MIB. Security for local access can depend on the Management Target MIB. Security for local access can depend on the
Management Target MIB or on recording appropriate security credentials Management Target MIB or on recording appropriate security credentials
of the creator of an entry and using those to access the local objects. of the creator of an entry and using those to access the local objects.
These security credentials are the parameters necessary as inputs to
isAccessAllowed from the Architecture for Describing SNMP Management
Frameworks. When accessing local objects without using a local target
tag, the system must (conceptually) use isAccessAllowed to ensure that
it does not violate security.
To facilitate the provisioning of access control by a security
administrator for this MIB itself using the View-Based Access Control
Model (VACM) defined in RFC 2275 [15] for tables in which multiple users
may need to independently create or modify entries, the initial index is
used as an "owner index". Such an initial index has a syntax of
SnmpAdminString, and can thus be trivially mapped to a securityName or
groupName as defined in VACM, in accordance with a security policy.
All entries in related tables belonging to a particular user will have
the same value for this initial index. For a given user's entries in a
particular table, the object identifiers for the information in these
entries will have the same subidentifiers (except for the "column"
subidentifier) up to the end of the encoded owner index. To configure
VACM to permit access to this portion of the table, one would create
vacmViewTreeFamilyTable entries with the value of
vacmViewTreeFamilySubtree including the owner index portion, and
vacmViewTreeFamilyMask "wildcarding" the column subidentifier. More
elaborate configurations are possible.
8. Definitions 8. Definitions
EVENT-MIB DEFINITIONS ::= BEGIN DISMAN-EVENT-MIB DEFINITIONS ::= BEGIN
IMPORTS IMPORTS
MODULE-IDENTITY, OBJECT-TYPE, MODULE-IDENTITY, OBJECT-TYPE,
experimental, Integer32, Unsigned32 experimental, Integer32, Unsigned32,
NOTIFICATION-TYPE FROM SNMPv2-SMI NOTIFICATION-TYPE, Counter32,
Gauge32 FROM SNMPv2-SMI
TEXTUAL-CONVENTION, RowStatus, TEXTUAL-CONVENTION, RowStatus,
TimeStamp, DisplayString FROM SNMPv2-TC TruthValue FROM SNMPv2-TC
MODULE-COMPLIANCE, OBJECT-GROUP FROM SNMPv2-CONF MODULE-COMPLIANCE, OBJECT-GROUP,
NOTIFICATION-GROUP FROM SNMPv2-CONF
sysUpTime FROM SNMPv2-MIB
SnmpTagValue FROM SNMP-TARGET-MIB SnmpTagValue FROM SNMP-TARGET-MIB
SnmpAdminString FROM SNMP-FRAMEWORK-MIB; SnmpAdminString FROM SNMP-FRAMEWORK-MIB;
eventMIB MODULE-IDENTITY dismanEventMIB MODULE-IDENTITY
LAST-UPDATED "9810071700Z" LAST-UPDATED "9902221700Z"
ORGANIZATION "IETF Distributed Management Working Group" ORGANIZATION "IETF Distributed Management Working Group"
CONTACT-INFO "Bob Stewart CONTACT-INFO "Bob Stewart
Cisco Systems, Inc. Cisco Systems, Inc.
170 West Tasman Drive, 170 West Tasman Drive,
San Jose CA 95134-1706. San Jose CA 95134-1706.
Phone: +1 408 526 4527 Phone: +1 408 526 4527
Email: bstewart@cisco.com" Email: bstewart@cisco.com"
DESCRIPTION DESCRIPTION
"The MIB module for defining event triggers and actions "The MIB module for defining event triggers and actions
for network management purposes." for network management purposes."
::= { experimental xx } ::= { experimental xx }
eventMIBObjects OBJECT IDENTIFIER ::= { eventMIB 1 } dismanEventMIBObjects OBJECT IDENTIFIER ::= { dismanEventMIB 1 }
mteTrigger OBJECT IDENTIFIER ::= { eventMIBObjects 1 } mteResource OBJECT IDENTIFIER ::= { dismanEventMIBObjects 1 }
mteEvent OBJECT IDENTIFIER ::= { eventMIBObjects 2 } mteTrigger OBJECT IDENTIFIER ::= { dismanEventMIBObjects 2 }
mteObjects OBJECT IDENTIFIER ::= { dismanEventMIBObjects 3 }
mteEvent OBJECT IDENTIFIER ::= { dismanEventMIBObjects 4 }
-- For use as a default OID:
zeroDotZero OBJECT IDENTIFIER ::= { 0 0 }
-- --
-- Textual Conventions -- Textual Conventions
-- --
FailureReason ::= TEXTUAL-CONVENTION FailureReason ::= TEXTUAL-CONVENTION
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"Reasons for failures in an attempt to send a management "Reasons for failures in an attempt to perform a management
message. request.
The first group of errors, numbered less than 100, are copied The first group of errors, numbered less than 0, are related
to problems in sending the request. The existence of a
particular error code here does not imply that all
implementations are capable of sensing that error and
returning that code.
The second group, numbered greater than 0, are copied
directly from SNMP protocol operations and are intended to carry directly from SNMP protocol operations and are intended to carry
exactly the meanings defined for the protocol as returned in exactly the meanings defined for the protocol as returned in
an SNMP response. Those numbered 100 or greater are related an SNMP response.
to problems in sending the request."
SYNTAX INTEGER { tooBig(1), localResourceLack some local resource such as memory lacking
or mteResourceSampleInstanceMaximum
exceeded
badDestination unrecognized domain name or otherwise
invalid destination address
destinationUnreachable can't get to destination address
noResponse no response to SNMP request
badType the data syntax of a retrieved object
as not as expected
sampleOverrun another sample attempt occurred before
the previous one completed"
SYNTAX INTEGER { localResourceLack(-1),
badDestination(-2),
destinationUnreachable(-3),
noResponse(-4),
badType(-5),
sampleOverrun(-6),
noError(0),
tooBig(1),
noSuchName(2), noSuchName(2),
badValue(3), badValue(3),
readOnly(4), readOnly(4),
genErr(5), genErr(5),
noAccess(6), noAccess(6),
wrongType(7), wrongType(7),
wrongLength(8), wrongLength(8),
wrongEncoding(9), wrongEncoding(9),
wrongValue(10), wrongValue(10),
noCreation(11), noCreation(11),
inconsistentValue(12), inconsistentValue(12),
resourceUnavailable(13), resourceUnavailable(13),
commitFailed(14), commitFailed(14),
undoFailed(15), undoFailed(15),
authorizationError(16), authorizationError(16),
notWritable(17), notWritable(17),
inconsistentName(18), inconsistentName(18) }
--
-- Resource Control Section
--
localResourceLack(101), mteResourceSampleMinimum OBJECT-TYPE
badDestination(102), SYNTAX Integer32 (-1 | 1..600)
noAck(103) } UNITS "seconds"
MAX-ACCESS read-write
STATUS current
DESCRIPTION
"The minimum mteTriggerFrequency this system will accept. A
system may use the larger values of this minimum to lessen the
impact of sampling.
Unless explicitly resource limited, a system's value for
this object should be 1.
Changing this value will not invalidate an existing setting
of mteTriggerFrequency."
::= { mteResource 1 }
mteResourceSampleInstanceMaximum OBJECT-TYPE
SYNTAX Unsigned32
UNITS "instances"
MAX-ACCESS read-write
STATUS current
DESCRIPTION
"The maximum number of instance entries this system will
support for sampling.
These are the entries that maintain state, one for each
instance of each sampled object as selected by
mteTriggerValueID. Note that wildcarded objects result
in multiple instances of this state.
A value of 0 indicates no preset limit, that is, the limit
is dynamic based on system operation and resources.
Unless explicitly resource limited, a system's value for
this object should be 0.
Changing this value will not eliminate or inhibit existing sample
state but could prevent allocation of additional state
information."
::= { mteResource 2 }
mteResourceSampleInstances OBJECT-TYPE
SYNTAX Gauge32
UNITS "instances"
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The number of currently active instance entries as
defined for mteResourceSampleInstanceMaximum."
::= { mteResource 3 }
mteResourceSampleInstancesHigh OBJECT-TYPE
SYNTAX Gauge32
UNITS "instances"
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The highest value of mteResourceSampleInstances that has
occurred since initialization of the management system."
::= { mteResource 4 }
mteResourceSampleInstanceLacks OBJECT-TYPE
SYNTAX Counter32
UNITS "instances"
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The number of times this system could not take a new sample
because that allocation would have exceeded the limit set by
mteResourceSampleInstanceMaximum."
::= { mteResource 5 }
-- --
-- Trigger Section -- Trigger Section
-- --
-- Counters -- Counters
mteTriggerFailures OBJECT-TYPE mteTriggerFailures OBJECT-TYPE
SYNTAX Counter32 SYNTAX Counter32
MAX-ACCESS read-only MAX-ACCESS read-only
skipping to change at page 9, line 21 skipping to change at page 11, line 38
MAX-ACCESS not-accessible MAX-ACCESS not-accessible
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"A table of management event trigger information." "A table of management event trigger information."
::= { mteTrigger 2 } ::= { mteTrigger 2 }
mteTriggerEntry OBJECT-TYPE mteTriggerEntry OBJECT-TYPE
SYNTAX MteTriggerEntry SYNTAX MteTriggerEntry
MAX-ACCESS not-accessible MAX-ACCESS not-accessible
STATUS current STATUS current
DESCRIPTION
"Information about a single trigger. Applications create and "Information about a single trigger. Applications create and
delete entries using mteTriggerStatus." delete entries using mteTriggerEntryStatus."
INDEX { IMPLIED mteTriggerName } INDEX { mteOwner, IMPLIED mteTriggerName }
::= { mteTriggerteble 1 } ::= { mteTriggerTable 1 }
MteTriggerEntry ::= SEQUENCE { MteTriggerEntry ::= SEQUENCE {
mteOwner SnmpAdminString,
mteTriggerName SnmpAdminString, mteTriggerName SnmpAdminString,
mteTriggerComment DisplayString, mteTriggerComment SnmpAdminString,
mteTriggerTest INTEGER, mteTriggerTest BITS,
mteTriggerValueID Integer32, mteTriggerSampleType INTEGER,
mteTriggerValueID OBJECT IDENTIFIER,
mteTriggerValueIDWildcard TruthValue, mteTriggerValueIDWildcard TruthValue,
mteTriggerTargetTag SnmpTagValue, mteTriggerTargetTag SnmpTagValue,
mteTriggerContextName SnmpAdminString, mteTriggerContextName SnmpAdminString,
mteTriggerContextNameWildcard TruthValue, mteTriggerContextNameWildcard TruthValue,
mteTriggerFrequency Integer32, mteTriggerFrequency Unsigned32,
mteTriggerBooleanStartup INTEGER, mteTriggerObjectsOwner SnmpAdminString,
mteTriggerThresholdStartup INTEGER,
mteTriggerRisingThreshold Integer32,
mteTriggerFallingThreshold Integer32,
mteTriggerEvent SnmpAdminString,
mteTriggerRisingEvent SnmpAdminString,
mteTriggerFallingEvent SnmpAdminString,
mteTriggerObjects SnmpAdminString, mteTriggerObjects SnmpAdminString,
mteTriggerStatus RowStatus mteTriggerEnabled TruthValue,
mteTriggerEntryStatus RowStatus
} }
mteOwner OBJECT-TYPE
SYNTAX SnmpAdminString (SIZE(0..32))
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"The owner of this entry. The exact semantics of this
string are subject to the security policy defined by the
security administrator."
::= { mteTriggerEntry 1 }
mteTriggerName OBJECT-TYPE mteTriggerName OBJECT-TYPE
SYNTAX SnmpAdminString (SIZE (1..64)) SYNTAX SnmpAdminString (SIZE (1..32))
MAX-ACCESS not-accessible MAX-ACCESS not-accessible
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"A locally-unique, administratively assigned name for the "A locally-unique, administratively assigned name for the
trigger." trigger within the scope of mteOwner."
::= { mteTriggerEntry 1 } ::= { mteTriggerEntry 2 }
mteTriggerComment OBJECT-TYPE mteTriggerComment OBJECT-TYPE
SYNTAX DisplayString SYNTAX SnmpAdminString
MAX-ACCESS read-create MAX-ACCESS read-create
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"A description of the trigger's function and use." "A description of the trigger's function and use."
DEFVAL { ''H } DEFVAL { ''H }
::= { mteTriggerEntry 2 } ::= { mteTriggerEntry 3 }
mteTriggerTest OBJECT-TYPE mteTriggerTest OBJECT-TYPE
SYNTAX INTEGER { boolean(1), threshold(2) } SYNTAX BITS { existence(0), boolean(1), threshold(2) }
MAX-ACCESS read-create MAX-ACCESS read-create
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The type of trigger test to perform. For all tests, "The type of trigger test to perform. For 'boolean' and
mteTriggerValue must evaluate to an integer. 'threshold' tests, the object at mteTriggerValueID must
evaluate to an integer, that is, anything that ends up encoded
for transmission as an integer.
For 'boolean', a value of 0 is false. A non-zero value is true For 'existence', the specific test is as selected by
and fires the trigger. The trigger will not fire again until mteTriggerExistenceTest. When an object appears or vanishes
the value has become false and come back to true. the trigger fires. The trigger will not fire again until the
object has changed states.
For 'threshold' it works as described below for For 'boolean', the specific test is as selected by
mteTriggerThresholdStartup, mteTriggerRisingThreshold, and mteTriggerBooleanTest. If the test result is true the trigger
mteTriggerFallingThreshold." fires. The trigger will not fire again until the value has
become false and come back to true.
For 'threshold' the test works as described below for
mteTriggerThresholdStartup, mteTriggerThresholdRising, and
mteTriggerThresholdFalling.
Note that combining 'boolean' and 'threshold' tests on the
same object may be somewhat redundant."
DEFVAL { boolean } DEFVAL { boolean }
::= { mteTriggerEntry 3 } ::= { mteTriggerEntry 4 }
mteTriggerSampleType OBJECT-TYPE
SYNTAX INTEGER { absoluteValue(1), deltaValue(2) }
MAX-ACCESS read-create
STATUS current
DESCRIPTION
"The type of sampling to perform.
An 'absoluteValue' sample requires only a single sample to be
meaningful, and is exactly the value of the object at
mteTriggerValueID at the sample time.
A 'deltaValue' requires two samples to be meaningful and is
thus not available for testing until the second and subsequent
samples after the object at mteTriggerValueID is first found
to exist. It is the difference between the two samples. For
unsigned values it is always positive, based on unsigned
arithmetic. For signed values it can be positive or negative.
For SNMP counters to be meaningful they must be sampled as a
'deltaValue'.
For 'deltaValue' mteTriggerDeltaTable contains further
parameters.
If only 'existence' is set in mteTriggerTest this object has
no meaning."
DEFVAL { absoluteValue }
::= { mteTriggerEntry 5 }
mteTriggerValueID OBJECT-TYPE mteTriggerValueID OBJECT-TYPE
SYNTAX OBJECT IDENTIFIER SYNTAX OBJECT IDENTIFIER
MAX-ACCESS read-create MAX-ACCESS read-create
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The object identifier of the MIB object to check to see "The object identifier of the MIB object to sample to see
if the trigger should fire. if the trigger should fire.
This may be wildcarded by truncating all or part of the This may be wildcarded by truncating all or part of the
instance portion, in which case the condition is obtained instance portion, in which case the value is obtained
as if with a GetNext function, checking multiple values as if with a GetNext function, checking multiple values
if they exist. If such wildcarding is applied, if they exist. If such wildcarding is applied,
mteTriggerIDWildcard must be 'true' and if not it must mteTriggerValueIDWildcard must be 'true' and if not it must
be 'false'." be 'false'.
DEFVAL { 0 0 }
::= { mteTriggerEntry 4 } Bad object identifiers or a mismatch between truncating the
identifier and the value of mteTriggerValueIDWildcard result
in operation as one would expect when providing the wrong
identifier to a Get or GetNext operation. The Get will fail
or get the wrong object. The GetNext will indeed get whatever
is next, proceeding until it runs past the initial part of the
identifier and perhaps many unintended objects for confusing
results. If the value syntax of those objects is not usable,
that results in a 'badType' error that terminates the scan.
Each instance that fills the wildcard is independent of any
additional instances, that is, wildcarded objects operate
as if there were a separate table entry for each instance
that fills the wildcard without having to actually predict
all possible instances ahead of time."
DEFVAL { zeroDotZero }
::= { mteTriggerEntry 6 }
mteTriggerValueIDWildcard OBJECT-TYPE mteTriggerValueIDWildcard OBJECT-TYPE
SYNTAX TruthValue SYNTAX TruthValue
MAX-ACCESS read-create MAX-ACCESS read-create
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"Control for whether mteTriggerValueID is to be treated as "Control for whether mteTriggerValueID is to be treated as
fully-specified or wildcarded, with 'true' indicating wildcard. fully-specified or wildcarded, with 'true' indicating wildcard."
DEFVAL { false } DEFVAL { false }
::= { mteTriggerEntry 5 } ::= { mteTriggerEntry 7 }
mteTriggerTargetTag OBJECT-TYPE mteTriggerTargetTag OBJECT-TYPE
SYNTAX SnmpTagValue SYNTAX SnmpTagValue
MAX-ACCESS read-create MAX-ACCESS read-create
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The tag for the target(s) from which to obtain the condition "The tag for the target(s) from which to obtain the condition
for a trigger check. for a trigger check.
Systems limited to self management may not accept a non-zero
length for the value of this object.
A length of 0 indicates the local system. In this case, A length of 0 indicates the local system. In this case,
access to the objects indicated by mteTriggerValueID is under access to the objects indicated by mteTriggerValueID is under
the security credentials of the requester that set the security credentials of the requester that set
mteTriggerStatus to 'active'." mteTriggerEntryStatus to 'active'. Those credentials are the
input parameters for isAccessAllowed from the Architecture for
Describing SNMP Management Frameworks.
Otherwise access rights are checked according to the security
parameters resulting from the tag."
DEFVAL { ''H } DEFVAL { ''H }
::= { mteTriggerEntry 6 } ::= { mteTriggerEntry 8 }
mteTriggerContextName OBJECT-TYPE mteTriggerContextName OBJECT-TYPE
SYNTAX SnmpAdminString SYNTAX SnmpAdminString
MAX-ACCESS read-create MAX-ACCESS read-create
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The management context from which to obtain mteTriggerValueID. "The management context from which to obtain mteTriggerValueID.
This may be wildcarded by leaving characters off the end. To This may be wildcarded by leaving characters off the end. For
indicate such wildcarding mteTriggerContextNameWildcard must example use 'Repeater' to wildcard to 'Repeater1',
be 'true'." 'Repeater2', 'Repeater-999.87b', and so on. To indicate such
wildcarding is intended, mteTriggerContextNameWildcard must
be 'true'.
Each instance that fills the wildcard is independent of any
additional instances, that is, wildcarded objects operate
as if there were a separate table entry for each instance
that fills the wildcard without having to actually predict
all possible instances ahead of time.
Operation of this feature assumes that the local system has a
list of available contexts against which to apply the
wildcard. If the objects are being read from the local
system, this is clearly the system's own list of contexts.
For a remote system a local version of such a list is not
defined by any current standard and may not be available, so
this function may not be supported."
DEFVAL { ''H } DEFVAL { ''H }
::= { mteTriggerEntry 7 } ::= { mteTriggerEntry 9 }
mteTriggerContextNameWildcard OBJECT-TYPE mteTriggerContextNameWildcard OBJECT-TYPE
SYNTAX TruthValue SYNTAX TruthValue
MAX-ACCESS read-create MAX-ACCESS read-create
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"Control for whether mteTriggerContextName is to be treated as "Control for whether mteTriggerContextName is to be treated as
fully-specified or wildcarded, with 'true' indicating wildcard. fully-specified or wildcarded, with 'true' indicating wildcard."
DEFVAL { false } DEFVAL { false }
::= { mteTriggerEntry 8 } ::= { mteTriggerEntry 10 }
mteTriggerFrequency OBJECT-TYPE mteTriggerFrequency OBJECT-TYPE
SYNTAX Integer32 (0..65535) SYNTAX Unsigned32
UNITS "seconds" UNITS "seconds"
MAX-ACCESS read-create MAX-ACCESS read-create
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The number of seconds to wait between trigger condition "The number of seconds to wait between trigger samples. To
checks. To encourage consistency in sampling, the encourage consistency in sampling, the interval is measured
interval is measured from the beginning of one check to from the beginning of one check to the beginning of the next
the beginning of the next and the timer is restarted immediately and the timer is restarted immediately when it expires, not
when it expires, not when the check completes. when the check completes.
If the next check begins before the previous one completed the If the next sample begins before the previous one completed the
system may either attempt to make the check or treat this as an system may either attempt to make the check or treat this as an
error condition. error condition with the error 'sampleOverrun'.
A frequency of 0 indicates instantaneous recognition of the A frequency of 0 indicates instantaneous recognition of the
condition. This is not possible in many cases, but such may condition. This is not possible in many cases, but may
be supported in cases where it makes sense and the system is be supported in cases where it makes sense and the system is
able to do so." able to do so. This feature allows the MIB to be used in
implementations where such interrupt-driven behavior is
possible and is not likely to be supported for all MIB objects
even then since such sampling generally has to be tightly
integrated into low-level code.
Systems that can support this should document those cases
where it can be used. In cases where it can not, setting this
object to 0 simply returns a bad value error."
DEFVAL { 600 } DEFVAL { 600 }
::= { mteTriggerEntry 9 } ::= { mteTriggerEntry 11 }
mteTriggerBooleanStartup OBJECT-TYPE mteTriggerObjectsOwner OBJECT-TYPE
SYNTAX SnmpAdminString (SIZE (0..32))
MAX-ACCESS read-create
STATUS current
DESCRIPTION
"To go with mteTriggerObjects, the mteOwner of a group of
objects from mteObjectsTable."
DEFVAL { ''H }
::= { mteTriggerEntry 12 }
mteTriggerObjects OBJECT-TYPE
SYNTAX SnmpAdminString (SIZE (0..32))
MAX-ACCESS read-create
STATUS current
DESCRIPTION
"The mteObjectsName of a group of objects from
mteObjectsTable. These objects are to be added to any
Notification resulting from the firing of this trigger.
A list of objects may also be added based on the event or on
the value of mteTriggerTest.
A length of 0 indicates no additional objects."
DEFVAL { ''H }
::= { mteTriggerEntry 13 }
mteTriggerEnabled OBJECT-TYPE
SYNTAX TruthValue SYNTAX TruthValue
MAX-ACCESS read-create MAX-ACCESS read-create
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"A control to allow a trigger to be configured but not used.
When the value is 'false' the trigger is not sampled."
DEFVAL { false }
::= { mteTriggerEntry 14 }
mteTriggerEntryStatus OBJECT-TYPE
SYNTAX RowStatus
MAX-ACCESS read-create
STATUS current
DESCRIPTION
"The control that allows creation and deletion of entries.
Once made active an entry may not be modified except to
delete it."
::= { mteTriggerEntry 15 }
--
-- Trigger Delta Table
--
mteTriggerDeltaTable OBJECT-TYPE
SYNTAX SEQUENCE OF MteTriggerDeltaEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"A table of management event trigger information for delta
sampling."
::= { mteTrigger 3 }
mteTriggerDeltaEntry OBJECT-TYPE
SYNTAX MteTriggerDeltaEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"Information about a single trigger's delta sampling. Entries
automatically exist in this this table for each mteTriggerEntry
that has mteTriggerSampleType set to 'deltaValue'."
INDEX { mteOwner, IMPLIED mteTriggerName }
::= { mteTriggerDeltaTable 1 }
MteTriggerDeltaEntry ::= SEQUENCE {
mteTriggerDeltaDiscontinuityID OBJECT IDENTIFIER,
mteTriggerDeltaDiscontinuityIDWildcard TruthValue,
mteTriggerDeltaDiscontinuityIDType INTEGER
}
sysUpTimeInstance OBJECT IDENTIFIER ::= { sysUpTime 0 }
mteTriggerDeltaDiscontinuityID OBJECT-TYPE
SYNTAX OBJECT IDENTIFIER
MAX-ACCESS read-write
STATUS current
DESCRIPTION
"The OBJECT IDENTIFIER (OID) of a TimeTicks or TimeStamp object
that indicates a discontinuity in the value at
mteTriggerValueID.
The OID may be for a leaf object (e.g. sysUpTime.0) or may
be wildcarded to match mteTriggerValueID.
This object supports normal checking for a discontinuity in a
counter. Note that if this object does not point to sysUpTime
discontinuity checking must still check sysUpTime for an overall
discontinuity.
If the object identified is not accessible the sample attempt
is in error, with the error code as from an SNMP request.
Bad object identifiers or a mismatch between truncating the
identifier and the value of mteDeltaDiscontinuityIDWildcard
result in operation as one would expect when providing the
wrong identifier to a Get operation. The Get will fail or get
the wrong object. If the value syntax of those objects is not
usable, that results in an error that terminates the sample
with a 'badType' error code."
DEFVAL { sysUpTimeInstance }
::= { mteTriggerDeltaEntry 1 }
mteTriggerDeltaDiscontinuityIDWildcard OBJECT-TYPE
SYNTAX TruthValue
MAX-ACCESS read-write
STATUS current
DESCRIPTION
"Control for whether mteTriggerDeltaDiscontinuityID is to be
treated as fully-specified or wildcarded, with 'true'
indicating wildcard."
DEFVAL { false }
::= { mteTriggerDeltaEntry 2 }
mteTriggerDeltaDiscontinuityIDType OBJECT-TYPE
SYNTAX INTEGER { timeTicks(1), timeStamp(2), dateAndTime(3) }
MAX-ACCESS read-write
STATUS current
DESCRIPTION
"The value 'timeTicks' indicates the
mteTriggerDeltaDiscontinuityID of this row is of syntax
TimeTicks. The value 'timeStamp' indicates syntax TimeStamp.
The value 'dateAndTime' indicates syntax DateAndTime."
DEFVAL { timeTicks }
::= { mteTriggerDeltaEntry 3 }
--
-- Trigger Existence Table
--
mteTriggerExistenceTable OBJECT-TYPE
SYNTAX SEQUENCE OF MteTriggerExistenceEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"A table of management event trigger information for existence
triggers."
::= { mteTrigger 4 }
mteTriggerExistenceEntry OBJECT-TYPE
SYNTAX MteTriggerExistenceEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"Information about a single existence trigger. Entries
automatically exist in this this table for each mteTriggerEntry
that has 'existence' set in mteTriggerTest."
INDEX { mteOwner, IMPLIED mteTriggerName }
::= { mteTriggerExistenceTable 1 }
MteTriggerExistenceEntry ::= SEQUENCE {
mteTriggerExistenceTest INTEGER,
mteTriggerExistenceStartup TruthValue,
mteTriggerExistenceObjectsOwner SnmpAdminString,
mteTriggerExistenceObjects SnmpAdminString,
mteTriggerExistenceEventOwner SnmpAdminString,
mteTriggerExistenceEvent SnmpAdminString
}
mteTriggerExistenceTest OBJECT-TYPE
SYNTAX BITS { present(0), absent(1), changed(2) }
MAX-ACCESS read-write
STATUS current
DESCRIPTION
"The type of existence test to perform. The trigger fires
when the object at mteTriggerValueID is seen to go from
present to absent, from absent to present, or to have it's
value changed, depending on which tests are selected.
Once the trigger has fired for either presence or absence it
will not fire again for that state until the object has been
to the other state."
DEFVAL { { present, absent } }
::= { mteTriggerExistenceEntry 1 }
mteTriggerExistenceStartup OBJECT-TYPE
SYNTAX BITS { present(0), absent(1), changed(2) }
MAX-ACCESS read-write
STATUS current
DESCRIPTION
"Control for whether an event may be triggered when this entry "Control for whether an event may be triggered when this entry
is first set to 'active'. If the value mteTriggerBooleanStartup is first set to 'active' and the test specified by
is 'true' and the first sample after this entry becomes active mteTriggerExistenceTest is true. Setting an option causes
is true then one mteTriggerEvent is triggered. that trigger to fire when its test is true."
DEFVAL { { present, absent } }
::= { mteTriggerExistenceEntry 2 }
If mteTriggerType is not 'boolean', this object is not mteTriggerExistenceObjectsOwner OBJECT-TYPE
instantiated." SYNTAX SnmpAdminString (SIZE (0..32))
MAX-ACCESS read-write
STATUS current
DESCRIPTION
"To go with mteTriggerExistenceObjects, the mteOwner of a
group of objects from mteObjectsTable."
DEFVAL { ''H }
::= { mteTriggerExistenceEntry 3 }
mteTriggerExistenceObjects OBJECT-TYPE
SYNTAX SnmpAdminString (SIZE (0..32))
MAX-ACCESS read-write
STATUS current
DESCRIPTION
"The mteObjectsName of a group of objects from
mteObjectsTable. These objects are to be added to any
Notification resulting from the firing of this trigger for
this test.
A list of objects may also be added based on the overall
trigger, the event or other settings in mteTriggerTest.
A length of 0 indicates no additional objects."
DEFVAL { ''H }
::= { mteTriggerExistenceEntry 4 }
mteTriggerExistenceEventOwner OBJECT-TYPE
SYNTAX SnmpAdminString (SIZE (0..32))
MAX-ACCESS read-write
STATUS current
DESCRIPTION
"To go with mteTriggerExistenceEvent, the mteOwner of a group
of objects from mteObjectsTable."
DEFVAL { ''H }
::= { mteTriggerExistenceEntry 5 }
mteTriggerExistenceEvent OBJECT-TYPE
SYNTAX SnmpAdminString (SIZE (0..32))
MAX-ACCESS read-write
STATUS current
DESCRIPTION
"The mteEventName of the event to invoke when mteTriggerType is
'existence' and this trigger fires. A length of 0 indicates no
event."
DEFVAL { ''H }
::= { mteTriggerExistenceEntry 6 }
--
-- Trigger Boolean Table
--
mteTriggerBooleanTable OBJECT-TYPE
SYNTAX SEQUENCE OF MteTriggerBooleanEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"A table of management event trigger information for boolean
triggers."
::= { mteTrigger 5 }
mteTriggerBooleanEntry OBJECT-TYPE
SYNTAX MteTriggerBooleanEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"Information about a single boolean trigger. Entries
automatically exist in this this table for each mteTriggerEntry
that has 'boolean' set in mteTriggerTest."
INDEX { mteOwner, IMPLIED mteTriggerName }
::= { mteTriggerBooleanTable 1 }
MteTriggerBooleanEntry ::= SEQUENCE {
mteTriggerBooleanComparison INTEGER,
mteTriggerBooleanValue Integer32,
mteTriggerBooleanStartup TruthValue,
mteTriggerBooleanObjectsOwner SnmpAdminString,
mteTriggerBooleanObjects SnmpAdminString,
mteTriggerBooleanEventOwner SnmpAdminString,
mteTriggerBooleanEvent SnmpAdminString
}
mteTriggerBooleanComparison OBJECT-TYPE
SYNTAX INTEGER { unequal(1), equal(2),
less(3), lessOrEqual(4),
greater(5), greaterOrEqual(6) }
MAX-ACCESS read-write
STATUS current
DESCRIPTION
"The type of boolean comparison to perform.
The value at mteTriggerValueID is compared to
mteTriggerBooleanValue, so for example if
mteTriggerBooleanComparison is 'less' the result would be true
if the value at mteTriggerValueID is less than the value of
mteTriggerBooleanValue."
DEFVAL { unequal }
::= { mteTriggerBooleanEntry 1 }
mteTriggerBooleanValue OBJECT-TYPE
SYNTAX Integer32
MAX-ACCESS read-write
STATUS current
DESCRIPTION
"The value to use for the test specified by
mteTriggerBooleanTest."
DEFVAL { 0 }
::= { mteTriggerBooleanEntry 2 }
mteTriggerBooleanStartup OBJECT-TYPE
SYNTAX TruthValue
MAX-ACCESS read-write
STATUS current
DESCRIPTION
"Control for whether an event may be triggered when this entry
is first set to 'active' or a new instance of the object at
mteTriggerValueID is found and the test specified by
mteTriggerBooleanComparison is true. In that case an event is
triggered if mteTriggerBooleanStartup is 'true'."
DEFVAL { true } DEFVAL { true }
::= { mteTriggerEntry 10 } ::= { mteTriggerBooleanEntry 3 }
mteTriggerBooleanObjectsOwner OBJECT-TYPE
SYNTAX SnmpAdminString (SIZE (0..32))
MAX-ACCESS read-write
STATUS current
DESCRIPTION
"To go with mteTriggerBooleanObjects, the mteOwner of a group
of objects from mteObjectsTable."
DEFVAL { ''H }
::= { mteTriggerBooleanEntry 4 }
mteTriggerBooleanObjects OBJECT-TYPE
SYNTAX SnmpAdminString (SIZE (0..32))
MAX-ACCESS read-write
STATUS current
DESCRIPTION
"The mteObjectsName of a group of objects from
mteObjectsTable. These objects are to be added to any
Notification resulting from the firing of this trigger for
this test.
A list of objects may also be added based on the overall
trigger, the event or other settings in mteTriggerTest.
A length of 0 indicates no additional objects."
DEFVAL { ''H }
::= { mteTriggerBooleanEntry 5 }
mteTriggerBooleanEventOwner OBJECT-TYPE
SYNTAX SnmpAdminString (SIZE (0..32))
MAX-ACCESS read-write
STATUS current
DESCRIPTION
"To go with mteTriggerBooleanEvent, the mteOwner of an event
entry from mteEventTable."
DEFVAL { ''H }
::= { mteTriggerBooleanEntry 6 }
mteTriggerBooleanEvent OBJECT-TYPE
SYNTAX SnmpAdminString (SIZE (0..32))
MAX-ACCESS read-write
STATUS current
DESCRIPTION
"The mteEventName of the event to invoke when mteTriggerType is
'boolean' and this trigger fires. A length of 0 indicates no
event."
DEFVAL { ''H }
::= { mteTriggerBooleanEntry 7 }
--
-- Trigger Threshold Table
--
mteTriggerThresholdTable OBJECT-TYPE
SYNTAX SEQUENCE OF MteTriggerThresholdEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"A table of management event trigger information for threshold
triggers."
::= { mteTrigger 6 }
mteTriggerThresholdEntry OBJECT-TYPE
SYNTAX MteTriggerThresholdEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"Information about a single threshold trigger. Entries
automatically exist in this table for each mteTriggerEntry
that has 'threshold' set in mteTriggerTest."
INDEX { mteOwner, IMPLIED mteTriggerName }
::= { mteTriggerThresholdTable 1 }
MteTriggerThresholdEntry ::= SEQUENCE {
mteTriggerThresholdValue Integer32,
mteTriggerThresholdStartup INTEGER,
mteTriggerThresholdRising Integer32,
mteTriggerThresholdFalling Integer32,
mteTriggerThresholdObjectsOwner SnmpAdminString,
mteTriggerThresholdObjects SnmpAdminString,
mteTriggerThresholdRisingEventOwner SnmpAdminString,
mteTriggerThresholdRisingEvent SnmpAdminString,
mteTriggerThresholdFallingEventOwner SnmpAdminString,
mteTriggerThresholdFallingEvent SnmpAdminString
}
mteTriggerThresholdValue OBJECT-TYPE
SYNTAX Integer32
MAX-ACCESS read-write
STATUS current
DESCRIPTION
"The value to use for the threshold test."
DEFVAL { 0 }
::= { mteTriggerThresholdEntry 1 }
mteTriggerThresholdStartup OBJECT-TYPE mteTriggerThresholdStartup OBJECT-TYPE
SYNTAX INTEGER { rising(1), falling(2), risingOrFalling(3) } SYNTAX INTEGER { rising(1), falling(2), risingOrFalling(3) }
MAX-ACCESS read-create MAX-ACCESS read-write
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The event that may be triggered when this entry is first "The event that may be triggered when this entry is first
set to 'active'. If the first sample after this entry set to 'active' and a new instance of the object at
becomes active is greater than or equal to mteTriggerValueID is found. If the first sample after this
mteTriggerRisingThreshold and mteTriggerThresholdStartup is instance becomes active is greater than or equal to
mteTriggerThresholdRising and mteTriggerThresholdStartup is
equal to 'rising' or 'risingOrFalling', then one equal to 'rising' or 'risingOrFalling', then one
mteTriggerRisingEvent is triggered. If the first mteTriggerThresholdRisingEvent is triggered for that instance.
sample after this entry becomes active is less than If the first sample after this entry becomes active is less than
or equal to mteTriggerFallingThreshold and or equal to mteTriggerThresholdFalling and
mteTriggerThresholdStartup is equal to 'falling' or mteTriggerThresholdStartup is equal to 'falling' or
'risingOrFalling', then one mteTriggerRisingEvent is triggered. 'risingOrFalling', then one mteTriggerThresholdRisingEvent is
triggered for that instance."
If mteTriggerType is not 'threshold', this object is not
instantiated."
DEFVAL { risingOrFalling } DEFVAL { risingOrFalling }
::= { mteTriggerEntry 11 } ::= { mteTriggerThresholdEntry 2 }
mteTriggerRisingThreshold OBJECT-TYPE mteTriggerThresholdRising OBJECT-TYPE
SYNTAX Integer32 SYNTAX Integer32
MAX-ACCESS read-create MAX-ACCESS read-write
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"A threshold value to check against if mteTriggerType is "A threshold value to check against if mteTriggerType is
'threshold'. 'threshold'.
When the current sampled value is greater than or equal to When the current sampled value is greater than or equal to
this threshold, and the value at the last sampling this threshold, and the value at the last sampling interval
interval was less than this threshold, one mteTriggerRisingEvent was less than this threshold, one
is triggered. That event is also triggered if the first sample mteTriggerThresholdRisingEvent is triggered. That event is
afer this entry bcomes active is greater than or equal to this also triggered if the first sample afer this entry bcomes
threshold and mteTriggerThresholdStartup is equal to 'rising' active is greater than or equal to this threshold and
or 'risingOrFalling'. mteTriggerThresholdStartup is equal to 'rising' or
'risingOrFalling'.
After a rising event is generated, another such event is not After a rising event is generated, another such event is not
triggered until the sampled value falls below this threshold and triggered until the sampled value falls below this threshold and
reaches mteTriggerFallingThreshold. reaches mteTriggerThresholdFalling."
If mteTriggerType is not 'threshold', this object is not
instantiated."
DEFVAL { 0 } DEFVAL { 0 }
::= { mteTriggerEntry 12 } ::= { mteTriggerThresholdEntry 3 }
mteTriggerFallingThreshold OBJECT-TYPE mteTriggerThresholdFalling OBJECT-TYPE
SYNTAX Integer32 SYNTAX Integer32
MAX-ACCESS read-create MAX-ACCESS read-write
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"A threshold value to check against if mteTriggerType is "A threshold value to check against if mteTriggerType is
'threshold'. 'threshold'.
When the current sampled value is less than or equal to When the current sampled value is less than or equal to this
this threshold, and the value at the last sampling interval threshold, and the value at the last sampling interval was
was greater than this threshold, one mteTriggerFallingEvent greater than this threshold, one
is triggered. That event is also triggered if the first sample mteTriggerThresholdFallingEvent is triggered. That event is
afer this entry bcomes active is less than or equal to this also triggered if the first sample afer this entry bcomes
threshold and mteTriggerThresholdStartup is equal to 'falling' active is less than or equal to this threshold and
or 'risingOrFalling'. mteTriggerThresholdStartup is equal to 'falling' or
'risingOrFalling'.
After a falling event is generated, another such event is not After a falling event is generated, another such event is not
triggered until the sampled value rises above this threshold and triggered until the sampled value rises above this threshold and
reaches mteTriggerRisingThreshold. reaches mteTriggerThresholdRising."
If mteTriggerType is not 'threshold', this object is not
instantiated."
DEFVAL { 0 } DEFVAL { 0 }
::= { mteTriggerEntry 13 } ::= { mteTriggerThresholdEntry 4 }
mteTriggerEvent OBJECT-TYPE mteTriggerThresholdObjectsOwner OBJECT-TYPE
SYNTAX SnmpAdminString (SIZE (0..64)) SYNTAX SnmpAdminString (SIZE (0..32))
MAX-ACCESS read-create MAX-ACCESS read-write
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The event to invoke when mteTriggerType is 'boolean' and "To go with mteTriggerThresholdObjects, the mteOwner of a group
this trigger fires. A length of 0 indicates no event. of objects from mteObjectsTable."
If mteTriggerType is not 'boolean', this object is not
instantiated."
DEFVAL { ''H } DEFVAL { ''H }
::= { mteTriggerEntry 14 } ::= { mteTriggerThresholdEntry 5 }
mteTriggerRisingEvent OBJECT-TYPE mteTriggerThresholdObjects OBJECT-TYPE
SYNTAX SnmpAdminString (SIZE (0..64)) SYNTAX SnmpAdminString (SIZE (0..32))
MAX-ACCESS read-create MAX-ACCESS read-write
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The event to invoke when mteTriggerType is 'threshold' and "The mteObjectsName of a group of objects from
this trigger fires based on mteTriggerRisingThreshold. A mteObjectsTable. These objects are to be added to any
value of 0 indicates no event. Notification resulting from the firing of this trigger for
this test.
If mteTriggerType is not 'threshold', this object is not A list of objects may also be added based on the overall
instantiated." trigger, the event or other settings in mteTriggerTest.
A length of 0 indicates no additional objects."
DEFVAL { ''H } DEFVAL { ''H }
::= { mteTriggerEntry 15 } ::= { mteTriggerThresholdEntry 6 }
mteTriggerFallingEvent OBJECT-TYPE mteTriggerThresholdRisingEventOwner OBJECT-TYPE
SYNTAX SnmpAdminString (SIZE (0..64)) SYNTAX SnmpAdminString (SIZE (0..32))
MAX-ACCESS read-create MAX-ACCESS read-write
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The event to invoke when mteTriggerType is 'threshold' and "To go with mteTriggerThresholdRisingEvent, the mteOwner of an
this trigger fires based on mteTriggerFallingThreshold. A event entry from mteEventTable."
value of 0 indicates no event.
If mteTriggerType is not 'threshold', this object is not
instantiated."
DEFVAL { ''H } DEFVAL { ''H }
::= { mteTriggerEntry 16 } ::= { mteTriggerThresholdEntry 7 }
mteTriggerObjects OBJECT-TYPE mteTriggerThresholdRisingEvent OBJECT-TYPE
SYNTAX SnmpAdminString (SIZE (0..64)) SYNTAX SnmpAdminString (SIZE (0..32))
MAX-ACCESS read-create MAX-ACCESS read-write
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The mteTriggerObjectNName of a group of objects from "The mteEventName of the event to invoke when mteTriggerType is
mteTriggerObjectTable. These objects are to be added to any 'threshold' and this trigger fires based on
Notification resulting from the firing of this trigger. mteTriggerThresholdRising. A length of 0 indicates no event."
DEFVAL { ''H }
::= { mteTriggerThresholdEntry 8 }
A length of 0 indicates no additional objects." mteTriggerThresholdFallingEventOwner OBJECT-TYPE
SYNTAX SnmpAdminString (SIZE (0..32))
MAX-ACCESS read-write
STATUS current
DESCRIPTION
"To go with mteTriggerThresholdFallingEvent, the mteOwner of an
event entry from mteEventTable."
DEFVAL { ''H } DEFVAL { ''H }
::= { mteTriggerEntry 17 } ::= { mteTriggerThresholdEntry 9 }
mteTriggerStatus OBJECT-TYPE mteTriggerThresholdFallingEvent OBJECT-TYPE
SYNTAX RowStatus SYNTAX SnmpAdminString (SIZE (0..32))
MAX-ACCESS read-create MAX-ACCESS read-write
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The control that allows creation and deletion of entries. "The mteEventName of the event to invoke when mteTriggerType is
Once made active an entry may not be modified except to 'threshold' and this trigger fires based on
delete it." mteTriggerThresholdFalling. A length of 0 indicates no event."
DEFVAL { createAndWait } DEFVAL { ''H }
::= { mteTriggerEntry 18 } ::= { mteTriggerThresholdEntry 10 }
-- --
-- Objects Table
-- --
mteTriggerObjectTable OBJECT-TYPE mteObjectsTable OBJECT-TYPE
SYNTAX SEQUENCE OF mteTriggerObjectEntry SYNTAX SEQUENCE OF MteObjectsEntry
MAX-ACCESS not-accessible MAX-ACCESS not-accessible
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"A table of objects related to a trigger and to be added to "A table of objects that can be added to notifications based
Notifications resulting from that trigger." on the trigger, trigger test, or event, as pointed to by
::= { mteTrigger 3 } entries in those tables."
::= { mteObjects 1 }
mteTriggerObjectEntry OBJECT-TYPE mteObjectsEntry OBJECT-TYPE
SYNTAX mteTriggerObjectEntry SYNTAX MteObjectsEntry
MAX-ACCESS not-accessible MAX-ACCESS not-accessible
STATUS current STATUS current
"Objects for a single trigger. Applications create and DESCRIPTION
delete entries using mteTriggerObjectStatus." "A group of objects. Applications create and delete entries
INDEX { mteTriggerObjectName, mteTriggerObjectIndex } using mteObjectsEntryStatus."
::= { mteTriggerObjectteble 1 } INDEX { mteOwner, mteObjectsName, mteObjecsIndex }
::= { mteObjectsTable 1 }
mteTriggerObjectEntry ::= SEQUENCE { MteObjectsEntry ::= SEQUENCE {
mteTriggerObjectName SnmpAdminString, mteObjectsName SnmpAdminString,
mteTriggerObjectIndex Unsigned32, mteObjectsIndex Unsigned32,
mteTriggerObjectID Integer32, mteObjectsID OBJECT IDENTIFIER,
mteTriggerObjectIDWildcard TruthValue, mteObjectsIDWildcard TruthValue,
mteTriggerObjectStatus RowStatus mteObjectsEntryStatus RowStatus
} }
mteTriggerObjectName OBJECT-TYPE mteObjectsName OBJECT-TYPE
SYNTAX SnmpAdminString (SIZE (1..64)) SYNTAX SnmpAdminString (SIZE (1..32))
MAX-ACCESS not-accessible MAX-ACCESS not-accessible
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"A locally-unique, administratively assigned name for a group of "A locally-unique, administratively assigned name for a group of
objects to associate with a trigger." objects."
::= { mteTriggerObjectEntry 1 } ::= { mteObjectsEntry 1 }
mteTriggerObjectIndex OBJECT-TYPE mteObjectsIndex OBJECT-TYPE
SYNTAX Unsigned32 (1..4294967295) SYNTAX Unsigned32 (1..4294967295)
MAX-ACCESS not-accessible MAX-ACCESS not-accessible
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"An arbitrary small integer for the purpose of identifying "An arbitrary small integer for the purpose of identifying
individual objects with a mteTriggerObjectName group." individual objects within a mteObjectsName group.
::= { mteTriggerObjectEntry 2 }
mteTriggerObjectID OBJECT-TYPE Objects within a group are placed in the notification in the
numerical order of this index.
Groups are placed in the notification in the order of the
selections for overall trigger, trigger test, and event.
Within trigger test they are in the same order as the
numerical values of the bits defined for mteTriggerTest.
Bad object identifiers or a mismatch between truncating the
identifier and the value of mteDeltaDiscontinuityIDWildcard
result in operation as one would expect when providing the
wrong identifier to a Get operation. The Get will fail or get
the wrong object. If the object is not available it is omitted
from the notification."
::= { mteObjectsEntry 2 }
mteObjectsID OBJECT-TYPE
SYNTAX OBJECT IDENTIFIER SYNTAX OBJECT IDENTIFIER
MAX-ACCESS read-create MAX-ACCESS read-create
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The object identifier of a MIB object to add to a Notification "The object identifier of a MIB object to add to a
that results from the firing of a trigger. Notification that results from the firing of a trigger.
This may be wildcarded by truncating all or part of the This may be wildcarded by truncating all or part of the
instance portion, in which case the instance portion of the instance portion, in which case the instance portion of the
OID for obtaining this object will be the same as that used OID for obtaining this object will be the same as that used
in obtaining the mteTriggerObjectValueID that fired. in obtaining the mteTriggerValueID that fired. If such
If such wildcarding is applied, mteTriggerObjectIDWildcard wildcarding is applied, mteObjectsIDWildcard must be
must be 'true' and if not it must be 'false'." 'true' and if not it must be 'false'.
DEFVAL { 0 0 }
::= { mteTriggerObjectEntry 3 }
mteTriggerObjectValueIDWildcard OBJECT-TYPE Each instance that fills the wildcard is independent of any
additional instances, that is, wildcarded objects operate
as if there were a separate table entry for each instance
that fills the wildcard without having to actually predict
all possible instances ahead of time."
DEFVAL { zeroDotZero }
::= { mteObjectsEntry 3 }
mteObjectsIDWildcard OBJECT-TYPE
SYNTAX TruthValue SYNTAX TruthValue
MAX-ACCESS read-create MAX-ACCESS read-create
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"Control for whether mteTriggerObjectValueID is to be treated as "Control for whether mteObjectsID is to be treated as
fully-specified or wildcarded, with 'true' indicating wildcard. fully-specified or wildcarded, with 'true' indicating wildcard."
DEFVAL { false } DEFVAL { false }
::= { mteTriggerObjectEntry 4 } ::= { mteObjectsEntry 4 }
mteTriggerObjectStatus OBJECT-TYPE mteObjectsEntryStatus OBJECT-TYPE
SYNTAX RowStatus SYNTAX RowStatus
MAX-ACCESS read-create MAX-ACCESS read-create
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The control that allows creation and deletion of entries. "The control that allows creation and deletion of entries.
Once made active an entry may not be modified except to Once made active an entry may not be modified except to
delete it." delete it."
DEFVAL { createAndWait } ::= { mteObjectsEntry 5 }
::= { mteTriggerObjectEntry 5 }
-- --
-- Event Section -- Event Section
-- --
-- Counters -- Counters
mteEventFailures OBJECT-TYPE mteEventFailures OBJECT-TYPE
SYNTAX Counter32 SYNTAX Counter32
MAX-ACCESS read-only MAX-ACCESS read-only
skipping to change at page 18, line 40 skipping to change at page 32, line 26
DESCRIPTION DESCRIPTION
"A table of management event action information." "A table of management event action information."
::= { mteEvent 2 } ::= { mteEvent 2 }
mteEventEntry OBJECT-TYPE mteEventEntry OBJECT-TYPE
SYNTAX MteEventEntry SYNTAX MteEventEntry
MAX-ACCESS not-accessible MAX-ACCESS not-accessible
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"Information about a single event. Applications create and "Information about a single event. Applications create and
delete entries using mteEventStatus." delete entries using mteEventEntryStatus."
INDEX { IMPLIED mteEventName } INDEX { mteOwner, IMPLIED mteEventName }
::= { mteEventTable 1 } ::= { mteEventTable 1 }
MteEventEntry ::= SEQUENCE { MteEventEntry ::= SEQUENCE {
mteEventName SnmpAdminString, mteEventName SnmpAdminString,
mteEventComment DisplayString, mteEventComment SnmpAdminString,
mteEventActions BITS, mteEventActions BITS,
mteEventNotification OBJECT IDENTIFIER, mteEventEnabled TruthValue,
mteEventObjects SnmpAdminString, mteEventEntryStatus RowStatus
mteEventSetObject OBJECT IDENTIFIER,
mteEventSetObjectWildcard TruthValue,
mteEventSetValue Integer32,
mteEventSetTargetTag SnmpTagValue,
mteEventSetContextName SnmpAdminString,
mteEventSetContextNameWildcard TruthValue,
mteEventStatus RowStatus
} }
mteEventName OBJECT-TYPE mteEventName OBJECT-TYPE
SYNTAX SnmpAdminString (SIZE (1..64)) SYNTAX SnmpAdminString (SIZE (1..32))
MAX-ACCESS not-accessible MAX-ACCESS not-accessible
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"A locally-unique, administratively assigned name for the "A locally-unique, administratively assigned name for the
event." event."
::= { mteEventCreationEntry 1 } ::= { mteEventEntry 1 }
mteEventComment OBJECT-TYPE mteEventComment OBJECT-TYPE
SYNTAX DisplayString SYNTAX SnmpAdminString
MAX-ACCESS read-create MAX-ACCESS read-create
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"A description of the event's function and use." "A description of the event's function and use."
DEFVAL { ''H } DEFVAL { ''H }
::= { mteEventEntry 2 } ::= { mteEventEntry 2 }
mteEventActions OBJECT-TYPE mteEventActions OBJECT-TYPE
SYNTAX BITS { notification, set } SYNTAX BITS { notification(0), set(1) }
MAX-ACCESS read-create MAX-ACCESS read-create
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The actions to peform when this event occurs. "The actions to perform when this event occurs.
For 'notification', Traps and/or Informs are sent according For 'notification', Traps and/or Informs are sent according
to the configuration in the SNMP Notification MIB. to the configuration in the SNMP Notification MIB.
For 'set', an SNMP Set operation is performed according to For 'set', an SNMP Set operation is performed according to
control values in this entry." control values in this entry."
DEFVAL { 0 } DEFVAL { { 0 } }
::= { mteEventEntry 3 } ::= { mteEventEntry 3 }
mteEventEnabled OBJECT-TYPE
SYNTAX TruthValue
MAX-ACCESS read-create
STATUS current
DESCRIPTION
"A control to allow an event to be configured but not used.
When the value is 'false' the event does not execute even if
triggered."
DEFVAL { false }
::= { mteEventEntry 4 }
mteEventEntryStatus OBJECT-TYPE
SYNTAX RowStatus
MAX-ACCESS read-create
STATUS current
DESCRIPTION
"The control that allows creation and deletion of entries.
Once made active an entry may not be modified except to
delete it."
::= { mteEventEntry 5 }
--
-- Event Notification Table
--
mteEventNotificationTable OBJECT-TYPE
SYNTAX SEQUENCE OF MteEventNotificationEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"A table of management event action notification information."
::= { mteEvent 3 }
mteEventNotificationEntry OBJECT-TYPE
SYNTAX MteEventNotificationEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"Information about a single event's notification. Entries
automatically exist in this this table for each mteTriggerEntry
that has 'notification' set in mteEventAction."
INDEX { mteOwner, IMPLIED mteTriggerName }
::= { mteEventNotificationTable 1 }
MteEventNotificationEntry ::= SEQUENCE {
mteEventNotification OBJECT IDENTIFIER,
mteEventNotificationObjectsOwner SnmpAdminString,
mteEventNotificationObjects SnmpAdminString
}
mteEventNotification OBJECT-TYPE mteEventNotification OBJECT-TYPE
SYNTAX OBJECT IDENTIFIER SYNTAX OBJECT IDENTIFIER
MAX-ACCESS read-create MAX-ACCESS read-write
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The object identifier from the NOTIFICATION-TYPE for the "The object identifier from the NOTIFICATION-TYPE for the
notification to use if metEventActions has 'notification' set. notification to use if metEventActions has 'notification' set."
DEFVAL { zeroDotZero }
::= { mteEventNotificationEntry 1 }
If 'notification' is not set, this object is not instantiated." mteEventNotificationObjectsOwner OBJECT-TYPE
DEFVAL { 0 0 } SYNTAX SnmpAdminString (SIZE (0..32))
::= { mteEventEntry 4 } MAX-ACCESS read-write
STATUS current
DESCRIPTION
"To go with mteEventNotificationObjects, the mteOwner of a
group of objects from mteObjectsTable."
DEFVAL { ''H }
::= { mteEventNotificationEntry 2 }
mteEventObjects OBJECT-TYPE mteEventNotificationObjects OBJECT-TYPE
SYNTAX SnmpAdminString (SIZE (0..64)) SYNTAX SnmpAdminString (SIZE (0..32))
MAX-ACCESS read-create MAX-ACCESS read-write
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The mteTriggerObjectName of a group of objects from "The mteObjectsName of a group of objects from
mteTriggerObjectTable if mteEventActions has 'notification' set. mteObjectsTable if mteEventActions has 'notification' set.
These objects are to be added to any Notification generated by These objects are to be added to any Notification generated by
this event. this event.
If 'notification' is not set, this object is not instantiated. Objects may also be added based on the trigger that stimulated
the event.
A length of 0 indicates no additional objects." A length of 0 indicates no additional objects."
DEFVAL { ''H } DEFVAL { ''H }
::= { mteEventEntry 5 } ::= { mteEventNotificationEntry 3 }
--
-- Event Set Table
--
mteEventSetTable OBJECT-TYPE
SYNTAX SEQUENCE OF MteEventSetEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"A table of management event action information."
::= { mteEvent 4 }
mteEventSetEntry OBJECT-TYPE
SYNTAX MteEventSetEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"Information about a single event's set option. Entries
automatically exist in this this table for each mteTriggerEntry
that has 'set' set in mteEventAction."
INDEX { mteOwner, IMPLIED mteTriggerName }
::= { mteEventSetTable 1 }
MteEventSetEntry ::= SEQUENCE {
mteEventSetObject OBJECT IDENTIFIER,
mteEventSetObjectWildcard TruthValue,
mteEventSetValue Integer32,
mteEventSetTargetTag SnmpTagValue,
mteEventSetContextName SnmpAdminString,
mteEventSetContextNameWildcard TruthValue
}
mteEventSetObject OBJECT-TYPE mteEventSetObject OBJECT-TYPE
SYNTAX OBJECT IDENTIFIER SYNTAX OBJECT IDENTIFIER
MAX-ACCESS read-create MAX-ACCESS read-write
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The object identifier from the MIB object to set if "The object identifier from the MIB object to set if
mteEventActions has 'set' set. mteEventActions has 'set' set.
This object identifier may be wildcarded by leaving This object identifier may be wildcarded by leaving
sub-identifiers off the end, in which case sub-identifiers off the end, in which case
nteEventSetObjectWildCard must be 'true'. nteEventSetObjectWildCard must be 'true'.
If mteEventSetObject is wildcarded the instance used to set it If mteEventSetObject is wildcarded the instance used to set the
is the same as the instance for the value of mteTriggerValueID object to which it points is the same as the instance from the
that triggered the event." value of mteTriggerValueID that triggered the event.
If 'set' is not set, this object is not instantiated." Each instance that fills the wildcard is independent of any
DEFVAL { 0 0 } additional instances, that is, wildcarded objects operate
::= { mteEventEntry 6 } as if there were a separate table entry for each instance
that fills the wildcard without having to actually predict
all possible instances ahead of time.
Bad object identifiers or a mismatch between truncating the
identifier and the value of mteSetObjectWildcard
result in operation as one would expect when providing the
wrong identifier to a Set operation. The Set will fail or set
the wrong object. If the value syntax of the destination
object is not correct, the Set fails with the normal SNMP
error code."
DEFVAL { zeroDotZero }
::= { mteEventSetEntry 1 }
mteEventSetObjectWildcard OBJECT-TYPE mteEventSetObjectWildcard OBJECT-TYPE
SYNTAX TruthValue SYNTAX TruthValue
MAX-ACCESS read-create MAX-ACCESS read-write
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"Control over whether mteEventSetObject is to be treated as "Control over whether mteEventSetObject is to be treated as
fully-specified or wildcarded, with 'true' indicating wildcard fully-specified or wildcarded, with 'true' indicating wildcard
if mteEventActions has 'set' set. if mteEventActions has 'set' set."
If 'set' is not set, this object is not instantiated."
DEFVAL { false } DEFVAL { false }
::= { mteEventEntry 7 } ::= { mteEventSetEntry 2 }
mteEventSetValue OBJECT-TYPE mteEventSetValue OBJECT-TYPE
SYNTAX Integer32 SYNTAX Integer32
MAX-ACCESS read-create MAX-ACCESS read-write
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The value to which to set the object at mteEventSetObject "The value to which to set the object at mteEventSetObject
if mteEventActions has 'set' set. if mteEventActions has 'set' set."
If 'set' is not set, this object is not instantiated."
DEFVAL { 0 } DEFVAL { 0 }
::= { mteEventEntry 8 } ::= { mteEventSetEntry 3 }
mteEventSetTargetTag OBJECT-TYPE mteEventSetTargetTag OBJECT-TYPE
SYNTAX SnmpTagValue SYNTAX SnmpTagValue
MAX-ACCESS read-create MAX-ACCESS read-write
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The tag for the target(s) at which to set the object at "The tag for the target(s) at which to set the object at
mteEventSetObject to mteEventSetValue if mteEventActions mteEventSetObject to mteEventSetValue if mteEventActions
has 'set' set. has 'set' set.
If 'set' is not set, this object is not instantiated."
Systems limited to self management may not accept a non-zero Systems limited to self management may not accept a non-zero
length for the value of this object. length for the value of this object.
A length of 0 indicates the local system. In this case, A length of 0 indicates the local system. In this case,
access to the objects indicated by mteEventObjectID is under access to the objects indicated by mteEventSetObject is under
the security credentials of the requester that set the security credentials of the requester that set
mteEventStatus to 'active'." mteTriggerEntryStatus to 'active'. Those credentials are the
input parameters for isAccessAllowed from the Architecture for
Describing SNMP Management Frameworks.
Otherwise access rights are checked according to the security
parameters resulting from the tag."
DEFVAL { ''H } DEFVAL { ''H }
::= { mteEventEntry 9 } ::= { mteEventSetEntry 4 }
mteEventSetContextName OBJECT-TYPE mteEventSetContextName OBJECT-TYPE
SYNTAX SnmpAdminString SYNTAX SnmpAdminString
MAX-ACCESS read-create MAX-ACCESS read-write
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The management context in which to set mteEventObjectID. "The management context in which to set mteEventObjectID.
if mteEventActions has 'set' set. if mteEventActions has 'set' set.
If 'set' is not set, this object is not instantiated."
This may be wildcarded by leaving characters off the end. To This may be wildcarded by leaving characters off the end. To
indicate such wildcarding mteEventSetContextNameWildcard must indicate such wildcarding mteEventSetContextNameWildcard must
be 'true'. be 'true'.
If this context name is wildcarded the value used to complete If this context name is wildcarded the value used to complete
the wildcarding of mteTriggerContextName will be appended." the wildcarding of mteTriggerContextName will be appended."
DEFVAL { ''H } DEFVAL { ''H }
::= { mteEventEntry 10 } ::= { mteEventSetEntry 5 }
mteEventSetContextNameWildcard OBJECT-TYPE mteEventSetContextNameWildcard OBJECT-TYPE
SYNTAX TruthValue SYNTAX TruthValue
MAX-ACCESS read-create MAX-ACCESS read-write
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"Control for whether mteEventSetContextName is to be treated as "Control for whether mteEventSetContextName is to be treated as
fully-specified or wildcarded, with 'true' indicating wildcard fully-specified or wildcarded, with 'true' indicating wildcard
if mteEventActions has 'set' set. if mteEventActions has 'set' set."
If 'set' is not set, this object is not instantiated."
DEFVAL { false } DEFVAL { false }
::= { mteTriggerEntry 10 } ::= { mteEventSetEntry 6 }
mteEventStatus OBJECT-TYPE
SYNTAX RowStatus
MAX-ACCESS read-create
STATUS current
DESCRIPTION
"The control that allows creation and deletion of entries.
Once made active an entry may not be modified except to
delete it."
DEFVAL { createAndWait }
::= { mteEventEntry 12 }
-- --
-- Notifications -- Notifications
-- --
eventMIBNotificationPrefix OBJECT IDENTIFIER ::= { eventMIB 2 } dismanEventMIBNotificationPrefix OBJECT IDENTIFIER ::= { dismanEventMIB 2 }
eventMIBNotifications OBJECT IDENTIFIER ::= dismanEventMIBNotifications OBJECT IDENTIFIER ::=
{ eventMIBNotificationPrefix 0 } { dismanEventMIBNotificationPrefix 0 }
eventMIBNotificationObjectss OBJECT IDENTIFIER dismanEventMIBNotificationObjects OBJECT IDENTIFIER
::= { eventMIBNotificationPrefix 1 } ::= { dismanEventMIBNotificationPrefix 1 }
-- --
-- Notification Objects -- Notification Objects
-- --
mteHotTrigger OBJECT-TYPE mteHotTrigger OBJECT-TYPE
SYNTAX SnmpAdminString SYNTAX SnmpAdminString
MAX-ACCESS accessible-for-notify MAX-ACCESS accessible-for-notify
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The name of the trigger causing the notification. "The name of the trigger causing the notification."
::= { mteTrigger 1 } ::= { dismanEventMIBNotificationObjects 1 }
mteHotTargetName OBJECT-TYPE mteHotTargetName OBJECT-TYPE
SYNTAX SnmpAdminString SYNTAX SnmpAdminString
MAX-ACCESS accessible-for-notify MAX-ACCESS accessible-for-notify
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The SNMP Target MIB's snmpTargetAddrName related to the "The SNMP Target MIB's snmpTargetAddrName related to the
notification. notification."
::= { mteTrigger 2 } ::= { dismanEventMIBNotificationObjects 2 }
mteHotContextName OBJECT-TYPE mteHotContextName OBJECT-TYPE
SYNTAX SnmpAdminString SYNTAX SnmpAdminString
MAX-ACCESS accessible-for-notify MAX-ACCESS accessible-for-notify
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The context name related to the notification. This must be as "The context name related to the notification. This must be as
fully-qualified as possible, including filling in wildcard fully-qualified as possible, including filling in wildcard
informaation determined in processing." information determined in processing."
::= { mteTrigger 3 } ::= { dismanEventMIBNotificationObjects 3 }
mteHotOID OBJECT-TYPE mteHotOID OBJECT-TYPE
SYNTAX OBJECT IDENTIFIER SYNTAX OBJECT IDENTIFIER
MAX-ACCESS accessible-for-notify MAX-ACCESS accessible-for-notify
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The object identifier of the destination object related to the "The object identifier of the destination object related to the
notification. This must be as fully-qualified as possible, notification. This must be as fully-qualified as possible,
inluding filling in wildcard informaation determined in inluding filling in wildcard informaation determined in
processing. processing.
For a trigger-related notification this is from For a trigger-related notification this is from
mteTriggerValueID. mteTriggerValueID.
For a set failure this is from mteEventSetObject." For a set failure this is from mteEventSetObject."
::= { mteTrigger 3 } ::= { dismanEventMIBNotificationObjects 4 }
mterHotValue OBJECT-TYPE mteHotValue OBJECT-TYPE
SYNTAX Integer32 SYNTAX Integer32
MAX-ACCESS accessible-for-notify MAX-ACCESS accessible-for-notify
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The value of the object at mteTriggerValueID when a "The value of the object at mteTriggerValueID when a
trigger fired." trigger fired."
::= { mteTrigger 5 } ::= { dismanEventMIBNotificationObjects 5 }
mteFailedReason OBJECT-TYPE mteFailedReason OBJECT-TYPE
SYNTAX FailureReason SYNTAX FailureReason
MAX-ACCESS accessible-for-notify MAX-ACCESS accessible-for-notify
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The reason for the failure of an attempt to check for a "The reason for the failure of an attempt to check for a
trigger condition or set an object in response to an event. trigger condition or set an object in response to an event."
::= { mteTrigger 6 } ::= { dismanEventMIBNotificationObjects 6 }
-- --
-- Notifications -- Notifications
-- --
mteTriggerSenseAlarm NOTIFICATION-TYPE mteTriggerFired NOTIFICATION-TYPE
OBJECTS { mteHotTrigger, OBJECTS { mteHotTrigger,
mteHotTargetName, mteHotTargetName,
mteHotContextName, mteHotContextName,
mteHotOID, mteHotOID,
mteHotValue } mteHotValue }
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"Notification that the trigger indicated by the object "Notification that the trigger indicated by the object
instances has fired, for triggers with mteTriggerType instances has fired, for triggers with mteTriggerType
'boolean'." 'boolean'."
::= { eventMIBNotifications 1 } ::= { dismanEventMIBNotifications 1 }
mteTriggerRisingAlarm NOTIFICATION-TYPE mteTriggerRising NOTIFICATION-TYPE
OBJECTS { mteHotTrigger, OBJECTS { mteHotTrigger,
mteHotTargetName, mteHotTargetName,
mteHotContextName, mteHotContextName,
mteHotOID, mteHotOID,
mteHotValue } mteHotValue }
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"Notification that the rising threshold was met for triggers "Notification that the rising threshold was met for triggers
with mteTriggerType 'threshold'." with mteTriggerType 'threshold'."
::= { eventMIBNotifications 2 } ::= { dismanEventMIBNotifications 2 }
mteTriggerFallingAlarm NOTIFICATION-TYPE mteTriggerFalling NOTIFICATION-TYPE
OBJECTS { mteHotTrigger, OBJECTS { mteHotTrigger,
mteHotTargetName, mteHotTargetName,
mteHotContextName, mteHotContextName,
mteHotOID, mteHotOID,
mteHotValue } mteHotValue }
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"Notification that the falling threshold was met for triggers "Notification that the falling threshold was met for triggers
with mteTriggerType 'threshold'." with mteTriggerType 'threshold'."
::= { eventMIBNotifications 3 } ::= { dismanEventMIBNotifications 3 }
mteTriggerFailureAlarm NOTIFICATION-TYPE mteTriggerFailure NOTIFICATION-TYPE
OBJECTS { mteHotTrigger, OBJECTS { mteHotTrigger,
mteHotTargetName, mteHotTargetName,
mteHotContextName, mteHotContextName,
mteHotOID, mteHotOID,
mteFailedReason } mteFailedReason }
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"Notification that an attempt to check a trigger has failed. "Notification that an attempt to check a trigger has failed.
The network manager must enable this notification only with The network manager must enable this notification only with
a certain fear and trembling, as it can easily crowd out more a certain fear and trembling, as it can easily crowd out more
important information. It should be used only to help diagnose important information. It should be used only to help diagnose
a problem that has appeared in the error counters and can not a problem that has appeared in the error counters and can not
be found otherwise." be found otherwise."
::= { eventMIBNotifications 4 } ::= { dismanEventMIBNotifications 4 }
mteEventSetFailureAlarm NOTIFICATION-TYPE mteEventSetFailure NOTIFICATION-TYPE
OBJECTS { mteHotTrigger, OBJECTS { mteHotTrigger,
mteHotTargetName, mteHotTargetName,
mteHotContextName, mteHotContextName,
mteHotOID, mteHotOID,
mteFailedReason } mteFailedReason }
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"Notification that an attempt to do a set in response to an "Notification that an attempt to do a set in response to an
event has failed. event has failed.
The network manager must enable this notification only with The network manager must enable this notification only with
a certain fear and trembling, as it can easily crowd out more a certain fear and trembling, as it can easily crowd out more
important information. It should be used only to help diagnose important information. It should be used only to help diagnose
a problem that has appeared in the error counters and can not a problem that has appeared in the error counters and can not
be found otherwise." be found otherwise."
::= { eventMIBNotifications 5 } ::= { dismanEventMIBNotifications 5 }
-- --
-- Conformance -- Conformance
-- --
eventMIBConformance OBJECT IDENTIFIER ::= { eventMIB 3 } dismanEventMIBConformance OBJECT IDENTIFIER ::= { dismanEventMIB 3 }
eventMIBCompliances OBJECT IDENTIFIER ::= { eventMIBConformance 1 } dismanEventMIBCompliances OBJECT IDENTIFIER ::= { dismanEventMIBConformance 1 }
eventMIBGroups OBJECT IDENTIFIER ::= { eventMIBConformance 2 } dismanEventMIBGroups OBJECT IDENTIFIER ::= { dismanEventMIBConformance 2 }
-- Compliance -- Compliance
eventMIBCompliance MODULE-COMPLIANCE dismanEventMIBCompliance MODULE-COMPLIANCE
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The compliance statement for entities which implement "The compliance statement for entities which implement
the Event MIB." the Event MIB."
MODULE -- this module MODULE -- this module
MANDATORY-GROUPS { MANDATORY-GROUPS {
eventTriggerGroup, dismanEventResourceGroup,
eventEventGroup, dismanEventTriggerGroup,
eventNotificationObjectGroup, dismanEventObjectsGroup,
eventNotificationGroup dismanEventEventGroup,
dismanEventNotificationObjectGroup,
dismanEventNotificationGroup
} }
OBJECT mteTriggerTargetTag OBJECT mteTriggerTargetTag
MIN-ACCESS read-only MIN-ACCESS read-only
DESCRIPTION DESCRIPTION
"Write access is not required, thus limiting "Write access is not required, thus limiting
monitoring to the local system or preconfigured monitoring to the local system or preconfigured
remote systems."" remote systems."
OBJECT mteEventSetTargetTag OBJECT mteEventSetTargetTag
MIN-ACCESS read-only MIN-ACCESS read-only
DESCRIPTION DESCRIPTION
"Write access is not required, thus limiting "Write access is not required, thus limiting
setting to the local system or preconfigured setting to the local system or preconfigured
remote systems."" remote systems."
OBJECT mteTriggerValueIDWildcard OBJECT mteTriggerValueIDWildcard
MIN-ACCESS read-only MIN-ACCESS read-only
DESCRIPTION DESCRIPTION
"Write access is not required, thus allowing "Write access is not required, thus allowing
the system not to implement wildcarding." the system not to implement wildcarding."
OBJECT mteTriggerContextNameWildcard OBJECT mteTriggerContextNameWildcard
MIN-ACCESS read-only MIN-ACCESS read-only
DESCRIPTION DESCRIPTION
"Write access is not required, thus allowing "Write access is not required, thus allowing
the system not to implement wildcarding." the system not to implement wildcarding."
OBJECT mteTriggerObjectValueIDWildcard OBJECT mteObjectsIDWildcard
MIN-ACCESS read-only MIN-ACCESS read-only
DESCRIPTION DESCRIPTION
"Write access is not required, thus allowing "Write access is not required, thus allowing
the system not to implement wildcarding." the system not to implement wildcarding."
OBJECT mteEventSetContextNameWildcard OBJECT mteEventSetContextNameWildcard
MIN-ACCESS read-only MIN-ACCESS read-only
DESCRIPTION DESCRIPTION
"Write access is not required, thus allowing "Write access is not required, thus allowing
the system not to implement wildcarding." the system not to implement wildcarding."
::= { eventMIBCompliances 1 } ::= { dismanEventMIBCompliances 1 }
-- Units of Conformance -- Units of Conformance
eventTriggerGroup OBJECT-GROUP dismanEventResourceGroup OBJECT-GROUP
OBJECTS {
mteResourceSampleMinimum,
mteResourceSampleInstanceMaximum,
mteResourceSampleInstances,
mteResourceSampleInstancesHigh,
mteResourceSampleInstanceLacks
}
STATUS current
DESCRIPTION
"Event resource status and control objects."
::= { dismanEventMIBGroups 1 }
dismanEventTriggerGroup OBJECT-GROUP
OBJECTS { OBJECTS {
mteTriggerFailures, mteTriggerFailures,
mteTriggerComment, mteTriggerComment,
mteTriggerTest, mteTriggerTest,
mteTriggerSampleType,
mteTriggerValueID, mteTriggerValueID,
mteTriggerValueIDWildcard, mteTriggerValueIDWildcard,
mteTriggerTargetTag, mteTriggerTargetTag,
mteTriggerContextName, mteTriggerContextName,
mteTriggerContextNameWildcard, mteTriggerContextNameWildcard,
mteTriggerFrequency, mteTriggerFrequency,
mteTriggerObjectsOwner,
mteTriggerObjects,
mteTriggerEnabled,
mteTriggerEntryStatus,
mteTriggerDeltaDiscontinuityID,
mteTriggerDeltaDiscontinuityIDWildcard,
mteTriggerDeltaDiscontinuityIDType,
mteTriggerExistenceTest,
mteTriggerExistenceStartup,
mteTriggerExistenceObjectsOwner,
mteTriggerExistenceObjects,
mteTriggerExistenceEventOwner,
mteTriggerExistenceEvent,
mteTriggerBooleanComparison,
mteTriggerBooleanValue,
mteTriggerBooleanStartup, mteTriggerBooleanStartup,
mteTriggerBooleanObjectsOwner,
mteTriggerBooleanObjects,
mteTriggerBooleanEventOwner,
mteTriggerBooleanEvent,
mteTriggerThresholdValue,
mteTriggerThresholdStartup, mteTriggerThresholdStartup,
mteTriggerRisingThreshold, mteTriggerThresholdObjectsOwner,
mteTriggerFallingThreshold, mteTriggerThresholdObjects,
mteTriggerEvent, mteTriggerThresholdRising,
mteTriggerRisingEvent, mteTriggerThresholdFalling,
mteTriggerFallingEvent, mteTriggerThresholdRisingEventOwner,
mteTriggerObjects, mteTriggerThresholdRisingEvent,
mteTriggerStatus, mteTriggerThresholdFallingEventOwner,
mteTriggerThresholdFallingEvent
}
STATUS current
DESCRIPTION
"Event triggers."
::= { dismanEventMIBGroups 2 }
mteTriggerObjectID, dismanEventObjectsGroup OBJECT-GROUP
mteTriggerObjectIDWildcard, OBJECTS {
mteTriggerObjectStatus mteObjectsID,
mteObjectsIDWildcard,
mteObjectsEntryStatus
} }
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"Event triggers and supplemental objects." "Supplemental objects."
::= { eventMIBGroups 1 } ::= { dismanEventMIBGroups 3 }
eventEventGroup OBJECT-GROUP dismanEventEventGroup OBJECT-GROUP
OBJECTS { OBJECTS {
mteEventFailures,
mteEventComment, mteEventComment,
mteEventActions, mteEventActions,
mteEventEnabled,
mteEventEntryStatus,
mteEventNotification, mteEventNotification,
mteEventObjects, mteEventNotificationObjectsOwner,
mteEventNotificationObjects,
mteEventSetObject, mteEventSetObject,
mteEventSetObjectWildcard, mteEventSetObjectWildcard,
mteEventSetValue, mteEventSetValue,
mteEventSetTargetTag, mteEventSetTargetTag,
mteEventSetContextName, mteEventSetContextName,
mteEventSetContextNameWildcard, mteEventSetContextNameWildcard
mteEventStatus
} }
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"Events." "Events."
::= { eventMIBGroups 2 } ::= { dismanEventMIBGroups 4 }
eventNotificationObjectGroup OBJECT-GROUP dismanEventNotificationObjectGroup OBJECT-GROUP
OBJECTS { OBJECTS {
mteHotTrigger, mteHotTrigger,
mteHotTargetName, mteHotTargetName,
mteHotContextName, mteHotContextName,
mteHotOID, mteHotOID,
mterHotValue, mteHotValue,
mteFailedReason mteFailedReason
} }
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"Notification objects." "Notification objects."
::= { eventMIBGroups 3 } ::= { dismanEventMIBGroups 5 }
eventNotificationGroup OBJECT-GROUP dismanEventNotificationGroup NOTIFICATION-GROUP
OBJECTS { OBJECTS {
mteTriggerSenseAlarm, mteTriggerFired,
mteTriggerRisingAlarm, mteTriggerRising,
mteTriggerFallingAlarm, mteTriggerFalling,
mteTriggerFailureAlarm, mteTriggerFailure,
mteEventSetFailureAlarm mteEventSetFailure
} }
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"Notifications." "Notifications."
::= { eventMIBGroups 4 } ::= { dismanEventMIBGroups 6 }
END END
9. Intellectual Property 9. Intellectual Property
The IETF takes no position regarding the validity or scope of any The IETF takes no position regarding the validity or scope of any
intellectual property or other rights that might be claimed to pertain intellectual property or other rights that might be claimed to pertain
to the implementation or use of the technology described in this to the implementation or use of the technology described in this
document or the extent to which any license under such rights might or document or the extent to which any license under such rights might or
might not be available; neither does it represent that it has made any might not be available; neither does it represent that it has made any
skipping to change at page 31, line 9 skipping to change at page 48, line 9
rights made available for publication and any assurances of licenses to rights made available for publication and any assurances of licenses to
be made available, or the result of an attempt made to obtain a general be made available, or the result of an attempt made to obtain a general
license or permission for the use of such proprietary rights by license or permission for the use of such proprietary rights by
implementors or users of this specification can be obtained from the implementors or users of this specification can be obtained from the
IETF Secretariat. IETF Secretariat.
10. Acknowledgements 10. Acknowledgements
This MIB contains considerable contributions from the RMON MIB, the This MIB contains considerable contributions from the RMON MIB, the
Distributed Management Design Team (Andy Bierman, Maria Greene, Bob Distributed Management Design Team (Andy Bierman, Maria Greene, Bob
Stewart, and Steve Waldbusser), and colleagues at Cisco. Stewart, and Steve Waldbusser), the Distributed Management Working
Group, and colleagues at Cisco.
11. References 11. References
[1] Harrington, D., Presuhn, R. and B. Wijnen, "An Architecture for [1] Harrington, D., Presuhn, R. and B. Wijnen, "An Architecture for
Describing SNMP Management Frameworks", RFC 2271, Cabletron Describing SNMP Management Frameworks", RFC 2271, Cabletron
Systems, Inc., BMC Software, Inc., IBM T. J. Watson Research, Systems, Inc., BMC Software, Inc., IBM T. J. Watson Research,
January 1998. January 1998.
[2] Rose, M. and K. McCloghrie, "Structure and Identification of [2] Rose, M. and K. McCloghrie, "Structure and Identification of
Management Information for TCP/IP-based Internets", RFC 1155, Management Information for TCP/IP-based Internets", RFC 1155,
skipping to change at page 35, line 7 skipping to change at page 52, line 7
Cisco Systems, Inc. Cisco Systems, Inc.
170 West Tasman Drive 170 West Tasman Drive
San Jose, CA 95134-1706 San Jose, CA 95134-1706
U.S.A. U.S.A.
Phone: +1 408 526 4527 Phone: +1 408 526 4527
Email: bstewart@cisco.com Email: bstewart@cisco.com
14. Full Copyright Statement 14. Full Copyright Statement
Copyright (C) The Internet Society (1998). All Rights Reserved. Copyright (C) The Internet Society (1999). All Rights Reserved.
This document and translations of it may be copied and furnished to This document and translations of it may be copied and furnished to
others, and derivative works that comment on or otherwise explain it or others, and derivative works that comment on or otherwise explain it or
assist in its implementation may be prepared, copied, published and assist in its implementation may be prepared, copied, published and
distributed, in whole or in part, without restriction of any kind, distributed, in whole or in part, without restriction of any kind,
provided that the above copyright notice and this paragraph are included provided that the above copyright notice and this paragraph are included
on all such copies and derivative works. However, this document itself on all such copies and derivative works. However, this document itself
may not be modified in any way, such as by removing the copyright notice may not be modified in any way, such as by removing the copyright notice
or references to the Internet Society or other Internet organizations, or references to the Internet Society or other Internet organizations,
except as needed for the purpose of developing Internet standards in except as needed for the purpose of developing Internet standards in
skipping to change at page 36, line 13 skipping to change at page 53, line 13
FITNESS FOR A PARTICULAR PURPOSE. FITNESS FOR A PARTICULAR PURPOSE.
Table of Contents Table of Contents
1 Abstract ........................................................ 2 1 Abstract ........................................................ 2
2 The SNMP Management Framework ................................... 2 2 The SNMP Management Framework ................................... 2
3 Overview ........................................................ 4 3 Overview ........................................................ 4
4 Relationship to Other MIBs ...................................... 4 4 Relationship to Other MIBs ...................................... 4
5 MIB Sections .................................................... 4 5 MIB Sections .................................................... 4
6 Operation ....................................................... 5 6 Operation ....................................................... 5
7 Security ........................................................ 5 7 Security ........................................................ 6
8 Definitions ..................................................... 7 8 Definitions ..................................................... 7
9 Intellectual Property ........................................... 30 9 Intellectual Property ........................................... 47
10 Acknowledgements ............................................... 31 10 Acknowledgements ............................................... 48
11 References ..................................................... 32 11 References ..................................................... 49
12 Security Considerations ........................................ 34 12 Security Considerations ........................................ 51
13 Author's Address ............................................... 34 13 Author's Address ............................................... 51
14 Full Copyright Statement ....................................... 35 14 Full Copyright Statement ....................................... 52
 End of changes. 

This html diff was produced by rfcdiff 1.23, available from http://www.levkowetz.com/ietf/tools/rfcdiff/