-- extracted from draft-stephan-ippm-mib-00.txt -- at Sat Jul 14 06:05:22 2001 IPPM-MIB DEFINITIONS ::= BEGIN IMPORTS MODULE-IDENTITY, NOTIFICATION-TYPE, OBJECT-TYPE, Integer32, Counter32 FROM SNMPv2-SMI OwnerString FROM RMON-MIB protocolDir FROM RMON2-MIB DisplayString, TimeStamp, DateAndTime, TruthValue, RowStatus, TEXTUAL-CONVENTION FROM SNMPv2-TC MODULE-COMPLIANCE, OBJECT-GROUP, NOTIFICATION-GROUP FROM SNMPv2-CONF; ippmMib MODULE-IDENTITY LAST-UPDATED "200107101500Z" -- July 10, 2001 ORGANIZATION "France Telecom - R&D" CONTACT-INFO "Postal : Emile Stephan France Telecom - R&D, Dpt. CPN 2, Avenue Pierre Marzin Technopole Anticipa 22307 Lannion Cedex FRANCE Tel: + 33 2 96 05 36 10 E-mail: emile.stephan@francetelecom.com" DESCRIPTION "This memo defines a portion of the Management Information Base (MIB) for use with network management protocols in TCP/IP-based internets. In particular, it defines objects for managing measures using the IP performance metrics specified by the IPPM Working Group." ::= { experimental 10000 } -- to be assigned, set to 10000 to be syntically correct. OwnerString ::= TEXTUAL-CONVENTION STATUS current DESCRIPTION "(re)defines OwnerString using V2 convention." SYNTAX DisplayString -- -- -- A absolute, GMT timer using UTC like convention. -- -- GMTDateAndTime ::= TEXTUAL-CONVENTION DISPLAY-HINT "1d-1d-1d,1d:1d:1d,2d" STATUS current DESCRIPTION "A date-time specification. field octets contents range ----- ------ -------- ----- 1 1 year* 0..256 2 2 month 1..12 3 3 day 1..31 4 4 hour 0..23 5 5 minutes 0..59 6 6 seconds 0..59 7 7-8 1/10 milliseconds 0..9999 *Notes: 0 stands for year 2000. For example, "0102192015100500" represent 8:15pm, 10 seconds and 50 ms GMT on 19 February 2001 and is displayed as 01-02-19,20:15:10,0500" SYNTAX OCTET STRING (SIZE (8)) GmtTimeFilter ::= TEXTUAL-CONVENTION STATUS current DESCRIPTION "GmtTimeFilter TC is inspired by the TimeFilter defined in the RMON2. The reference of the time of TimeFilter is the local value of sysUptime while GmtTimeFilter uses a absolute reference of time. GmtTimeFilter is intended to be used for the index of a table. It allows an application to download only those rows changed since a particular time. A row is considered changed if the value of any object in the row changes or if the row is created or deleted. Each new conceptual row will be associated with the timeMark instance which was created at the value of ippmTimeSysTimer. It is intended to provide an absolute timestamp index for the result of measures. Typically to each singleton produced by an IPPM measure is associated the timemark corresponding to the moment of the measure. illustrations: Consider the 2 tables measureTable and resultTable measureTable OBJECT-TYPE SYNTAX SEQUENCE OF MeasureEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "" ::= { fooMib 1 } INDEX { measureIndex } resultTable OBJECT-TYPE SYNTAX SEQUENCE OF ResultEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "" ::= { fooMib 2 } INDEX { measureIndex, resultTimeMark } ResultEntry { resultTimeMark TimeFilter, resultCounts Counter } Should there be two measure rows in the measure table (measureIndex == 1, measureIndex == 2) which produced results asynchronously (e.g. made at Poisson intervals or sibling) and log them in the result table. Measure 1 produced the result 34 at time 0102192015100500 GMT, while row 2 produced the value 54 most recently (10ms later) at time 0102192015100600 GMT, and both rows are updated on several later occasions such that the current values are 37 and 53 respectively. Then the following resultCounts instances would exist. resultCounts.1.0102192015100500 34 resultCounts.2.0102192015100600 54 resultCounts.1.0102192015100950 65 resultCounts.1.0102192015100600 57 resultCounts.2.0102192015100800 48 resultCounts.2.0102192015100850 53 resultCounts.1.0102192015110050 49 resultCounts.1.0102192015110200 37 The following get-bulk explains how a NMS retrieves the results of the measures. get-bulk(nonRptrs=1, maxReps=10, resultCounts.1); returns: resultCounts.1.0102192015100500 == 34 resultCounts.1.0102192015100950 == 65 resultCounts.1.0102192015100600 == 57 resultCounts.1.0102192015110050 == 49 resultCounts.1.0102192015110200 == 37 # return lexigraphically-next two MIB instances get-bulk(nonRptrs=0, maxReps=2, resultCounts.1.0102192015100600, resultCounts.2.0102192015100600); returns: resultCounts.1.0102192015100950 == 65 resultCounts.2.0102192015100800 == 48 resultCounts.1.0102192015100600 == 57 resultCounts.2.0102192015100850 == 53 get-bulk(nonRptrs=0, maxReps=2, resultCounts.1.0102192015110200, resultCounts.2.0102192015110200); returns: return lexigraphically-next two MIB instances no 'resultTable' counter values at all are returned because neither counter has been updated since time 0102192015110200" SYNTAX GMTDateAndTime TypeP ::= TEXTUAL-CONVENTION DISPLAY-HINT "1d." STATUS current DESCRIPTION "This textual convention is used to describe the protocols encapsulation list of a packet, and is used as the value of the SYNTAX clause for the type of the Src and Dst of a IPPM measure. The RFC2895 specifies a macro for the definition of protocols identifiers while its companion document, the RFC2896 defines a set of protocols identifiers. Notes: An IPPM TypeP does not differ from RMON2 Protocols identifiers but TypeP usage in IPPM MIB differs from Protocol identifier usage in RMON2. A IPPM measure is active so generally TypeP does not describe the link layer (i.e. ether2...). Valid Internet packets are sent from Src to Dst. Then the choice of the link layer relies on the Internet stack. For example, the RFC2896 defines the protocol identifier '16.0.0.0.1.0.0.8.0.0.0.0.6.0.0.0.23.3.0.0.0' which represents ether2.ip.tcp.telnet and the protocol identifier 16.0.0.0.1.0.0.8.0.0.0.0.4.0.0.0.17.3.0.0.0 which stands for ether2.ip.ipip4.udp. The corresponding TypeP are '12.0.0.8.0.0.0.0.6.0.0.0.23.3.0.0.0' (ip.tcp.telnet) and 12.0.0.8.0.0.0.0.4.0.0.0.17.3.0.0.0 (ip.ipip4.udp)." SYNTAX OCTET STRING -- IPPM Mib objects definitions ippmCompliances OBJECT IDENTIFIER ::= { ippmMib 1 } ippmOwnerGroup OBJECT IDENTIFIER ::= { ippmMib 2 } ippmSystemGroup OBJECT IDENTIFIER ::= { ippmMib 3 } ippmMeasureGroup OBJECT IDENTIFIER ::= { ippmMib 4 } ippmSamplerGroup OBJECT IDENTIFIER ::= { ippmMib 5 } ippmStatisticGroup OBJECT IDENTIFIER ::= { ippmMib 6 } -- -- ippmOwnerGroup -- -- The ippmOwnerAndIndexControlGroup grants block of private indexes to the NMS applications. -- -- ippmOwnerAndIndexControlTable OBJECT-TYPE SYNTAX SEQUENCE OF IppmOwnerEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "A NMS entity wishing to create and activate remote Ippm measurements in an agent must previously be registered in the ippmOwnerAndIndexControlTable using the conceptual row mechanism described in the RMON2. Notes: The control of the access to the IPPM MIB is outside the scope of this table. As that point is crucial objects will be added in a further release to provide the NMS with the capability to grant other entities to use their ressources.An object to manage the metrics granted per owner will be added too." ::= { ippmOwnerGroup 1 } ippmOwnerAndIndexControlEntry OBJECT-TYPE SYNTAX IppmOwnerAndIndexControlEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "The description of the resources the agent granted to a SNMP application. An application may be granted with multiple ranges. Entries can be only created and deleted. Deleting the control entry causes the deletion of any associated data entries. There is no relation between an owner range of indexes and the resources reserved for this owner. For example, an instance of ippmOwnerAndIndexControlEntryOwner with a ownerString 'acme', which represents the 14th owner created in ippmOwnerAndIndexControlTable would be named ippmOwnerAndIndexControlEntryOwner.14. Notes: The OwnerAndIndexControlIndex value is a local index managed directly by the agent. It is not used in anyway in the other IPPM tables. { discussion: administrative information fields should be added for each owner such as IP address, management station name, network manager's name, location, email, or phone number.}" INDEX { ippmOwnerAndIndexControlIndex } ::= { ippmOwnerAndIndexControlTable 1 } IppmOwnerAndIndexControlEntry ::= SEQUENCE { ippmOwnerAndIndexControlIndex INTEGER, ippmOwnerAndIndexControlRangeBegin INTEGER, ippmOwnerAndIndexControlRangeEnd INTEGER, ippmOwnerAndIndexControlStatus RowStatus, ippmOwnerAndIndexControlEntryOwner OwnerString } ippmOwnerAndIndexControlIndex OBJECT-TYPE SYNTAX INTEGER MAX-ACCESS read-create STATUS current DESCRIPTION "The index of the entry." ::= { ippmOwnerAndIndexControlEntry 1 } ippmOwnerAndIndexControlRangeBegin OBJECT-TYPE SYNTAX INTEGER MAX-ACCESS read-create STATUS current DEFVAL { 500 } DESCRIPTION "The first index of the range." ::= { ippmOwnerAndIndexControlEntry 2 } ippmOwnerAndIndexControlRangeEnd OBJECT-TYPE SYNTAX INTEGER MAX-ACCESS read-create STATUS current DEFVAL { 2500 } DESCRIPTION "The last index of the range." ::= { ippmOwnerAndIndexControlEntry 3 } ippmOwnerAndIndexControlStatus OBJECT-TYPE SYNTAX RowStatus MAX-ACCESS read-create STATUS current DESCRIPTION "The status of this table entry." ::= { ippmOwnerAndIndexControlEntry 4 } ippmOwnerAndIndexControlEntryOwner OBJECT-TYPE SYNTAX OwnerString MAX-ACCESS read-create STATUS current DESCRIPTION "Identifies the manager which owns this entry." ::= { ippmOwnerAndIndexControlEntry 5 } -- -- ippmSystemGroup -- -- ippmSystemTimer OBJECT-TYPE SYNTAX GMTDateAndTime MAX-ACCESS read-only STATUS current DESCRIPTION "The current time of the system." ::= { ippmSystemGroup 1 } ippmSystemSynchonizationType OBJECT-TYPE SYNTAX INTEGER { none(0), NTP(1), GPS(2), other(3) } MAX-ACCESS read-only STATUS current DESCRIPTION "ippmSystemSynchonizationType describes the mechanism used to synchronise the system. none There is no synchonisation available. NTP The system is synchronised using the network time protocol. The NTP synchronisation must be described finely in the ippmSystemSynchonizationDescription. GPS The system is synchronised using the GPS. Other The synchronisation process must be defined extensively in the ippmSystemSynchonizationDescription. " ::= { ippmSystemGroup 2 } ippmSystemSynchonizationDescription OBJECT-TYPE SYNTAX DisplayString MAX-ACCESS read-only STATUS current DESCRIPTION "The description of the synchronisation process." ::= { ippmSystemGroup 3 } ippmSystemClockResolution OBJECT-TYPE SYNTAX INTEGER MAX-ACCESS read-only STATUS current DESCRIPTION "ippmSystemClockResolution provides the precision of the clock used for the measures. The unit is 1/10 of millisecond. For example, the clock on an old Unix host might advance only once every 10 msec, and thus have a resolution of only 10 msec." ::= { ippmSystemGroup 4 } ippmSystemSynchronisationTime OBJECT-TYPE SYNTAX DateAndTime MAX-ACCESS read-only STATUS current DESCRIPTION "The time when occurs the last synchronisation of the clock. The last synchronisation must be set even if the synchronisation is not automatic." ::= { ippmSystemGroup 5 } ippmSystemClockAccuracy OBJECT-TYPE SYNTAX INTEGER MAX-ACCESS read-only STATUS current DESCRIPTION "The most recent accuracy of the clock computed. The accuracy must be compute even if the synchronisation is not automatic." ::= { ippmSystemGroup 6 } ippmSystemClockSkew OBJECT-TYPE SYNTAX INTEGER MAX-ACCESS read-only STATUS current DESCRIPTION "The most recent skew of the clock computed. The ippmSystemSkew must be compute even if the synchronisation is not automatic." ::= { ippmSystemGroup 7 } ippmSystemPrevClockAccuracy OBJECT-TYPE SYNTAX INTEGER MAX-ACCESS read-only STATUS current DESCRIPTION "The previous accuracy of the clock measured. The ippmSystemPrevClockAccuracy must be computed even if the synchronisation is not automatic." ::= { ippmSystemGroup 8 } ippmSystemPrevClockSkew OBJECT-TYPE SYNTAX INTEGER MAX-ACCESS read-only STATUS current DESCRIPTION "The previous skew of the clock measured. The ippmSystemPrevClockSkew must be computed even if the synchronisation is not automatic." ::= { ippmSystemGroup 9 } -- -- -- -- ippmMeasureGroup -- -- -- ippmMetricTable OBJECT-TYPE SYNTAX SEQUENCE OF ippmMetricEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "This table describes the current implementation. This table is mandatory. Each IPPM standardized metric must be described in the table. " ::= { ippmMeasureGroup 1 } ippmMetricEntry OBJECT-TYPE SYNTAX IppmMetricEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "An entry describes the static capabilities of a metric implementation." INDEX { ippmMetricIndex } ::= { ippmMetricTable 1 } IppmMetricEntry ::= SEQUENCE { ippmMetricIndex INTEGER, ippmMetricCapabilities BITS, ippmMetricDescription DisplayString, ippmMetricMaxHistorySize INTEGER } ippmMetricIndex OBJECT-TYPE SYNTAX INTEGER MAX-ACCESS read-only STATUS current DESCRIPTION "ippmMetricIndex defines an unambiguous index for each standardized metric. A metric has the fixed index in impMetricTable corresponding to the chronological order of the standardization of the metric memos defining the metrics that is the RFCs order and the sequential order of the metrics definition in each memo. The IPPM RFC are: RFC Title ------------------------------------------------- RFC2678 IPPM Metrics for Measuring Connectivity RFC2679 A One-way Delay Metric for IPPM RFC2680 One Way Packet Loss Metric for IPPM RFC2681 Round-trip for Delay Metric for IPPM The resulting indexes are: Metric Index ------------------------------------------------- Instantaneous-Unidirectional-Connectivity 1 Instantaneous-Bidirectional-Connectivity 2 Interval-Unidirectional-Connectivity 3 Interval-Bidirectional-Connectivity 4 Interval-Temporal-Connectivity 5 One-way-Delay 6 One-way-Delay-Poisson-Stream 7 One-way-Delay-Percentile 8 One-way-Delay-Median 9 One-way-Delay-Minimum 10 One-way-Delay-Inverse-Percentile 11 One-way-Packet-Loss 12 One-way-Packet-Loss-Poisson-Stream 13 One-way-Packet-Loss-Average 14 Round-trip-Delay 15 Round-trip-Delay-Poisson-Stream 16 Round-trip-Delay-Percentile 17 Round-trip-Delay-Median 18 Round-trip-Delay-Minimum 19 Round-trip-Delay-Inverse-Percentile 20 " ::= { ippmMetricEntry 1 } ippmMetricCapabilities OBJECT-TYPE SYNTAX INTEGER { notImplemented(0), implemented(1) } MAX-ACCESS read-only STATUS current DESCRIPTION "notImplemented the metric is not implemented. implemented the metric is implemented." DEFVAL { implemented } ::= { ippmMetricEntry 2 } ippmMetricDescription OBJECT-TYPE SYNTAX DisplayString MAX-ACCESS read-only STATUS current DESCRIPTION "A textual description of the metric implementation." ::= { ippmMetricEntry 3 } ippmMetricMaxHistorySize OBJECT-TYPE SYNTAX INTEGER MAX-ACCESS read-only STATUS current DESCRIPTION "Specifies the maximal size of the archive of this metric in the ippmHistoryTable." ::= { ippmMetricEntry 4 } -- -- ippmMeasureControlTable -- -- ippmMeasureControlTable OBJECT-TYPE SYNTAX SEQUENCE OF IppmMeasureControlEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "The table of all the IPPM measures which are running in the device. They may not be active. a measure consists in a subset of metrics to compute. The results of the measure may be saved in the ippmHistoryTable. The configuration of the measure sets the size of the history requested in ippmMeasureControlHystorySize. The maximal number of MIB objects to be collected in the portion of ippmHistoryTable associated with this metric depends the value of the ippmMetricMaxHistorySize. The value of each metric ippmMeasureControlHystorySize must not be over the value of ippmMetricMaxHistorySize corresponding to this metric in ippmMetricTable. " ::= { ippmMeasureGroup 2 } ippmMeasureControlEntry OBJECT-TYPE SYNTAX IppmMeasureControlEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "A SNMP entity wishing to create and activate a measurement adds a new entry in the ippmMeasureControlTable. Typically the configuration operation set the values of the conceptual row parameters using an unused owner index and sets the status of the row to createAndGo. An SNMP error 'inconsistentValue' is returned if the owner index is out of range." INDEX { ippmMeasureControlOwner, ippmMeasureControlIndex } ::= { ippmMeasureControlTable 1 } IppmMeasureControlEntry ::= SEQUENCE { ippmMeasureControlIndex INTEGER, ippmMeasureControlName DisplayString, ippmMeasureControlMetrics BITS, ippmMeasureControlBeginTime GMTDateAndTime, ippmMeasureControlClockPeriodUnit Integer32, ippmMeasureControlClockPeriod Integer32, ippmMeasureControlDurationUnit Integer32, ippmMeasureControlDuration Integer32, ippmMeasureControlHystorySize Integer32, ippmMeasureControlOwner OwnerString, ippmMeasureControlStatus RowStatus } ippmMeasureControlIndex OBJECT-TYPE SYNTAX INTEGER MAX-ACCESS read-write STATUS current DESCRIPTION "The owner index of the measure. Its value must be in the range of indexes granted to that customer. The index is managed by the owner in its range of index. An SNMP error 'inconsistentValue' is returned if the index of the owner is out of range." ::= { ippmMeasureControlEntry 1 } ippmMeasureControlName OBJECT-TYPE SYNTAX INTEGER MAX-ACCESS read-write STATUS current DESCRIPTION "The name of the instance of the metric. It illustrates the specificity of the metric and includes the metric and the typeP. example: IP-port-HTTP-connectivity" ::= { ippmMeasureControlEntry 2 } ippmMeasureControlMetrics OBJECT-TYPE SYNTAX BITS { none(0), -- reserved Instantaneous-Unidirectional-Connectivity(1), Instantaneous-Bidirectional-Connectivity(2), Interval-Unidirectional-Connectivity(3), Interval-Bidirectional-Connectivity(4), Interval-Temporal-Connectivity(5), One-way-Delay(6), One-way-Delay-Poisson-Stream(7), One-way-Delay-Percentile(8), One-way-Delay-Median(9), One-way-Delay-Minimum(10), One-way-Delay-Inverse-Percentile(11), One-way-Packet-Loss(12), One-way-Packet-Loss-Poisson-Stream(13), One-way-Packet-Loss-Average(14), Round-trip-Delay(15), Round-trip-Delay-Poisson-Stream(16), Round-trip-Delay-Percentile(17), Round-trip-Delay-Median(18), Round-trip-Delay-Minimum(19), Round-trip-Delay-Inverse-Percentile(20) } MAX-ACCESS read-create STATUS current DESCRIPTION "Defines the metrics to compute within this measure. A measure may be configured for the result of different metrics singletons to be archive in the ippmHistoryTable. The ippmMetricIndex of the created result has the value of the bit index of the corresponding ippmMeasureControlMetrics as explained above in the ippmMetricIndex definition. Example: A measure asking for One-way-Delay(6) and One-way- Packet-Loss(12) generated a flow of singletons which are logged in the ippmHistoryTable. The singletons created for the One-way-Delay measure have a value of ippmMetricIndex of 6 while the created singletons for the One-way-Packet-Loss measure have a value of ippmMetricIndex of 12." DEFVAL { { One-way-Delay, One-way-Packet-Loss } } ::= { ippmMeasureControlEntry 3 } ippmMeasureControlBeginTime OBJECT-TYPE SYNTAX GMTDateAndTime MAX-ACCESS read-create STATUS current DESCRIPTION "Specifies the time at which the measure starts." ::= { ippmMeasureControlEntry 4 } ippmMeasureControlClockPeriodUnit OBJECT-TYPE SYNTAX INTEGER { year(1), month(2), week(3), day(4), hour(5), second(6), ms(7), us(8), ns(9) } MAX-ACCESS read-create STATUS current DESCRIPTION "Specifies the unit of the measure period." DEFVAL { 6 } ::= { ippmMeasureControlEntry 5 } ippmMeasureControlClockPeriod OBJECT-TYPE SYNTAX Integer32 MAX-ACCESS read-create STATUS current DESCRIPTION "Specifies the among of time between 2 sampling intervals. Notes: This interval generates a flow of periodical instants which may be transformed as a flow of unpredictable instants of measure by the ippmSamplerControlClockPattern." DEFVAL { 60 } ::= { ippmMeasureControlEntry 6 } ippmMeasureControlDurationUnits OBJECT-TYPE SYNTAX INTEGER { year(1), month(2), week(3), day(4), hour(5), second(6), ms(7), us(8), ns(9) } MAX-ACCESS read-create STATUS current DESCRIPTION "Specifies the unit of the measure duration." DEFVAL { 6 } ::= { ippmMeasureControlEntry 7 } ippmMeasureControlDuration OBJECT-TYPE SYNTAX Integer32 MAX-ACCESS read-create STATUS current DESCRIPTION "Specifies the duration of the measure." DEFVAL { 120 } ::= { ippmMeasureControlEntry 8 } ippmMeasureControlHystorySize OBJECT-TYPE SYNTAX Integer32 MAX-ACCESS read-create STATUS current DESCRIPTION "Specifies the size of the history for each metric of this measure. Notes: This parameter is common to all the results of metrics of the current measure." DEFVAL { 120 } ::= { ippmMeasureControlEntry 9 } ippmMeasureControlOwner OBJECT-TYPE SYNTAX OwnerString MAX-ACCESS read-create STATUS current DESCRIPTION "The owner that configured this entry." DEFVAL { "acme" } ::= { ippmMeasureControlEntry 10 } ippmMeasureControlStatus OBJECT-TYPE SYNTAX RowStatus MAX-ACCESS read-create STATUS current DESCRIPTION "The status of this table entry. Once the entry status is set to active, the associate entry cannot be modified." DEFVAL { 4 } ::= { ippmMeasureControlEntry 11 } -- -- ippmHistoryTable -- ippmHistoryTable OBJECT-TYPE SYNTAX SEQUENCE OF IppmHistoryEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "A list of measure history entries." ::= { ippmMeasureGroup 3 } ippmHistoryEntry OBJECT-TYPE SYNTAX IppmHistoryEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "This sample is associated with the ippmMeasureControlEntry which set up the parameters for a regular collection of these samples. The couple ippmMeasureControlOwner value, ippmMeasureControlIndex value in the index identifies the ippmMeasureControlEntry on whose behalf this entry was created. The ippmMetricIndex value in the index identifies the ippmMetricEntry on whose behalf this entry was created. It identifies the type of the metric performed. The ippmHistoryTimeMark value is the absolute time when the ippmHistoryValue was performed. Example: A one way delay measure is created by the entity 'acme' using the owner index 1 and setting the 6th bit (corresponding to One-way-Delay) of ippmMeasureControlMetrics to 1. Consider that the result of the one way delay measured for acme on the day 15 of June at 8h20mn 10s 10ms is 23. The result is identified as the singleton ippmHistoryValue.acme.1.6.0106150820100100 and stored with value 23. Its value may be retrieved using a get- next(ippmHistoryValue.acme.1.6.0106150820100099) which returns (ippmHistoryValue.acme.1.6.0106150820100100 == 23). The ippmMetricIndex value of '6' corresponds to the 6th metric of ippmMetricTable which is Type-P-One-way- Delay. " INDEX { ippmMeasureControlOwner, ippmMeasureControlIndex, ippmMetricIndex, ippmHistoryTimeMark } ::= { ippmHistoryTable 1 } IppmHistoryEntry ::= SEQUENCE { ippmHistoryTimeMark GMTDateAndTime, ippmHistoryValue INTEGER } ippmHistoryTimeMark OBJECT-TYPE SYNTAX GMTDateAndTime MAX-ACCESS read-only STATUS current DESCRIPTION "The mark time corresponding to the instant of measure of the result." ::= { ippmHistoryEntry 1 } ippmHistoryValue OBJECT-TYPE SYNTAX INTEGER MAX-ACCESS read-only STATUS current DESCRIPTION "The value." ::= { ippmHistoryEntry 2 } -- -- ippmSamplerGroup -- -- -- -- ippmSamplerControlTable -- -- ippmSamplerControlTable OBJECT-TYPE SYNTAX SEQUENCE OF IppmSamplerControlEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "A sampler is a measure which performs network measures and provides a flow of results. This table extends the ippmMeasureControlTable. A sampler is a specific measure. A sampler performs several metrics measure per packet exchange. Each step of a measure produces a singleton result per metric. The timestamped results are saved in the ippmHistoryTable." ::= { ippmSamplerGroup 1 } ippmSamplerControlEntry OBJECT-TYPE SYNTAX IppmSamplerControlEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "A SNMP entity wishing to create and activate a sampler adds a new entry in the ippmMeasureControlTable and in IppmSamplerControlTable. Typically the configuration operation set both the values of the new ippmMeasureControlEntry and of the new IppmSamplerControlEntry and sets the status of the row to createAndGo. An SNMP error 'inconsistentValue' is returned if the index is out of range. The ippmMeasureControlMetrics is set to a list of metrics to be computed from the same raw packet exchange. Each step of measure delivers a singleton per chosen metric. Results are timestamped and saved in the ippmHistoryTable." INDEX { ippmMeasureControlOwner, ippmMeasureControlIndex } ::= { ippmSamplerControlTable 1 } IppmSamplerControlEntry ::= SEQUENCE { ippmSamplerControlSrcTypeP TypeP, ippmSamplerControlSrc OCTET STRING, ippmSamplerControlDstTypeP TypeP, ippmSamplerControlDst OCTET STRING, ippmSamplerControlClockPattern OCTET STRING, ippmSamplerControlTimeoutDelay Integer32, ippmSamplerControlL3PacketSize Integer32, ippmSamplerControlDataPattern OCTET STRING } ippmSamplerControlSrcTypeP OBJECT-TYPE SYNTAX TypeP MAX-ACCESS read-create STATUS current DESCRIPTION "Defines the type P of the source address of the packets sent by the measure." DEFVAL { '0400008000100'H } -- ->ip: 4.0.0.8.0.1.0 ::= { ippmSamplerControlEntry 1 } ippmSamplerControlSrc OBJECT-TYPE SYNTAX OCTET STRING MAX-ACCESS read-create STATUS current DESCRIPTION "Specifies the address of the source of the measure. It is represented as an octet string with specific semantics and length as identified by the ippmSamplerControlSrcTypeP. For example, if the ippmSamplerControlSrcTypeP indicates an encapsulation of 'ip', this object length is 4, followed by the 4 octets of the IP address, in network byte order." DEFVAL { '04C0210415'H } -- -> ip: 192.33.4.21 ::= { ippmSamplerControlEntry 2} ippmSamplerControlDstTypeP OBJECT-TYPE SYNTAX TypeP MAX-ACCESS read-create STATUS current DESCRIPTION "Defines the type P of the destination address of the packets sent by the measure." DEFVAL { '0400008000100'H } -- ->ip: 4.0.0.8.0.1.0 ::= { ippmSamplerControlEntry 3 } ippmSamplerControlDst OBJECT-TYPE SYNTAX OCTET STRING MAX-ACCESS read-create STATUS current DESCRIPTION "Specifies the address of the destination of the measure. It is represented as an octet string with specific semantics and length as identified by the ippmSamplerControlDstTypeP. For example, if the ippmSamplerControlDstTypeP indicates an encapsulation of 'ip', this object length is 4, followed by the 4 octets of the IP address, in network byte order." DEFVAL { '04C0220414'H } -- -> ip: 192.34.4.20 ::= { ippmSamplerControlEntry 4 } ippmSamplerControlClockPattern OBJECT-TYPE SYNTAX OCTET STRING MAX-ACCESS read-create STATUS current DESCRIPTION "This cyclic clock shapes the profile of the instants of measurement according to an arbitrary distribution law. The clock resolution is ippmMeasureControlClockPeriod. The bits of the clock set to the value 1 determine the valid instants of measurement. A measure is to be processed if and only if the current bit value is 1. This pseudo-random clock pattern allows the configuration by the NMS of numerous kind of sampling law such as periodic or Poisson." DEFVAL { '1111'B } -- 100% periodic ::= { ippmSamplerControlEntry 5 } ippmSamplerControlTimeoutDelay OBJECT-TYPE SYNTAX Integer32 MAX-ACCESS read-create STATUS current UNITS "Milliseconds" DESCRIPTION "Specifies the delay after which the packet is considered lost." DEFVAL { 1 } ::= { ippmSamplerControlEntry 6 } ippmSamplerControlL3PacketSize OBJECT-TYPE SYNTAX Integer32 MAX-ACCESS read-create STATUS current DESCRIPTION "Specifies the size of the packets send at the last network layer in the sense of the TypeP definition." DEFVAL { 64 } ::= { ippmSamplerControlEntry 7 } ippmSamplerControlDataPattern OBJECT-TYPE SYNTAX OCTET STRING MAX-ACCESS read-create STATUS current DESCRIPTION "The current field defines the round robin pattern used to fill the packet." DEFVAL { 'FF'H } ::= { ippmSamplerControlEntry 8 } -- -- -- ippmStatisticGroup -- -- -- -- -- ippmStatisticControlTable -- -- ippmStatisticControlTable OBJECT-TYPE SYNTAX SEQUENCE OF IppmStatisticControlEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "A statistic is a measure which performs computation on data saved in the ippmHistoryTable. This table extends the ippmMeasureControlTable. A statistic is a specific measure. A statistic measure may compute several metrics. Each step of a statistic computation produces a singleton result per metric. The results are saved in the ippmHistoryTable." ::= { ippmStatisticGroup 1 } ippmStatisticControlEntry OBJECT-TYPE SYNTAX IppmStatisticControlEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "A SNMP entity wishing to create and activate a statistic measure adds a new entry in the ippmMeasureControlTable and in ippmStatisticControlTable. Typically the configuration operation set both the values of the new ippmMeasureControlEntry and of the new IppmStatisticControlEntry and sets the status of the row to createAndGo. An SNMP error 'inconsistentValue' is returned if the index is out of range. The ippmMeasureControlMetrics is set to a list of metrics to be computed from a set of values saved in the usrHistoryTable. Each step of the computation delivers a singleton per chosen metric. The result may be saved in the ippmHistoryTable." INDEX { ippmMeasureControlOwner, ippmMeasureControlIndex } ::= { ippmMeasureControlTable 1 } IppmStatisticControlEntry ::= SEQUENCE { ippmStatisticControlHistoryMetric INTEGER, ippmStatisticControlHistoryOwner OwnerString, ippmStatisticControlHistoryOwnerIndex INTEGER } ippmStatisticControlHistoryMetric OBJECT-TYPE SYNTAX INTEGER MAX-ACCESS read-create STATUS current DESCRIPTION "The reference to the metric value saved in the ippmHistoryTable." ::= { ippmSamplerControlEntry 1 } ippmStatisticControlHistoryOwner OBJECT-TYPE SYNTAX OwnerString MAX-ACCESS read-create STATUS current DESCRIPTION "The reference to the owner of this history." ::= { ippmSamplerControlEntry 2 } ippmStatisticControlHistoryOwnerIndex OBJECT-TYPE SYNTAX INTEGER MAX-ACCESS read-create STATUS current DESCRIPTION "The reference to the owner index of this history." ::= { ippmSamplerControlEntry 3 } -- Compliance statements IppmCompliance MODULE-COMPLIANCE STATUS current DESCRIPTION "The compliance statement for SNMP entities which implement the IPPM MIB" MODULE -- this module MANDATORY-GROUPS{ ippmOwnerGroup, ippmSystemGroup, ippmMeasureGroup, ippmSamplerGroup, ippmStatisticGroup } ::= { ippmCompliances 1 } END -- -- -- "Copyright (C) The Internet Society (2001). All Rights Reserved. -- -- This document and translations of it may be copied and furnished to -- others, and derivative works that comment on or otherwise explain it -- or assist its implementation may be prepared, copied, published and -- distributed, in whole or in part, without restriction of any kind, -- provided that the above copyright notice and this paragraph are -- included 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 or references to the Internet Society or other -- Internet organizations, except as needed for the purpose of -- developing Internet standards in which case the procedures for -- copyrights defined in the Internet Standards process must be -- followed, or as required to translate it into languages other than -- English. -- The limited permissions granted above are perpetual and will not be -- revoked by the Internet Society or its successors or assigns. -- -- This document and the information contained herein is provided on an -- "AS IS" basis and THE INTERNET SOCIETY AND THE INTERNET ENGINEERING -- TASK FORCE DISCLAIMS ALL WARRANTIES, EXPRESS OR IMPLIED, INCLUDING -- BUT NOT LIMITED TO ANY WARRANTY THAT THE USE OF THE INFORMATION -- HEREIN WILL NOT INFRINGE ANY RIGHTS OR ANY IMPLIED WARRANTIES OF -- MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE.