CISCO-REPORT-INTERVAL-TC-MIB

This MIB module defines textual conventions used by MIB
modules that define objects describing performance history
data based on a configurable reporting interval.

Use of these textual conventions assumes the following:

    - The SNMP entity supports performance history data
      collection based on a configurable interval.

    - The SNMP entity is capable of maintaining a history of N
      report intervals.  A MIB module using these textual
      conventions defines the value of N, which may be
      configurable.

    - The SNMP entity may optionally support aggregation of
      performance data maintained by historic report intervals.

    - A MIB module using these textual conventions may define
      separate tables for the current interval, historic
      intervals, and the aggregation of historic performance
      data.

    - A MIB module using these textual conventions must define
      the following objects:

      xxxReportInterval OBJECT-TYPE
          SYNTAX      Unsigned32 (0..4294967295)
          UNITS       'xxx-units'
          MAX-ACCESS  read-only
          STATUS      current
          DESCRIPTION
              'This object indicates the duration of a report
              interval.'
          ::= { xxx }

      xxxReportMaxIntervals OBJECT-TYPE
          SYNTAX      Unsigned32 (0..4294967295)
          UNITS       'report intervals'
          MAX-ACCESS  read-only
          STATUS      current
          DESCRIPTION
              'This object indicates the maximum number of
              report intervals.'
          ::= { xxx }

      xxxReportElapsedTime OBJECT-TYPE
          SYNTAX      Gauge32
          UNITS       'xxx-units'
          MAX-ACCESS  read-only
          STATUS      current
          DESCRIPTION
              'This object indicates the time that has elapsed
              since the beginning of the current report
              interval.'
          ::= { xxx }

      xxxReportIntervals OBJECT-TYPE
          SYNTAX      Gauge32
          UNITS       'report intervals'
          MAX-ACCESS  read-only
          STATUS      current
          DESCRIPTION
              'This object indicates the number of report
              intervals for which data has been collected.  The
              value of this column starts at 0 and increments
              at the end of each report interval until the 
              number of report intervals is equal to the 
              corresponding value of xxxReportMaxIntervals.'
          ::= { xxx }

      xxxReportInvalidIntervals OBJECT-TYPE
          SYNTAX      Gauge32
          UNITS       'report intervals'
          MAX-ACCESS  read-only
          STATUS      current
          DESCRIPTION
              'This object indicates the number of report
              intervals, in the range of 0 to the value of the
              corresponding instance of xxxReportValidIntervals,

              for which no data is available.  The value of this
              column will typically be 0, except in certain
              circumstances when some intervals are not
              available.
          ::= { xxx }

      Observe that if the MIB module defines tables that
      maintain performance data for multiple instances of a
      measured entity (e.g., an interface), then the definition
      of these objects need to allow for the maintenance of
      these objects per instance of the measured entity.

      A MIB module may choose to provide the write-access to
      xxxReportInterval and xxxReportMaxIntervals.  In this 
      case, the MIB module must consider the following:

      - The MIB module may want to refine the data type to
        something more concise.  Alternatively, an 
        implementation may specify variations in an agent
        capabilities.

      - If the definition of either of these objects specifies
        '0' as an acceptable value, then the descriptive text
        should describe the semantics of this value.

      - The descriptive text of xxxReportInterval must explain,
        'When this value changes, the SNMP entity should discard
        any previously collected report interval data.'

      - The descriptive text of xxxReportMaxIntervals must
        explain, 'When this value changes to a value less than
        its current value, the SNMP entity should discard older
        report intervals to comply with the new value.'

Imported Objects

ciscoMgmtCISCO-SMI
MODULE-IDENTITY, Gauge32SNMPv2-SMI
TEXTUAL-CONVENTIONSNMPv2-TC
ciscoReportIntervalTcMIB.1.3.6.1.4.1.9.9.670