Blame mibs/ietf/ACCOUNTING-CONTROL-MIB

Packit 022b05
ACCOUNTING-CONTROL-MIB DEFINITIONS ::= BEGIN
Packit 022b05
Packit 022b05
IMPORTS
Packit 022b05
    MODULE-IDENTITY, OBJECT-TYPE, NOTIFICATION-TYPE,
Packit 022b05
    mib-2, Integer32                              FROM SNMPv2-SMI
Packit 022b05
    TEXTUAL-CONVENTION, RowStatus, TestAndIncr,
Packit 022b05
    DisplayString, TruthValue                     FROM SNMPv2-TC
Packit 022b05
    MODULE-COMPLIANCE, OBJECT-GROUP, NOTIFICATION-GROUP
Packit 022b05
                                                  FROM SNMPv2-CONF
Packit 022b05
    ifIndex                                       FROM IF-MIB;
Packit 022b05
Packit 022b05
Packit 022b05
accountingControlMIB MODULE-IDENTITY
Packit 022b05
    LAST-UPDATED "9809281000Z"
Packit 022b05
    ORGANIZATION "IETF AToM MIB Working Group"
Packit 022b05
    CONTACT-INFO "Keith McCloghrie
Packit 022b05
                  Cisco Systems, Inc.
Packit 022b05
                  170 West Tasman Drive,
Packit 022b05
                  San Jose CA 95134-1706.
Packit 022b05
                  Phone: +1 408 526 5260
Packit 022b05
                  Email: kzm@cisco.com"
Packit 022b05
    DESCRIPTION
Packit 022b05
            "The MIB module for managing the collection and storage of
Packit 022b05
            accounting information for connections in a connection-
Packit 022b05
            oriented network such as ATM."
Packit 022b05
    ::= { mib-2 60 }
Packit 022b05
Packit 022b05
Packit 022b05
acctngMIBObjects       OBJECT IDENTIFIER ::= { accountingControlMIB 1 }
Packit 022b05
Packit 022b05
acctngSelectionControl OBJECT IDENTIFIER ::= { acctngMIBObjects 1 }
Packit 022b05
acctngFileControl      OBJECT IDENTIFIER ::= { acctngMIBObjects 2 }
Packit 022b05
acctngInterfaceControl OBJECT IDENTIFIER ::= { acctngMIBObjects 3 }
Packit 022b05
acctngTrapControl      OBJECT IDENTIFIER ::= { acctngMIBObjects 4 }
Packit 022b05
Packit 022b05
-- Textual Conventions
Packit 022b05
Packit 022b05
Packit 022b05
DataCollectionSubtree ::= TEXTUAL-CONVENTION
Packit 022b05
    STATUS       current
Packit 022b05
    DESCRIPTION
Packit 022b05
            "The subtree component of a (subtree, list) tuple.  Such a
Packit 022b05
            (subtree, list) tuple defines a set of objects and their
Packit 022b05
            values to be collected as accounting data for a connection.
Packit 022b05
            The subtree specifies a single OBJECT IDENTIFIER value such
Packit 022b05
            that each object in the set is named by the subtree value
Packit 022b05
            appended with a single additional sub-identifier."
Packit 022b05
    SYNTAX       OBJECT IDENTIFIER
Packit 022b05
Packit 022b05
DataCollectionList ::= TEXTUAL-CONVENTION
Packit 022b05
    STATUS       current
Packit 022b05
    DESCRIPTION
Packit 022b05
            "The list component of a (subtree, list) tuple.  Such a
Packit 022b05
            (subtree, list) tuple defines a set of objects and their
Packit 022b05
            values to be collected as accounting data for a connection.
Packit 022b05
            The subtree specifies a single OBJECT IDENTIFIER value such
Packit 022b05
            that each object in the set is named by the subtree value
Packit 022b05
            appended with a single additional sub-identifier.  The list
Packit 022b05
            specifies a set of data items, where the presence of an item
Packit 022b05
            in the list indicates that the item is (to be) present in
Packit 022b05
            the data collected for a connection; the absence of an item
Packit 022b05
            from the list indicates that the item is not (to be) present
Packit 022b05
            in the data collected for a connection.  Each data item is
Packit 022b05
            represented by an integer which when appended (as as
Packit 022b05
            additional sub-identifier) to the OBJECT IDENTIFIER value of
Packit 022b05
            the subtree identified by the tuple, is the name of an
Packit 022b05
            object defining that data item (its description and its
Packit 022b05
            syntax).
Packit 022b05
Packit 022b05
            The list is specified as an OCTET STRING in which each data
Packit 022b05
            item is represented by a single bit, where data items 1
Packit 022b05
            through 8 are represented by the bits in the first octet,
Packit 022b05
            data items 9 through 16 by the bits in the second octet,
Packit 022b05
            etc.  In each octet, the lowest numbered data item is
Packit 022b05
            represented by the most significant bit, and the highest
Packit 022b05
            numbered data item by the least significant bit.  A data
Packit 022b05
            item is present in the list when its bit is set, and absent
Packit 022b05
            when its bit is reset.  If the length of an OCTET STRING
Packit 022b05
            value is too short to represent one or more data items
Packit 022b05
            defined in a subtree, then those data items are absent from
Packit 022b05
            the set identified by the tuple of that subtree and that
Packit 022b05
            OCTET STRING value."
Packit 022b05
    SYNTAX       OCTET STRING (SIZE(0..8))
Packit 022b05
Packit 022b05
FileIndex ::= TEXTUAL-CONVENTION
Packit 022b05
    STATUS       current
Packit 022b05
    DESCRIPTION
Packit 022b05
            "An arbitrary integer value identifying a file into which
Packit 022b05
            accounting data is being collected."
Packit 022b05
    SYNTAX       Integer32 (1..65535)
Packit 022b05
Packit 022b05
Packit 022b05
-- The Accounting Information Selection table
Packit 022b05
Packit 022b05
acctngSelectionTable OBJECT-TYPE
Packit 022b05
    SYNTAX      SEQUENCE OF AcctngSelectionEntry
Packit 022b05
    MAX-ACCESS  not-accessible
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
            "A list of accounting information selection entries.
Packit 022b05
Packit 022b05
            Note that additions, modifications and deletions of entries
Packit 022b05
            in this table can occur at any time, but such changes only
Packit 022b05
            take effect on the next occasion when collection begins into
Packit 022b05
            a new file.  Thus, between modification and the next 'swap',
Packit 022b05
            the content of this table does not reflect the current
Packit 022b05
            selection."
Packit 022b05
    ::= { acctngSelectionControl 1 }
Packit 022b05
Packit 022b05
acctngSelectionEntry OBJECT-TYPE
Packit 022b05
    SYNTAX      AcctngSelectionEntry
Packit 022b05
    MAX-ACCESS  not-accessible
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
            "An entry identifying an (subtree, list) tuple used to
Packit 022b05
            select a set of accounting information which is to be
Packit 022b05
            collected."
Packit 022b05
    INDEX   { acctngSelectionIndex }
Packit 022b05
    ::= { acctngSelectionTable 1 }
Packit 022b05
Packit 022b05
AcctngSelectionEntry ::=
Packit 022b05
    SEQUENCE {
Packit 022b05
        acctngSelectionIndex     Integer32,
Packit 022b05
        acctngSelectionSubtree   DataCollectionSubtree,
Packit 022b05
        acctngSelectionList      DataCollectionList,
Packit 022b05
        acctngSelectionFile      FileIndex,
Packit 022b05
        acctngSelectionType      BITS,
Packit 022b05
        acctngSelectionRowStatus RowStatus
Packit 022b05
    }
Packit 022b05
Packit 022b05
acctngSelectionIndex OBJECT-TYPE
Packit 022b05
    SYNTAX      Integer32 (1..65535)
Packit 022b05
    MAX-ACCESS  not-accessible
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
            "An arbitrary integer value which uniquely identifies a
Packit 022b05
            tuple stored in this table.  This value is required to be
Packit 022b05
            the permanent 'handle' for an entry in this table for as
Packit 022b05
            long as that entry exists, including across restarts and
Packit 022b05
            power outages."
Packit 022b05
    ::= { acctngSelectionEntry 1 }
Packit 022b05
Packit 022b05
acctngSelectionSubtree OBJECT-TYPE
Packit 022b05
    SYNTAX      DataCollectionSubtree
Packit 022b05
    MAX-ACCESS  read-create
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
            "The combination of acctngSelectionSubtree and
Packit 022b05
            acctngSelectionList specifies one (subtree, list) tuple
Packit 022b05
            which is to be collected."
Packit 022b05
    ::= { acctngSelectionEntry 2 }
Packit 022b05
Packit 022b05
acctngSelectionList OBJECT-TYPE
Packit 022b05
    SYNTAX      DataCollectionList
Packit 022b05
    MAX-ACCESS  read-create
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
            "The combination of acctngSelectionSubtree and
Packit 022b05
            acctngSelectionList specifies one (subtree, list) tuple
Packit 022b05
            which is to be collected."
Packit 022b05
    ::= { acctngSelectionEntry 3 }
Packit 022b05
Packit 022b05
acctngSelectionFile OBJECT-TYPE
Packit 022b05
    SYNTAX      FileIndex
Packit 022b05
    MAX-ACCESS  read-create
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
            "An indication of the file into which the accounting
Packit 022b05
            information identified by this entry is to be stored.  If
Packit 022b05
            there is no conceptual row in the acctngFileTable for which
Packit 022b05
            the value of acctngFileIndex has the same value as this
Packit 022b05
            object, then the information selected by this entry is not
Packit 022b05
            collected."
Packit 022b05
    ::= { acctngSelectionEntry 4 }
Packit 022b05
Packit 022b05
acctngSelectionType OBJECT-TYPE
Packit 022b05
    SYNTAX      BITS { svcIncoming(0),
Packit 022b05
                       svcOutgoing(1),
Packit 022b05
                       svpIncoming(2),
Packit 022b05
                       svpOutgoing(3),
Packit 022b05
                       pvc(4),
Packit 022b05
                       pvp(5),
Packit 022b05
                       spvcOriginator(6),
Packit 022b05
                       spvcTarget(7),
Packit 022b05
                       spvpOriginator(8),
Packit 022b05
                       spvpTarget(9) }
Packit 022b05
    MAX-ACCESS  read-create
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
            "Indicates the types of connections for which the
Packit 022b05
            information selected by this entry are to be collected."
Packit 022b05
    DEFVAL      { { svcIncoming, svcOutgoing,
Packit 022b05
                    svpIncoming, svpOutgoing } }
Packit 022b05
    ::= { acctngSelectionEntry 5 }
Packit 022b05
Packit 022b05
acctngSelectionRowStatus OBJECT-TYPE
Packit 022b05
    SYNTAX      RowStatus
Packit 022b05
    MAX-ACCESS  read-create
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
            "The status of this conceptual row.  An agent may refuse to
Packit 022b05
            create new conceptual rows and/or modify existing conceptual
Packit 022b05
            rows, if such creation/modification would cause multiple
Packit 022b05
            rows to have the same values of acctngSelectionSubtree and
Packit 022b05
            acctngSelectionList.
Packit 022b05
Packit 022b05
            A conceptual row can not have the status of 'active' until
Packit 022b05
            values have been assigned to the acctngSelectionSubtree,
Packit 022b05
            acctngSelectionList and acctngSelectionFile columnar objects
Packit 022b05
            within that row.
Packit 022b05
Packit 022b05
            An agent must not refuse to change the values of the
Packit 022b05
            acctngSelectionSubtree, acctngSelectionList and
Packit 022b05
            acctngSelectionFile columnar objects within a conceptual row
Packit 022b05
            even while that row's status is 'active'.  Similarly, an
Packit 022b05
            agent must not refuse to destroy an existing conceptual row
Packit 022b05
            while the file referenced by that row's instance of
Packit 022b05
            acctngSelectionFile is in active use, i.e., while the
Packit 022b05
            corresponding instance of acctngFileRowStatus has the value
Packit 022b05
            'active'.  However, such changes only take effect upon the
Packit 022b05
            next occasion when collection begins into a new (version of
Packit 022b05
            the) file."
Packit 022b05
    ::= { acctngSelectionEntry 6 }
Packit 022b05
Packit 022b05
-- The Accounting File table
Packit 022b05
Packit 022b05
acctngFileTable OBJECT-TYPE
Packit 022b05
    SYNTAX      SEQUENCE OF AcctngFileEntry
Packit 022b05
    MAX-ACCESS  not-accessible
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
            "A list of files into which accounting information is to be
Packit 022b05
            stored."
Packit 022b05
    ::= { acctngFileControl 1 }
Packit 022b05
Packit 022b05
acctngFileEntry OBJECT-TYPE
Packit 022b05
    SYNTAX      AcctngFileEntry
Packit 022b05
    MAX-ACCESS  not-accessible
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
            "An entry identifying a file into which accounting
Packit 022b05
            information is to be collected."
Packit 022b05
    INDEX   { acctngFileIndex }
Packit 022b05
    ::= { acctngFileTable 1 }
Packit 022b05
Packit 022b05
AcctngFileEntry ::=
Packit 022b05
    SEQUENCE {
Packit 022b05
        acctngFileIndex                 FileIndex,
Packit 022b05
        acctngFileName                  DisplayString,
Packit 022b05
        acctngFileNameSuffix            DisplayString,
Packit 022b05
        acctngFileDescription           DisplayString,
Packit 022b05
        acctngFileCommand               INTEGER,
Packit 022b05
        acctngFileMaximumSize           Integer32,
Packit 022b05
        acctngFileCurrentSize           Integer32,
Packit 022b05
        acctngFileFormat                INTEGER,
Packit 022b05
        acctngFileCollectMode           BITS,
Packit 022b05
        acctngFileCollectFailedAttempts BITS,
Packit 022b05
        acctngFileInterval              Integer32,
Packit 022b05
        acctngFileMinAge                Integer32,
Packit 022b05
        acctngFileRowStatus             RowStatus
Packit 022b05
    }
Packit 022b05
Packit 022b05
acctngFileIndex OBJECT-TYPE
Packit 022b05
    SYNTAX      FileIndex
Packit 022b05
    MAX-ACCESS  not-accessible
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
            "A unique value identifying a file into which accounting
Packit 022b05
            data is to be stored.  This value is required to be the
Packit 022b05
            permanent 'handle' for an entry in this table for as long as
Packit 022b05
            that entry exists, including across restarts and power
Packit 022b05
            outages."
Packit 022b05
    ::= { acctngFileEntry 1 }
Packit 022b05
Packit 022b05
acctngFileName OBJECT-TYPE
Packit 022b05
    SYNTAX      DisplayString (SIZE(1..32))
Packit 022b05
    MAX-ACCESS  read-create
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
            "The name of the file into which accounting data is to be
Packit 022b05
            stored.  If files are named using suffixes, then the name of
Packit 022b05
            the current file is the concatenation of acctngFileName and
Packit 022b05
            acctngFileNameSuffix.
Packit 022b05
Packit 022b05
            An agent will respond with an error (e.g., 'wrongValue') to
Packit 022b05
            a management set operation which attempts to modify the
Packit 022b05
            value of this object to the same value as already held by
Packit 022b05
            another instance of acctngFileName.  An agent will also
Packit 022b05
            respond with an error (e.g., 'wrongValue') if the new value
Packit 022b05
            is invalid for use as a file name on the local file system
Packit 022b05
            (e.g., many file systems do not support white space embedded
Packit 022b05
            in file names).
Packit 022b05
Packit 022b05
            The value of this object can not be modified while the
Packit 022b05
            corresponding instance of acctngFileRowStatus is 'active'."
Packit 022b05
    ::= { acctngFileEntry 2 }
Packit 022b05
Packit 022b05
acctngFileNameSuffix OBJECT-TYPE
Packit 022b05
    SYNTAX      DisplayString (SIZE(0..8))
Packit 022b05
    MAX-ACCESS  read-only
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
            "The suffix, if any, of the name of a file into which
Packit 022b05
            accounting data is currently being stored.  If suffixes are
Packit 022b05
            not used, then the value of this object is the zero-length
Packit 022b05
            string.  Note that if a separator, such as a period, is used
Packit 022b05
            in appending the suffix to the file name, then that
Packit 022b05
            separator appears as the first character of this value."
Packit 022b05
    ::= { acctngFileEntry 3 }
Packit 022b05
Packit 022b05
acctngFileDescription OBJECT-TYPE
Packit 022b05
    SYNTAX      DisplayString
Packit 022b05
    MAX-ACCESS  read-create
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
            "The textual description of the accounting data which will
Packit 022b05
            be stored (on the next occasion) when header information is
Packit 022b05
            stored in the file.  The value of this object may be
Packit 022b05
            modified at any time."
Packit 022b05
    DEFVAL      { "" }
Packit 022b05
    ::= { acctngFileEntry 4 }
Packit 022b05
Packit 022b05
acctngFileCommand OBJECT-TYPE
Packit 022b05
    SYNTAX      INTEGER {
Packit 022b05
                    -- the following two values are states:
Packit 022b05
                    -- they may be read but not written
Packit 022b05
                    idle(1),
Packit 022b05
                    cmdInProgress(2),
Packit 022b05
                    -- the following two values are actions:
Packit 022b05
                    -- they may be written, but are never read
Packit 022b05
                    swapToNewFile(3),
Packit 022b05
                    collectNow(4)
Packit 022b05
                }
Packit 022b05
    MAX-ACCESS  read-create
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
            "A control object for the collection of accounting data.
Packit 022b05
            When read the value is either 'idle' or 'cmdInProgress'.
Packit 022b05
            Writing a value is only allowed when the current value is
Packit 022b05
            'idle'.  When a value is successfully written, the value
Packit 022b05
            changes to 'cmdInProgress' until completion of the action,
Packit 022b05
            at which time the value reverts to 'idle'.  Actions are
Packit 022b05
            invoked by writing the following values:
Packit 022b05
Packit 022b05
               'swapToNewFile' - the collection of data into the current
Packit 022b05
                      file is terminated, and collection continues into
Packit 022b05
                      a new (version of the) file.
Packit 022b05
Packit 022b05
               'collectNow' - the agent creates and stores a connection
Packit 022b05
                      record into the current file for each active
Packit 022b05
                      connection having a type matching
Packit 022b05
                      acctngSelectionType and an age greater than
Packit 022b05
                      acctngFileMinAge."
Packit 022b05
    DEFVAL      { idle }
Packit 022b05
    ::= { acctngFileEntry 5 }
Packit 022b05
Packit 022b05
acctngFileMaximumSize OBJECT-TYPE
Packit 022b05
    SYNTAX      Integer32 (100..2147483647)
Packit 022b05
    UNITS       "bytes"
Packit 022b05
    MAX-ACCESS  read-create
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
            "The maximum size of the file (including header
Packit 022b05
            information).  When the file of collected data reaches this
Packit 022b05
            size, either the agent automatically swaps to a new version
Packit 022b05
            (i.e., a new value acctngFileNameSuffix) of the file, or new
Packit 022b05
            records are discarded.  Since a file must contain an
Packit 022b05
            integral number of connection records, the actual maximum
Packit 022b05
            size of the file may be just less OR Just greater than the
Packit 022b05
            value of this object.
Packit 022b05
Packit 022b05
            The value of this object can not be modified while the
Packit 022b05
            corresponding instance of acctngFileRowStatus is 'active'.
Packit 022b05
            The largest value of the maximum file size in some agents
Packit 022b05
            will be less than 2147483647 bytes."
Packit 022b05
    DEFVAL      { 5000000 }
Packit 022b05
    ::= { acctngFileEntry 6 }
Packit 022b05
Packit 022b05
acctngFileCurrentSize OBJECT-TYPE
Packit 022b05
    SYNTAX      Integer32 (0..2147483647)
Packit 022b05
    UNITS       "bytes"
Packit 022b05
    MAX-ACCESS  read-only
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
            "The current size of the file into which data is currently
Packit 022b05
            being collected, including header information."
Packit 022b05
    ::= { acctngFileEntry 7 }
Packit 022b05
Packit 022b05
acctngFileFormat OBJECT-TYPE
Packit 022b05
    SYNTAX      INTEGER { other(1), ber(2) }
Packit 022b05
    MAX-ACCESS  read-create
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
            "An indication of the format in which the accounting data is
Packit 022b05
            to be stored in the file.  If the value is modified, the new
Packit 022b05
            value takes effect after the next 'swap' to a new file.  The
Packit 022b05
            value ber(2) indicates the standard format."
Packit 022b05
    DEFVAL      { ber }
Packit 022b05
    ::= { acctngFileEntry 8 }
Packit 022b05
Packit 022b05
acctngFileCollectMode OBJECT-TYPE
Packit 022b05
    SYNTAX      BITS { onRelease(0), periodically(1) }
Packit 022b05
    MAX-ACCESS  read-create
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
            "An indication of when accounting data is to be written into
Packit 022b05
            this file.  Note that in addition to the occasions indicated
Packit 022b05
            by the value of this object, an agent always writes
Packit 022b05
            information on appropriate connections to the file when the
Packit 022b05
            corresponding instance of acctngFileCommand is set to
Packit 022b05
            'collectNow'.
Packit 022b05
Packit 022b05
              - 'onRelease' - whenever a connection (or possibly,
Packit 022b05
                      connection attempt) is terminated, either through
Packit 022b05
                      a Release message or through management removal,
Packit 022b05
                      information on that connection is written.
Packit 022b05
Packit 022b05
              - 'periodically' - information on appropriate connections
Packit 022b05
                      is written on the expiry of a periodic timer,
Packit 022b05
Packit 022b05
            This value may be modified at any time."
Packit 022b05
    DEFVAL      { { onRelease } }
Packit 022b05
    ::= { acctngFileEntry 9 }
Packit 022b05
Packit 022b05
acctngFileCollectFailedAttempts OBJECT-TYPE
Packit 022b05
    SYNTAX      BITS { soft(0), regular(1) }
Packit 022b05
    MAX-ACCESS  read-create
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
            "An indication of whether connection data is to be collected
Packit 022b05
            for failed connection attempts when the value of the
Packit 022b05
            corresponding instance of acctngFileCollectMode includes
Packit 022b05
            'onRelease'.  The individual values have the following
Packit 022b05
            meaning:
Packit 022b05
Packit 022b05
              'soft' - indicates that connection data is to be collected
Packit 022b05
            for failed Soft PVCs/PVPs which originate or terminate at
Packit 022b05
            the relevant interface.
Packit 022b05
Packit 022b05
              'regular' - indicates that connection data is to be
Packit 022b05
            collected for failed SVCs, including Soft PVCs/PVPs not
Packit 022b05
            originating or terminating at the relevant interface.
Packit 022b05
Packit 022b05
            This value may be modified at any time."
Packit 022b05
    DEFVAL      { { soft, regular } }
Packit 022b05
    ::= { acctngFileEntry 10 }
Packit 022b05
Packit 022b05
acctngFileInterval OBJECT-TYPE
Packit 022b05
    SYNTAX      Integer32 (60..86400)
Packit 022b05
    UNITS       "seconds"
Packit 022b05
    MAX-ACCESS  read-create
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
            "The number of seconds between the periodic collections of
Packit 022b05
            accounting data when the value of the corresponding instance
Packit 022b05
            of acctngFileCollectMode includes 'periodically'.  Some
Packit 022b05
            agents may impose restrictions on the range of this
Packit 022b05
            interval.  This value may be modified at any time."
Packit 022b05
    DEFVAL     { 3600 }
Packit 022b05
    ::= { acctngFileEntry 11 }
Packit 022b05
Packit 022b05
acctngFileMinAge OBJECT-TYPE
Packit 022b05
    SYNTAX      Integer32 (60..86400)
Packit 022b05
    UNITS       "seconds"
Packit 022b05
    MAX-ACCESS  read-create
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
            "The minimum age of a connection, as used to determine the
Packit 022b05
            set of connections for which data is to be collected at the
Packit 022b05
            periodic intervals and/or when acctngFileCommand is set to
Packit 022b05
            'collectNow'.  The age of a connection is the elapsed time
Packit 022b05
            since it was last installed.
Packit 022b05
Packit 022b05
            When the periodic interval expires for a file or when
Packit 022b05
            acctngFileCommand is set to 'collectNow', accounting data is
Packit 022b05
            collected and stored in the file for each connection having
Packit 022b05
            a type matching acctngSelectionType and whose age at that
Packit 022b05
            time is greater than the value of acctngFileMinAge
Packit 022b05
            associated with the file.  This value may be modified at any
Packit 022b05
            time."
Packit 022b05
    DEFVAL     { 3600 }
Packit 022b05
    ::= { acctngFileEntry 12 }
Packit 022b05
Packit 022b05
acctngFileRowStatus OBJECT-TYPE
Packit 022b05
    SYNTAX      RowStatus
Packit 022b05
    MAX-ACCESS  read-create
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
            "The status of this conceptual row.
Packit 022b05
Packit 022b05
            This object can not be set to 'active' until a value has
Packit 022b05
            been assigned to the corresponding instance of
Packit 022b05
            acctngFileName.  Collection of data into the file does not
Packit 022b05
            begin until this object has the value 'active' and one or
Packit 022b05
            more (active) instances of acctngSelectionFile refer to it.
Packit 022b05
            If this value is modified after a collection has begun,
Packit 022b05
            collection into this file terminates and a new (or new
Packit 022b05
            version of the) file is immediately made ready for future
Packit 022b05
            collection (as if acctngFileCommand had been set to
Packit 022b05
            'swapToNewFile'), but collection into the new (or new
Packit 022b05
            version of the) file does not begin until the value is
Packit 022b05
            subsequently set back to active."
Packit 022b05
    ::= { acctngFileEntry 13 }
Packit 022b05
Packit 022b05
-- Overall Control
Packit 022b05
Packit 022b05
acctngAdminStatus OBJECT-TYPE
Packit 022b05
    SYNTAX      INTEGER { enabled(1), disabled(2) }
Packit 022b05
    MAX-ACCESS  read-write
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
            "A control object to indicate the administratively desired
Packit 022b05
            state of the collection of accounting records across all
Packit 022b05
            interfaces.
Packit 022b05
Packit 022b05
            Modifying the value of acctngAdminStatus to 'disabled' does
Packit 022b05
            not remove or change the current configuration as
Packit 022b05
            represented by the active rows in the acctngSelectionTable,
Packit 022b05
            acctngFileTable and acctngInterfaceTable tables."
Packit 022b05
    ::= { acctngInterfaceControl 1 }
Packit 022b05
Packit 022b05
acctngOperStatus OBJECT-TYPE
Packit 022b05
    SYNTAX      INTEGER { enabled(1), disabled(2) }
Packit 022b05
    MAX-ACCESS  read-only
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
            "A status object to indicate the operational state of the
Packit 022b05
            collection of accounting records across all interfaces.
Packit 022b05
Packit 022b05
            When the value of acctngAdminStatus is modified to be
Packit 022b05
            'enabled', the value of this object will change to 'enabled'
Packit 022b05
            providing it is possible to begin collecting accounting
Packit 022b05
            records.
Packit 022b05
Packit 022b05
            When the value of acctngAdminStatus is modified to be
Packit 022b05
            'disabled', the value of this object will change to
Packit 022b05
            'disabled' as soon as the collection of accounting records
Packit 022b05
            has terminated."
Packit 022b05
    ::= { acctngInterfaceControl 2 }
Packit 022b05
Packit 022b05
acctngProtection OBJECT-TYPE
Packit 022b05
    SYNTAX      TestAndIncr
Packit 022b05
    MAX-ACCESS  read-write
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
            "A control object to protect against duplication of control
Packit 022b05
            commands.  Over some transport/network protocols, it is
Packit 022b05
            possible for SNMP messages to get duplicated.  Such
Packit 022b05
            duplication, if it occurred at just the wrong time could
Packit 022b05
            cause serious disruption to the collection and retrieval of
Packit 022b05
            accounting data, e.g., if a SNMP message setting
Packit 022b05
            acctngFileCommand to 'swapToNewFile' were to be duplicated,
Packit 022b05
            a whole file of accounting data could be lost.
Packit 022b05
Packit 022b05
            To protect against such duplication, a management
Packit 022b05
            application should retrieve the value of this object, and
Packit 022b05
            include in the Set operation needing protection, a variable
Packit 022b05
            binding which sets this object to the retrieved value."
Packit 022b05
    ::= { acctngInterfaceControl 3 }
Packit 022b05
Packit 022b05
acctngAgentMode OBJECT-TYPE
Packit 022b05
    SYNTAX      INTEGER { swapOnCommand(1), swapOnFull(2) }
Packit 022b05
    MAX-ACCESS  read-only
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
            "An indication of the behaviour mode of the agent when a
Packit 022b05
            file becomes full:
Packit 022b05
Packit 022b05
               'swapOnCommand' - the agent does not automatically swap
Packit 022b05
                      to a new file; rather, it discards newly collected
Packit 022b05
                      data until a management application subsequently
Packit 022b05
                      instructs it to swap to a new file.
Packit 022b05
Packit 022b05
               'swapOnFull' - the agent terminates collection into the
Packit 022b05
                      current file as and when that file becomes full."
Packit 022b05
    ::= { acctngInterfaceControl 4 }
Packit 022b05
Packit 022b05
Packit 022b05
--  Per-interface control table
Packit 022b05
Packit 022b05
acctngInterfaceTable OBJECT-TYPE
Packit 022b05
    SYNTAX      SEQUENCE OF AcctngInterfaceEntry
Packit 022b05
    MAX-ACCESS  not-accessible
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
            "A table controlling the collection of accounting data on
Packit 022b05
            specific interfaces of the switch."
Packit 022b05
    ::= { acctngInterfaceControl 5 }
Packit 022b05
Packit 022b05
acctngInterfaceEntry OBJECT-TYPE
Packit 022b05
    SYNTAX      AcctngInterfaceEntry
Packit 022b05
    MAX-ACCESS  not-accessible
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
            "An entry which controls whether accounting data is to be
Packit 022b05
            collected on an interface.  The types of interfaces which
Packit 022b05
            are represented in this table is implementation-specific."
Packit 022b05
    INDEX   { ifIndex }
Packit 022b05
    ::= { acctngInterfaceTable 1 }
Packit 022b05
Packit 022b05
AcctngInterfaceEntry ::=
Packit 022b05
    SEQUENCE {
Packit 022b05
        acctngInterfaceEnable     TruthValue
Packit 022b05
    }
Packit 022b05
Packit 022b05
acctngInterfaceEnable OBJECT-TYPE
Packit 022b05
    SYNTAX      TruthValue
Packit 022b05
    MAX-ACCESS  read-write
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
            "Indicates whether the collection of accounting data is
Packit 022b05
            enabled on this interface."
Packit 022b05
    ::= { acctngInterfaceEntry 1 }
Packit 022b05
Packit 022b05
-- Objects for controlling the use of Notifications
Packit 022b05
Packit 022b05
acctngControlTrapThreshold OBJECT-TYPE
Packit 022b05
    SYNTAX      INTEGER (0..99)
Packit 022b05
    MAX-ACCESS  read-write
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
            "A percentage of the maximum file size at which a 'nearly-
Packit 022b05
            full' trap is generated.  The value of 0 indicates that no
Packit 022b05
            'nearly-full' trap is to be generated."
Packit 022b05
    ::= { acctngTrapControl 1 }
Packit 022b05
Packit 022b05
acctngControlTrapEnable OBJECT-TYPE
Packit 022b05
    SYNTAX      TruthValue
Packit 022b05
    MAX-ACCESS  read-write
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
            "An indication of whether the acctngFileNearlyFull and
Packit 022b05
            acctngFileFull traps are enabled."
Packit 022b05
    ::= { acctngTrapControl 2 }
Packit 022b05
Packit 022b05
-- notifications
Packit 022b05
Packit 022b05
acctngNotifications OBJECT IDENTIFIER ::= { accountingControlMIB 2 }
Packit 022b05
Packit 022b05
acctngNotifyPrefix OBJECT IDENTIFIER ::= { acctngNotifications 0 }
Packit 022b05
Packit 022b05
Packit 022b05
acctngFileNearlyFull NOTIFICATION-TYPE
Packit 022b05
    OBJECTS     { acctngFileName,
Packit 022b05
                  acctngFileMaximumSize,
Packit 022b05
                  acctngControlTrapThreshold,
Packit 022b05
                  acctngFileNameSuffix }
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
            "An indication that the size of the file into which
Packit 022b05
            accounting information is currently being collected has
Packit 022b05
            exceeded the threshold percentage of its maximum file size.
Packit 022b05
            This notification is generated only at the time of the
Packit 022b05
            transition from not-exceeding to exceeding."
Packit 022b05
    ::= { acctngNotifyPrefix 1 }
Packit 022b05
Packit 022b05
Packit 022b05
acctngFileFull NOTIFICATION-TYPE
Packit 022b05
    OBJECTS     { acctngFileName,
Packit 022b05
                  acctngFileMaximumSize,
Packit 022b05
                  acctngFileNameSuffix }
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
            "An indication that the size of the file into which
Packit 022b05
            accounting information is currently being collected has
Packit 022b05
            transistioned to its maximum file size.  This notification
Packit 022b05
            is generated (for all values of acctngAgentMode) at the time
Packit 022b05
            of the transition from not-full to full.  If acctngAgentMode
Packit 022b05
            has the value 'swapOnCommand', it is also generated
Packit 022b05
            periodically thereafter until such time as collection of
Packit 022b05
            data is no longer inhibited by the file full condition."
Packit 022b05
    ::= { acctngNotifyPrefix 2 }
Packit 022b05
Packit 022b05
Packit 022b05
-- conformance information
Packit 022b05
Packit 022b05
acctngConformance OBJECT IDENTIFIER ::= { accountingControlMIB 3 }
Packit 022b05
acctngGroups      OBJECT IDENTIFIER ::= { acctngConformance 1 }
Packit 022b05
acctngCompliances OBJECT IDENTIFIER ::= { acctngConformance 2 }
Packit 022b05
Packit 022b05
acctngCompliance MODULE-COMPLIANCE
Packit 022b05
    STATUS  current
Packit 022b05
    DESCRIPTION
Packit 022b05
            "The compliance statement for switches which implement the
Packit 022b05
            Accounting Control MIB."
Packit 022b05
Packit 022b05
    MODULE  -- this module
Packit 022b05
        MANDATORY-GROUPS { acctngBasicGroup,
Packit 022b05
                           acctngNotificationsGroup }
Packit 022b05
Packit 022b05
        OBJECT      acctngSelectionType
Packit 022b05
        SYNTAX      BITS { svcIncoming(0), svcOutgoing(1) }
Packit 022b05
        DESCRIPTION "The minimal requirement is collection for SVCs."
Packit 022b05
Packit 022b05
        OBJECT      acctngSelectionRowStatus
Packit 022b05
        MIN-ACCESS  read-only
Packit 022b05
        DESCRIPTION "Write access is not required."
Packit 022b05
Packit 022b05
        OBJECT      acctngFileName
Packit 022b05
        MIN-ACCESS  read-only
Packit 022b05
        DESCRIPTION "Write access is not required."
Packit 022b05
Packit 022b05
        OBJECT      acctngFileCommand
Packit 022b05
        MIN-ACCESS  read-only
Packit 022b05
        DESCRIPTION "Write access is not required."
Packit 022b05
Packit 022b05
        OBJECT      acctngFileFormat
Packit 022b05
        SYNTAX      INTEGER { ber(2) }
Packit 022b05
        MIN-ACCESS  read-only
Packit 022b05
        DESCRIPTION "Only the standard format is required, and write
Packit 022b05
                    access is not required."
Packit 022b05
Packit 022b05
        OBJECT      acctngFileMaximumSize
Packit 022b05
        MIN-ACCESS  read-only
Packit 022b05
        DESCRIPTION "Write access is not required."
Packit 022b05
Packit 022b05
        OBJECT      acctngFileCollectMode
Packit 022b05
        SYNTAX      BITS { onRelease(0) }
Packit 022b05
        MIN-ACCESS  read-only
Packit 022b05
        DESCRIPTION "The minimal requirement is for collection on
Packit 022b05
                    connection release."
Packit 022b05
Packit 022b05
        OBJECT      acctngFileInterval
Packit 022b05
        MIN-ACCESS  read-only
Packit 022b05
        DESCRIPTION "Write access is not required."
Packit 022b05
Packit 022b05
        OBJECT      acctngFileCollectFailedAttempts
Packit 022b05
        MIN-ACCESS  read-only
Packit 022b05
        DESCRIPTION "Write access is not required."
Packit 022b05
Packit 022b05
        OBJECT      acctngFileRowStatus
Packit 022b05
        MIN-ACCESS  read-only
Packit 022b05
        DESCRIPTION "Write access is not required."
Packit 022b05
Packit 022b05
    ::= { acctngCompliances 1 }
Packit 022b05
Packit 022b05
Packit 022b05
-- units of conformance
Packit 022b05
Packit 022b05
acctngBasicGroup    OBJECT-GROUP
Packit 022b05
    OBJECTS { acctngSelectionSubtree, acctngSelectionList,
Packit 022b05
              acctngSelectionFile, acctngSelectionType,
Packit 022b05
              acctngSelectionRowStatus, acctngFileName,
Packit 022b05
              acctngFileNameSuffix, acctngFileDescription,
Packit 022b05
              acctngFileCommand, acctngFileMaximumSize,
Packit 022b05
              acctngFileCurrentSize, acctngFileRowStatus,
Packit 022b05
              acctngFileFormat, acctngFileCollectMode,
Packit 022b05
              acctngFileCollectFailedAttempts, acctngFileInterval,
Packit 022b05
              acctngFileMinAge,
Packit 022b05
              acctngAdminStatus, acctngOperStatus,
Packit 022b05
              acctngProtection, acctngAgentMode,
Packit 022b05
              acctngInterfaceEnable,
Packit 022b05
              acctngControlTrapThreshold,
Packit 022b05
              acctngControlTrapEnable
Packit 022b05
            }
Packit 022b05
    STATUS  current
Packit 022b05
    DESCRIPTION
Packit 022b05
            "A collection of objects providing control of the basic
Packit 022b05
            collection of accounting data for connection-oriented
Packit 022b05
            networks."
Packit 022b05
    ::= { acctngGroups 1 }
Packit 022b05
Packit 022b05
acctngNotificationsGroup NOTIFICATION-GROUP
Packit 022b05
    NOTIFICATIONS { acctngFileNearlyFull, acctngFileFull }
Packit 022b05
    STATUS        current
Packit 022b05
    DESCRIPTION
Packit 022b05
            "The notifications of events relating to controlling the
Packit 022b05
            collection of accounting data."
Packit 022b05
    ::= { acctngGroups 2 }
Packit 022b05
Packit 022b05
END