mibs/ietf/DSMON-MIB

   1 DSMON-MIB DEFINITIONS ::= BEGIN
   2
   3 IMPORTS
   4         MODULE-IDENTITY, OBJECT-TYPE, Integer32,
   5         Counter32, Gauge32
   6                 FROM SNMPv2-SMI
   7         MODULE-COMPLIANCE, OBJECT-GROUP
   8                 FROM SNMPv2-CONF
   9         RowStatus, TimeStamp, TEXTUAL-CONVENTION, TruthValue
  10                 FROM SNMPv2-TC
  11         OwnerString, rmon
  12                 FROM RMON-MIB
  13         protocolDirLocalIndex, LastCreateTime,
  14         DataSource, ZeroBasedCounter32, TimeFilter
  15                 FROM RMON2-MIB
  16         CounterBasedGauge64, ZeroBasedCounter64
  17                 FROM HCNUM-TC
  18         SnmpAdminString
  19                 FROM SNMP-FRAMEWORK-MIB
  20         Dscp
  21                 FROM DIFFSERV-DSCP-TC;
  22
  23 dsmonMIB MODULE-IDENTITY
  24     LAST-UPDATED    "200205310000Z"
  25     ORGANIZATION    "IETF RMONMIB Working Group"
  26     CONTACT-INFO
  27             "        Andy Bierman
  28                      Cisco Systems, Inc.
  29                      RMONMIB WG Chair and DSMON MIB Editor
  30
  31              Postal: 170 West Tasman Drive
  32                      San Jose, CA USA 95134
  33                 Tel: +1 408 527-3711
  34              E-mail: abierman@cisco.com
  35
  36              Send comments to <rmonmib@ietf.org>
  37              Mailing list subscription info:
  38                  http://www.ietf.org/mailman/listinfo/rmonmib "
  39     DESCRIPTION
  40             "This module defines Remote Monitoring MIB extensions for
  41             Differentiated Services enabled networks.
  42
  43              RMON DIFFSERV DSCP statistics
  44               * Per Counter Aggregation Group
  45               * Per Protocol Per Counter Aggregation Group
  46               * Per Counter Aggregation Group Per Host
  47
  48
  49
  50               * Per Counter Aggregation Group Per Host-Pair
  51
  52             In order to maintain the RMON 'look-and-feel' and semantic
  53             consistency, some of the text from the RMON-2 and HC-RMON
  54             MIBs by Steve Waldbusser has been adapted for use in this
  55             MIB."
  56     REVISION        "200205310000Z"
  57     DESCRIPTION
  58             "Initial version of the DSMON MIB module.  This version
  59             published as RFC 3287."
  60     ::= { rmon 26 }
  61
  62
  63 dsmonObjects       OBJECT IDENTIFIER ::= { dsmonMIB 1 }
  64 dsmonNotifications OBJECT IDENTIFIER ::= { dsmonMIB 2 }
  65 dsmonConformance   OBJECT IDENTIFIER ::= { dsmonMIB 3 }
  66
  67 dsmonAggObjects    OBJECT IDENTIFIER ::= { dsmonObjects 1 }
  68 dsmonStatsObjects  OBJECT IDENTIFIER ::= { dsmonObjects 2 }
  69 dsmonPdistObjects  OBJECT IDENTIFIER ::= { dsmonObjects 3 }
  70 dsmonHostObjects   OBJECT IDENTIFIER ::= { dsmonObjects 4 }
  71 dsmonCapsObjects   OBJECT IDENTIFIER ::= { dsmonObjects 5 }
  72 dsmonMatrixObjects OBJECT IDENTIFIER ::= { dsmonObjects 6 }
  73
  74 --
  75 -- Textual Convention to define a
  76 -- DSMON Counter Aggregation Group Index
  77 --
  78
  79 DsmonCounterAggGroupIndex ::= TEXTUAL-CONVENTION
  80     STATUS current
  81     DESCRIPTION
  82             "This TC describes a data type which identifies a DSMON
  83             counter aggregation group, which is an arbitrary grouping of
  84             conceptual counters, for monitoring purposes only.  The
  85             range for this data type begins with zero (instead of
  86             one), to allow for a direct mapping between counter
  87             indexing schemes that start at zero (e.g. DSCP values in
  88             packets) and counter aggregation group values."
  89     SYNTAX Integer32 (0..2147483647)
  90
  91 --
  92 -- Textual Convention to define a
  93 -- DSMON Counter Aggregation Profile Index
  94 --
  95
  96 DsmonCounterAggProfileIndex ::= TEXTUAL-CONVENTION
  97     STATUS current
  98
  99
 100
 101     DESCRIPTION
 102             "This TC describes a data type which identifies a DSMON
 103             counter aggregation profile, which is a set of counter
 104             aggregation group assignments for each of the 64 DSCP
 105             values, for a particular statistical collection."
 106     SYNTAX Integer32 (1..2147483647)
 107
 108
 109 -- ***********************************************************
 110 -- *                                                         *
 111 -- *           D S M O N    C A P A B I L I T I E S          *
 112 -- *                                                         *
 113 -- ***********************************************************
 114
 115 dsmonCapabilities OBJECT-TYPE
 116     SYNTAX      BITS  {
 117                        dsmonCounterAggControl(0),
 118                        dsmonStats(1),
 119                        dsmonStatsOvfl(2),
 120                        dsmonStatsHC(3),
 121                        dsmonPdist(4),
 122                        dsmonPdistOvfl(5),
 123                        dsmonPdistHC(6),
 124                        dsmonHost(7),
 125                        dsmonHostOvfl(8),
 126                        dsmonHostHC(9),
 127                        dsmonCaps(10),
 128                        dsmonMatrix(11),
 129                        dsmonMatrixOvfl(12),
 130                        dsmonMatrixHC(13)
 131                       }
 132     MAX-ACCESS  read-only
 133     STATUS      current
 134     DESCRIPTION
 135             "This object provides an indication of the DSMON groups
 136             supported by the agent.  If a bit is set, then the agent
 137             implements all of the objects in the DSMON object group,
 138             where bit 'n' represents the MIB group identified by the
 139             OBJECT IDENTIFIER value { dsmonGroups n+1 }."
 140     ::= { dsmonCapsObjects 1 }
 141
 142
 143 -- ***********************************************************
 144 -- *                                                         *
 145 -- *   A G G R E G A T I O N   C O N T R O L   G R O U P S   *
 146 -- *                                                         *
 147 -- ***********************************************************
 148
 149
 150
 151
 152 dsmonMaxAggGroups OBJECT-TYPE
 153     SYNTAX      Integer32 (2..64)
 154     MAX-ACCESS  read-only
 155     STATUS      current
 156     DESCRIPTION
 157             "The maximum number of counter aggregation groups that this
 158             agent can support.  The agent will allow this number of
 159             distinct groups to be configured in the
 160             dsmonAggProfileTable, numbered from '0' to
 161             'dsmonMaxAggGroups - 1', for each counter aggregation
 162             profile entry supported by the agent.
 163
 164             The agent MUST NOT lower this value during system operation,
 165             and SHOULD set this object to an appropriate value during
 166             system initialization."
 167     ::= { dsmonAggObjects 1 }
 168
 169 dsmonAggControlLocked OBJECT-TYPE
 170     SYNTAX      TruthValue
 171     MAX-ACCESS  read-write
 172     STATUS      current
 173     DESCRIPTION
 174             "Controls the setup of counter aggregation groups for this
 175             agent.
 176
 177             If this object contains the value 'true', then write access
 178             to the objects in the dsmonAggControlTable (except the
 179             dsmonAggControlOwner object), dsmonAggProfileTable, and
 180             dsmonAggGroupTable is not permitted, and data collection is
 181             possible.  This object only controls write access to these
 182             MIB objects.  The DSMON data collection control tables
 183             (e.g., dsmonHostCtlTable) can be configured at any time,
 184             regardless of the value of this object.
 185
 186             If this object contains the value 'false', write access to
 187             the objects in the dsmonAggControlTable,
 188             dsmonAggProfileTable, and dsmonAggGroupTable is permitted,
 189             and data collection is not possible.  In addition, all
 190             objects in all DSMON data tables (e.g., dsmonStatsTable)
 191             shall be deleted.
 192
 193             An agent is not required to process SNMP Set Requests for
 194             this object in conjunction with other objects from this MIB.
 195             This is intended to simplify the processing of Set Requests
 196             for tables such as the dsmonAggProfileTable, by eliminating
 197             the possibility that a single Set PDU will contain multiple
 198             varbinds which are in conflict, such as a PDU which both
 199             modifies the dsmonAggProfileTable and locks the
 200
 201
 202
 203             dsmonAggProfileTable at the same time.
 204
 205             Note that the agent is not required to validate the entire
 206             counter aggregation configuration when an attempt is made to
 207             transition an instance of this object from 'true' to
 208             'false'.  That validation is done if and when a DSMON data
 209             collection is activated.
 210
 211             An agent is required to reactivate any suspended data
 212             collections when this object transitions to 'true', Each
 213             active data control entry (e.g., dsmonStatsControlEntry),
 214             will be validated with respect to the new counter
 215             aggregation configuration.  If the counter aggregation
 216             profile referenced in the data collection is valid, then
 217             that collection will be restarted.  Otherwise, the RowStatus
 218             object (e.g., dsmonStatsControlStatus) will be set to
 219             'notReady' for that collection control entry."
 220     ::= { dsmonAggObjects 2 }
 221
 222 dsmonAggControlChanges OBJECT-TYPE
 223     SYNTAX      Counter32
 224     MAX-ACCESS  read-only
 225     STATUS      current
 226     DESCRIPTION
 227             "This object counts the number of times the value of the
 228             dsmonAggControlLocked object has changed.  A management
 229             station can use this object to detect if counters in the
 230             DSMON data tables (e.g., dsmonStatsEntry) have been deleted
 231             and recreated between polls.
 232
 233             This object shall be incremented by one each time the
 234             dsmonAggControlLocked object changes from 'false' to 'true',
 235             or from 'true' to 'false'."
 236     ::= { dsmonAggObjects 3 }
 237
 238 dsmonAggControlLastChangeTime OBJECT-TYPE
 239     SYNTAX      TimeStamp
 240     MAX-ACCESS  read-only
 241     STATUS      current
 242     DESCRIPTION
 243             "This object identifies the value of sysUpTime at the moment
 244             the dsmonAggControlLocked object was last modified.  A
 245             management station can use this object to detect if counters
 246             in the DSMON data tables (e.g., dsmonStatsEntry) have been
 247             deleted and recreated between polls.
 248
 249             This object shall be updated with the current value of
 250             sysUpTime, if the dsmonAggControlLocked object changes from
 251
 252
 253
 254             'false' to 'true', or from 'true' to 'false'.
 255
 256             Upon system initialization, this object shall contain the
 257             value zero."
 258     ::= { dsmonAggObjects 4 }
 259
 260
 261 --
 262 -- Counter Aggregation Control Table
 263 --
 264
 265 dsmonAggControlTable OBJECT-TYPE
 266     SYNTAX      SEQUENCE OF DsmonAggControlEntry
 267     MAX-ACCESS  not-accessible
 268     STATUS      current
 269     DESCRIPTION
 270             "This table provides an overall description and control
 271             point for all dsmonAggProfileEntries with the same
 272             dsmonAggControlIndex value.
 273
 274             A management application SHOULD create a counter aggregation
 275             profile by first creating and activating an entry in this
 276             table.  This will cause the agent to create a set of 64
 277             dsmonAggProfileEntries on behalf of this control entry.  An
 278             application can then set the individual counter aggregation
 279             group assignments for each of the 64 DSCP values,
 280
 281             This table MUST NOT be modified if the dsmonAggControlLocked
 282             object is equal to 'true'.
 283
 284             Note that an agent MAY choose to limit the actual number of
 285             entries which may be created in this table, and
 286             (independently) the number of counter aggregation profiles
 287             which may be applied to a particular data source.  In this
 288             case, the agent SHOULD return an error-status of
 289             'resourceUnavailable(13)', as per section 4.2.5 of the
 290             'Protocol Operations for SNMPv2' specification [RFC1905].
 291
 292             The agent SHOULD support non-volatile configuration of this
 293             table, and upon system initialization, the table SHOULD be
 294             initialized with the saved values.  Otherwise, each
 295             potential counter aggregation group description string
 296             SHOULD contain the empty string."
 297     ::= { dsmonAggObjects 5 }
 298
 299 dsmonAggControlEntry OBJECT-TYPE
 300     SYNTAX      DsmonAggControlEntry
 301     MAX-ACCESS  not-accessible
 302
 303
 304
 305     STATUS      current
 306     DESCRIPTION
 307             "A conceptual row in the dsmonAggControlTable."
 308     INDEX { dsmonAggControlIndex }
 309     ::= { dsmonAggControlTable 1 }
 310
 311 DsmonAggControlEntry ::= SEQUENCE {
 312     dsmonAggControlIndex         DsmonCounterAggProfileIndex,
 313     dsmonAggControlDescr         SnmpAdminString,
 314     dsmonAggControlOwner         OwnerString,
 315     dsmonAggControlStatus        RowStatus
 316 }
 317
 318 dsmonAggControlIndex OBJECT-TYPE
 319     SYNTAX      DsmonCounterAggProfileIndex
 320     MAX-ACCESS  not-accessible
 321     STATUS      current
 322     DESCRIPTION
 323             "An arbitrary integer index value used to identify the
 324             counter aggregation profile specified by this control
 325             entry."
 326     ::= { dsmonAggControlEntry 1 }
 327
 328 dsmonAggControlDescr OBJECT-TYPE
 329     SYNTAX      SnmpAdminString (SIZE (0..64))
 330     MAX-ACCESS  read-create
 331     STATUS      current
 332     DESCRIPTION
 333             "An administratively assigned description of the counter
 334             aggregation profile identified by this entry.
 335
 336             Upon first creation of an instance of this object, the agent
 337             SHOULD set this object to the empty string.  If the agent
 338             supports non-volatile storage, then this object SHOULD be
 339             re-initialized with its stored value after a system reboot.
 340
 341             This object MUST NOT be modified if the associated
 342             dsmonAggControlStatus object is equal to 'active', or the
 343             dsmonAggControlLocked object is equal to 'true'."
 344     ::= { dsmonAggControlEntry 2 }
 345
 346 dsmonAggControlOwner OBJECT-TYPE
 347     SYNTAX     OwnerString
 348     MAX-ACCESS read-create
 349     STATUS     current
 350     DESCRIPTION
 351             "The entity that configured this entry and is therefore
 352             using the resources assigned to it."
 353
 354
 355
 356     ::= { dsmonAggControlEntry 3 }
 357
 358 dsmonAggControlStatus OBJECT-TYPE
 359     SYNTAX      RowStatus
 360     MAX-ACCESS  read-create
 361     STATUS      current
 362     DESCRIPTION
 363             "The status of this row.
 364
 365             An entry MUST NOT exist in the active state unless all
 366             objects in the entry have an appropriate value.
 367
 368             Upon setting this object to active(1), the agent will create
 369             a complete set of 64 associated entries in the
 370             dsmonAggProfileTable.
 371
 372             If this object is not equal to active(1), all associated
 373             entries in the dsmonAggProfileTable shall be deleted.
 374
 375             This object MUST NOT be modified if the
 376             dsmonAggControlLocked object is equal to 'true'."
 377     ::= { dsmonAggControlEntry 4 }
 378
 379 --
 380 -- Counter Aggregation Profile Table
 381 --
 382
 383 dsmonAggProfileTable OBJECT-TYPE
 384     SYNTAX      SEQUENCE OF DsmonAggProfileEntry
 385     MAX-ACCESS  not-accessible
 386     STATUS      current
 387     DESCRIPTION
 388             "Controls the setup of counter aggregation profiles for this
 389             agent.  For each such profile, every DSCP value MUST be
 390             configured into exactly one counter aggregation group.
 391
 392             This table MUST NOT be modified if the dsmonAggControlLocked
 393             object is equal to 'true'.
 394
 395             The agent will create a set of 64 entries in this table
 396             (with the same dsmonAggControlIndex value) when the
 397             associated dsmonAggControlEntry is activated.
 398
 399             If the agent supports non-volatile configuration of this
 400             table, then upon system initialization, this table SHOULD be
 401             initialized with the saved values."
 402     ::= { dsmonAggObjects 6 }
 403
 404
 405
 406
 407 dsmonAggProfileEntry OBJECT-TYPE
 408     SYNTAX      DsmonAggProfileEntry
 409     MAX-ACCESS  not-accessible
 410     STATUS      current
 411     DESCRIPTION
 412             "A conceptual row in the dsmonAggProfileTable.  The
 413             dsmonAggControlIndex value in the index identifies the
 414             dsmonAggControlEntry associated with each entry in this
 415             table."
 416     INDEX { dsmonAggControlIndex, dsmonAggProfileDSCP }
 417     ::= { dsmonAggProfileTable 1 }
 418
 419 DsmonAggProfileEntry ::= SEQUENCE {
 420     dsmonAggProfileDSCP          Dscp,
 421     dsmonAggGroupIndex           DsmonCounterAggGroupIndex
 422 }
 423
 424
 425 dsmonAggProfileDSCP OBJECT-TYPE
 426     SYNTAX      Dscp
 427     MAX-ACCESS  not-accessible
 428     STATUS      current
 429     DESCRIPTION
 430             "The specific DSCP value for the DSCP counter which is
 431             configured in a counter aggregation group by this entry."
 432     ::= { dsmonAggProfileEntry 1 }
 433
 434 dsmonAggGroupIndex OBJECT-TYPE
 435     SYNTAX      DsmonCounterAggGroupIndex
 436     MAX-ACCESS  read-write
 437     STATUS      current
 438     DESCRIPTION
 439             "The counter aggregation group which contains this DSCP
 440             value.  Upon creation of a new sub-tree (set of 64 entries
 441             with the same dsmonAggControlIndex value) in this table, the
 442             agent SHOULD initialize all related instances of this object
 443             to the value zero.
 444
 445             This object MUST NOT be modified if the
 446             dsmonAggControlLocked object is equal to 'true'."
 447     DEFVAL { 0 }
 448     ::= { dsmonAggProfileEntry 2 }
 449
 450
 451 --
 452 -- Counter Aggregation Group Table
 453 --
 454
 455
 456
 457
 458 dsmonAggGroupTable OBJECT-TYPE
 459     SYNTAX      SEQUENCE OF DsmonAggGroupEntry
 460     MAX-ACCESS  not-accessible
 461     STATUS      current
 462     DESCRIPTION
 463             "This table provides a description of each counter
 464             aggregation group configured on this system.  Note that the
 465             semantics of a particular counter aggregation group are only
 466             relevant within the scope of a particular counter
 467             aggregation profile.
 468
 469             This table MUST NOT be modified if the dsmonAggControlLocked
 470             object is equal to 'true'.
 471
 472             Note that an agent MAY choose to limit the actual number of
 473             entries which may be created in this table, and
 474             (independently) the number of counter aggregation profiles
 475             which may be applied to a particular data source.  In this
 476             case, the agent SHOULD return an error-status of
 477             'resourceUnavailable(13)', as per section 4.2.5 of the
 478             'Protocol Operations for SNMPv2' specification [RFC1905].
 479
 480             If the agent supports non-volatile configuration of this
 481             table, then upon system initialization, this table SHOULD be
 482             initialized with the saved values.  Otherwise, each
 483             potential counter aggregation group description string
 484             SHOULD contain the empty string.
 485
 486             An agent SHOULD allow entries to be created or modified in
 487             this table, even if the specified dsmonAggControlIndex value
 488             does not identify a valid dsmonAggControlEntry or a complete
 489             set of valid dsmonAggProfileEntries, to reduce row creation
 490             order dependencies."
 491     ::= { dsmonAggObjects 7 }
 492
 493 dsmonAggGroupEntry OBJECT-TYPE
 494     SYNTAX      DsmonAggGroupEntry
 495     MAX-ACCESS  not-accessible
 496     STATUS      current
 497     DESCRIPTION
 498             "A conceptual row in the dsmonAggGroupTable.  The
 499             dsmonAggGroupIndex value in the INDEX identifies the counter
 500             aggregation group associated with each entry.
 501
 502             The dsmonAggControlIndex in the index identifies the counter
 503             aggregation profile associated with each entry, identified
 504             by the dsmonAggControlEntry and dsmonAggProfileEntries with
 505             the same index value.
 506
 507
 508
 509             The agent SHOULD support non-volatile configuration of this
 510             table, and upon system initialization, the table SHOULD be
 511             initialized with the saved values.
 512
 513             The dsmonAggGroupIndex in the index identifies the counter
 514             aggregation group associated with each entry.  This object
 515             SHOULD be indexed from zero to 'N', where 'N' is less than
 516             the value of the dsmonMaxAggGroups for this agent."
 517
 518     INDEX { dsmonAggControlIndex, dsmonAggGroupIndex }
 519     ::= { dsmonAggGroupTable 1 }
 520 DsmonAggGroupEntry ::= SEQUENCE {
 521     dsmonAggGroupDescr         SnmpAdminString,
 522     dsmonAggGroupStatus        RowStatus
 523 }
 524
 525 dsmonAggGroupDescr OBJECT-TYPE
 526     SYNTAX      SnmpAdminString (SIZE (0..64))
 527     MAX-ACCESS  read-create
 528     STATUS      current
 529     DESCRIPTION
 530             "An administratively assigned description of the counter
 531             aggregation group identified by this entry.
 532
 533             Upon first creation of an instance of this object, the agent
 534             SHOULD set this object to the empty string.
 535
 536             This object MUST NOT be modified if the associated
 537             dsmonAggGroupStatus object is equal to 'active', or the
 538             dsmonAggControlLocked object is equal to 'true'."
 539     ::= { dsmonAggGroupEntry 1 }
 540
 541 dsmonAggGroupStatus OBJECT-TYPE
 542     SYNTAX      RowStatus
 543     MAX-ACCESS  read-create
 544     STATUS      current
 545     DESCRIPTION
 546             "The status of this row.
 547
 548             An entry MUST NOT exist in the active state unless all
 549             objects in the entry have an appropriate value.
 550
 551             This object MUST NOT be modified if the
 552             dsmonAggControlLocked object is equal to 'true'."
 553     ::= { dsmonAggGroupEntry 2 }
 554
 555
 556
 557
 558
 559
 560 -- *************************************************************
 561 -- *                                                           *
 562 -- *     P E R - D A T A S O U R C E   C O L L E C T I O N S   *
 563 -- *                                                           *
 564 -- *************************************************************
 565
 566 --
 567 -- Per-DataSource Statistics Control Table
 568 --
 569
 570 dsmonStatsControlTable OBJECT-TYPE
 571     SYNTAX      SEQUENCE OF DsmonStatsControlEntry
 572     MAX-ACCESS  not-accessible
 573     STATUS      current
 574     DESCRIPTION
 575             "Controls the setup of per data source per counter
 576             aggregation group distribution statistics.
 577
 578             Note that an agent MAY choose to limit the actual number of
 579             entries which may be created in this table.  In this case,
 580             the agent SHOULD return an error-status of
 581             'resourceUnavailable(13)', as per section 4.2.5 of the
 582             'Protocol Operations for SNMPv2' specification [RFC1905]."
 583     ::= { dsmonStatsObjects 1 }
 584
 585 dsmonStatsControlEntry OBJECT-TYPE
 586     SYNTAX      DsmonStatsControlEntry
 587     MAX-ACCESS  not-accessible
 588     STATUS      current
 589     DESCRIPTION
 590             "A conceptual row in the dsmonStatsControlTable.
 591
 592             Entries are created and deleted from this table by
 593             management action only, using the dsmonStatsControlStatus
 594             RowStatus object.
 595
 596             The agent SHOULD support non-volatile configuration of this
 597             table, and upon system initialization, the table SHOULD be
 598             initialized with the saved values.
 599
 600             Activation of a control row in this table will cause an
 601             associated dsmonStatsTable to be created and maintained by
 602             the agent."
 603     INDEX { dsmonStatsControlIndex }
 604     ::= { dsmonStatsControlTable 1 }
 605
 606 DsmonStatsControlEntry ::= SEQUENCE {
 607     dsmonStatsControlIndex                Integer32,
 608
 609
 610
 611     dsmonStatsControlDataSource           DataSource,
 612     dsmonStatsControlAggProfile           DsmonCounterAggProfileIndex,
 613     dsmonStatsControlDroppedFrames        Counter32,
 614     dsmonStatsControlCreateTime           LastCreateTime,
 615     dsmonStatsControlOwner                OwnerString,
 616     dsmonStatsControlStatus               RowStatus
 617 }
 618
 619 dsmonStatsControlIndex OBJECT-TYPE
 620     SYNTAX      Integer32 (1..65535)
 621     MAX-ACCESS  not-accessible
 622     STATUS      current
 623     DESCRIPTION
 624             "An arbitrary and unique index for this
 625             dsmonStatsControlEntry."
 626     ::= { dsmonStatsControlEntry 1 }
 627
 628 dsmonStatsControlDataSource OBJECT-TYPE
 629     SYNTAX      DataSource
 630     MAX-ACCESS  read-create
 631     STATUS      current
 632     DESCRIPTION
 633             "The data source of this per protocol per counter
 634             aggregation group distribution.
 635
 636             Note that only packets that contain a network protocol
 637             encapsulation which contains a DS field [RFC2474] will be
 638             counted in this table.
 639
 640             This object MUST NOT be modified if the associated
 641             dsmonStatsControlStatus object is equal to active(1)."
 642     ::= { dsmonStatsControlEntry 2 }
 643
 644 dsmonStatsControlAggProfile OBJECT-TYPE
 645     SYNTAX      DsmonCounterAggProfileIndex
 646     MAX-ACCESS  read-create
 647     STATUS      current
 648     DESCRIPTION
 649             "The dsmonAggControlIndex value identifying the counter
 650             aggregation profile which should be used on behalf of this
 651             dsmonStatsControlEntry.
 652
 653             The associated dsmonAggControlEntry and
 654             dsmonAggProfileEntries, identified by the same
 655             dsmonAggControlIndex index value, MUST be active in order
 656             for this entry to remain active.  It is possible for the
 657             counter aggregation configuration to change from a valid to
 658             invalid state for this dsmonStats collection.  In this case,
 659
 660
 661
 662             the associated dsmonStatsControlStatus object will be
 663             changed to the 'notReady' state, and data collection will
 664             not occur on behalf of this control entry.
 665
 666             Note that an agent MAY choose to limit the actual number of
 667             counter aggregation profiles which may be applied to a
 668             particular data source.
 669
 670             This object MUST NOT be modified if the associated
 671             dsmonStatsControlStatus object is equal to active(1)."
 672     ::= { dsmonStatsControlEntry 3 }
 673
 674 dsmonStatsControlDroppedFrames OBJECT-TYPE
 675     SYNTAX     Counter32
 676     UNITS      "frames"
 677     MAX-ACCESS read-only
 678     STATUS     current
 679     DESCRIPTION
 680             "The total number of frames which were received by the probe
 681             and therefore not accounted for in the *StatsDropEvents, but
 682             for which the probe chose not to count for this entry for
 683             whatever reason.  Most often, this event occurs when the
 684             probe is out of some resources and decides to shed load from
 685             this collection.
 686
 687             This count does not include packets that were not counted
 688             because they had MAC-layer errors.
 689
 690             Note that, unlike the dropEvents counter, this number is the
 691             exact number of frames dropped."
 692     ::= { dsmonStatsControlEntry 4 }
 693
 694 dsmonStatsControlCreateTime OBJECT-TYPE
 695     SYNTAX     LastCreateTime
 696     MAX-ACCESS read-only
 697     STATUS     current
 698     DESCRIPTION
 699             "The value of sysUpTime when this control entry was last
 700             activated.  This can be used by the management station to
 701             detect if the table has been deleted and recreated between
 702             polls."
 703     ::= { dsmonStatsControlEntry 5 }
 704
 705 dsmonStatsControlOwner OBJECT-TYPE
 706     SYNTAX      OwnerString
 707     MAX-ACCESS  read-create
 708     STATUS      current
 709     DESCRIPTION
 710
 711
 712
 713             "The entity that configured this entry and is therefore
 714             using the resources assigned to it."
 715     ::= { dsmonStatsControlEntry 6 }
 716
 717 dsmonStatsControlStatus OBJECT-TYPE
 718     SYNTAX      RowStatus
 719     MAX-ACCESS  read-create
 720     STATUS      current
 721     DESCRIPTION
 722             "The status of this row.
 723
 724             An entry MUST NOT exist in the active state unless all
 725             objects in the entry have an appropriate value.
 726
 727             If this object is not equal to active(1), all associated
 728             entries in the dsmonStatsTable shall be deleted."
 729     ::= { dsmonStatsControlEntry 7 }
 730
 731 --
 732 -- Per-DataSource Statistics Table
 733 --
 734
 735 dsmonStatsTable OBJECT-TYPE
 736     SYNTAX      SEQUENCE OF DsmonStatsEntry
 737     MAX-ACCESS  not-accessible
 738     STATUS      current
 739     DESCRIPTION
 740             "A list of information on counter aggregation group usage
 741             for each monitored data source.
 742
 743             The following table defines per counter aggregation group
 744             statistics for full and/or half-duplex links as well as high
 745             capacity links.
 746
 747             For half-duplex links, or full-duplex-capable links
 748             operating in half-duplex mode, the dsmonStatsIn* objects
 749             shall be used and the dsmonStatsOut* objects will not
 750             increment.
 751
 752             For full-duplex links, the dsmonStatsOut* objects will be
 753             present.  Whenever possible, the probe SHOULD count packets
 754             moving away from the closest terminating equipment as output
 755             packets.  Failing that, the probe SHOULD count packets
 756             moving away from the DTE as output packets.
 757
 758             If the dsmonAggControlLocked object is equal to 'false',
 759             then all entries in this table will be deleted and the agent
 760             will not process packets on behalf of any
 761
 762
 763
 764             dsmonStatsControlEntry."
 765     ::= { dsmonStatsObjects 2 }
 766
 767 dsmonStatsEntry OBJECT-TYPE
 768     SYNTAX      DsmonStatsEntry
 769     MAX-ACCESS  not-accessible
 770     STATUS      current
 771     DESCRIPTION
 772             "A list of information on Differentiated Services DSCP
 773             usage, containing inbound and outbound packet and octet
 774             counters for each counter aggregation group configured for
 775             collection.
 776
 777             The dsmonStatsControlIndex value in the index identifies the
 778             dsmonStatsControlEntry on whose behalf this entry was
 779             created.
 780
 781             The dsmonAggGroupIndex value in the index is determined by
 782             examining the DSCP value in each monitored packet, and the
 783             dsmonAggProfileTable entry for that DSCP value.
 784
 785             Note that only packets that contain a network protocol
 786             encapsulation which contains a DS field [RFC2474] will be
 787             counted in this table.
 788
 789             An example of the indexing of this entry is
 790             dsmonStatsOutPkts.1.16"
 791      INDEX { dsmonStatsControlIndex, dsmonAggGroupIndex }
 792     ::= { dsmonStatsTable 1 }
 793
 794 DsmonStatsEntry ::= SEQUENCE {
 795     dsmonStatsInPkts            ZeroBasedCounter32,
 796     dsmonStatsInOctets          ZeroBasedCounter32,
 797     dsmonStatsInOvflPkts        ZeroBasedCounter32,
 798     dsmonStatsInOvflOctets      ZeroBasedCounter32,
 799     dsmonStatsInHCPkts          ZeroBasedCounter64,
 800     dsmonStatsInHCOctets        ZeroBasedCounter64,
 801     dsmonStatsOutPkts           ZeroBasedCounter32,
 802     dsmonStatsOutOctets         ZeroBasedCounter32,
 803     dsmonStatsOutOvflPkts       ZeroBasedCounter32,
 804     dsmonStatsOutOvflOctets     ZeroBasedCounter32,
 805     dsmonStatsOutHCPkts         ZeroBasedCounter64,
 806     dsmonStatsOutHCOctets       ZeroBasedCounter64
 807 }
 808
 809 dsmonStatsInPkts OBJECT-TYPE
 810     SYNTAX      ZeroBasedCounter32
 811     UNITS       "packets"
 812
 813
 814
 815     MAX-ACCESS  read-only
 816     STATUS      current
 817     DESCRIPTION
 818             "The number of packets using one of the DSCP values in the
 819             indicated counter aggregation group, received on a half-
 820             duplex link or on the inbound connection of a full-duplex
 821             link."
 822     ::= { dsmonStatsEntry 1 }
 823
 824 dsmonStatsInOctets OBJECT-TYPE
 825     SYNTAX      ZeroBasedCounter32
 826     UNITS       "octets"
 827     MAX-ACCESS  read-only
 828     STATUS      current
 829     DESCRIPTION
 830             "The number of octets in packets, using one of the DSCP
 831             values in the indicated counter aggregation group, received
 832             on a half-duplex link or on the inbound connection of a
 833             full-duplex link."
 834     ::= { dsmonStatsEntry 2 }
 835
 836 dsmonStatsInOvflPkts OBJECT-TYPE
 837     SYNTAX      ZeroBasedCounter32
 838     MAX-ACCESS  read-only
 839     STATUS      deprecated
 840     DESCRIPTION
 841             "The number of times the associated dsmonStatsInPkts counter
 842             has overflowed.  Note that this object will only be
 843             instantiated if the associated dsmonStatsInHCPkts object is
 844             also instantiated for a particular dataSource."
 845     ::= { dsmonStatsEntry 3 }
 846
 847 dsmonStatsInOvflOctets OBJECT-TYPE
 848     SYNTAX      ZeroBasedCounter32
 849     MAX-ACCESS  read-only
 850     STATUS      deprecated
 851     DESCRIPTION
 852             "The number of times the associated dsmonStatsInOctets
 853             counter has overflowed.  Note that this object will only be
 854             instantiated if the associated dsmonStatsInHCOctets object
 855             is also instantiated for a particular dataSource."
 856     ::= { dsmonStatsEntry 4 }
 857
 858 dsmonStatsInHCPkts OBJECT-TYPE
 859     SYNTAX      ZeroBasedCounter64
 860     UNITS       "packets"
 861     MAX-ACCESS  read-only
 862     STATUS      current
 863
 864
 865
 866     DESCRIPTION
 867             "The 64-bit version of the dsmonStatsInPkts object.
 868
 869             Note that this object will only be instantiated if the RMON
 870             agent supports High Capacity monitoring for a particular
 871             dataSource."
 872     ::= { dsmonStatsEntry 5 }
 873
 874 dsmonStatsInHCOctets OBJECT-TYPE
 875     SYNTAX      ZeroBasedCounter64
 876     UNITS       "octets"
 877     MAX-ACCESS  read-only
 878     STATUS      current
 879     DESCRIPTION
 880             "The 64-bit version of the dsmonStatsInOctets object.
 881
 882             Note that this object will only be instantiated if the RMON
 883             agent supports High Capacity monitoring for a particular
 884             dataSource."
 885     ::= { dsmonStatsEntry 6 }
 886
 887 dsmonStatsOutPkts OBJECT-TYPE
 888     SYNTAX      ZeroBasedCounter32
 889     UNITS       "packets"
 890     MAX-ACCESS  read-only
 891     STATUS      current
 892     DESCRIPTION
 893             "The number of packets using one of the DSCP values in the
 894             indicated counter aggregation group, received on a full-
 895             duplex link in the direction of the network."
 896     ::= { dsmonStatsEntry 7 }
 897
 898 dsmonStatsOutOctets OBJECT-TYPE
 899     SYNTAX      ZeroBasedCounter32
 900     UNITS       "octets"
 901     MAX-ACCESS  read-only
 902     STATUS      current
 903     DESCRIPTION
 904             "The number of octets in packets, using one of the DSCP
 905             values in the indicated counter aggregation group, received
 906             on a full-duplex link in the direction of the network."
 907     ::= { dsmonStatsEntry 8 }
 908
 909 dsmonStatsOutOvflPkts OBJECT-TYPE
 910     SYNTAX      ZeroBasedCounter32
 911     MAX-ACCESS  read-only
 912     STATUS      deprecated
 913     DESCRIPTION
 914
 915
 916
 917             "The number of times the associated dsmonStatsOutPkts
 918             counter has overflowed.  Note that this object will only be
 919             instantiated if the associated dsmonStatsOutHCPkts object is
 920             also instantiated for a particular dataSource."
 921     ::= { dsmonStatsEntry 9 }
 922
 923 dsmonStatsOutOvflOctets OBJECT-TYPE
 924     SYNTAX      ZeroBasedCounter32
 925     MAX-ACCESS  read-only
 926     STATUS      deprecated
 927     DESCRIPTION
 928             "The number of times the associated dsmonStatsOutOctets
 929             counter has overflowed.  Note that this object will only be
 930             instantiated if the associated dsmonStatsOutHCOctets object
 931             is also instantiated for a particular dataSource."
 932     ::= { dsmonStatsEntry 10 }
 933
 934 dsmonStatsOutHCPkts OBJECT-TYPE
 935     SYNTAX      ZeroBasedCounter64
 936     UNITS       "packets"
 937     MAX-ACCESS  read-only
 938     STATUS      current
 939     DESCRIPTION
 940             "The 64-bit version of the dsmonStatsOutPkts object.
 941
 942             Note that this object will only be instantiated if the RMON
 943             agent supports High Capacity monitoring for a particular
 944             dataSource."
 945     ::= { dsmonStatsEntry 11 }
 946
 947 dsmonStatsOutHCOctets OBJECT-TYPE
 948     SYNTAX      ZeroBasedCounter64
 949     UNITS       "octets"
 950     MAX-ACCESS  read-only
 951     STATUS      current
 952     DESCRIPTION
 953             "The 64-bit version of the dsmonStatsOutOctets object.
 954             Note that this object will only be instantiated if the RMON
 955             agent supports High Capacity monitoring for a particular
 956             dataSource."
 957     ::= { dsmonStatsEntry 12 }
 958
 959
 960 -- ***********************************************************
 961 -- *                                                         *
 962 -- *     P E R - P R O T O C O L    C O L L E C T I O N S    *
 963 -- *                                                         *
 964 -- ***********************************************************
 965
 966
 967
 968 --
 969 -- DSCP Per-Protocol Statistics Control Table
 970 --
 971
 972 dsmonPdistCtlTable OBJECT-TYPE
 973     SYNTAX      SEQUENCE OF DsmonPdistCtlEntry
 974     MAX-ACCESS  not-accessible
 975     STATUS      current
 976     DESCRIPTION
 977             "Controls the setup of per application per counter
 978             aggregation group distribution statistics.
 979
 980             Note that an agent MAY choose to limit the actual number of
 981             entries which may be created in this table.  In this case,
 982             the agent SHOULD return an error-status of
 983             'resourceUnavailable(13)', as per section 4.2.5 of the
 984             'Protocol Operations for SNMPv2' specification [RFC1905]."
 985     ::= { dsmonPdistObjects 1 }
 986
 987 dsmonPdistCtlEntry OBJECT-TYPE
 988     SYNTAX      DsmonPdistCtlEntry
 989     MAX-ACCESS  not-accessible
 990     STATUS      current
 991     DESCRIPTION
 992             "A conceptual row in the dsmonPdistCtlTable.
 993
 994             Entries are created and deleted from this table by
 995             management action only, using the dsmonPdistCtlStatus
 996             RowStatus object.
 997
 998             The agent SHOULD support non-volatile configuration of this
 999             table, and upon system initialization, the table SHOULD be
1000             initialized with the saved values.
1001
1002             Activation of a control row in this table will cause an
1003             associated dsmonPdistStatsTable to be created and maintained
1004             by the agent."
1005     INDEX { dsmonPdistCtlIndex }
1006     ::= { dsmonPdistCtlTable 1 }
1007
1008 DsmonPdistCtlEntry ::= SEQUENCE {
1009     dsmonPdistCtlIndex                Integer32,
1010     dsmonPdistCtlDataSource           DataSource,
1011     dsmonPdistCtlAggProfile           DsmonCounterAggProfileIndex,
1012     dsmonPdistCtlMaxDesiredEntries    Integer32,
1013     dsmonPdistCtlDroppedFrames        Counter32,
1014     dsmonPdistCtlInserts              Counter32,
1015     dsmonPdistCtlDeletes              Counter32,
1016
1017
1018
1019     dsmonPdistCtlCreateTime           LastCreateTime,
1020     dsmonPdistCtlOwner                OwnerString,
1021     dsmonPdistCtlStatus               RowStatus
1022 }
1023
1024 dsmonPdistCtlIndex OBJECT-TYPE
1025     SYNTAX      Integer32 (1..65535)
1026     MAX-ACCESS  not-accessible
1027     STATUS      current
1028     DESCRIPTION
1029             "An arbitrary and unique index for this dsmonPdistCtlEntry."
1030     ::= { dsmonPdistCtlEntry 1 }
1031
1032 dsmonPdistCtlDataSource OBJECT-TYPE
1033     SYNTAX      DataSource
1034     MAX-ACCESS  read-create
1035     STATUS      current
1036     DESCRIPTION
1037             "The source of data for the this per protocol counter
1038             aggregation group distribution.
1039
1040             This object MUST NOT be modified if the associated
1041             dsmonPdistCtlStatus object is equal to active(1)."
1042     ::= { dsmonPdistCtlEntry 2 }
1043
1044 dsmonPdistCtlAggProfile OBJECT-TYPE
1045     SYNTAX      DsmonCounterAggProfileIndex
1046     MAX-ACCESS  read-create
1047     STATUS      current
1048     DESCRIPTION
1049             "The dsmonAggControlIndex value identifying the counter
1050             aggregation profile which should be used on behalf of this
1051             dsmonPdistCtlEntry.
1052
1053             The associated dsmonAggControlEntry and
1054             dsmonAggProfileEntries, identified by the same
1055             dsmonAggControlIndex index value, MUST be active in order
1056             for this entry to remain active.  It is possible for the
1057             counter aggregation configuration to change from a valid to
1058             invalid state for this dsmonPdist collection.  In this case,
1059             the associated dsmonPdistCtlStatus object will be changed to
1060             the 'notReady' state, and data collection will not occur on
1061             behalf of this control entry.
1062
1063             Note that an agent MAY choose to limit the actual number of
1064             counter aggregation profiles which may be applied to a
1065             particular data source.
1066
1067
1068
1069
1070             This object MUST NOT be modified if the associated
1071             dsmonPdistCtlStatus object is equal to active(1)."
1072     ::= { dsmonPdistCtlEntry 3 }
1073
1074 dsmonPdistCtlMaxDesiredEntries OBJECT-TYPE
1075     SYNTAX      Integer32 (-1 | 1..2147483647)
1076     MAX-ACCESS  read-create
1077     STATUS      current
1078     DESCRIPTION
1079             "The maximum number of entries that are desired in the
1080             dsmonPdistStatsTable on behalf of this control entry.  The
1081             probe will not create more than this number of associated
1082             entries in the table, but MAY choose to create fewer entries
1083             in this table for any reason including the lack of
1084             resources.
1085
1086             If this value is set to -1, the probe MAY create any number
1087             of entries in this table.
1088
1089             This object MUST NOT be modified if the associated
1090             dsmonPdistCtlStatus object is equal to active(1)."
1091     ::= { dsmonPdistCtlEntry 4 }
1092
1093 dsmonPdistCtlDroppedFrames OBJECT-TYPE
1094     SYNTAX     Counter32
1095     UNITS      "frames"
1096     MAX-ACCESS read-only
1097     STATUS     current
1098     DESCRIPTION
1099             "The total number of frames which were received by the probe
1100             and therefore not accounted for in the *StatsDropEvents, but
1101             for which the probe chose not to count for this entry for
1102             whatever reason.  Most often, this event occurs when the
1103             probe is out of some resources and decides to shed load from
1104             this collection.
1105
1106             This count does not include packets that were not counted
1107             because they had MAC-layer errors.
1108
1109             Note that, unlike the dropEvents counter, this number is the
1110             exact number of frames dropped."
1111     ::= { dsmonPdistCtlEntry 5 }
1112
1113 dsmonPdistCtlInserts OBJECT-TYPE
1114     SYNTAX     Counter32
1115     UNITS      "table entries"
1116     MAX-ACCESS read-only
1117     STATUS     current
1118
1119
1120
1121     DESCRIPTION
1122             "The number of times a dsmonPdist entry has been inserted
1123             into the dsmonPdistTable.  If an entry is inserted, then
1124             deleted, and then inserted, this counter will be incremented
1125             by 2.
1126
1127             To allow for efficient implementation strategies, agents MAY
1128             delay updating this object for short periods of time.  For
1129             example, an implementation strategy may allow internal data
1130             structures to differ from those visible via SNMP for short
1131             periods of time.  This counter may reflect the internal data
1132             structures for those short periods of time.
1133
1134             Note that the table size can be determined by subtracting
1135             dsmonPdistCtlDeletes from dsmonPdistCtlInserts."
1136     ::= { dsmonPdistCtlEntry 6 }
1137
1138 dsmonPdistCtlDeletes OBJECT-TYPE
1139     SYNTAX     Counter32
1140     UNITS      "table entries"
1141     MAX-ACCESS read-only
1142     STATUS     current
1143     DESCRIPTION
1144             "The number of times a dsmonPdist entry has been deleted
1145             from the dsmonPdist table (for any reason).  If an entry is
1146             deleted, then inserted, and then deleted, this counter will
1147             be incremented by 2.
1148
1149             To allow for efficient implementation strategies, agents MAY
1150             delay updating this object for short periods of time.  For
1151             example, an implementation strategy may allow internal data
1152             structures to differ from those visible via SNMP for short
1153             periods of time.  This counter may reflect the internal data
1154             structures for those short periods of time.
1155
1156             Note that the table size can be determined by subtracting
1157             dsmonPdistCtlDeletes from dsmonPdistCtlInserts."
1158     ::= { dsmonPdistCtlEntry 7 }
1159
1160 dsmonPdistCtlCreateTime OBJECT-TYPE
1161     SYNTAX     LastCreateTime
1162     MAX-ACCESS read-only
1163     STATUS     current
1164     DESCRIPTION
1165             "The value of sysUpTime when this control entry was last
1166             activated.  This can be used by the management station to
1167             detect if the table has been deleted and recreated between
1168             polls."
1169
1170
1171
1172     ::= { dsmonPdistCtlEntry 8 }
1173
1174 dsmonPdistCtlOwner OBJECT-TYPE
1175     SYNTAX      OwnerString
1176     MAX-ACCESS  read-create
1177     STATUS      current
1178     DESCRIPTION
1179             "The entity that configured this entry and is therefore
1180             using the resources assigned to it."
1181     ::= { dsmonPdistCtlEntry 9 }
1182
1183 dsmonPdistCtlStatus OBJECT-TYPE
1184     SYNTAX      RowStatus
1185     MAX-ACCESS  read-create
1186     STATUS      current
1187     DESCRIPTION
1188             "The status of this row.
1189
1190             An entry MUST NOT exist in the active state unless all
1191             objects in the entry have an appropriate value.
1192
1193             If this object is not equal to active(1), all associated
1194             entries in the dsmonPdistStatsTable shall be deleted."
1195     ::= { dsmonPdistCtlEntry 10 }
1196
1197 --
1198 -- Per-Protocol Statistics Table
1199 --
1200
1201 dsmonPdistStatsTable OBJECT-TYPE
1202     SYNTAX      SEQUENCE OF DsmonPdistStatsEntry
1203     MAX-ACCESS  not-accessible
1204     STATUS      current
1205     DESCRIPTION
1206             "A list of information on a per protocol per counter
1207             aggregation group usage.
1208
1209             If the dsmonAggControlLocked object is equal to 'false',
1210             then all entries in this table will be deleted and the agent
1211             will not process packets on behalf of any
1212             dsmonPdistCtlEntry."
1213     ::= { dsmonPdistObjects 2 }
1214
1215 dsmonPdistStatsEntry OBJECT-TYPE
1216     SYNTAX      DsmonPdistStatsEntry
1217     MAX-ACCESS  not-accessible
1218     STATUS      current
1219     DESCRIPTION
1220
1221
1222
1223             "A list of information on Differentiated Services DSCP
1224             usage, containing packet and octet counters for each counter
1225             aggregation group configured for collection, and each
1226             protocol (as identified by the protocolDirLocalIndex for the
1227             protocol) identified in each monitored packet.
1228
1229             The dsmonPdistCtlIndex value in the index identifies the
1230             dsmonPdistCtlEntry on whose behalf this entry was created.
1231
1232             Note that only packets that contain a network protocol
1233             encapsulation which contains a DS field [RFC2474] will be
1234             counted in this table.
1235
1236             The dsmonAggGroupIndex value in the index is determined by
1237             examining the DSCP value in each monitored packet, and the
1238             dsmonAggProfileTable entry for that value.
1239
1240             The protocolDirLocalIndex in the index identifies the
1241             protocolDirEntry for the protocol encapsulation of each
1242             monitored packet.  The agent will include only application
1243             layer protocols in the associated dsmonPdistStatsTable.  Any
1244             'terminal' protocol is considered to be an application
1245             protocol.
1246
1247             An example of the indexing of this entry is
1248             dsmonPdistStatsPkts.9.29943.0.42."
1249      INDEX { dsmonPdistCtlIndex,
1250              dsmonPdistTimeMark,
1251              dsmonAggGroupIndex,
1252              protocolDirLocalIndex }
1253     ::= { dsmonPdistStatsTable 1 }
1254
1255 DsmonPdistStatsEntry ::= SEQUENCE {
1256     dsmonPdistTimeMark             TimeFilter,
1257     dsmonPdistStatsPkts            ZeroBasedCounter32,
1258     dsmonPdistStatsOctets          ZeroBasedCounter32,
1259     dsmonPdistStatsOvflPkts        ZeroBasedCounter32,
1260     dsmonPdistStatsOvflOctets      ZeroBasedCounter32,
1261     dsmonPdistStatsHCPkts          ZeroBasedCounter64,
1262     dsmonPdistStatsHCOctets        ZeroBasedCounter64,
1263     dsmonPdistStatsCreateTime      LastCreateTime
1264 }
1265
1266 dsmonPdistTimeMark OBJECT-TYPE
1267     SYNTAX      TimeFilter
1268     MAX-ACCESS  not-accessible
1269     STATUS      current
1270     DESCRIPTION
1271
1272
1273
1274             "The Time Filter index for this table.  This object may be
1275             used by a management station to retrieve only rows which
1276             have been created or modified since a particular time.  Note
1277             that the current value for a row are always returned and the
1278             TimeFilter is not a historical data archiving mechanism.
1279             Refer to RFC 2021 [RFC2021] for a detailed description of
1280             TimeFilter operation."
1281     ::= { dsmonPdistStatsEntry 1 }
1282
1283 dsmonPdistStatsPkts OBJECT-TYPE
1284     SYNTAX      ZeroBasedCounter32
1285     UNITS       "packets"
1286     MAX-ACCESS  read-only
1287     STATUS      current
1288     DESCRIPTION
1289             "The number of packets, using one of the DSCP values in the
1290             indicated counter aggregation group, for the protocol
1291             identified by the associated protocolDirLocalIndex value."
1292     ::= { dsmonPdistStatsEntry 2 }
1293
1294 dsmonPdistStatsOctets OBJECT-TYPE
1295     SYNTAX      ZeroBasedCounter32
1296     UNITS       "octets"
1297     MAX-ACCESS  read-only
1298     STATUS      current
1299     DESCRIPTION
1300             "The number of octets in packets, using one of the DSCP
1301             values in the indicated counter aggregation group, for the
1302             protocol identified by the associated protocolDirLocalIndex
1303             value.
1304
1305             Note that this object doesn't count just those octets in the
1306             particular protocol frames, but includes the entire packet
1307             that contained the protocol."
1308     ::= { dsmonPdistStatsEntry 3 }
1309
1310 dsmonPdistStatsOvflPkts OBJECT-TYPE
1311     SYNTAX      ZeroBasedCounter32
1312     MAX-ACCESS  read-only
1313     STATUS      deprecated
1314     DESCRIPTION
1315             "The number of times the associated dsmonPdistStatsPkts
1316             counter has overflowed.  Note that this object will only be
1317             instantiated if the associated dsmonPdistStatsHCPkts object
1318             is also instantiated for a particular dataSource."
1319     ::= { dsmonPdistStatsEntry 4 }
1320
1321 dsmonPdistStatsOvflOctets OBJECT-TYPE
1322
1323
1324
1325     SYNTAX      ZeroBasedCounter32
1326     MAX-ACCESS  read-only
1327     STATUS      deprecated
1328     DESCRIPTION
1329             "The number of times the associated dsmonPdistStatsOctets
1330             counter has overflowed.  Note that this object will only be
1331             instantiated if the associated dsmonPdistStatsHCOctets
1332             object is also instantiated for a particular dataSource."
1333     ::= { dsmonPdistStatsEntry 5 }
1334
1335 dsmonPdistStatsHCPkts OBJECT-TYPE
1336     SYNTAX      ZeroBasedCounter64
1337     UNITS       "packets"
1338     MAX-ACCESS  read-only
1339     STATUS      current
1340     DESCRIPTION
1341             "The 64-bit version of the dsmonPdistStatsPkts object.
1342
1343             Note that this object will only be instantiated if the RMON
1344             agent supports High Capacity monitoring for a particular
1345             dataSource."
1346     ::= { dsmonPdistStatsEntry 6 }
1347
1348 dsmonPdistStatsHCOctets OBJECT-TYPE
1349     SYNTAX      ZeroBasedCounter64
1350     UNITS       "octets"
1351     MAX-ACCESS  read-only
1352     STATUS      current
1353     DESCRIPTION
1354             "The 64-bit version of the dsmonPdistStatsOctets object.
1355
1356             Note that this object will only be instantiated if the RMON
1357             agent supports High Capacity monitoring for a particular
1358             dataSource."
1359     ::= { dsmonPdistStatsEntry 7 }
1360
1361 dsmonPdistStatsCreateTime OBJECT-TYPE
1362     SYNTAX     LastCreateTime
1363     MAX-ACCESS read-only
1364     STATUS     current
1365     DESCRIPTION
1366             "The value of sysUpTime when this dsmonPdistStats entry was
1367             last instantiated by the agent.  This can be used by the
1368             management station to detect if the entry has been deleted
1369             and recreated between polls."
1370     ::= { dsmonPdistStatsEntry 8 }
1371
1372
1373
1374
1375
1376 --
1377 -- Per-Protocol Statistics TopN Control Table
1378 --
1379
1380 dsmonPdistTopNCtlTable OBJECT-TYPE
1381     SYNTAX      SEQUENCE OF DsmonPdistTopNCtlEntry
1382     MAX-ACCESS  not-accessible
1383     STATUS      current
1384     DESCRIPTION
1385             "A set of parameters that control the creation of a report
1386             of the top N dsmonPdist entries according to a particular
1387             metric.
1388
1389             Note that an agent MAY choose to limit the actual number of
1390             entries which may be created in this table.  In this case,
1391             the agent SHOULD return an error-status of
1392             'resourceUnavailable(13)', as per section 4.2.5 of the
1393             'Protocol Operations for SNMPv2' specification [RFC1905]."
1394     ::= { dsmonPdistObjects 3 }
1395
1396 dsmonPdistTopNCtlEntry OBJECT-TYPE
1397     SYNTAX      DsmonPdistTopNCtlEntry
1398     MAX-ACCESS  not-accessible
1399     STATUS      current
1400     DESCRIPTION
1401             "A conceptual row in the dsmonPdistTopNCtlTable.
1402
1403             Entries are created and deleted from this table by
1404             management action only, using the dsmonPdistTopNCtlStatus
1405             RowStatus object.
1406
1407             The agent SHOULD support non-volatile configuration of this
1408             table, and upon system initialization, the table SHOULD be
1409             initialized with the saved values.
1410
1411             Activation of a control row in this table will cause an
1412             associated dsmonPdistTopNTable to be created and maintained
1413             by the agent."
1414     INDEX { dsmonPdistTopNCtlIndex }
1415     ::= { dsmonPdistTopNCtlTable 1 }
1416
1417 DsmonPdistTopNCtlEntry ::= SEQUENCE {
1418     dsmonPdistTopNCtlIndex            Integer32,
1419     dsmonPdistTopNCtlPdistIndex       Integer32,
1420     dsmonPdistTopNCtlRateBase         INTEGER,
1421     dsmonPdistTopNCtlTimeRemaining    Integer32,
1422     dsmonPdistTopNCtlGeneratedReprts  Counter32,
1423     dsmonPdistTopNCtlDuration         Integer32,
1424
1425
1426
1427     dsmonPdistTopNCtlRequestedSize    Integer32,
1428     dsmonPdistTopNCtlGrantedSize      Integer32,
1429     dsmonPdistTopNCtlStartTime        TimeStamp,
1430     dsmonPdistTopNCtlOwner            OwnerString,
1431     dsmonPdistTopNCtlStatus           RowStatus
1432 }
1433
1434 dsmonPdistTopNCtlIndex OBJECT-TYPE
1435     SYNTAX     Integer32 (1..65535)
1436     MAX-ACCESS not-accessible
1437     STATUS     current
1438     DESCRIPTION
1439             "An index that uniquely identifies an entry in the
1440             dsmonPdistTopNCtlTable, with the same dsmonPdistTopNCtlIndex
1441             value as this object.  Each entry in this table defines one
1442             Top N report prepared on behalf of the dsmonPdistStatsEntry
1443             collection with the same dsmonPdistCtlIndex as this object."
1444     ::= { dsmonPdistTopNCtlEntry 1 }
1445
1446 dsmonPdistTopNCtlPdistIndex OBJECT-TYPE
1447     SYNTAX     Integer32 (1..65535)
1448     MAX-ACCESS read-create
1449     STATUS     current
1450     DESCRIPTION
1451             "The dsmonPdistTable for which a top N report will be
1452             prepared on behalf of this entry.  The dsmonPdistTable is
1453             identified by the value of the dsmonPdistCtlIndex for that
1454             table - that value is used here to identify the particular
1455             table.
1456
1457             This object MUST NOT be modified if the associated
1458             dsmonPdistTopNCtlStatus object is equal to active(1)."
1459     ::= { dsmonPdistTopNCtlEntry 2 }
1460
1461 dsmonPdistTopNCtlRateBase OBJECT-TYPE
1462     SYNTAX     INTEGER {
1463                   dsmonPdistTopNPkts(1),
1464                   dsmonPdistTopNOctets(2),
1465                   dsmonPdistTopNHCPkts(3),
1466                   dsmonPdistTopNHCOctets(4)
1467                }
1468     MAX-ACCESS read-create
1469     STATUS     current
1470     DESCRIPTION
1471             "The variable for each dsmonPdist that the
1472             dsmonPdistTopNRate and dsmonPdistTopNHCRate variables are
1473             based upon.  Each dsmonPdistTopN report generated on behalf
1474             of this control entry will be ranked in descending order,
1475
1476
1477
1478             based on the associated dsmonPdistStatsTable counter,
1479             identified by this object.
1480
1481             The following table identifies the dsmonPdistTable counter
1482             associated with each enumeration:
1483
1484             Enumeration              RateBase MIB Object
1485             -----------              -------------------
1486             dsmonPdistTopNPkts          dsmonPdistStatsPkts
1487             dsmonPdistTopNOctets        dsmonPdistStatsOctets
1488             dsmonPdistTopNHCPkts        dsmonPdistStatsHCPkts
1489             dsmonPdistTopNHCOctets      dsmonPdistStatsHCOctets
1490
1491             Note that the dsmonPdistTopNHCPkts and
1492             dsmonPdistTopNHCOctets enumerations are only available if
1493             the agent supports High Capacity monitoring.
1494
1495             This object MUST NOT be modified if the associated
1496             dsmonPdistTopNCtlStatus object is equal to active(1)."
1497     ::= { dsmonPdistTopNCtlEntry 3 }
1498
1499 dsmonPdistTopNCtlTimeRemaining OBJECT-TYPE
1500     SYNTAX     Integer32 (0..2147483647)
1501     UNITS      "seconds"
1502     MAX-ACCESS read-create
1503     STATUS     current
1504     DESCRIPTION
1505             "The number of seconds left in the report currently being
1506             collected.  When this object is modified by the management
1507             station, a new collection is started, possibly aborting a
1508             currently running report.  The new value is used as the
1509             requested duration of this report, and is immediately loaded
1510             into the associated dsmonPdistTopNCtlDuration object.
1511
1512             When the report finishes, the probe will automatically start
1513             another collection with the same initial value of
1514             dsmonPdistTopNCtlTimeRemaining.  Thus the management station
1515             may simply read the resulting reports repeatedly, checking
1516             the startTime and duration each time to ensure that a report
1517             was not missed or that the report parameters were not
1518             changed.
1519
1520             While the value of this object is non-zero, it decrements by
1521             one per second until it reaches zero.  At the time that this
1522             object decrements to zero, the report is made accessible in
1523             the dsmonPdistTopNTable, overwriting any report that may be
1524             there.
1525
1526
1527
1528
1529             When this object is modified by the management station, any
1530             associated entries in the dsmonPdistTopNTable shall be
1531             deleted."
1532     DEFVAL { 1800 }
1533     ::= { dsmonPdistTopNCtlEntry 4 }
1534
1535 dsmonPdistTopNCtlGeneratedReprts OBJECT-TYPE
1536     SYNTAX     Counter32
1537     UNITS      "reports"
1538     MAX-ACCESS read-only
1539     STATUS     current
1540     DESCRIPTION
1541             "The number of reports that have been generated by this
1542             entry."
1543     ::= { dsmonPdistTopNCtlEntry 5 }
1544
1545 dsmonPdistTopNCtlDuration OBJECT-TYPE
1546     SYNTAX     Integer32 (0..2147483647)
1547     UNITS      "seconds"
1548     MAX-ACCESS read-only
1549     STATUS     current
1550     DESCRIPTION
1551             "The number of seconds that this report has collected during
1552             the last sampling interval.
1553
1554             When the associated dsmonPdistTopNCtlTimeRemaining object is
1555             set, this object shall be set by the probe to the same value
1556             and shall not be modified until the next time the
1557             dsmonPdistTopNCtlTimeRemaining is set.
1558
1559             This value shall be zero if no reports have been requested
1560             for this dsmonPdistTopNCtlEntry."
1561     ::= { dsmonPdistTopNCtlEntry 6 }
1562
1563 dsmonPdistTopNCtlRequestedSize OBJECT-TYPE
1564     SYNTAX     Integer32 (0..2147483647)
1565     UNITS      "table entries"
1566     MAX-ACCESS read-create
1567     STATUS     current
1568     DESCRIPTION
1569             "The maximum number of dsmonPdist entries requested for this
1570             report.
1571
1572             When this object is created or modified, the probe SHOULD
1573             set dsmonPdistTopNCtlGrantedSize as closely to this object
1574             as is possible for the particular probe implementation and
1575             available resources."
1576     DEFVAL { 150 }
1577
1578
1579
1580     ::= { dsmonPdistTopNCtlEntry 7 }
1581
1582 dsmonPdistTopNCtlGrantedSize OBJECT-TYPE
1583     SYNTAX     Integer32 (0..2147483647)
1584     UNITS      "table entries"
1585     MAX-ACCESS read-only
1586     STATUS     current
1587     DESCRIPTION
1588             "The maximum number of dsmonPdist entries in this report.
1589
1590             When the associated dsmonPdistTopNCtlRequestedSize object is
1591             created or modified, the probe SHOULD set this object as
1592             closely to the requested value as is possible for the
1593             particular implementation and available resources.  The
1594             probe MUST NOT lower this value except as a result of a
1595             set to the associated dsmonPdistTopNCtlRequestedSize
1596             object.
1597
1598             Protocol entries with the highest value of
1599             dsmonPdistTopNRate or dsmonPdistTopNHCRate (depending on the
1600             value of the associated dsmonPdistTopNCtlRateBase object)
1601             shall be placed in this table in decreasing order of this
1602             rate until there is no more room or until there are no more
1603             dsmonPdist entries."
1604     ::= { dsmonPdistTopNCtlEntry 8 }
1605
1606 dsmonPdistTopNCtlStartTime OBJECT-TYPE
1607     SYNTAX     TimeStamp
1608     MAX-ACCESS read-only
1609     STATUS     current
1610     DESCRIPTION
1611             "The value of sysUpTime when this top N report was last
1612             started.  In other words, this is the time that the
1613             associated dsmonPdistTopNCtlTimeRemaining object was
1614             modified to start the requested report or the time the
1615             report was last automatically (re)started.
1616
1617             This object may be used by the management station to
1618             determine if a report was missed or not."
1619     ::= { dsmonPdistTopNCtlEntry 9 }
1620
1621 dsmonPdistTopNCtlOwner OBJECT-TYPE
1622     SYNTAX     OwnerString
1623     MAX-ACCESS read-create
1624     STATUS     current
1625     DESCRIPTION
1626             "The entity that configured this entry and is therefore
1627             using the resources assigned to it."
1628
1629
1630
1631     ::= { dsmonPdistTopNCtlEntry 10 }
1632
1633 dsmonPdistTopNCtlStatus OBJECT-TYPE
1634     SYNTAX     RowStatus
1635     MAX-ACCESS read-create
1636     STATUS     current
1637     DESCRIPTION
1638             "The status of this dsmonPdistTopNCtlEntry.
1639
1640             An entry MUST NOT exist in the active state unless all
1641             objects in the entry have an appropriate value.
1642
1643             If this object is not equal to active(1), all associated
1644             entries in the dsmonPdistTopNTable shall be deleted by the
1645             agent."
1646     ::= { dsmonPdistTopNCtlEntry 11 }
1647
1648 --
1649 -- dsmonPdist TopN Table
1650 --
1651
1652 dsmonPdistTopNTable OBJECT-TYPE
1653     SYNTAX     SEQUENCE OF DsmonPdistTopNEntry
1654     MAX-ACCESS not-accessible
1655     STATUS     current
1656     DESCRIPTION
1657             "A set of statistics for those protocol distribution entries
1658             that have counted the highest number of octets or packets.
1659
1660             If the dsmonAggControlLocked object is equal to 'false',
1661             then all entries in this table SHALL be deleted, and the
1662             agent will not process TopN reports on behalf of any
1663             dsmonPdistTopNCtlEntry.
1664
1665             When the dsmonAggControlLocked object is set to 'true', then
1666             particular reports SHOULD be restarted from the beginning,
1667             on behalf of all active rows in the dsmonPdistTopNCtlTable.
1668
1669             Note that dsmonPdist entries which did not increment at all
1670             during the report interval SHOULD NOT be included in
1671             dsmonPdistTopN reports."
1672     ::= { dsmonPdistObjects 4 }
1673
1674 dsmonPdistTopNEntry OBJECT-TYPE
1675     SYNTAX     DsmonPdistTopNEntry
1676     MAX-ACCESS not-accessible
1677     STATUS     current
1678     DESCRIPTION
1679
1680
1681
1682             "A conceptual row in the dsmonPdistTopNTable.
1683
1684             The dsmonPdistTopNCtlIndex value in the index identifies the
1685             dsmonPdistTopNCtlEntry on whose behalf this entry was
1686             created.  Entries in this table are ordered from 1 to 'N',
1687             where lower numbers represent higher values of the rate base
1688             object, over the report interval."
1689     INDEX { dsmonPdistTopNCtlIndex, dsmonPdistTopNIndex }
1690     ::= { dsmonPdistTopNTable 1 }
1691
1692 DsmonPdistTopNEntry ::= SEQUENCE {
1693     dsmonPdistTopNIndex                      Integer32,
1694     dsmonPdistTopNPDLocalIndex               Integer32,
1695     dsmonPdistTopNAggGroup                   DsmonCounterAggGroupIndex,
1696     dsmonPdistTopNRate                       Gauge32,
1697     dsmonPdistTopNRateOvfl                   Gauge32,
1698     dsmonPdistTopNHCRate                     CounterBasedGauge64
1699 }
1700
1701 dsmonPdistTopNIndex OBJECT-TYPE
1702     SYNTAX     Integer32 (1..2147483647)
1703     MAX-ACCESS not-accessible
1704     STATUS     current
1705     DESCRIPTION
1706             "An index that uniquely identifies an entry in the
1707             dsmonPdistTopNTable among those in the same report.  This
1708             index is between 1 and N, where N is the number of entries
1709             in this report.  Note that 'N' may change over time, and may
1710             also be less than the dsmonPdistTopNCtlGrantedSize value
1711             associated with this entry."
1712     ::= { dsmonPdistTopNEntry 1 }
1713
1714 dsmonPdistTopNPDLocalIndex OBJECT-TYPE
1715     SYNTAX     Integer32 (1..2147483647)
1716     MAX-ACCESS read-only
1717     STATUS     current
1718     DESCRIPTION
1719             "The protocolDirLocalIndex value which identifies the
1720             protocol associated with this entry.
1721
1722             If the protocolDirEntry associated with the
1723             protocolDirLocalIndex with the same value as this object is
1724             de-activated or deleted, then the agent MUST delete this
1725             dsmonPdistTopN entry."
1726     ::= { dsmonPdistTopNEntry 2 }
1727
1728 dsmonPdistTopNAggGroup OBJECT-TYPE
1729     SYNTAX      DsmonCounterAggGroupIndex
1730
1731
1732
1733     MAX-ACCESS  read-only
1734     STATUS      current
1735     DESCRIPTION
1736             "The DSCP counter aggregation group index value associated
1737             with protocol identified in this entry.  This object
1738             identifies the dsmonAggGroupEntry with the same
1739             dsmonAggControlIndex value as the associated
1740             dsmonPdistCtlAggProfile object and the same
1741             dsmonAggGroupIndex value as this object."
1742     ::= { dsmonPdistTopNEntry 3 }
1743
1744 dsmonPdistTopNRate OBJECT-TYPE
1745     SYNTAX     Gauge32
1746     MAX-ACCESS read-only
1747     STATUS     current
1748     DESCRIPTION
1749             "The amount of change in the selected variable during this
1750             sampling interval.  The selected variable is this protocol's
1751             instance of the object selected by
1752             dsmonPdistTopNCtlRateBase.
1753
1754             If the associated dsmonPdistTopNCtlRateBase is equal to
1755             'dsmonPdistTopNHCPkts' or 'dsmonPdistTopNHCOctets', then
1756             this object will contain the the least significant 32 bits
1757             of the associated dsmonPdistTopNHCRate object."
1758     ::= { dsmonPdistTopNEntry 4 }
1759
1760 dsmonPdistTopNRateOvfl OBJECT-TYPE
1761     SYNTAX     Gauge32
1762     MAX-ACCESS read-only
1763     STATUS     deprecated
1764     DESCRIPTION
1765             "The most significant 32 bits of the associated
1766             dsmonPdistTopNHCRate object.
1767
1768             If the associated dsmonPdistTopNCtlRateBase is equal to
1769             'dsmonPdistTopNHCPkts' or 'dsmonPdistTopNHCOctets', then
1770             this object will contain the upper 32 bits of the associated
1771             dsmonPdistTopNHCRate object.
1772
1773             If the associated dsmonPdistTopNCtlRateBase is equal to
1774             'dsmonPdistTopNPkts' or 'dsmonPdistTopNOctets', then this
1775             object will contain the value zero.
1776
1777             The agent MAY choose not to instantiate this object if High
1778             Capacity monitoring is not supported."
1779     ::= { dsmonPdistTopNEntry 5 }
1780
1781
1782
1783
1784 dsmonPdistTopNHCRate OBJECT-TYPE
1785     SYNTAX     CounterBasedGauge64
1786     MAX-ACCESS read-only
1787     STATUS     current
1788     DESCRIPTION
1789             "The amount of change in the selected variable during this
1790             sampling interval.  The selected variable is this protocol's
1791             instance of the object selected by
1792             dsmonPdistTopNCtlRateBase.
1793
1794             If the associated dsmonPdistTopNCtlRateBase is equal to
1795             'dsmonPdistTopNPkts' or 'dsmonPdistTopNOctets', then this
1796             object will contain the value zero, and the associated
1797             dsmonPdistTopNRate object will contain the change in the
1798             selected variable during the sampling interval.
1799
1800             The agent MAY choose not to instantiate this object if High
1801             Capacity monitoring is not supported."
1802     ::= { dsmonPdistTopNEntry 6 }
1803
1804
1805 -- ***********************************************************
1806 -- *                                                         *
1807 -- *      P E R  -  H O S T       C O L L E C T I O N S      *
1808 -- *                                                         *
1809 -- ***********************************************************
1810
1811
1812 --
1813 -- NL Host Statistics Control Table
1814 --
1815
1816 dsmonHostCtlTable OBJECT-TYPE
1817     SYNTAX      SEQUENCE OF DsmonHostCtlEntry
1818     MAX-ACCESS  not-accessible
1819     STATUS      current
1820     DESCRIPTION
1821             "Controls setup of per counter aggregation group, per
1822             network layer host distribution statistics.
1823
1824             Note that an agent MAY choose to limit the actual number of
1825             entries which may be created in this table.  In this case,
1826             the agent SHOULD return an error-status of
1827             'resourceUnavailable(13)', as per section 4.2.5 of the
1828             'Protocol Operations for SNMPv2' specification [RFC1905]."
1829     ::= { dsmonHostObjects 1 }
1830
1831 dsmonHostCtlEntry OBJECT-TYPE
1832
1833
1834
1835     SYNTAX      DsmonHostCtlEntry
1836     MAX-ACCESS  not-accessible
1837     STATUS      current
1838     DESCRIPTION
1839             "A conceptual row in the dsmonHostCtlTable.
1840
1841             Entries are created and deleted from this table by
1842             management action only, using the dsmonHostCtlStatus
1843             RowStatus object.
1844
1845             The agent SHOULD support non-volatile configuration of this
1846             table, and upon system initialization, the table SHOULD be
1847             initialized with the saved values.
1848
1849             Activation of a control row in this table will cause an
1850             associated dsmonHostTable to be created and maintained by
1851             the agent."
1852     INDEX { dsmonHostCtlIndex }
1853     ::= { dsmonHostCtlTable 1 }
1854
1855 DsmonHostCtlEntry ::= SEQUENCE {
1856     dsmonHostCtlIndex                Integer32,
1857     dsmonHostCtlDataSource           DataSource,
1858     dsmonHostCtlAggProfile           DsmonCounterAggProfileIndex,
1859     dsmonHostCtlMaxDesiredEntries    Integer32,
1860     dsmonHostCtlIPv4PrefixLen        Integer32,
1861     dsmonHostCtlIPv6PrefixLen        Integer32,
1862     dsmonHostCtlDroppedFrames        Counter32,
1863     dsmonHostCtlInserts              Counter32,
1864     dsmonHostCtlDeletes              Counter32,
1865     dsmonHostCtlCreateTime           LastCreateTime,
1866     dsmonHostCtlOwner                OwnerString,
1867     dsmonHostCtlStatus               RowStatus
1868 }
1869
1870 dsmonHostCtlIndex OBJECT-TYPE
1871     SYNTAX      Integer32 (1..65535)
1872     MAX-ACCESS  not-accessible
1873     STATUS      current
1874     DESCRIPTION
1875             "An arbitrary and unique index for this dsmonHostCtlEntry."
1876     ::= { dsmonHostCtlEntry 1 }
1877
1878 dsmonHostCtlDataSource OBJECT-TYPE
1879     SYNTAX      DataSource
1880     MAX-ACCESS  read-create
1881     STATUS      current
1882     DESCRIPTION
1883
1884
1885
1886             "The source of data for the associated dsmonHostTable.
1887
1888             Note that only packets that contain a network protocol
1889             encapsulation which contains a DS field [RFC2474] will be
1890             counted in this table.
1891
1892             This object MUST NOT be modified if the associated
1893             dsmonHostCtlStatus object is equal to active(1)."
1894     ::= { dsmonHostCtlEntry 2 }
1895
1896 dsmonHostCtlAggProfile OBJECT-TYPE
1897     SYNTAX      DsmonCounterAggProfileIndex
1898     MAX-ACCESS  read-create
1899     STATUS      current
1900     DESCRIPTION
1901             "The dsmonAggControlIndex value identifying the counter
1902             aggregation profile which should be used on behalf of this
1903             dsmonHostCtlEntry.
1904
1905             The associated dsmonAggControlEntry and
1906             dsmonAggProfileEntries, identified by the same
1907             dsmonAggControlIndex index value, MUST be active in order
1908             for this entry to remain active.  It is possible for the
1909             counter aggregation configuration to change from a valid to
1910             invalid state for this dsmonHost collection.  In this case,
1911             the associated dsmonHostCtlStatus object will be changed to
1912             the 'notReady' state, and data collection will not occur on
1913             behalf of this control entry.
1914
1915             Note that an agent MAY choose to limit the actual number of
1916             counter aggregation profiles which may be applied to a
1917             particular data source.
1918
1919             This object MUST NOT be modified if the associated
1920             dsmonHostCtlStatus object is equal to active(1)."
1921     ::= { dsmonHostCtlEntry 3 }
1922
1923 dsmonHostCtlMaxDesiredEntries OBJECT-TYPE
1924     SYNTAX      Integer32 (-1 | 1..2147483647)
1925     UNITS       "table entries"
1926     MAX-ACCESS  read-create
1927     STATUS      current
1928     DESCRIPTION
1929             "The maximum number of entries that are desired in the
1930             dsmonHostTable on behalf of this control entry.  The probe
1931             will not create more than this number of associated entries
1932             in the table, but MAY choose to create fewer entries in this
1933             table for any reason including the lack of resources.
1934
1935
1936
1937             If this value is set to -1, the probe MAY create any number
1938             of entries in this table.
1939
1940             This object MUST NOT be modified if the associated
1941             dsmonHostCtlStatus object is equal to active(1)."
1942     ::= { dsmonHostCtlEntry 4 }
1943
1944 dsmonHostCtlIPv4PrefixLen OBJECT-TYPE
1945     SYNTAX      Integer32 (8..32)
1946     UNITS       "bits"
1947     MAX-ACCESS  read-create
1948     STATUS      current
1949     DESCRIPTION
1950             "The number of 'leftmost' contiguous bits in the host
1951             address field for encapsulations of IPv4, that should be
1952             maintained in this collection.  This object controls how the
1953             dsmonHostAddress object is derived for packets which contain
1954             an encapsulation of IPv4.
1955
1956             If this object has a value less than 32, then 'm' rightmost
1957             bits, where 'm' is equal to '32 -
1958             dsmonHostCtlIPv4PrefixLen', will be cleared to zero for
1959             counting purposes only.  The 'leftmost' bit is the most
1960             significant bit of the first network-byte-order octet of the
1961             address.
1962
1963             If this object is equal to 32, then no bits are cleared in
1964             each dsmonHostAddress field.
1965
1966             This object MUST NOT be modified if the associated
1967             dsmonHostCtlStatus object is equal to active(1)."
1968     DEFVAL { 32 }
1969     ::= { dsmonHostCtlEntry 5 }
1970
1971 dsmonHostCtlIPv6PrefixLen OBJECT-TYPE
1972     SYNTAX      Integer32 (8..128)
1973     UNITS       "bits"
1974     MAX-ACCESS  read-create
1975     STATUS      current
1976     DESCRIPTION
1977             "The number of 'leftmost' contiguous bits in the host
1978             address field for encapsulations of IPv6, that should be
1979             maintained in this collection.  This object controls how the
1980             dsmonHostAddress object is derived for packets which contain
1981             an encapsulation of IPv6.
1982
1983             If this object has a value less than 128, then 'm' rightmost
1984             bits, where 'm' is equal to '128 -
1985
1986
1987
1988             dsmonHostCtlIPv6PrefixLen', will be cleared to zero for
1989             counting purposes only.  The 'leftmost' bit is the most
1990             significant bit of the first network-byte-order octet of the
1991             address.
1992
1993             If this object is equal to 128, then no bits are cleared in
1994             each dsmonHostAddress field.
1995
1996             This object MUST NOT be modified if the associated
1997             dsmonHostCtlStatus object is equal to active(1)."
1998     DEFVAL { 128 }
1999     ::= { dsmonHostCtlEntry 6 }
2000
2001 dsmonHostCtlDroppedFrames OBJECT-TYPE
2002     SYNTAX     Counter32
2003     UNITS      "frames"
2004     MAX-ACCESS read-only
2005     STATUS     current
2006     DESCRIPTION
2007             "The total number of frames which were received by the probe
2008             and therefore not accounted for in the *StatsDropEvents, but
2009             for which the probe chose not to count for the associated
2010             dsmonHost entries for whatever reason.  Most often, this
2011             event occurs when the probe is out of some resources and
2012             decides to shed load from this collection.
2013
2014             This count does not include packets that were not counted
2015             because they had MAC-layer errors.
2016
2017             Note that if the dsmonHostTable is inactive because no
2018             appropriate protocols are enabled in the protocol directory,
2019             this value SHOULD be 0.
2020
2021             Note that, unlike the dropEvents counter, this number is the
2022             exact number of frames dropped."
2023     ::= { dsmonHostCtlEntry 7 }
2024
2025 dsmonHostCtlInserts OBJECT-TYPE
2026     SYNTAX     Counter32
2027     UNITS      "table entries"
2028     MAX-ACCESS read-only
2029     STATUS     current
2030     DESCRIPTION
2031             "The number of times a dsmonHost entry has been inserted
2032             into the dsmonHost table.  If an entry is inserted, then
2033             deleted, and then inserted, this counter will be incremented
2034             by 2.
2035
2036
2037
2038
2039             To allow for efficient implementation strategies, agents MAY
2040             delay updating this object for short periods of time.  For
2041             example, an implementation strategy may allow internal data
2042             structures to differ from those visible via SNMP for short
2043             periods of time.  This counter may reflect the internal data
2044             structures for those short periods of time.
2045
2046             Note that the table size can be determined by subtracting
2047             dsmonHostCtlDeletes from dsmonHostCtlInserts."
2048     ::= { dsmonHostCtlEntry 8 }
2049
2050 dsmonHostCtlDeletes OBJECT-TYPE
2051     SYNTAX     Counter32
2052     UNITS      "table entries"
2053     MAX-ACCESS read-only
2054     STATUS     current
2055     DESCRIPTION
2056             "The number of times a dsmonHost entry has been deleted from
2057             the dsmonHost table (for any reason).  If an entry is
2058             deleted, then inserted, and then deleted, this counter will
2059             be incremented by 2.
2060
2061             To allow for efficient implementation strategies, agents MAY
2062             delay updating this object for short periods of time.  For
2063             example, an implementation strategy may allow internal data
2064             structures to differ from those visible via SNMP for short
2065             periods of time.  This counter may reflect the internal data
2066             structures for those short periods of time.
2067
2068             Note that the table size can be determined by subtracting
2069             dsmonHostCtlDeletes from dsmonHostCtlInserts."
2070     ::= { dsmonHostCtlEntry 9 }
2071
2072 dsmonHostCtlCreateTime OBJECT-TYPE
2073     SYNTAX     LastCreateTime
2074     MAX-ACCESS read-only
2075     STATUS     current
2076     DESCRIPTION
2077             "The value of sysUpTime when this control entry was last
2078             activated.  This can be used by the management station to
2079             detect if the table has been deleted and recreated between
2080             polls."
2081     ::= { dsmonHostCtlEntry 10 }
2082
2083 dsmonHostCtlOwner OBJECT-TYPE
2084     SYNTAX      OwnerString
2085     MAX-ACCESS  read-create
2086     STATUS      current
2087
2088
2089
2090     DESCRIPTION
2091             "The entity that configured this entry and is therefore
2092             using the resources assigned to it."
2093     ::= { dsmonHostCtlEntry 11 }
2094
2095 dsmonHostCtlStatus OBJECT-TYPE
2096     SYNTAX      RowStatus
2097     MAX-ACCESS  read-create
2098     STATUS      current
2099     DESCRIPTION
2100             "The status of this dsmonHostCtlEntry.
2101
2102             An entry MUST NOT exist in the active state unless all
2103             objects in the entry have an appropriate value.
2104
2105             If this object is not equal to active(1), all associated
2106             entries in the dsmonHostTable shall be deleted."
2107     ::= { dsmonHostCtlEntry 12 }
2108
2109 --
2110 -- NL Host Statistics Table
2111 --
2112
2113 dsmonHostTable OBJECT-TYPE
2114     SYNTAX      SEQUENCE OF DsmonHostEntry
2115     MAX-ACCESS  not-accessible
2116     STATUS      current
2117     DESCRIPTION
2118             "A collection of statistics for particular network protocols
2119             which contain a DS field, and that has been discovered on a
2120             particular dataSource.
2121
2122             The probe will add to this table all appropriate network
2123             protocols, for each network address seen as the source or
2124             destination address in all packets with no MAC errors, and
2125             will increment octet and packet counts in the table for all
2126             packets with no MAC errors.
2127
2128             If the dsmonAggControlLocked object is equal to 'false',
2129             then all entries in this table will be deleted, and the
2130             agent will not process packets on behalf of any
2131             dsmonHostCtlEntry."
2132     ::= { dsmonHostObjects 2 }
2133
2134 dsmonHostEntry OBJECT-TYPE
2135     SYNTAX      DsmonHostEntry
2136     MAX-ACCESS  not-accessible
2137     STATUS      current
2138
2139
2140
2141     DESCRIPTION
2142             "A list of information on Differentiated Services DSCP
2143             usage, containing packet and octet counters for each counter
2144             aggregation group index configured for collection per host
2145             address, as identified in the dsmonAggProfileTable.
2146
2147             The dsmonHostCtlIndex value in the index identifies the
2148             dsmonHostCtlEntry on whose behalf this entry was created.
2149
2150             The protocolDirLocalIndex value in the index identifies the
2151             specific network layer protocol encapsulation associated
2152             with each entry, and the network protocol type of the
2153             dsmonHostAddress object.  It MUST identify a
2154             protocolDirEntry which contains a DS field (e.g., IPv4 or
2155             IPv6).  Note that if a protocol encapsulation with multiple
2156             network layers is specified, then associated entries in this
2157             table refer to the innermost network protocol layer host
2158             address.
2159
2160             The dsmonAggGroupIndex value in the index is determined by
2161             examining the DSCP value in each monitored packet, and the
2162             dsmonAggProfileTable entry configured for that value.
2163
2164             An example of the indexing of this entry is
2165             dsmonHostOutPkts.1.27273.3.200.4.171.69.120.0"
2166     INDEX { dsmonHostCtlIndex,
2167             dsmonHostTimeMark,
2168             dsmonAggGroupIndex,
2169             protocolDirLocalIndex,
2170             dsmonHostAddress }
2171     ::= { dsmonHostTable 1 }
2172
2173 DsmonHostEntry ::= SEQUENCE {
2174     dsmonHostTimeMark              TimeFilter,
2175     dsmonHostAddress               OCTET STRING,
2176     dsmonHostInPkts                ZeroBasedCounter32,
2177     dsmonHostInOctets              ZeroBasedCounter32,
2178     dsmonHostInOvflPkts            ZeroBasedCounter32,
2179     dsmonHostInOvflOctets          ZeroBasedCounter32,
2180     dsmonHostInHCPkts              ZeroBasedCounter64,
2181     dsmonHostInHCOctets            ZeroBasedCounter64,
2182     dsmonHostOutPkts               ZeroBasedCounter32,
2183     dsmonHostOutOctets             ZeroBasedCounter32,
2184     dsmonHostOutOvflPkts           ZeroBasedCounter32,
2185     dsmonHostOutOvflOctets         ZeroBasedCounter32,
2186     dsmonHostOutHCPkts             ZeroBasedCounter64,
2187     dsmonHostOutHCOctets           ZeroBasedCounter64,
2188     dsmonHostCreateTime            LastCreateTime
2189
2190
2191
2192 }
2193
2194 dsmonHostTimeMark OBJECT-TYPE
2195     SYNTAX      TimeFilter
2196     MAX-ACCESS  not-accessible
2197     STATUS      current
2198     DESCRIPTION
2199             "The Time Filter index for this table.  This object may be
2200             used by a management station to retrieve only rows which
2201             have been created or modified since a particular time.  Note
2202             that the current value for a row are always returned and the
2203             TimeFilter is not a historical data archiving mechanism.
2204             Refer to RFC 2021 [RFC2021] for a detailed description of
2205             TimeFilter operation."
2206     ::= { dsmonHostEntry 1 }
2207
2208 dsmonHostAddress OBJECT-TYPE
2209     SYNTAX      OCTET STRING (SIZE (0..110))
2210     MAX-ACCESS  not-accessible
2211     STATUS      current
2212     DESCRIPTION
2213             "The network address for this dsmonHostEntry.
2214
2215             This object is encoded according to the protocol type
2216             indicated by the protocolDirLocalIndex value in the index.
2217
2218             In addition, this object may have some 'rightmost' bits
2219             cleared to zero for counting purposes, as indicated by the
2220             associated dsmonHostCtlIPv4PrefixLen or
2221             dsmonHostCtlIPv6PrefixLen objects."
2222     ::= { dsmonHostEntry 2 }
2223
2224 dsmonHostInPkts OBJECT-TYPE
2225     SYNTAX      ZeroBasedCounter32
2226     UNITS       "packets"
2227     MAX-ACCESS  read-only
2228     STATUS      current
2229     DESCRIPTION
2230             "The number of packets without errors, using one of the DSCP
2231             values in the indicated counter aggregation group, and
2232             transmitted to this address, since this entry was added to
2233             the dsmonHostTable.  Note that this is the number of link-
2234             layer packets, so if a single network-layer packet is
2235             fragmented into several link-layer frames, this counter is
2236             incremented several times."
2237     ::= { dsmonHostEntry 3 }
2238
2239 dsmonHostInOctets OBJECT-TYPE
2240
2241
2242
2243     SYNTAX      ZeroBasedCounter32
2244     UNITS       "octets"
2245     MAX-ACCESS  read-only
2246     STATUS      current
2247     DESCRIPTION
2248             "The number of octets in all packets, transmitted to this
2249             address and using one of the DSCP values in the indicated
2250             counter aggregation group, since this entry was added to the
2251             dsmonHostTable (excluding framing bits but including FCS
2252             octets), excluding those octets in packets that contained
2253             errors.
2254
2255             Note this doesn't count just those octets in the particular
2256             protocol frames, but includes the entire packet that
2257             contained the protocol."
2258     ::= { dsmonHostEntry 4 }
2259
2260 dsmonHostInOvflPkts OBJECT-TYPE
2261     SYNTAX      ZeroBasedCounter32
2262     MAX-ACCESS  read-only
2263     STATUS      deprecated
2264     DESCRIPTION
2265             "The number of times the associated dsmonHostInPkts counter
2266             has overflowed.  Note that this object will only be
2267             instantiated if the associated dsmonHostInHCPkts object is
2268             also instantiated for a particular dataSource."
2269     ::= { dsmonHostEntry 5 }
2270
2271 dsmonHostInOvflOctets OBJECT-TYPE
2272     SYNTAX      ZeroBasedCounter32
2273     MAX-ACCESS  read-only
2274     STATUS      deprecated
2275     DESCRIPTION
2276             "The number of times the associated dsmonHostInOctets
2277             counter has overflowed.  Note that this object will only be
2278             instantiated if the associated dsmonHostInHCOctets object is
2279             also instantiated for a particular dataSource."
2280     ::= { dsmonHostEntry 6 }
2281
2282 dsmonHostInHCPkts OBJECT-TYPE
2283     SYNTAX      ZeroBasedCounter64
2284     UNITS       "packets"
2285     MAX-ACCESS  read-only
2286     STATUS      current
2287     DESCRIPTION
2288             "The 64-bit version of the dsmonHostInPkts object.
2289
2290             Note that this object will only be instantiated if the RMON
2291
2292
2293
2294             agent supports High Capacity monitoring for a particular
2295             dataSource."
2296     ::= { dsmonHostEntry 7 }
2297
2298 dsmonHostInHCOctets OBJECT-TYPE
2299     SYNTAX      ZeroBasedCounter64
2300     UNITS       "octets"
2301     MAX-ACCESS  read-only
2302     STATUS      current
2303     DESCRIPTION
2304             "The 64-bit version of the dsmonHostInOctets object.
2305
2306             Note that this object will only be instantiated if the RMON
2307             agent supports High Capacity monitoring for a particular
2308             dataSource."
2309     ::= { dsmonHostEntry 8 }
2310
2311 dsmonHostOutPkts OBJECT-TYPE
2312     SYNTAX      ZeroBasedCounter32
2313     UNITS       "packets"
2314     MAX-ACCESS  read-only
2315     STATUS      current
2316     DESCRIPTION
2317             "The number of packets without errors, using one of the DSCP
2318             values in the indicated counter aggregation group, and
2319             transmitted by this address, since this entry was added to
2320             the dsmonHostTable.  Note that this is the number of link-
2321             layer packets, so if a single network-layer packet is
2322             fragmented into several link-layer frames, this counter is
2323             incremented several times."
2324     ::= { dsmonHostEntry 9 }
2325
2326 dsmonHostOutOctets OBJECT-TYPE
2327     SYNTAX      ZeroBasedCounter32
2328     UNITS       "octets"
2329     MAX-ACCESS  read-only
2330     STATUS      current
2331     DESCRIPTION
2332             "The number of octets, transmitted by this address and using
2333             one of the DSCP values in the identified counter aggregation
2334             group, since this entry was added to the dsmonHostTable
2335             (excluding framing bits but including FCS octets), excluding
2336             those octets in packets that contained errors.
2337
2338             Note this doesn't count just those octets in the particular
2339             protocol frames, but includes the entire packet that
2340             contained the protocol."
2341     ::= { dsmonHostEntry 10 }
2342
2343
2344
2345 dsmonHostOutOvflPkts OBJECT-TYPE
2346     SYNTAX      ZeroBasedCounter32
2347     MAX-ACCESS  read-only
2348     STATUS      deprecated
2349     DESCRIPTION
2350             "The number of times the associated dsmonHostOutPkts counter
2351             has overflowed.  Note that this object will only be
2352             instantiated if the associated dsmonHostOutHCPkts object is
2353             also instantiated for a particular dataSource."
2354     ::= { dsmonHostEntry 11 }
2355
2356 dsmonHostOutOvflOctets OBJECT-TYPE
2357     SYNTAX      ZeroBasedCounter32
2358     MAX-ACCESS  read-only
2359     STATUS      deprecated
2360     DESCRIPTION
2361             "The number of times the associated dsmonHostOutOctets
2362             counter has overflowed.  Note that this object will only be
2363             instantiated if the associated dsmonHostOutHCOctets object
2364             is also instantiated for a particular dataSource."
2365     ::= { dsmonHostEntry 12 }
2366
2367 dsmonHostOutHCPkts OBJECT-TYPE
2368     SYNTAX      ZeroBasedCounter64
2369     UNITS       "packets"
2370     MAX-ACCESS  read-only
2371     STATUS      current
2372     DESCRIPTION
2373             "The 64-bit version of the dsmonHostOutPkts object.
2374
2375             Note that this object will only be instantiated if the RMON
2376             agent supports High Capacity monitoring for a particular
2377             dataSource."
2378     ::= { dsmonHostEntry 13 }
2379
2380 dsmonHostOutHCOctets OBJECT-TYPE
2381     SYNTAX      ZeroBasedCounter64
2382     UNITS       "octets"
2383     MAX-ACCESS  read-only
2384     STATUS      current
2385     DESCRIPTION
2386             "The 64-bit version of the dsmonHostOutOctets object.
2387
2388             Note that this object will only be instantiated if the RMON
2389             agent supports High Capacity monitoring for a particular
2390             dataSource."
2391     ::= { dsmonHostEntry 14 }
2392
2393
2394
2395
2396 dsmonHostCreateTime OBJECT-TYPE
2397     SYNTAX     LastCreateTime
2398     MAX-ACCESS read-only
2399     STATUS     current
2400     DESCRIPTION
2401             "The value of sysUpTime when this dsmonHost entry was last
2402             instantiated by the agent.  This can be used by the
2403             management station to ensure that the entry has not been
2404             deleted and recreated between polls."
2405     ::= { dsmonHostEntry 15 }
2406
2407
2408 --
2409 -- Per-Protocol Per-Host NL Statistics TopN Control Table
2410 --
2411
2412 dsmonHostTopNCtlTable OBJECT-TYPE
2413     SYNTAX      SEQUENCE OF DsmonHostTopNCtlEntry
2414     MAX-ACCESS  not-accessible
2415     STATUS      current
2416     DESCRIPTION
2417             "A set of parameters that control the creation of a report
2418             of the top N dsmonHost entries according to a selected
2419             metric.
2420
2421             Note that an agent MAY choose to limit the actual number of
2422             entries which may be created in this table.  In this case,
2423             the agent SHOULD return an error-status of
2424             'resourceUnavailable(13)', as per section 4.2.5 of the
2425             'Protocol Operations for SNMPv2' specification [RFC1905]."
2426     ::= { dsmonHostObjects 3 }
2427
2428 dsmonHostTopNCtlEntry OBJECT-TYPE
2429     SYNTAX      DsmonHostTopNCtlEntry
2430     MAX-ACCESS  not-accessible
2431     STATUS      current
2432     DESCRIPTION
2433             "A conceptual row in the dsmonHostTopNCtlTable.
2434
2435             Entries are created and deleted from this table by
2436             management action only, using the dsmonHostTopNCtlStatus
2437             RowStatus object.
2438
2439             The agent SHOULD support non-volatile configuration of this
2440             table, and upon system initialization, the table SHOULD be
2441             initialized with the saved values.
2442
2443             Activation of a control row in this table will cause an
2444
2445
2446
2447             associated dsmonHostTopNTable to be created and maintained
2448             by the agent."
2449     INDEX { dsmonHostTopNCtlIndex }
2450     ::= { dsmonHostTopNCtlTable 1 }
2451
2452 DsmonHostTopNCtlEntry ::= SEQUENCE {
2453     dsmonHostTopNCtlIndex            Integer32,
2454     dsmonHostTopNCtlHostIndex        Integer32,
2455     dsmonHostTopNCtlRateBase         INTEGER,
2456     dsmonHostTopNCtlTimeRemaining    Integer32,
2457     dsmonHostTopNCtlGeneratedReports Counter32,
2458     dsmonHostTopNCtlDuration         Integer32,
2459     dsmonHostTopNCtlRequestedSize    Integer32,
2460     dsmonHostTopNCtlGrantedSize      Integer32,
2461     dsmonHostTopNCtlStartTime        TimeStamp,
2462     dsmonHostTopNCtlOwner            OwnerString,
2463     dsmonHostTopNCtlStatus           RowStatus
2464 }
2465
2466 dsmonHostTopNCtlIndex OBJECT-TYPE
2467     SYNTAX     Integer32 (1..65535)
2468     MAX-ACCESS not-accessible
2469     STATUS     current
2470     DESCRIPTION
2471             "An index that uniquely identifies an entry in the
2472             dsmonHostTopNCtlTable.  Each such entry defines one Top N
2473             report prepared for one RMON dataSource."
2474     ::= { dsmonHostTopNCtlEntry 1 }
2475
2476 dsmonHostTopNCtlHostIndex OBJECT-TYPE
2477     SYNTAX     Integer32 (1..65535)
2478     MAX-ACCESS read-create
2479     STATUS     current
2480     DESCRIPTION
2481             "The dsmonHostTable for which a top N report will be
2482             prepared on behalf of this entry.  The dsmonHostTable is
2483             identified by the value of the dsmonHostCtlIndex for that
2484             table - that value is used here to identify the particular
2485             table.
2486
2487             This object MUST NOT be modified if the associated
2488             dsmonHostTopNCtlStatus object is equal to active(1)."
2489     ::= { dsmonHostTopNCtlEntry 2 }
2490
2491 dsmonHostTopNCtlRateBase OBJECT-TYPE
2492     SYNTAX     INTEGER {
2493                   dsmonHostTopNInPkts(1),
2494                   dsmonHostTopNInOctets(2),
2495
2496
2497
2498                   dsmonHostTopNOutPkts(3),
2499                   dsmonHostTopNOutOctets(4),
2500                   dsmonHostTopNTotalPkts(5),
2501                   dsmonHostTopNTotalOctets(6),
2502                   dsmonHostTopNInHCPkts(7),
2503                   dsmonHostTopNInHCOctets(8),
2504                   dsmonHostTopNOutHCPkts(9),
2505                   dsmonHostTopNOutHCOctets(10),
2506                   dsmonHostTopNTotalHCPkts(11),
2507                   dsmonHostTopNTotalHCOctets(12)
2508                }
2509     MAX-ACCESS read-create
2510     STATUS     current
2511     DESCRIPTION
2512             "The variable(s) for each dsmonHost that the
2513             dsmonHostTopNRate and dsmonHostTopNHCRate variables are
2514             based upon.  Each dsmonHostTopN report generated on behalf
2515             of this control entry will be ranked in descending order,
2516             based on the associated dsmonHostTable counter(s),
2517             identified by this object.
2518
2519             The following table identifies the dsmonHostTable counters
2520             associated with each enumeration:
2521
2522             Enumeration              RateBase MIB Objects
2523             -----------              --------------------
2524             dsmonHostTopNInPkts         dsmonHostInPkts
2525             dsmonHostTopNInOctets       dsmonHostInOctets
2526             dsmonHostTopNOutPkts        dsmonHostOutPkts
2527             dsmonHostTopNOutOctets      dsmonHostOutOctets
2528             dsmonHostTopNTotalPkts      dsmonHostInPkts +
2529                                           dsmonHostOutPkts
2530             dsmonHostTopNTotalOctets    dsmonHostInOctets +
2531                                           dsmonHostOutOctets
2532             dsmonHostTopNInHCPkts       dsmonHostInHCPkts
2533             dsmonHostTopNInHCOctets     dsmonHostInHCOctets
2534             dsmonHostTopNOutHCPkts      dsmonHostOutHCPkts
2535             dsmonHostTopNOutHCOctets    dsmonHostOutHCPkts
2536             dsmonHostTopNTotalHCPkts    dsmonHostInHCPkts +
2537                                           dsmonHostOutHCPkts
2538             dsmonHostTopNTotalHCOctets  dsmonHostInHCOctets +
2539                                           dsmonHostOutHCOctets
2540
2541             The following enumerations are only available if the agent
2542             supports High Capacity monitoring:
2543
2544             dsmonHostTopNInHCPkts
2545             dsmonHostTopNInHCOctets
2546
2547
2548
2549             dsmonHostTopNOutHCPkts
2550             dsmonHostTopNOutHCOctets
2551             dsmonHostTopNTotalHCPkts
2552             dsmonHostTopNTotalHCOctets
2553
2554             It is an implementation-specific matter whether an agent can
2555             detect an overflow condition resulting from the addition of
2556             two counter delta values for the following enumerations:
2557
2558             dsmonHostTopNTotalPkts
2559             dsmonHostTopNTotalOctets
2560             dsmonHostTopNTotalHCPkts
2561             dsmonHostTopNTotalHCOctets
2562
2563             In the event such an overflow condition can be detected by
2564             the agent, the associated dsmonHostTopNRate,
2565             dsmonHostTopNRateOvfl, and/or dsmonHostTopNHCRate objects
2566             should be set to their maximum value.
2567
2568             This object MUST NOT be modified if the associated
2569             dsmonHostTopNCtlStatus object is equal to active(1)."
2570     ::= { dsmonHostTopNCtlEntry 3 }
2571
2572 dsmonHostTopNCtlTimeRemaining OBJECT-TYPE
2573     SYNTAX     Integer32 (0..2147483647)
2574     UNITS      "seconds"
2575     MAX-ACCESS read-create
2576     STATUS     current
2577     DESCRIPTION
2578             "The number of seconds left in the report currently being
2579             collected.  When this object is modified by the management
2580             station, a new collection is started, possibly aborting a
2581             currently running report.  The new value is used as the
2582             requested duration of this report, and is immediately loaded
2583             into the associated dsmonHostTopNCtlDuration object.
2584
2585             When the report finishes, the probe will automatically start
2586             another collection with the same initial value of
2587             dsmonHostTopNCtlTimeRemaining.  Thus the management station
2588             may simply read the resulting reports repeatedly, checking
2589             the startTime and duration each time to ensure that a report
2590             was not missed or that the report parameters were not
2591             changed.
2592
2593             While the value of this object is non-zero, it decrements by
2594             one per second until it reaches zero.  At the time that this
2595             object decrements to zero, the report is made accessible in
2596             the dsmonHostTopNTable, overwriting any report that may be
2597
2598
2599
2600             there.
2601
2602             When this object is modified by the management station, any
2603             associated entries in the dsmonHostTopNTable shall be
2604             deleted."
2605     DEFVAL { 1800 }
2606     ::= { dsmonHostTopNCtlEntry 4 }
2607
2608 dsmonHostTopNCtlGeneratedReports OBJECT-TYPE
2609     SYNTAX     Counter32
2610     UNITS      "reports"
2611     MAX-ACCESS read-only
2612     STATUS     current
2613     DESCRIPTION
2614             "The number of reports that have been generated by this
2615             entry."
2616     ::= { dsmonHostTopNCtlEntry 5 }
2617
2618 dsmonHostTopNCtlDuration OBJECT-TYPE
2619     SYNTAX     Integer32 (0..2147483647)
2620     UNITS      "seconds"
2621     MAX-ACCESS read-only
2622     STATUS     current
2623     DESCRIPTION
2624             "The number of seconds that this report has collected during
2625             the last sampling interval.
2626
2627             When the associated dsmonHostTopNCtlTimeRemaining object is
2628             set, this object shall be set by the probe to the same value
2629             and shall not be modified until the next time the
2630             dsmonHostTopNCtlTimeRemaining is set.
2631
2632             This value shall be zero if no reports have been requested
2633             for this dsmonHostTopNCtlEntry."
2634     ::= { dsmonHostTopNCtlEntry 6 }
2635
2636 dsmonHostTopNCtlRequestedSize OBJECT-TYPE
2637     SYNTAX     Integer32 (0..2147483647)
2638     UNITS      "table entries"
2639     MAX-ACCESS read-create
2640     STATUS     current
2641     DESCRIPTION
2642             "The maximum number of dsmonHost entries requested for this
2643             report.
2644
2645             When this object is created or modified, the probe SHOULD
2646             set dsmonHostTopNCtlGrantedSize as closely to this object as
2647             is possible for the particular probe implementation and
2648
2649
2650
2651             available resources."
2652     DEFVAL { 150 }
2653     ::= { dsmonHostTopNCtlEntry 7 }
2654
2655 dsmonHostTopNCtlGrantedSize OBJECT-TYPE
2656     SYNTAX     Integer32 (0..2147483647)
2657     UNITS      "table entries"
2658     MAX-ACCESS read-only
2659     STATUS     current
2660     DESCRIPTION
2661             "The maximum number of dsmonHost entries in this report.
2662
2663             When the associated dsmonHostTopNCtlRequestedSize object is
2664             created or modified, the probe SHOULD set this object as
2665             closely to the requested value as is possible for the
2666             particular implementation and available resources.  The
2667             probe MUST NOT lower this value except as a result of a
2668             set to the associated dsmonHostTopNCtlRequestedSize
2669             object.
2670
2671             Protocol entries with the highest value of dsmonHostTopNRate
2672             or dsmonHostTopNHCRate (depending on the value of the
2673             associated dsmonHostTopNCtlRateBase object) shall be placed
2674             in this table in decreasing order of this rate until there
2675             is no more room or until there are no more dsmonHost
2676             entries."
2677     ::= { dsmonHostTopNCtlEntry 8 }
2678
2679 dsmonHostTopNCtlStartTime OBJECT-TYPE
2680     SYNTAX     TimeStamp
2681     MAX-ACCESS read-only
2682     STATUS     current
2683     DESCRIPTION
2684             "The value of sysUpTime when this top N report was last
2685             started.  In other words, this is the time that the
2686             associated dsmonHostTopNCtlTimeRemaining object was modified
2687             to start the requested report or the time the report was
2688             last automatically (re)started.
2689
2690             This object may be used by the management station to
2691             determine if a report was missed or not."
2692     ::= { dsmonHostTopNCtlEntry 9 }
2693
2694 dsmonHostTopNCtlOwner OBJECT-TYPE
2695     SYNTAX     OwnerString
2696     MAX-ACCESS read-create
2697     STATUS     current
2698     DESCRIPTION
2699
2700
2701
2702             "The entity that configured this entry and is therefore
2703             using the resources assigned to it."
2704     ::= { dsmonHostTopNCtlEntry 10 }
2705
2706 dsmonHostTopNCtlStatus OBJECT-TYPE
2707     SYNTAX     RowStatus
2708     MAX-ACCESS read-create
2709     STATUS     current
2710     DESCRIPTION
2711             "The status of this dsmonHostTopNCtlEntry.
2712
2713             An entry MUST NOT exist in the active state unless all
2714             objects in the entry have an appropriate value.
2715
2716             If this object is not equal to active(1), all associated
2717             entries in the dsmonHostTopNTable shall be deleted by the
2718             agent."
2719     ::= { dsmonHostTopNCtlEntry 11 }
2720
2721 --
2722 -- dsmonHost TopN Table
2723 --
2724
2725 dsmonHostTopNTable OBJECT-TYPE
2726     SYNTAX     SEQUENCE OF DsmonHostTopNEntry
2727     MAX-ACCESS not-accessible
2728     STATUS     current
2729     DESCRIPTION
2730             "A set of statistics for those dsmonHost entries that have
2731             counted the highest number of octets or packets.
2732
2733             If the dsmonAggControlLocked object is equal to 'false',
2734             then all entries in this table SHALL be deleted, and the
2735             agent will not process TopN reports on behalf of any
2736             dsmonHostTopNCtlEntry.
2737
2738             When the dsmonAggControlLocked object is set to 'true', then
2739             particular reports SHOULD be restarted from the beginning,
2740             on behalf of all active rows in the dsmonHostTopNCtlTable.
2741
2742             Note that dsmonHost entries which did not increment at all
2743             during the report interval SHOULD NOT be included in
2744             dsmonHostTopN reports."
2745     ::= { dsmonHostObjects 4 }
2746
2747 dsmonHostTopNEntry OBJECT-TYPE
2748     SYNTAX     DsmonHostTopNEntry
2749     MAX-ACCESS not-accessible
2750
2751
2752
2753     STATUS     current
2754     DESCRIPTION
2755             "A conceptual row in the dsmonHostTopNTable.
2756
2757             The dsmonHostTopNCtlIndex value in the index identifies the
2758             dsmonHostTopNCtlEntry on whose behalf this entry was
2759             created.
2760
2761             Entries in this table are ordered from 1 to 'N', where lower
2762             numbers represent higher values of the rate base object,
2763             over the report interval."
2764     INDEX { dsmonHostTopNCtlIndex, dsmonHostTopNIndex }
2765     ::= { dsmonHostTopNTable 1 }
2766
2767 DsmonHostTopNEntry ::= SEQUENCE {
2768     dsmonHostTopNIndex                Integer32,
2769     dsmonHostTopNPDLocalIndex         Integer32,
2770     dsmonHostTopNAddress              OCTET STRING,
2771     dsmonHostTopNAggGroup             DsmonCounterAggGroupIndex,
2772     dsmonHostTopNRate                 Gauge32,
2773     dsmonHostTopNRateOvfl             Gauge32,
2774     dsmonHostTopNHCRate               CounterBasedGauge64
2775   }
2776
2777 dsmonHostTopNIndex OBJECT-TYPE
2778     SYNTAX     Integer32 (1..2147483647)
2779     MAX-ACCESS not-accessible
2780     STATUS     current
2781     DESCRIPTION
2782             "An index that uniquely identifies an entry in the
2783             dsmonHostTopNTable among those in the same report.  This
2784             index is between 1 and N, where N is the number of entries
2785             in this report."
2786     ::= { dsmonHostTopNEntry 1 }
2787
2788 dsmonHostTopNPDLocalIndex OBJECT-TYPE
2789     SYNTAX     Integer32 (1..2147483647)
2790     MAX-ACCESS read-only
2791     STATUS     current
2792     DESCRIPTION
2793             "The protocolDirLocalIndex value which identifies the
2794             protocol associated with the dsmonHostTopNAddress object in
2795             this entry.
2796
2797             If the protocolDirEntry associated with the
2798             protocolDirLocalIndex with the same value as this object is
2799             de-activated or deleted, then the agent MUST delete this
2800             dsmonHostTopN entry."
2801
2802
2803
2804     ::= { dsmonHostTopNEntry 2 }
2805
2806 dsmonHostTopNAddress OBJECT-TYPE
2807     SYNTAX     OCTET STRING
2808     MAX-ACCESS read-only
2809     STATUS     current
2810     DESCRIPTION
2811             "The dsmonHostAddress value for the network host identified
2812             in this entry.  The associated dsmonHostTopNPDLocalIndex
2813             object identifies the network protocol type and the encoding
2814             rules for this object."
2815     ::= { dsmonHostTopNEntry 3 }
2816
2817 dsmonHostTopNAggGroup OBJECT-TYPE
2818     SYNTAX      DsmonCounterAggGroupIndex
2819     MAX-ACCESS  read-only
2820     STATUS      current
2821     DESCRIPTION
2822             "The counter aggregation group index value associated with
2823             host identified in this entry.  This object identifies the
2824             dsmonAggGroupEntry with the same dsmonAggControlIndex value
2825             as the associated dsmonHostCtlAggProfile object and the same
2826             dsmonAggGroupIndex value as this object."
2827     ::= { dsmonHostTopNEntry 4 }
2828
2829 dsmonHostTopNRate OBJECT-TYPE
2830     SYNTAX     Gauge32
2831     MAX-ACCESS read-only
2832     STATUS     current
2833     DESCRIPTION
2834             "The amount of change in the selected variable during this
2835             sampling interval.  The selected variable is this host's
2836             instance of the object selected by dsmonHostTopNCtlRateBase.
2837
2838             If the associated dsmonHostTopNCtlRateBase indicates a High
2839             Capacity monitoring enumeration, (e.g.
2840             'dsmonHostTopNInHCPkts'), then this object will contain the
2841             the least significant 32 bits of the associated
2842             dsmonHostTopNHCRate object."
2843     ::= { dsmonHostTopNEntry 5 }
2844
2845 dsmonHostTopNRateOvfl OBJECT-TYPE
2846     SYNTAX     Gauge32
2847     MAX-ACCESS read-only
2848     STATUS     deprecated
2849     DESCRIPTION
2850             "The most significant 32 bits of the associated
2851             dsmonHostTopNHCRate object.
2852
2853
2854
2855             If the associated dsmonHostTopNCtlRateBase is equal to any
2856             of the High Capacity monitoring enumerations (e.g.
2857             'dsmonHostTopNInHCPkts'), then this object will contain the
2858             upper 32 bits of the associated dsmonHostTopNHCRate object.
2859
2860             If the associated dsmonHostTopNCtlRateBase is not equal to
2861             any of High Capacity monitoring enumerations, then this
2862             object will contain the value zero.
2863
2864             The agent MAY choose not to instantiate this object if High
2865             Capacity monitoring is not supported."
2866     ::= { dsmonHostTopNEntry 6 }
2867
2868 dsmonHostTopNHCRate OBJECT-TYPE
2869     SYNTAX     CounterBasedGauge64
2870     MAX-ACCESS read-only
2871     STATUS     current
2872     DESCRIPTION
2873             "The amount of change in the selected variable during this
2874             sampling interval.  The selected variable is this host's
2875             instance of the object selected by dsmonHostTopNCtlRateBase.
2876
2877             If the associated dsmonHostTopNCtlRateBase is not equal to
2878             any of the High Capacity monitoring enumerations (e.g.,
2879             'dsmonHostTopNInPkts'), then this object will contain the
2880             value zero, and the associated dsmonHostTopNRate object will
2881             contain the change in the selected variable during the
2882             sampling interval.
2883
2884             The agent MAY choose not to instantiate this object if High
2885             Capacity monitoring is not supported."
2886     ::= { dsmonHostTopNEntry 7 }
2887
2888
2889 -- **************************************************************
2890 -- *                                                            *
2891 -- *   P E R  -  C O N V E R S I O N    C O L L E C T I O N S   *
2892 -- *                                                            *
2893 -- **************************************************************
2894
2895 --
2896 -- AL Matrix Statistics Control Table
2897 --
2898
2899 dsmonMatrixCtlTable OBJECT-TYPE
2900     SYNTAX      SEQUENCE OF DsmonMatrixCtlEntry
2901     MAX-ACCESS  not-accessible
2902     STATUS      current
2903
2904
2905
2906     DESCRIPTION
2907             "Controls setup of per counter aggregation group, per host-
2908             pair, application protocol distribution statistics.
2909
2910             Note that an agent MAY choose to limit the actual number of
2911             entries which may be created in this table.  In this case,
2912             the agent SHOULD return an error-status of
2913             'resourceUnavailable(13)', as per section 4.2.5 of the
2914             'Protocol Operations for SNMPv2' specification [RFC1905]."
2915     ::= { dsmonMatrixObjects 1 }
2916
2917 dsmonMatrixCtlEntry OBJECT-TYPE
2918     SYNTAX      DsmonMatrixCtlEntry
2919     MAX-ACCESS  not-accessible
2920     STATUS      current
2921     DESCRIPTION
2922             "A conceptual row in the dsmonMatrixCtlTable.
2923
2924             Entries are created and deleted from this table by
2925             management action only, using the dsmonMatrixCtlStatus
2926             RowStatus object.
2927
2928             The agent SHOULD support non-volatile configuration of this
2929             table, and upon system initialization, the table SHOULD be
2930             initialized with the saved values.
2931
2932             Activation of a control row in this table will cause an
2933             associated dsmonMatrixSDTable and dsmonMatrixDSTable to be
2934             created and maintained by the agent."
2935     INDEX { dsmonMatrixCtlIndex }
2936     ::= { dsmonMatrixCtlTable 1 }
2937
2938 DsmonMatrixCtlEntry ::= SEQUENCE {
2939     dsmonMatrixCtlIndex                Integer32,
2940     dsmonMatrixCtlDataSource           DataSource,
2941     dsmonMatrixCtlAggProfile           DsmonCounterAggProfileIndex,
2942     dsmonMatrixCtlMaxDesiredEntries    Integer32,
2943     dsmonMatrixCtlDroppedFrames        Counter32,
2944     dsmonMatrixCtlInserts              Counter32,
2945     dsmonMatrixCtlDeletes              Counter32,
2946     dsmonMatrixCtlCreateTime           LastCreateTime,
2947     dsmonMatrixCtlOwner                OwnerString,
2948     dsmonMatrixCtlStatus               RowStatus
2949 }
2950
2951 dsmonMatrixCtlIndex OBJECT-TYPE
2952     SYNTAX      Integer32 (1..65535)
2953     MAX-ACCESS  not-accessible
2954
2955
2956
2957     STATUS      current
2958     DESCRIPTION
2959             "An arbitrary and unique index for this
2960             dsmonMatrixCtlEntry."
2961     ::= { dsmonMatrixCtlEntry 1 }
2962
2963 dsmonMatrixCtlDataSource OBJECT-TYPE
2964     SYNTAX      DataSource
2965     MAX-ACCESS  read-create
2966     STATUS      current
2967     DESCRIPTION
2968             "The source of data for the associated dsmonMatrixSDTable
2969             and dsmonMatrixDSTable.
2970
2971             Note that only packets that contain a network protocol
2972             encapsulation which contains a DS field [RFC2474] will be
2973             counted in this table.
2974
2975             This object MUST NOT be modified if the associated
2976             dsmonMatrixCtlStatus object is equal to active(1)."
2977     ::= { dsmonMatrixCtlEntry 2 }
2978
2979 dsmonMatrixCtlAggProfile OBJECT-TYPE
2980     SYNTAX      DsmonCounterAggProfileIndex
2981     MAX-ACCESS  read-create
2982     STATUS      current
2983     DESCRIPTION
2984             "The dsmonAggControlIndex value identifying the counter
2985             aggregation profile which should be used on behalf of this
2986             dsmonMatrixCtlEntry.
2987
2988             The associated dsmonAggControlEntry and
2989             dsmonAggProfileEntries, identified by the same
2990             dsmonAggControlIndex index value, MUST be active in order
2991             for this entry to remain active.  It is possible for the
2992             counter aggregation configuration to change from a valid to
2993             invalid state for this dsmonMatrix collection.  In this
2994             case, the associated dsmonMatrixCtlStatus object will be
2995             changed to the 'notReady' state, and data collection will
2996             not occur on behalf of this control entry.
2997
2998             Note that an agent MAY choose to limit the actual number of
2999             counter aggregation profiles which may be applied to a
3000             particular data source.
3001
3002             This object MUST NOT be modified if the associated
3003             dsmonMatrixCtlStatus object is equal to active(1)."
3004     ::= { dsmonMatrixCtlEntry 3 }
3005
3006
3007
3008 dsmonMatrixCtlMaxDesiredEntries OBJECT-TYPE
3009     SYNTAX      Integer32 (-1 | 1..2147483647)
3010     UNITS       "table entries"
3011     MAX-ACCESS  read-create
3012     STATUS      current
3013     DESCRIPTION
3014             "The maximum number of entries that are desired in the
3015             dsmonMatrix tables on behalf of this control entry.  The
3016             probe will not create more than this number of associated
3017             entries in these tables, but may choose to create fewer
3018             entries in this table for any reason including the lack of
3019             resources.
3020
3021             If this value is set to -1, the probe may create any number
3022             of entries in this table.
3023
3024             This object MUST NOT be modified if the associated
3025             dsmonMatrixCtlStatus object is equal to active(1)."
3026     ::= { dsmonMatrixCtlEntry 4 }
3027
3028 dsmonMatrixCtlDroppedFrames OBJECT-TYPE
3029     SYNTAX     Counter32
3030     UNITS      "frames"
3031     MAX-ACCESS read-only
3032     STATUS     current
3033     DESCRIPTION
3034             "The total number of frames which were received by the probe
3035             and therefore not accounted for in the *StatsDropEvents, but
3036             for which the probe chose not to count for the associated
3037             dsmonMatrixSD and dsmonMatrixDS entries for whatever reason.
3038             Most often, this event occurs when the probe is out of some
3039             resources and decides to shed load from this collection.
3040
3041             This count does not include packets that were not counted
3042             because they had MAC-layer errors.
3043
3044             Note that if the dsmonMatrix tables are inactive because no
3045             appropriate protocols are enabled in the protocol directory,
3046             this value SHOULD be 0.
3047
3048             Note that, unlike the dropEvents counter, this number is the
3049             exact number of frames dropped."
3050     ::= { dsmonMatrixCtlEntry 5 }
3051
3052 dsmonMatrixCtlInserts OBJECT-TYPE
3053     SYNTAX     Counter32
3054     UNITS      "table entries"
3055     MAX-ACCESS read-only
3056
3057
3058
3059     STATUS     current
3060     DESCRIPTION
3061             "The number of times a dsmonMatrix entry has been inserted
3062             into the dsmonMatrix tables.  If an entry is inserted, then
3063             deleted, and then inserted, this counter will be incremented
3064             by 2.  The addition of a conversation into both the
3065             dsmonMatrixSDTable and dsmonMatrixDSTable shall be counted
3066             as two insertions (even though every addition into one table
3067             must be accompanied by an insertion into the other).
3068
3069             To allow for efficient implementation strategies, agents may
3070             delay updating this object for short periods of time.  For
3071             example, an implementation strategy may allow internal data
3072             structures to differ from those visible via SNMP for short
3073             periods of time.  This counter may reflect the internal data
3074             structures for those short periods of time.  Note that the
3075             sum of the dsmonMatrixSDTable and dsmonMatrixDSTable sizes
3076             can be determined by subtracting dsmonMatrixCtlDeletes from
3077             dsmonMatrixCtlInserts."
3078     ::= { dsmonMatrixCtlEntry 6 }
3079
3080 dsmonMatrixCtlDeletes OBJECT-TYPE
3081     SYNTAX     Counter32
3082     UNITS      "table entries"
3083     MAX-ACCESS read-only
3084     STATUS     current
3085     DESCRIPTION
3086             "The number of times a dsmonMatrix entry has been deleted
3087             from the dsmonMatrix tables (for any reason).  If an entry
3088             is deleted, then inserted, and then deleted, this counter
3089             will be incremented by 2.  The deletion of a conversation
3090             from both the dsmonMatrixSDTable and dsmonMatrixDSTable
3091             shall be counted as two deletions (even though every
3092             deletion from one table must be accompanied by a deletion
3093             from the other).
3094
3095             To allow for efficient implementation strategies, agents MAY
3096             delay updating this object for short periods of time.  For
3097             example, an implementation strategy may allow internal data
3098             structures to differ from those visible via SNMP for short
3099             periods of time.  This counter may reflect the internal data
3100             structures for those short periods of time.
3101
3102             Note that the sum of the dsmonMatrixSDTable and
3103             dsmonMatrixDSTable sizes can be determined by subtracting
3104             dsmonMatrixCtlDeletes from dsmonMatrixCtlInserts."
3105     ::= { dsmonMatrixCtlEntry 7 }
3106
3107
3108
3109
3110 dsmonMatrixCtlCreateTime OBJECT-TYPE
3111     SYNTAX     LastCreateTime
3112     MAX-ACCESS read-only
3113     STATUS     current
3114     DESCRIPTION
3115             "The value of sysUpTime when this control entry was last
3116             activated.  This can be used by the management station to
3117             detect if the table has been deleted and recreated between
3118             polls."
3119     ::= { dsmonMatrixCtlEntry 8 }
3120
3121 dsmonMatrixCtlOwner OBJECT-TYPE
3122     SYNTAX      OwnerString
3123     MAX-ACCESS  read-create
3124     STATUS      current
3125     DESCRIPTION
3126             "The entity that configured this entry and is therefore
3127             using the resources assigned to it."
3128     ::= { dsmonMatrixCtlEntry 9 }
3129
3130 dsmonMatrixCtlStatus OBJECT-TYPE
3131     SYNTAX      RowStatus
3132     MAX-ACCESS  read-create
3133     STATUS      current
3134     DESCRIPTION
3135             "The status of this dsmonMatrixCtlEntry.
3136
3137             An entry MUST NOT exist in the active state unless all
3138             objects in the entry have an appropriate value.
3139
3140             If this object is not equal to active(1), all associated
3141             entries in the dsmonMatrixSDTable and dsmonMatrixDSTable
3142             shall be deleted."
3143     ::= { dsmonMatrixCtlEntry 10 }
3144
3145 --
3146 -- AL Matrix SD Statistics Table
3147 --
3148
3149 dsmonMatrixSDTable OBJECT-TYPE
3150     SYNTAX      SEQUENCE OF DsmonMatrixSDEntry
3151     MAX-ACCESS  not-accessible
3152     STATUS      current
3153     DESCRIPTION
3154             "A list of application traffic matrix entries which collect
3155             statistics for conversations of a particular application
3156             protocol between two network-level addresses.  This table is
3157             indexed first by the source address and then by the
3158
3159
3160
3161             destination address to make it convenient to collect all
3162             statistics from a particular address.
3163
3164             The probe will add to this table all pairs of addresses for
3165             all protocols seen in all packets with no MAC errors, and
3166             will increment octet and packet counts in the table for all
3167             packets with no MAC errors."
3168     ::= { dsmonMatrixObjects 2 }
3169
3170 dsmonMatrixSDEntry OBJECT-TYPE
3171     SYNTAX      DsmonMatrixSDEntry
3172     MAX-ACCESS  not-accessible
3173     STATUS      current
3174     DESCRIPTION
3175             "A conceptual row in the dsmonMatrixSDTable.
3176
3177             The dsmonMatrixCtlIndex value in the index identifies the
3178             dsmonMatrixCtlEntry on whose behalf this entry was created.
3179
3180             The dsmonAggGroupIndex value in the index is determined by
3181             examining the DSCP value in each monitored packet, and the
3182             dsmonAggProfileTable entry configured for that value."
3183     INDEX { dsmonMatrixCtlIndex,
3184             dsmonMatrixTimeMark,
3185             dsmonAggGroupIndex,
3186             dsmonMatrixNLIndex,
3187             dsmonMatrixSourceAddress,
3188             dsmonMatrixDestAddress,
3189             dsmonMatrixALIndex
3190            }
3191     ::= { dsmonMatrixSDTable 1 }
3192
3193 DsmonMatrixSDEntry ::= SEQUENCE {
3194     dsmonMatrixTimeMark                 TimeFilter,
3195     dsmonMatrixNLIndex                  Integer32,
3196     dsmonMatrixSourceAddress            OCTET STRING,
3197     dsmonMatrixDestAddress              OCTET STRING,
3198     dsmonMatrixALIndex                  Integer32,
3199     dsmonMatrixSDPkts                   ZeroBasedCounter32,
3200     dsmonMatrixSDOvflPkts               ZeroBasedCounter32,
3201     dsmonMatrixSDHCPkts                 ZeroBasedCounter64,
3202     dsmonMatrixSDOctets                 ZeroBasedCounter32,
3203     dsmonMatrixSDOvflOctets             ZeroBasedCounter32,
3204     dsmonMatrixSDHCOctets               ZeroBasedCounter64,
3205     dsmonMatrixSDCreateTime             LastCreateTime
3206 }
3207
3208 dsmonMatrixTimeMark OBJECT-TYPE
3209
3210
3211
3212     SYNTAX      TimeFilter
3213     MAX-ACCESS  not-accessible
3214     STATUS      current
3215     DESCRIPTION
3216             "The Time Filter index for this table.  This object may be
3217             used by a management station to retrieve only rows which
3218             have been created or modified since a particular time.  Note
3219             that the current value for a row are always returned and the
3220             TimeFilter is not a historical data archiving mechanism.
3221             Refer to RFC 2021 [RFC2021] for a detailed description of
3222             TimeFilter operation."
3223     ::= { dsmonMatrixSDEntry 1 }
3224
3225 dsmonMatrixNLIndex OBJECT-TYPE
3226     SYNTAX      Integer32 (1..2147483647)
3227     MAX-ACCESS  not-accessible
3228     STATUS      current
3229     DESCRIPTION
3230             "The protocolDirLocalIndex value of a protocolDirEntry
3231             representing the specific network layer protocol
3232             encapsulation associated with each entry, and the network
3233             protocol type of the dsmonMatrixSourceAddress and
3234             dsmonMatrixDestAddress objects."
3235     ::= { dsmonMatrixSDEntry 2 }
3236
3237 dsmonMatrixSourceAddress OBJECT-TYPE
3238     SYNTAX      OCTET STRING (SIZE (0..54))
3239     MAX-ACCESS  not-accessible
3240     STATUS      current
3241     DESCRIPTION
3242             "The network source address for this dsmonMatrix entry.
3243
3244             This is represented as an octet string with specific
3245             semantics and length as identified by the dsmonMatrixNLIndex
3246             component of the index.
3247
3248             For example, if the dsmonMatrixNLIndex indicates an
3249             encapsulation of IPv4, this object is encoded as a length
3250             octet of 4, followed by the 4 octets of the IPv4 address, in
3251             network byte order."
3252     ::= { dsmonMatrixSDEntry 3 }
3253
3254 dsmonMatrixDestAddress OBJECT-TYPE
3255     SYNTAX      OCTET STRING (SIZE (0..54))
3256     MAX-ACCESS  not-accessible
3257     STATUS      current
3258     DESCRIPTION
3259             "The network destination address for this dsmonMatrix entry.
3260
3261
3262
3263             This is represented as an octet string with specific
3264             semantics and length as identified by the dsmonMatrixNLIndex
3265             component of the index.
3266
3267             For example, if the dsmonMatrixNLIndex indicates an
3268             encapsulation of IPv4, this object is encoded as a length
3269             octet of 4, followed by the 4 octets of the IPv4 address, in
3270             network byte order."
3271     ::= { dsmonMatrixSDEntry 4 }
3272
3273 dsmonMatrixALIndex OBJECT-TYPE
3274     SYNTAX      Integer32 (1..2147483647)
3275     MAX-ACCESS  not-accessible
3276     STATUS      current
3277     DESCRIPTION
3278             "The protocolDirLocalIndex value of the protocolDirEntry
3279             representing the specific application layer protocol
3280             associated with each entry.
3281
3282             It MUST identify an protocolDirEntry which is a direct or
3283             indirect descendant of the protocolDirEntry identified by
3284             the associated dsmonMatrixNLIndex object."
3285     ::= { dsmonMatrixSDEntry 5 }
3286
3287 dsmonMatrixSDPkts OBJECT-TYPE
3288     SYNTAX      ZeroBasedCounter32
3289     UNITS       "packets"
3290     MAX-ACCESS  read-only
3291     STATUS      current
3292     DESCRIPTION
3293             "The number of packets of this protocol type (indicated by
3294             the associated dsmonMatrixALIndex object) without errors
3295             transmitted from the source address to the destination
3296             address since this entry was added to the
3297             dsmonMatrixSDTable.  Note that this is the number of link-
3298             layer packets, so if a single network-layer packet is
3299             fragmented into several link-layer frames, this counter is
3300             incremented several times."
3301     ::= { dsmonMatrixSDEntry 6 }
3302
3303 dsmonMatrixSDOvflPkts OBJECT-TYPE
3304     SYNTAX      ZeroBasedCounter32
3305     MAX-ACCESS  read-only
3306     STATUS      deprecated
3307     DESCRIPTION
3308             "The number of times the associated dsmonMatrixSDPkts
3309             counter has overflowed, since this entry was added to the
3310             dsmonMatrixSDTable."
3311
3312
3313
3314     ::= { dsmonMatrixSDEntry 7 }
3315
3316 dsmonMatrixSDHCPkts OBJECT-TYPE
3317     SYNTAX      ZeroBasedCounter64
3318     UNITS       "packets"
3319     MAX-ACCESS  read-only
3320     STATUS      current
3321     DESCRIPTION
3322             "The 64-bit version of the dsmonMatrixSDPkts object.
3323
3324             Note that this object will only be instantiated if the RMON
3325             agent supports High Capacity monitoring for a particular
3326             dataSource."
3327     ::= { dsmonMatrixSDEntry 8 }
3328
3329 dsmonMatrixSDOctets OBJECT-TYPE
3330     SYNTAX      ZeroBasedCounter32
3331     UNITS       "octets"
3332     MAX-ACCESS  read-only
3333     STATUS      current
3334     DESCRIPTION
3335             "The number of octets in packets of this protocol type
3336             transmitted from the source address to the destination
3337             address since this entry was added to the dsmonMatrixSDTable
3338             (excluding framing bits but including FCS octets), excluding
3339             those octets in packets that contained errors.
3340
3341             Note this doesn't count just those octets in the particular
3342             protocol frames, but includes the entire packet that
3343             contained the protocol."
3344     ::= { dsmonMatrixSDEntry 9 }
3345
3346 dsmonMatrixSDOvflOctets OBJECT-TYPE
3347     SYNTAX      ZeroBasedCounter32
3348     MAX-ACCESS  read-only
3349     STATUS      deprecated
3350     DESCRIPTION
3351             "The number of times the associated dsmonMatrixSDOctets
3352             counter has overflowed, since this entry was added to the
3353             dsmonMatrixSDTable."
3354     ::= { dsmonMatrixSDEntry 10 }
3355
3356 dsmonMatrixSDHCOctets OBJECT-TYPE
3357     SYNTAX      ZeroBasedCounter64
3358     UNITS       "octets"
3359     MAX-ACCESS  read-only
3360     STATUS      current
3361     DESCRIPTION
3362
3363
3364
3365             "The 64-bit version of the dsmonMatrixSDPkts object.
3366
3367             Note that this object will only be instantiated if the RMON
3368             agent supports High Capacity monitoring for a particular
3369             dataSource."
3370     ::= { dsmonMatrixSDEntry 11 }
3371
3372 dsmonMatrixSDCreateTime OBJECT-TYPE
3373     SYNTAX     LastCreateTime
3374     MAX-ACCESS read-only
3375     STATUS     current
3376     DESCRIPTION
3377             "The value of sysUpTime when this entry was last activated.
3378             This can be used by the management station to ensure that
3379             the entry has not been deleted and recreated between polls."
3380     ::= { dsmonMatrixSDEntry 12 }
3381
3382
3383 --
3384 -- AL Matrix DS Statistics Table
3385 --
3386
3387 dsmonMatrixDSTable OBJECT-TYPE
3388     SYNTAX      SEQUENCE OF DsmonMatrixDSEntry
3389     MAX-ACCESS  not-accessible
3390     STATUS      current
3391     DESCRIPTION
3392             "A list of application traffic matrix entries which collect
3393             statistics for conversations of a particular application
3394             protocol between two network-level addresses.  This table is
3395             indexed first by the destination address and then by the
3396             source address to make it convenient to collect all
3397             statistics from a particular address.
3398
3399             The probe will add to this table all pairs of addresses for
3400             all protocols seen in all packets with no MAC errors, and
3401             will increment octet and packet counts in the table for all
3402             packets with no MAC errors."
3403     ::= { dsmonMatrixObjects 3 }
3404
3405 dsmonMatrixDSEntry OBJECT-TYPE
3406     SYNTAX      DsmonMatrixDSEntry
3407     MAX-ACCESS  not-accessible
3408     STATUS      current
3409     DESCRIPTION
3410             "A conceptual row in the dsmonMatrixDSTable.  Note that this
3411             table is conceptually a re-ordered version of the
3412             dsmonMatrixSDTable.  Therefore, all of the index values from
3413
3414
3415
3416             that table are used by reference, and their semantics are
3417             exactly as described in the dsmonMatrixSDTable.
3418
3419             The dsmonMatrixCtlIndex value in the index identifies the
3420             dsmonMatrixCtlEntry on whose behalf this entry was created.
3421
3422             The dsmonMatrixTimeMark value in the index identifies the
3423             Time Filter index for this table.
3424
3425             The dsmonAggGroupIndex value in the index is determined by
3426             examining the DSCP value in each monitored packet, and the
3427             dsmonAggProfileTable entry configured for that value.
3428
3429             The dsmonMatrixNLIndex value in the index identifies the
3430             protocolDirLocalIndex value of a protocolDirEntry
3431             representing the specific network layer protocol
3432             encapsulation associated with each entry, and the network
3433             protocol type of the dsmonMatrixSourceAddress and
3434             dsmonMatrixDestAddress objects.
3435
3436             The dsmonMatrixDestAddress value in the index identifies the
3437             network destination address for this dsmonMatrix entry.
3438
3439             The dsmonMatrixSourceAddress value in the index identifies
3440             the network source address for this dsmonMatrix entry.
3441
3442             The dsmonMatrixALIndex value in the index identifies the
3443             protocolDirLocalIndex value of the protocolDirEntry
3444             representing the specific application layer protocol
3445             associated with each entry."
3446     INDEX { dsmonMatrixCtlIndex,
3447             dsmonMatrixTimeMark,
3448             dsmonAggGroupIndex,
3449             dsmonMatrixNLIndex,
3450             dsmonMatrixDestAddress,
3451             dsmonMatrixSourceAddress,
3452             dsmonMatrixALIndex
3453            }
3454     ::= { dsmonMatrixDSTable 1 }
3455
3456 DsmonMatrixDSEntry ::= SEQUENCE {
3457     dsmonMatrixDSPkts                   ZeroBasedCounter32,
3458     dsmonMatrixDSOvflPkts               ZeroBasedCounter32,
3459     dsmonMatrixDSHCPkts                 ZeroBasedCounter64,
3460     dsmonMatrixDSOctets                 ZeroBasedCounter32,
3461     dsmonMatrixDSOvflOctets             ZeroBasedCounter32,
3462     dsmonMatrixDSHCOctets               ZeroBasedCounter64,
3463     dsmonMatrixDSCreateTime             LastCreateTime
3464
3465
3466
3467 }
3468
3469 dsmonMatrixDSPkts OBJECT-TYPE
3470     SYNTAX      ZeroBasedCounter32
3471     UNITS       "packets"
3472     MAX-ACCESS  read-only
3473     STATUS      current
3474     DESCRIPTION
3475             "The number of packets of this protocol type (indicated by
3476             the associated dsmonMatrixALIndex object) without errors
3477             transmitted from the source address to the destination
3478             address since this entry was added to the
3479             dsmonMatrixDSTable.  Note that this is the number of link-
3480             layer packets, so if a single network-layer packet is
3481             fragmented into several link-layer frames, this counter is
3482             incremented several times."
3483     ::= { dsmonMatrixDSEntry 1 }
3484
3485 dsmonMatrixDSOvflPkts OBJECT-TYPE
3486     SYNTAX      ZeroBasedCounter32
3487     MAX-ACCESS  read-only
3488     STATUS      deprecated
3489     DESCRIPTION
3490             "The number of times the associated dsmonMatrixDSPkts
3491             counter has overflowed, since this entry was added to the
3492             dsmonMatrixDSTable."
3493     ::= { dsmonMatrixDSEntry 2 }
3494
3495 dsmonMatrixDSHCPkts OBJECT-TYPE
3496     SYNTAX      ZeroBasedCounter64
3497     UNITS       "packets"
3498     MAX-ACCESS  read-only
3499     STATUS      current
3500     DESCRIPTION
3501             "The 64-bit version of the dsmonMatrixDSPkts object.
3502
3503             Note that this object will only be instantiated if the RMON
3504             agent supports High Capacity monitoring for a particular
3505             dataSource."
3506     ::= { dsmonMatrixDSEntry 3 }
3507
3508 dsmonMatrixDSOctets OBJECT-TYPE
3509     SYNTAX      ZeroBasedCounter32
3510     UNITS       "octets"
3511     MAX-ACCESS  read-only
3512     STATUS      current
3513     DESCRIPTION
3514             "The number of octets in packets of this protocol type
3515
3516
3517
3518             transmitted from the source address to the destination
3519             address since this entry was added to the dsmonMatrixDSTable
3520             (excluding framing bits but including FCS octets), excluding
3521             those octets in packets that contained errors.
3522
3523             Note this doesn't count just those octets in the particular
3524             protocol frames, but includes the entire packet that
3525             contained the protocol."
3526     ::= { dsmonMatrixDSEntry 4 }
3527
3528 dsmonMatrixDSOvflOctets OBJECT-TYPE
3529     SYNTAX      ZeroBasedCounter32
3530     MAX-ACCESS  read-only
3531     STATUS      deprecated
3532     DESCRIPTION
3533             "The number of times the associated dsmonMatrixDSOctets
3534             counter has overflowed, since this entry was added to the
3535             dsmonMatrixDSTable."
3536     ::= { dsmonMatrixDSEntry 5 }
3537
3538 dsmonMatrixDSHCOctets OBJECT-TYPE
3539     SYNTAX      ZeroBasedCounter64
3540     UNITS       "octets"
3541     MAX-ACCESS  read-only
3542     STATUS      current
3543     DESCRIPTION
3544             "The 64-bit version of the dsmonMatrixDSPkts object.
3545
3546             Note that this object will only be instantiated if the RMON
3547             agent supports High Capacity monitoring for a particular
3548             dataSource."
3549     ::= { dsmonMatrixDSEntry 6 }
3550
3551 dsmonMatrixDSCreateTime OBJECT-TYPE
3552     SYNTAX     LastCreateTime
3553     MAX-ACCESS read-only
3554     STATUS     current
3555     DESCRIPTION
3556             "The value of sysUpTime when this entry was last activated.
3557             This can be used by the management station to ensure that
3558             the entry has not been deleted and recreated between polls."
3559     ::= { dsmonMatrixDSEntry 7 }
3560
3561
3562 --
3563 -- Per-Protocol Per-Matrix Statistics TopN Control Table
3564 --
3565
3566
3567
3568
3569 dsmonMatrixTopNCtlTable OBJECT-TYPE
3570     SYNTAX      SEQUENCE OF DsmonMatrixTopNCtlEntry
3571     MAX-ACCESS  not-accessible
3572     STATUS      current
3573     DESCRIPTION
3574             "A set of parameters that control the creation of a report
3575             of the top N dsmonMatrix entries according to a selected
3576             metric.
3577
3578             Note that an agent MAY choose to limit the actual number of
3579             entries which may be created in this table.  In this case,
3580             the agent SHOULD return an error-status of
3581             'resourceUnavailable(13)', as per section 4.2.5 of the
3582             'Protocol Operations for SNMPv2' specification [RFC1905]."
3583     ::= { dsmonMatrixObjects 4 }
3584
3585 dsmonMatrixTopNCtlEntry OBJECT-TYPE
3586     SYNTAX      DsmonMatrixTopNCtlEntry
3587     MAX-ACCESS  not-accessible
3588     STATUS      current
3589     DESCRIPTION
3590             "A conceptual row in the dsmonMatrixTopNCtlTable.
3591
3592             Entries are created and deleted from this table by
3593             management action only, using the dsmonMatrixTopNCtlStatus
3594             RowStatus object.
3595
3596             The agent SHOULD support non-volatile configuration of this
3597             table, and upon system initialization, the table SHOULD be
3598             initialized with the saved values.
3599
3600             Activation of a control row in this table will cause an
3601             associated dsmonMatrixTopNTable to be created and maintained
3602             by the agent."
3603     INDEX { dsmonMatrixTopNCtlIndex }
3604     ::= { dsmonMatrixTopNCtlTable 1 }
3605
3606 DsmonMatrixTopNCtlEntry ::= SEQUENCE {
3607     dsmonMatrixTopNCtlIndex            Integer32,
3608     dsmonMatrixTopNCtlMatrixIndex      Integer32,
3609     dsmonMatrixTopNCtlRateBase         INTEGER,
3610     dsmonMatrixTopNCtlTimeRemaining    Integer32,
3611     dsmonMatrixTopNCtlGeneratedRpts    Counter32,
3612     dsmonMatrixTopNCtlDuration         Integer32,
3613     dsmonMatrixTopNCtlRequestedSize    Integer32,
3614     dsmonMatrixTopNCtlGrantedSize      Integer32,
3615     dsmonMatrixTopNCtlStartTime        TimeStamp,
3616     dsmonMatrixTopNCtlOwner            OwnerString,
3617
3618
3619
3620     dsmonMatrixTopNCtlStatus           RowStatus
3621 }
3622
3623 dsmonMatrixTopNCtlIndex OBJECT-TYPE
3624     SYNTAX     Integer32 (1..65535)
3625     MAX-ACCESS not-accessible
3626     STATUS     current
3627     DESCRIPTION
3628             "An index that uniquely identifies an entry in the
3629             dsmonMatrixTopNCtlTable.  Each such entry defines one Top N
3630             report prepared for one RMON dataSource."
3631     ::= { dsmonMatrixTopNCtlEntry 1 }
3632
3633 dsmonMatrixTopNCtlMatrixIndex OBJECT-TYPE
3634     SYNTAX     Integer32 (1..65535)
3635     MAX-ACCESS read-create
3636     STATUS     current
3637     DESCRIPTION
3638             "The dsmonMatrixSDTable for which a top N report will be
3639             prepared on behalf of this entry.  The dsmonMatrixSDTable is
3640             identified by the same value of the dsmonMatrixCtlIndex
3641             object.
3642
3643             This object MUST NOT be modified if the associated
3644             dsmonMatrixTopNCtlStatus object is equal to active(1)."
3645     ::= { dsmonMatrixTopNCtlEntry 2 }
3646
3647 dsmonMatrixTopNCtlRateBase OBJECT-TYPE
3648     SYNTAX     INTEGER {
3649                   dsmonMatrixTopNPkts(1),
3650                   dsmonMatrixTopNOctets(2),
3651                   dsmonMatrixTopNHCPkts(3),
3652                   dsmonMatrixTopNHCOctets(4)
3653                }
3654     MAX-ACCESS read-create
3655     STATUS     current
3656     DESCRIPTION
3657             "The variable for each dsmonMatrixSD entry that the
3658             dsmonMatrixTopNRate and dsmonMatrixTopNHCRate variables are
3659             based upon.  Each dsmonMatrixTopN report generated on behalf
3660             of this control entry will be ranked in descending order,
3661             based on the associated dsmonMatrixSDTable counter,
3662             identified by this object.
3663
3664             The following table identifies the dsmonMatrixSDTable
3665             counters associated with each enumeration:
3666
3667             Enumeration                 RateBase MIB Objects
3668
3669
3670
3671             -----------                 --------------------
3672             dsmonMatrixTopNPkts         dsmonMatrixSDPkts
3673             dsmonMatrixTopNOctets       dsmonMatrixSDOctets
3674             dsmonMatrixTopNHCPkts       dsmonMatrixSDHCPkts
3675             dsmonMatrixTopNHCOctets     dsmonMatrixSDHCOctets
3676
3677             The following enumerations are only available if the agent
3678             supports High Capacity monitoring:
3679
3680             dsmonMatrixTopNHCPkts
3681             dsmonMatrixTopNHCOctets
3682
3683             This object MUST NOT be modified if the associated
3684             dsmonMatrixTopNCtlStatus object is equal to active(1)."
3685     ::= { dsmonMatrixTopNCtlEntry 3 }
3686
3687 dsmonMatrixTopNCtlTimeRemaining OBJECT-TYPE
3688     SYNTAX     Integer32 (0..2147483647)
3689     UNITS      "seconds"
3690     MAX-ACCESS read-create
3691     STATUS     current
3692     DESCRIPTION
3693             "The number of seconds left in the report currently being
3694             collected.  When this object is modified by the management
3695             station, a new collection is started, possibly aborting a
3696             currently running report.  The new value is used as the
3697             requested duration of this report, and is immediately loaded
3698             into the associated dsmonMatrixTopNCtlDuration object.
3699
3700             When the report finishes, the probe will automatically start
3701             another collection with the same initial value of
3702             dsmonMatrixTopNCtlTimeRemaining.  Thus the management
3703             station may simply read the resulting reports repeatedly,
3704             checking the startTime and duration each time to ensure that
3705             a report was not missed or that the report parameters were
3706             not changed.
3707
3708             While the value of this object is non-zero, it decrements by
3709             one per second until it reaches zero.  At the time that this
3710             object decrements to zero, the report is made accessible in
3711             the dsmonMatrixTopNTable, overwriting any report that may be
3712             there.
3713
3714             When this object is modified by the management station, any
3715             associated entries in the dsmonMatrixTopNTable shall be
3716             deleted."
3717     DEFVAL { 1800 }
3718     ::= { dsmonMatrixTopNCtlEntry 4 }
3719
3720
3721
3722 dsmonMatrixTopNCtlGeneratedRpts OBJECT-TYPE
3723     SYNTAX     Counter32
3724     UNITS      "reports"
3725     MAX-ACCESS read-only
3726     STATUS     current
3727     DESCRIPTION
3728             "The number of reports that have been generated by this
3729             entry."
3730     ::= { dsmonMatrixTopNCtlEntry 5 }
3731
3732 dsmonMatrixTopNCtlDuration OBJECT-TYPE
3733     SYNTAX     Integer32 (0..2147483647)
3734     UNITS      "seconds"
3735     MAX-ACCESS read-only
3736     STATUS     current
3737     DESCRIPTION
3738             "The number of seconds that this report has collected during
3739             the last sampling interval.
3740
3741             When the associated dsmonMatrixTopNCtlTimeRemaining object
3742             is set, this object shall be set by the probe to the same
3743             value and shall not be modified until the next time the
3744             dsmonMatrixTopNCtlTimeRemaining is set.
3745
3746             This value shall be zero if no reports have been requested
3747             for this dsmonMatrixTopNCtlEntry."
3748     ::= { dsmonMatrixTopNCtlEntry 6 }
3749
3750 dsmonMatrixTopNCtlRequestedSize OBJECT-TYPE
3751     SYNTAX     Integer32 (0..2147483647)
3752     UNITS      "table entries"
3753     MAX-ACCESS read-create
3754     STATUS     current
3755     DESCRIPTION
3756             "The maximum number of dsmonMatrix entries requested for
3757             this report.
3758
3759             When this object is created or modified, the probe SHOULD
3760             set dsmonMatrixTopNCtlGrantedSize as closely to this object
3761             as is possible for the particular probe implementation and
3762             available resources."
3763     DEFVAL { 150 }
3764     ::= { dsmonMatrixTopNCtlEntry 7 }
3765
3766 dsmonMatrixTopNCtlGrantedSize OBJECT-TYPE
3767     SYNTAX     Integer32 (0..2147483647)
3768     UNITS      "table entries"
3769     MAX-ACCESS read-only
3770
3771
3772
3773     STATUS     current
3774     DESCRIPTION
3775             "The maximum number of dsmonMatrix entries in this report.
3776
3777             When the associated dsmonMatrixTopNCtlRequestedSize object
3778             is created or modified, the probe SHOULD set this object as
3779             closely to the requested value as is possible for the
3780             particular implementation and available resources.  The
3781             probe MUST NOT lower this value except as a result of a
3782             set to the associated dsmonMatrixTopNCtlRequestedSize
3783             object.
3784
3785             Protocol entries with the highest value of
3786             dsmonMatrixTopNRate or dsmonMatrixTopNHCRate (depending on
3787             the value of the associated dsmonMatrixTopNCtlRateBase
3788             object) shall be placed in this table in decreasing order of
3789             this rate until there is no more room or until there are no
3790             more dsmonMatrix entries."
3791     ::= { dsmonMatrixTopNCtlEntry 8 }
3792
3793 dsmonMatrixTopNCtlStartTime OBJECT-TYPE
3794     SYNTAX     TimeStamp
3795     MAX-ACCESS read-only
3796     STATUS     current
3797     DESCRIPTION
3798             "The value of sysUpTime when this top N report was last
3799             started.  In other words, this is the time that the
3800             associated dsmonMatrixTopNCtlTimeRemaining object was
3801             modified to start the requested report or the time the
3802             report was last automatically (re)started.
3803
3804             This object may be used by the management station to
3805             determine if a report was missed or not."
3806     ::= { dsmonMatrixTopNCtlEntry 9 }
3807
3808 dsmonMatrixTopNCtlOwner OBJECT-TYPE
3809     SYNTAX     OwnerString
3810     MAX-ACCESS read-create
3811     STATUS     current
3812     DESCRIPTION
3813             "The entity that configured this entry and is therefore
3814             using the resources assigned to it."
3815     ::= { dsmonMatrixTopNCtlEntry 10 }
3816
3817 dsmonMatrixTopNCtlStatus OBJECT-TYPE
3818     SYNTAX     RowStatus
3819     MAX-ACCESS read-create
3820     STATUS     current
3821
3822
3823
3824     DESCRIPTION
3825             "The status of this dsmonMatrixTopNCtlEntry.
3826
3827             An entry MUST NOT exist in the active state unless all
3828             objects in the entry have an appropriate value.
3829
3830             If this object is not equal to active(1), all associated
3831             entries in the dsmonMatrixTopNTable shall be deleted by the
3832             agent."
3833     ::= { dsmonMatrixTopNCtlEntry 11 }
3834
3835 --
3836 -- dsmonMatrix TopN Table
3837 --
3838
3839 dsmonMatrixTopNTable OBJECT-TYPE
3840     SYNTAX     SEQUENCE OF DsmonMatrixTopNEntry
3841     MAX-ACCESS not-accessible
3842     STATUS     current
3843     DESCRIPTION
3844             "A set of statistics for those dsmonMatrix entries that have
3845             counted the highest number of octets or packets.
3846
3847             If the dsmonAggControlLocked object is equal to 'false',
3848             then all entries in this table SHALL be deleted, and the
3849             agent will not process TopN reports on behalf of any
3850             dsmonMatrixTopNCtlEntry.
3851
3852             When the dsmonAggControlLocked object is set to 'true', then
3853             particular reports SHOULD be restarted from the beginning,
3854             on behalf of all active rows in the dsmonMatrixTopNCtlTable.
3855
3856             Note that dsmonMatrix entries which did not increment at all
3857             during the report interval SHOULD NOT be included in
3858             dsmonMatrixTopN reports."
3859     ::= { dsmonMatrixObjects 5 }
3860
3861 dsmonMatrixTopNEntry OBJECT-TYPE
3862     SYNTAX     DsmonMatrixTopNEntry
3863     MAX-ACCESS not-accessible
3864     STATUS     current
3865     DESCRIPTION
3866             "A conceptual row in the dsmonMatrixTopNTable.
3867
3868             The dsmonMatrixTopNCtlIndex value in the index identifies
3869             the dsmonMatrixTopNCtlEntry on whose behalf this entry was
3870             created.
3871
3872
3873
3874
3875             Entries in this table are ordered from 1 to 'N', where lower
3876             numbers represent higher values of the rate base object,
3877             over the report interval."
3878     INDEX { dsmonMatrixTopNCtlIndex, dsmonMatrixTopNIndex }
3879     ::= { dsmonMatrixTopNTable 1 }
3880
3881 DsmonMatrixTopNEntry ::= SEQUENCE {
3882     dsmonMatrixTopNIndex                Integer32,
3883     dsmonMatrixTopNAggGroup             DsmonCounterAggGroupIndex,
3884     dsmonMatrixTopNNLIndex              Integer32,
3885     dsmonMatrixTopNSourceAddress        OCTET STRING,
3886     dsmonMatrixTopNDestAddress          OCTET STRING,
3887     dsmonMatrixTopNALIndex              Integer32,
3888     dsmonMatrixTopNPktRate              Gauge32,
3889     dsmonMatrixTopNPktRateOvfl          Gauge32,
3890     dsmonMatrixTopNHCPktRate            CounterBasedGauge64,
3891     dsmonMatrixTopNRevPktRate           Gauge32,
3892     dsmonMatrixTopNRevPktRateOvfl       Gauge32,
3893     dsmonMatrixTopNHCRevPktRate         CounterBasedGauge64,
3894     dsmonMatrixTopNOctetRate            Gauge32,
3895     dsmonMatrixTopNOctetRateOvfl        Gauge32,
3896     dsmonMatrixTopNHCOctetRate          CounterBasedGauge64,
3897     dsmonMatrixTopNRevOctetRate         Gauge32,
3898     dsmonMatrixTopNRevOctetRateOvfl     Gauge32,
3899     dsmonMatrixTopNHCRevOctetRate       CounterBasedGauge64
3900   }
3901
3902 dsmonMatrixTopNIndex OBJECT-TYPE
3903     SYNTAX     Integer32 (1..2147483647)
3904     MAX-ACCESS not-accessible
3905     STATUS     current
3906     DESCRIPTION
3907             "An index that uniquely identifies an entry in the
3908             dsmonMatrixTopNTable among those in the same report.  This
3909             index is between 1 and N, where N is the number of entries
3910             in this report."
3911     ::= { dsmonMatrixTopNEntry 1 }
3912
3913 dsmonMatrixTopNAggGroup OBJECT-TYPE
3914     SYNTAX      DsmonCounterAggGroupIndex
3915     MAX-ACCESS  read-only
3916     STATUS      current
3917     DESCRIPTION
3918             "The counter aggregation group index value associated with
3919             host identified in this entry.  This object identifies the
3920             dsmonAggGroupEntry with the same dsmonAggControlIndex value
3921             as the associated dsmonMatrixCtlAggProfile object and the
3922             same dsmonAggGroupIndex value as this object."
3923
3924
3925
3926     ::= { dsmonMatrixTopNEntry 2 }
3927
3928 dsmonMatrixTopNNLIndex OBJECT-TYPE
3929     SYNTAX     Integer32 (1..2147483647)
3930     MAX-ACCESS read-only
3931     STATUS     current
3932     DESCRIPTION
3933             "The protocolDirLocalIndex value which identifies the
3934             protocol associated with the dsmonMatrixTopNSourceAddress
3935             and dsmonMatrixTopNDestAddress objects in this entry.
3936
3937             If the protocolDirEntry associated with the
3938             protocolDirLocalIndex with the same value as this object is
3939             de-activated or deleted, then the agent MUST delete this
3940             dsmonMatrixTopN entry."
3941     ::= { dsmonMatrixTopNEntry 3 }
3942
3943 dsmonMatrixTopNSourceAddress OBJECT-TYPE
3944     SYNTAX     OCTET STRING
3945     MAX-ACCESS read-only
3946     STATUS     current
3947     DESCRIPTION
3948             "The dsmonMatrixSDSourceAddress value for the source network
3949             host identified in this entry.  The associated
3950             dsmonMatrixTopNNLIndex object identifies the network
3951             protocol type and the encoding rules for this object."
3952     ::= { dsmonMatrixTopNEntry 4 }
3953
3954 dsmonMatrixTopNDestAddress OBJECT-TYPE
3955     SYNTAX     OCTET STRING
3956     MAX-ACCESS read-only
3957     STATUS     current
3958     DESCRIPTION
3959             "The dsmonMatrixSDDestAddress value for the destination
3960             network host identified in this entry.  The associated
3961             dsmonMatrixTopNNLIndex object identifies the network
3962             protocol type and the encoding rules for this object."
3963     ::= { dsmonMatrixTopNEntry 5 }
3964
3965 dsmonMatrixTopNALIndex OBJECT-TYPE
3966     SYNTAX     Integer32 (1..2147483647)
3967     MAX-ACCESS read-only
3968     STATUS     current
3969     DESCRIPTION
3970             "The protocolDirLocalIndex value which identifies the
3971             application protocol associated with this entry.
3972
3973             If the protocolDirEntry associated with the
3974
3975
3976
3977             protocolDirLocalIndex with the same value as this object is
3978             de-activated or deleted, then the agent MUST delete this
3979             dsmonMatrixTopN entry."
3980     ::= { dsmonMatrixTopNEntry 6 }
3981
3982 dsmonMatrixTopNPktRate OBJECT-TYPE
3983     SYNTAX     Gauge32
3984     MAX-ACCESS read-only
3985     STATUS     current
3986     DESCRIPTION
3987             "The number of packets seen of this protocol from the source
3988             host to the destination host during this sampling interval,
3989             counted using the rules for counting the dsmonMatrixSDPkts
3990             object.
3991
3992             If the value of dsmonMatrixTopNCtlRateBase is
3993             dsmonMatrixTopNPkts, this variable will be used to sort this
3994             report.
3995
3996             If the value of the dsmonMatrixTopNCtlRateBase is
3997             dsmonMatrixTopNHCPkts or dsmonMatrixTopNHCOctets, then this
3998             object will contain the the least significant 32 bits of the
3999             associated dsmonMatrixTopNHCPktRate object."
4000     ::= { dsmonMatrixTopNEntry 7 }
4001
4002 dsmonMatrixTopNPktRateOvfl OBJECT-TYPE
4003     SYNTAX     Gauge32
4004     MAX-ACCESS read-only
4005     STATUS     deprecated
4006     DESCRIPTION
4007             "The most significant 32 bits of the associated
4008             dsmonMatrixTopNHCPktRate object.
4009
4010             If the associated dsmonMatrixTopNCtlRateBase is equal to
4011             dsmonMatrixTopNHCPkts or dsmonMatrixTopNHCOctets, then this
4012             object will contain the most significant 32 bits of the
4013             associated dsmonMatrixTopNHCPktRate object, otherwise this
4014             object will contain the value zero.
4015
4016             The agent MAY choose not to instantiate this object if High
4017             Capacity monitoring is not supported."
4018     ::= { dsmonMatrixTopNEntry 8 }
4019
4020 dsmonMatrixTopNHCPktRate OBJECT-TYPE
4021     SYNTAX     CounterBasedGauge64
4022     MAX-ACCESS read-only
4023     STATUS     current
4024     DESCRIPTION
4025
4026
4027
4028             "The number of packets seen of this protocol from the source
4029             host to the destination host during this sampling interval,
4030             counted using the rules for counting the dsmonMatrixSDHCPkts
4031             object.
4032
4033             If the value of dsmonMatrixTopNCtlRateBase is
4034             dsmonMatrixTopNHCPkts, this variable will be used to sort
4035             this report.
4036
4037             The agent MAY choose not to instantiate this object if High
4038             Capacity monitoring is not supported."
4039     ::= { dsmonMatrixTopNEntry 9 }
4040
4041 dsmonMatrixTopNRevPktRate OBJECT-TYPE
4042     SYNTAX     Gauge32
4043     MAX-ACCESS read-only
4044     STATUS     current
4045     DESCRIPTION
4046             "The number of packets seen of this protocol from the
4047             destination host to the source host during this sampling
4048             interval, counted using the rules for counting the
4049             dsmonMatrixDSPkts object  (note that the corresponding
4050             dsmonMatrixSDPkts object selected is the one whose source
4051             address is equal to dsmonMatrixTopNDestAddress and whose
4052             destination address is equal to
4053             dsmonMatrixTopNSourceAddress.)"
4054     ::= { dsmonMatrixTopNEntry 10 }
4055
4056 dsmonMatrixTopNRevPktRateOvfl OBJECT-TYPE
4057     SYNTAX     Gauge32
4058     MAX-ACCESS read-only
4059     STATUS     deprecated
4060     DESCRIPTION
4061             "The most significant 32 bits of the associated
4062             dsmonMatrixTopNHCRevPktRate object.
4063
4064             If the associated dsmonMatrixTopNCtlRateBase is equal to
4065             dsmonMatrixTopNHCPkts or dsmonMatrixTopNHCOCtets, then this
4066             object will contain the most significant 32 bits of the
4067             associated dsmonMatrixTopNHCRevPktRate object, otherwise
4068             this object will contain the value zero.
4069
4070             The agent MAY choose not to instantiate this object if High
4071             Capacity monitoring is not supported."
4072     ::= { dsmonMatrixTopNEntry 11 }
4073
4074 dsmonMatrixTopNHCRevPktRate OBJECT-TYPE
4075     SYNTAX     CounterBasedGauge64
4076
4077
4078
4079     MAX-ACCESS read-only
4080     STATUS     current
4081     DESCRIPTION
4082             "The number of packets seen of this protocol from the
4083             destination host to the source host during this sampling
4084             interval, counted using the rules for counting the
4085             dsmonMatrixDSHCPkts object  (note that the corresponding
4086             dsmonMatrixSDHCPkts object selected is the one whose source
4087             address is equal to dsmonMatrixTopNDestAddress and whose
4088             destination address is equal to
4089             dsmonMatrixTopNSourceAddress.)
4090
4091             The agent MAY choose not to instantiate this object if High
4092             Capacity monitoring is not supported."
4093     ::= { dsmonMatrixTopNEntry 12 }
4094
4095 dsmonMatrixTopNOctetRate OBJECT-TYPE
4096     SYNTAX     Gauge32
4097     MAX-ACCESS read-only
4098     STATUS     current
4099     DESCRIPTION
4100             "The number of octets seen of this protocol from the source
4101             host to the destination host during this sampling interval,
4102             counted using the rules for counting the dsmonMatrixSDOctets
4103             object.
4104
4105             If the value of dsmonMatrixTopNCtlRateBase is
4106             dsmonMatrixTopNOctets, this variable will be used to sort
4107             this report.
4108
4109             If the value of the dsmonMatrixTopNCtlRateBase is
4110             dsmonMatrixTopNHCPkts or dsmonMatrixTopNHCOctets, then this
4111             object will contain the the least significant 32 bits of the
4112             associated dsmonMatrixTopNHCPktRate object."
4113     ::= { dsmonMatrixTopNEntry 13 }
4114
4115 dsmonMatrixTopNOctetRateOvfl OBJECT-TYPE
4116     SYNTAX     Gauge32
4117     MAX-ACCESS read-only
4118     STATUS     deprecated
4119     DESCRIPTION
4120             "The most significant 32 bits of the associated
4121             dsmonMatrixTopNHCOctetRate object.
4122
4123             If the associated dsmonMatrixTopNCtlRateBase is equal to
4124             dsmonMatrixTopNHCPkts or dsmonMatrixTopNHCOctets, then this
4125             object will contain the most significant 32 bits of the
4126             associated dsmonMatrixTopNHCOctetRate object, otherwise this
4127
4128
4129
4130             object will contain the value zero.
4131
4132             The agent MAY choose not to instantiate this object if High
4133             Capacity monitoring is not supported."
4134     ::= { dsmonMatrixTopNEntry 14 }
4135
4136 dsmonMatrixTopNHCOctetRate OBJECT-TYPE
4137     SYNTAX     CounterBasedGauge64
4138     MAX-ACCESS read-only
4139     STATUS     current
4140     DESCRIPTION
4141             "The number of octets seen of this protocol from the source
4142             host to the destination host during this sampling interval,
4143             counted using the rules for counting the
4144             dsmonMatrixSDHCOctets object.
4145
4146             If the value of dsmonMatrixTopNCtlRateBase is
4147             dsmonMatrixTopNHCOctets, this variable will be used to sort
4148             this report.
4149
4150             The agent MAY choose not to instantiate this object if High
4151             Capacity monitoring is not supported."
4152     ::= { dsmonMatrixTopNEntry 15 }
4153
4154 dsmonMatrixTopNRevOctetRate OBJECT-TYPE
4155     SYNTAX     Gauge32
4156     MAX-ACCESS read-only
4157     STATUS     current
4158     DESCRIPTION
4159             "The number of octets seen of this protocol from the
4160             destination host to the source host during this sampling
4161             interval, counted using the rules for counting the
4162             dsmonMatrixDSOctets object  (note that the corresponding
4163             dsmonMatrixSDOctets object selected is the one whose source
4164             address is equal to dsmonMatrixTopNDestAddress and whose
4165             destination address is equal to
4166             dsmonMatrixTopNSourceAddress.)"
4167     ::= { dsmonMatrixTopNEntry 16 }
4168
4169 dsmonMatrixTopNRevOctetRateOvfl OBJECT-TYPE
4170     SYNTAX     Gauge32
4171     MAX-ACCESS read-only
4172     STATUS     deprecated
4173     DESCRIPTION
4174             "The most significant 32 bits of the associated
4175             dsmonMatrixTopNHCRevOctetRate object.
4176
4177             If the associated dsmonMatrixTopNCtlRateBase is equal to
4178
4179
4180
4181             dsmonMatrixTopNHCPkts or dsmonMatrixTopNHCOCtets, then this
4182             object will contain the most significant 32 bits of the
4183             associated dsmonMatrixTopNHCRevPktRate object, otherwise
4184             this object will contain the value zero.
4185
4186             The agent MAY choose not to instantiate this object if High
4187             Capacity monitoring is not supported."
4188     ::= { dsmonMatrixTopNEntry 17 }
4189
4190 dsmonMatrixTopNHCRevOctetRate OBJECT-TYPE
4191     SYNTAX     CounterBasedGauge64
4192     MAX-ACCESS read-only
4193     STATUS     current
4194     DESCRIPTION
4195             "The number of octets seen of this protocol from the
4196             destination host to the source host during this sampling
4197             interval, counted using the rules for counting the
4198             dsmonMatrixDSHCOctets object  (note that the corresponding
4199             dsmonMatrixSDHCOctets object selected is the one whose
4200             source address is equal to dsmonMatrixTopNDestAddress and
4201             whose destination address is equal to
4202             dsmonMatrixTopNSourceAddress.)
4203
4204             The agent MAY choose not to instantiate this object if High
4205             Capacity monitoring is not supported."
4206     ::= { dsmonMatrixTopNEntry 18 }
4207
4208 --
4209 -- Conformance Section
4210 --
4211
4212 dsmonCompliances OBJECT IDENTIFIER ::= { dsmonConformance 1 }
4213 dsmonGroups      OBJECT IDENTIFIER ::= { dsmonConformance 2 }
4214
4215 --
4216 -- Compliance for agents that do not support HC or Counter64
4217 --
4218
4219 dsmonCompliance MODULE-COMPLIANCE
4220     STATUS  current
4221     DESCRIPTION
4222             "Describes the requirements for conformance to the
4223             Differentiated Services Monitoring MIB."
4224     MODULE  -- this module
4225         MANDATORY-GROUPS {
4226                            dsmonCounterAggControlGroup,
4227                            dsmonStatsGroup,
4228                            dsmonCapsGroup
4229
4230
4231
4232                          }
4233
4234         GROUP   dsmonStatsHCGroup
4235         DESCRIPTION
4236             "The dsmonStatsHCGroup is mandatory for systems which
4237             implement High Capacity monitoring."
4238
4239         GROUP   dsmonPdistGroup
4240         DESCRIPTION
4241             "The dsmonPdistGroup is mandatory for systems which
4242             implement RMON-2 protocolDirTable based protocol
4243             distribution monitoring."
4244
4245         GROUP  dsmonPdistHCGroup
4246         DESCRIPTION
4247             "The dsmonPdistHCGroup is mandatory for systems which
4248             implement RMON-2 protocolDirTable based protocol
4249             distribution monitoring on high capacity interfaces."
4250
4251         GROUP  dsmonHostGroup
4252         DESCRIPTION
4253             "The dsmonHostGroup is mandatory for systems which implement
4254             RMON-2 nlHostTable based network protocol monitoring."
4255
4256         GROUP  dsmonHostHCGroup
4257         DESCRIPTION
4258             "The dsmonHostHCGroup is mandatory for systems which
4259             implement RMON-2 nlHostTable based network protocol
4260             monitoring, on high capacity interfaces."
4261
4262         GROUP  dsmonMatrixGroup
4263         DESCRIPTION
4264             "The dsmonMatrixGroup is mandatory for systems which
4265             implement RMON-2 alMatrix based application protocol
4266             monitoring."
4267
4268         GROUP  dsmonMatrixHCGroup
4269         DESCRIPTION
4270             "The dsmonMatrixHCGroup is mandatory for systems which
4271             implement RMON-2 alMatrix based application protocol
4272             monitoring, on high capacity interfaces."
4273
4274     ::= { dsmonCompliances 1 }
4275
4276 --
4277 -- Compliance for agents that support HC and Counter64
4278 --
4279
4280
4281
4282
4283 dsmonHCCompliance MODULE-COMPLIANCE
4284     STATUS  current
4285     DESCRIPTION
4286             "Describes the requirements for conformance to the
4287             Differentiated Services Monitoring MIB for agents which also
4288             support High Capacity monitoring and the Counter64 data
4289             type."
4290     MODULE  -- this module
4291         MANDATORY-GROUPS {
4292                            dsmonCounterAggControlGroup,
4293                            dsmonStatsGroup,
4294                            dsmonStatsHCGroup,
4295                            dsmonCapsGroup
4296                          }
4297
4298         GROUP   dsmonPdistGroup
4299         DESCRIPTION
4300             "The dsmonPdistGroup is mandatory for systems which
4301             implement RMON-2 protocolDirTable based protocol
4302             distribution monitoring."
4303
4304         GROUP  dsmonPdistHCGroup
4305         DESCRIPTION
4306             "The dsmonPdistHCGroup is mandatory for systems which
4307             implement RMON-2 protocolDirTable based protocol
4308             distribution monitoring."
4309
4310         GROUP  dsmonHostGroup
4311         DESCRIPTION
4312             "The dsmonHostGroup is mandatory for systems which implement
4313             RMON-2 nlHostTable based network protocol monitoring."
4314
4315         GROUP  dsmonHostHCGroup
4316         DESCRIPTION
4317             "The dsmonHostHCGroup is mandatory for systems which
4318             implement RMON-2 nlHostTable based network protocol
4319             monitoring."
4320
4321         GROUP  dsmonMatrixGroup
4322         DESCRIPTION
4323             "The dsmonMatrixGroup is mandatory for systems which
4324             implement RMON-2 alMatrix based application protocol
4325             monitoring."
4326
4327         GROUP  dsmonMatrixHCGroup
4328         DESCRIPTION
4329             "The dsmonMatrixHCGroup is mandatory for systems which
4330             implement RMON-2 alMatrix based application protocol
4331
4332
4333
4334             monitoring."
4335
4336     ::= { dsmonCompliances 2 }
4337
4338 --
4339 -- Compliance for agents that support HC, but not Counter64
4340 --
4341
4342 dsmonHCNoC64Compliance MODULE-COMPLIANCE
4343     STATUS  deprecated
4344     DESCRIPTION
4345             "Describes the requirements for conformance to the
4346             Differentiated Services Monitoring MIB for an agent which
4347             supports high capacity monitoring, but does not support the
4348             Counter64 data type (e.g., only supports the SNMPv1
4349             protocol)."
4350     MODULE  -- this module
4351         MANDATORY-GROUPS {
4352                            dsmonCounterAggControlGroup,
4353                            dsmonStatsGroup,
4354                            dsmonStatsOvflGroup,
4355                            dsmonCapsGroup
4356                          }
4357
4358         GROUP   dsmonStatsHCGroup
4359         DESCRIPTION
4360             "Implementation of the dsmonStatsHCGroup is not required.
4361             High Capacity monitoring."
4362
4363         GROUP   dsmonPdistGroup
4364         DESCRIPTION
4365             "The dsmonPdistGroup is mandatory for systems which
4366             implement RMON-2 protocolDirTable based protocol
4367             distribution monitoring."
4368
4369         GROUP   dsmonPdistOvflGroup
4370         DESCRIPTION
4371             "The dsmonPdistGroup is mandatory for systems which
4372             implement RMON-2 protocolDirTable based protocol
4373             distribution monitoring."
4374
4375         GROUP  dsmonPdistHCGroup
4376         DESCRIPTION
4377             "Implementation of the dsmonPdistHCGroup is not required."
4378
4379         GROUP  dsmonHostGroup
4380         DESCRIPTION
4381             "The dsmonHostGroup is mandatory for systems which implement
4382
4383
4384
4385             RMON-2 nlHostTable based network protocol monitoring."
4386
4387         GROUP  dsmonHostOvflGroup
4388         DESCRIPTION
4389             "The dsmonHostGroup is mandatory for systems which implement
4390             RMON-2 nlHostTable based network protocol monitoring."
4391
4392         GROUP  dsmonHostHCGroup
4393         DESCRIPTION
4394             "Implementation of the dsmonHostHCGroup is not required."
4395
4396         GROUP  dsmonMatrixGroup
4397         DESCRIPTION
4398             "The dsmonMatrixGroup is mandatory for systems which
4399             implement RMON-2 alMatrix based application protocol
4400             monitoring."
4401
4402         GROUP  dsmonMatrixOvflGroup
4403         DESCRIPTION
4404             "The dsmonMatrixGroup is mandatory for systems which
4405             implement RMON-2 alMatrix based application protocol
4406             monitoring."
4407
4408         GROUP  dsmonMatrixHCGroup
4409         DESCRIPTION
4410             "Implementation of the dsmonMatrixHCGroup is not required."
4411
4412     ::= { dsmonCompliances 3 }
4413
4414
4415
4416 -- Object Groups
4417
4418 dsmonCounterAggControlGroup OBJECT-GROUP
4419     OBJECTS {
4420              dsmonMaxAggGroups,
4421              dsmonAggControlLocked,
4422              dsmonAggControlChanges,
4423              dsmonAggControlLastChangeTime,
4424              dsmonAggControlDescr,
4425              dsmonAggControlOwner,
4426              dsmonAggControlStatus,
4427              dsmonAggGroupIndex,
4428              dsmonAggGroupDescr,
4429              dsmonAggGroupStatus
4430     }
4431     STATUS  current
4432     DESCRIPTION
4433
4434
4435
4436             "A collection of objects used to configure and manage
4437             counter aggregation groups for DSMON collection purposes."
4438     ::= { dsmonGroups 1 }
4439
4440 dsmonStatsGroup OBJECT-GROUP
4441     OBJECTS {
4442              dsmonStatsControlDataSource,
4443              dsmonStatsControlAggProfile,
4444              dsmonStatsControlDroppedFrames,
4445              dsmonStatsControlCreateTime,
4446              dsmonStatsControlOwner,
4447              dsmonStatsControlStatus,
4448              dsmonStatsInPkts,
4449              dsmonStatsInOctets,
4450              dsmonStatsOutPkts,
4451              dsmonStatsOutOctets
4452     }
4453     STATUS  current
4454     DESCRIPTION
4455             "A collection of objects providing per DSCP statistics."
4456     ::= { dsmonGroups 2 }
4457
4458 dsmonStatsOvflGroup OBJECT-GROUP
4459     OBJECTS {
4460             dsmonStatsInOvflPkts,
4461             dsmonStatsInOvflOctets,
4462             dsmonStatsOutOvflPkts,
4463             dsmonStatsOutOvflOctets
4464     }
4465     STATUS  deprecated
4466     DESCRIPTION
4467             "A collection of objects providing per-DSCP overflow
4468             counters for systems with high capacity data sources, but
4469             without support for the Counter64 data type."
4470     ::= { dsmonGroups 3 }
4471
4472 dsmonStatsHCGroup OBJECT-GROUP
4473     OBJECTS {
4474             dsmonStatsInHCPkts,
4475             dsmonStatsInHCOctets,
4476             dsmonStatsOutHCPkts,
4477             dsmonStatsOutHCOctets
4478     }
4479     STATUS  current
4480     DESCRIPTION
4481             "A collection of objects providing per DSCP statistics for
4482             high capacity data sources."
4483     ::= { dsmonGroups 4 }
4484
4485
4486
4487 dsmonPdistGroup OBJECT-GROUP
4488     OBJECTS {
4489             dsmonPdistCtlDataSource,
4490             dsmonPdistCtlAggProfile,
4491             dsmonPdistCtlMaxDesiredEntries,
4492             dsmonPdistCtlDroppedFrames,
4493             dsmonPdistCtlInserts,
4494             dsmonPdistCtlDeletes,
4495             dsmonPdistCtlCreateTime,
4496             dsmonPdistCtlOwner,
4497             dsmonPdistCtlStatus,
4498             dsmonPdistStatsPkts,
4499             dsmonPdistStatsOctets,
4500             dsmonPdistStatsCreateTime,
4501             dsmonPdistTopNCtlPdistIndex,
4502             dsmonPdistTopNCtlRateBase,
4503             dsmonPdistTopNCtlTimeRemaining,
4504             dsmonPdistTopNCtlGeneratedReprts,
4505             dsmonPdistTopNCtlDuration,
4506             dsmonPdistTopNCtlRequestedSize,
4507             dsmonPdistTopNCtlGrantedSize,
4508             dsmonPdistTopNCtlStartTime,
4509             dsmonPdistTopNCtlOwner,
4510             dsmonPdistTopNCtlStatus,
4511             dsmonPdistTopNPDLocalIndex,
4512             dsmonPdistTopNAggGroup,
4513             dsmonPdistTopNRate
4514     }
4515     STATUS  current
4516     DESCRIPTION
4517             "A collection of objects providing per protocol DSCP
4518             monitoring extensions to the RMON-2 MIB."
4519     ::= { dsmonGroups 5 }
4520
4521 dsmonPdistOvflGroup OBJECT-GROUP
4522     OBJECTS {
4523             dsmonPdistStatsOvflPkts,
4524             dsmonPdistStatsOvflOctets,
4525             dsmonPdistTopNRateOvfl
4526     }
4527     STATUS  deprecated
4528     DESCRIPTION
4529             "A collection of objects providing per-protocol DSCP
4530             overflow counters for systems with high capacity data
4531             sources, but without support for the Counter64 data type."
4532     ::= { dsmonGroups 6 }
4533
4534 dsmonPdistHCGroup OBJECT-GROUP
4535
4536
4537
4538     OBJECTS {
4539             dsmonPdistStatsHCPkts,
4540             dsmonPdistStatsHCOctets,
4541             dsmonPdistTopNHCRate
4542     }
4543     STATUS  current
4544     DESCRIPTION
4545             "A collection of objects providing per protocol DSCP
4546             monitoring extensions to the RMON-2 MIB for High Capacity
4547             networks."
4548     ::= { dsmonGroups 7 }
4549
4550 dsmonHostGroup OBJECT-GROUP
4551     OBJECTS {
4552             dsmonHostCtlDataSource,
4553             dsmonHostCtlAggProfile,
4554             dsmonHostCtlMaxDesiredEntries,
4555             dsmonHostCtlIPv4PrefixLen,
4556             dsmonHostCtlIPv6PrefixLen,
4557             dsmonHostCtlDroppedFrames,
4558             dsmonHostCtlInserts,
4559             dsmonHostCtlDeletes,
4560             dsmonHostCtlCreateTime,
4561             dsmonHostCtlOwner,
4562             dsmonHostCtlStatus,
4563             dsmonHostInPkts,
4564             dsmonHostInOctets,
4565             dsmonHostOutPkts,
4566             dsmonHostOutOctets,
4567             dsmonHostCreateTime,
4568             dsmonHostTopNCtlHostIndex,
4569             dsmonHostTopNCtlRateBase,
4570             dsmonHostTopNCtlTimeRemaining,
4571             dsmonHostTopNCtlGeneratedReports,
4572             dsmonHostTopNCtlDuration,
4573             dsmonHostTopNCtlRequestedSize,
4574             dsmonHostTopNCtlGrantedSize,
4575             dsmonHostTopNCtlStartTime,
4576             dsmonHostTopNCtlOwner,
4577             dsmonHostTopNCtlStatus,
4578             dsmonHostTopNPDLocalIndex,
4579             dsmonHostTopNAddress,
4580             dsmonHostTopNAggGroup,
4581             dsmonHostTopNRate
4582     }
4583     STATUS  current
4584     DESCRIPTION
4585             "A collection of objects providing per Host monitoring
4586
4587
4588
4589             functions."
4590     ::= { dsmonGroups 8 }
4591
4592 dsmonHostOvflGroup OBJECT-GROUP
4593     OBJECTS {
4594             dsmonHostInOvflPkts,
4595             dsmonHostInOvflOctets,
4596             dsmonHostOutOvflPkts,
4597             dsmonHostOutOvflOctets,
4598             dsmonHostTopNRateOvfl
4599     }
4600     STATUS  deprecated
4601     DESCRIPTION
4602             "A collection of objects providing per host DSCP overflow
4603             counters for systems with high capacity data sources, but
4604             without support for the Counter64 data type."
4605     ::= { dsmonGroups 9 }
4606
4607 dsmonHostHCGroup OBJECT-GROUP
4608     OBJECTS {
4609             dsmonHostInHCPkts,
4610             dsmonHostInHCOctets,
4611             dsmonHostOutHCPkts,
4612             dsmonHostOutHCOctets,
4613             dsmonHostTopNHCRate
4614     }
4615     STATUS  current
4616     DESCRIPTION
4617             "A collection of objects providing per Host monitoring
4618             functions for High Capacity networks."
4619     ::= { dsmonGroups 10 }
4620
4621 dsmonCapsGroup OBJECT-GROUP
4622     OBJECTS {
4623             dsmonCapabilities
4624     }
4625     STATUS  current
4626     DESCRIPTION
4627             "A collection of objects providing an indication of the
4628             DSMON monitoring functions supported by the agent."
4629     ::= { dsmonGroups 11 }
4630
4631 dsmonMatrixGroup OBJECT-GROUP
4632     OBJECTS {
4633             dsmonMatrixCtlDataSource,
4634             dsmonMatrixCtlAggProfile,
4635             dsmonMatrixCtlMaxDesiredEntries,
4636             dsmonMatrixCtlDroppedFrames,
4637
4638
4639
4640             dsmonMatrixCtlInserts,
4641             dsmonMatrixCtlDeletes,
4642             dsmonMatrixCtlCreateTime,
4643             dsmonMatrixCtlOwner,
4644             dsmonMatrixCtlStatus,
4645             dsmonMatrixSDPkts,
4646             dsmonMatrixSDOctets,
4647             dsmonMatrixSDCreateTime,
4648             dsmonMatrixDSPkts,
4649             dsmonMatrixDSOctets,
4650             dsmonMatrixDSCreateTime,
4651             dsmonMatrixTopNCtlMatrixIndex,
4652             dsmonMatrixTopNCtlRateBase,
4653             dsmonMatrixTopNCtlTimeRemaining,
4654             dsmonMatrixTopNCtlGeneratedRpts,
4655             dsmonMatrixTopNCtlDuration,
4656             dsmonMatrixTopNCtlRequestedSize,
4657             dsmonMatrixTopNCtlGrantedSize,
4658             dsmonMatrixTopNCtlStartTime,
4659             dsmonMatrixTopNCtlOwner,
4660             dsmonMatrixTopNCtlStatus,
4661             dsmonMatrixTopNAggGroup,
4662             dsmonMatrixTopNNLIndex,
4663             dsmonMatrixTopNSourceAddress,
4664             dsmonMatrixTopNDestAddress,
4665             dsmonMatrixTopNALIndex,
4666             dsmonMatrixTopNPktRate,
4667             dsmonMatrixTopNRevPktRate,
4668             dsmonMatrixTopNOctetRate,
4669             dsmonMatrixTopNRevOctetRate
4670     }
4671     STATUS  current
4672     DESCRIPTION
4673             "A collection of objects providing per conversation
4674             monitoring functions."
4675     ::= { dsmonGroups 12 }
4676
4677 dsmonMatrixOvflGroup OBJECT-GROUP
4678     OBJECTS {
4679             dsmonMatrixSDOvflPkts,
4680             dsmonMatrixSDOvflOctets,
4681             dsmonMatrixDSOvflPkts,
4682             dsmonMatrixDSOvflOctets,
4683             dsmonMatrixTopNPktRateOvfl,
4684             dsmonMatrixTopNRevPktRateOvfl,
4685             dsmonMatrixTopNOctetRateOvfl,
4686             dsmonMatrixTopNRevOctetRateOvfl
4687     }
4688
4689
4690
4691     STATUS  deprecated
4692     DESCRIPTION
4693             "A collection of objects providing per conversation
4694             monitoring functions for systems with high capacity data
4695             sources, but without support for the Counter64 data type."
4696     ::= { dsmonGroups 13 }
4697
4698 dsmonMatrixHCGroup OBJECT-GROUP
4699     OBJECTS {
4700             dsmonMatrixSDHCPkts,
4701             dsmonMatrixSDHCOctets,
4702             dsmonMatrixDSHCPkts,
4703             dsmonMatrixDSHCOctets,
4704             dsmonMatrixTopNHCPktRate,
4705             dsmonMatrixTopNHCRevPktRate,
4706             dsmonMatrixTopNHCOctetRate,
4707             dsmonMatrixTopNHCRevOctetRate
4708     }
4709     STATUS  current
4710     DESCRIPTION
4711             "A collection of objects providing per conversation
4712             monitoring functions for High Capacity networks."
4713     ::= { dsmonGroups 14 }
4714
4715 END