-- extracted from rfc2493.txt
-- at Mon Nov 15 17:11:40 1999

PerfHist-TC-MIB DEFINITIONS ::= BEGIN

IMPORTS
        MODULE-IDENTITY,
        Gauge32,
        mib-2
                FROM SNMPv2-SMI
        TEXTUAL-CONVENTION
                FROM SNMPv2-TC;

perfHistTCMIB MODULE-IDENTITY
        LAST-UPDATED "9811071100Z" -- Nov 7, 1998 11:00:00 AM
        ORGANIZATION "IETF AToMMIB and TrunkMIB WGs"
        CONTACT-INFO
               "Kaj Tesink
                Postal:  Bellcore
                         331 Newman Springs Road
                         Red Bank, NJ 07701
                         USA
                Tel:     +1 732 758 5254
                Fax:     +1 732 758 2269
                E-mail:  kaj@bellcore.com"
        DESCRIPTION
               "This MIB Module provides Textual Conventions
                to be used by systems supporting 15 minute
                based performance history counts."
 -- 1.3.6.1.2.1.58 --  ::= { mib-2 58 }


-- The Textual Conventions defined below are organized
-- alphabetically
-- Use of these TCs assumes the following:
-- 0  The agent supports 15 minute based history
--    counters.
-- 0  The agent is capable of keeping a history of n
--    intervals of 15 minute performance data. The
--    value of n is defined by the specific MIB
--    module but shall be 0 < n =< 96.
-- 0  The agent may optionally support performance
--    data aggregating the history intervals.
-- 0  The agent will keep separate tables for the
--    current interval, the history intervals, and
--    the total aggregates.
-- 0  The agent will keep the following objects.
--    If performance data is kept for multiple instances
--    of a measured entity, then
--    these objects are applied to each instance of
--    the measured entity (e.g., interfaces).
--
-- xyzTimeElapsed OBJECT-TYPE
--       SYNTAX  INTEGER (0..899)
--       MAX-ACCESS  read-only
--       STATUS  current
--       DESCRIPTION
--       "The number of seconds that have elapsed since
--       the beginning of the current measurement period.
--       If, for some reason, such as an adjustment in the
--       system's time-of-day clock, the current interval
--       exceeds the maximum value, the agent will return
--       the maximum value."
--       ::= { xxx }
-- xyzValidIntervals OBJECT-TYPE
--       SYNTAX  INTEGER (0..)
--       MAX-ACCESS  read-only
--       STATUS  current
--       DESCRIPTION
--       "The number of previous near end intervals
--       for which data was collected.
--          [ The overall constraint on  is 1 =< n =< 96; ]
--          [ Define any additional constraints on  here. ]
--       The value will be  unless the measurement was
--       (re-)started within the last (*15) minutes, in which
--       case the value will be the number of complete 15
--       minute intervals for which the agent has at least
--       some data. In certain cases (e.g., in the case
--       where the agent is a proxy) it is possible that some
--       intervals are unavailable.  In this case, this
--       interval is the maximum interval number for
--       which data is available."
--       ::= { xxx }
-- xyzInvalidIntervals OBJECT-TYPE
--     SYNTAX  INTEGER (0..)
--     MAX-ACCESS  read-only
--     STATUS  current
--     DESCRIPTION
--       "The number of intervals in the range from
--        0 to xyzValidIntervals for which no
--        data is available. This object will typically
--        be zero except in cases where the data for some
--        intervals are not available (e.g., in proxy
--        situations)."
--       ::= { xxx }

PerfCurrentCount ::= TEXTUAL-CONVENTION
        STATUS current
        DESCRIPTION
               "A counter associated with a
                performance measurement in a current 15
                minute measurement interval. The value
                of this counter starts from zero and is
                increased when associated events occur,
                until the end of the 15 minute interval.
                At that time the value of the counter is
                stored in the first 15 minute history
                interval, and the CurrentCount is
                restarted at zero. In the
                case where the agent has no valid data
                available for the current interval the
                corresponding object instance is not
                available and upon a retrieval request
                a corresponding error message shall be
                returned to indicate that this instance
                does not exist (for example, a noSuchName
                error for SNMPv1 and a noSuchInstance for
                SNMPv2 GET operation)."
        SYNTAX Gauge32


PerfIntervalCount ::= TEXTUAL-CONVENTION
        STATUS current
        DESCRIPTION
               "A counter associated with a
                performance measurement in a previous
                15 minute measurement interval. In the
                case where the agent has no valid data
                available for a particular interval the
                corresponding object instance is not
                available and upon a retrieval request
                a corresponding error message shall be
                returned to indicate that this instance
                does not exist (for example, a noSuchName
                error for SNMPv1 and a noSuchInstance for
                SNMPv2 GET operation).
                In a system supporting
                a history of n intervals with
                IntervalCount(1) and IntervalCount(n) the
                most and least recent intervals
                respectively, the following applies at
                the end of a 15 minute interval:
                - discard the value of IntervalCount(n)
                - the value of IntervalCount(i) becomes that
                  of IntervalCount(i-1) for n >= i > 1
                - the value of IntervalCount(1) becomes that
                  of CurrentCount
                - the TotalCount, if supported, is adjusted."
        SYNTAX Gauge32


PerfTotalCount ::= TEXTUAL-CONVENTION
        STATUS current
        DESCRIPTION
               "A counter associated with a
                performance measurements aggregating the
                previous valid 15 minute measurement
                intervals. (Intervals for which no valid
                data was available are not counted)"
        SYNTAX Gauge32


END
-- 
--    Copyright (C) The Internet Society (1999).  All Rights Reserved.
-- 
--    This document and translations of it may be copied and furnished to
--    others, and derivative works that comment on or otherwise explain it
--    or assist in its implementation may be prepared, copied, published
--    and distributed, in whole or in part, without restriction of any
--    kind, provided that the above copyright notice and this paragraph are
--    included on all such copies and derivative works.  However, this
--    document itself may not be modified in any way, such as by removing
--    the copyright notice or references to the Internet Society or other
--    Internet organizations, except as needed for the purpose of
--    developing Internet standards in which case the procedures for
--    copyrights defined in the Internet Standards process must be
--    followed, or as required to translate it into languages other than
--    English.
-- 
--    The limited permissions granted above are perpetual and will not be
--    revoked by the Internet Society or its successors or assigns.
-- 
--    This document and the information contained herein is provided on an
--    "AS IS" basis and THE INTERNET SOCIETY AND THE INTERNET ENGINEERING
--    TASK FORCE DISCLAIMS ALL WARRANTIES, EXPRESS OR IMPLIED, INCLUDING
--    BUT NOT LIMITED TO ANY WARRANTY THAT THE USE OF THE INFORMATION
--    HEREIN WILL NOT INFRINGE ANY RIGHTS OR ANY IMPLIED WARRANTIES OF
--    MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE.