home *** CD-ROM | disk | FTP | other *** search
/ Internet Core Protocols / Oreilly-InternetCoreProtocols.iso / RFCs / rfc2513.txt < prev    next >
Encoding:
Text File  |  1999-10-14  |  61.0 KB  |  1,628 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7. Network Working Group                                      K. McCloghrie
  8. Request for Comments: 2513                           Cisco Systems, Inc.
  9. Category: Standards Track                                    J. Heinanen
  10.                                                      Telia Finland, Inc.
  11.                                                                W. Greene
  12.                                             MCI Telecommunications Corp.
  13.                                                                A. Prasad
  14.                                                      Cisco Systems, Inc.
  15.                                                            February 1999
  16.  
  17.  
  18.              Managed Objects for Controlling the Collection
  19.                and Storage of Accounting Information for
  20.                       Connection-Oriented Networks
  21.  
  22. Status of this Memo
  23.  
  24.    This document specifies an Internet standards track protocol for the
  25.    Internet community, and requests discussion and suggestions for
  26.    improvements.  Please refer to the current edition of the "Internet
  27.    Official Protocol Standards" (STD 1) for the standardization state
  28.    and status of this protocol.  Distribution of this memo is unlimited.
  29.  
  30. Copyright Notice
  31.  
  32.    Copyright (C) The Internet Society (1999).  All Rights Reserved.
  33.  
  34. Table of Contents
  35.  
  36.    1 Introduction .................................................... 2
  37.    2 The SNMP Network Management Framework ........................... 2
  38.    3 Overview ........................................................ 3
  39.    3.1 Operational Model ............................................. 3
  40.    3.2 Selection of Accounting Data .................................. 5
  41.    3.3 Format of Collection File ..................................... 6
  42.    4 Definitions ..................................................... 9
  43.    5 Acknowledgements ................................................25
  44.    6 References ......................................................25
  45.    7 Security Considerations .........................................27
  46.    8 IANA Considerations .............................................27
  47.    9 Authors' Addresses ..............................................28
  48.    10 Full Copyright Statement .......................................29
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58. McCloghrie, et. al.         Standards Track                     [Page 1]
  59.  
  60. RFC 2513           Connection-Oriented Accounting MIB      February 1999
  61.  
  62.  
  63. 1.  Introduction
  64.  
  65.    This memo defines a portion of the Management Information Base (MIB)
  66.    for use with network management protocols in the Internet community.
  67.    In particular, it describes managed objects used for controlling the
  68.    collection and storage of accounting information for connection-
  69.    oriented networks such as ATM.  The accounting data is collected into
  70.    files for later retrieval via a file transfer protocol.  For
  71.    information on data which can be collected for ATM networks, see
  72.    [19].
  73.  
  74. 2.  The SNMP Network Management Framework
  75.  
  76.    The SNMP Management Framework presently consists of five major
  77.    components:
  78.  
  79.    o    An overall architecture, described in RFC 2271 [1].
  80.  
  81.    o    Mechanisms for describing and naming objects and events for the
  82.         purpose of management.  The first version of this Structure of
  83.         Management Information (SMI) is called SMIv1 and described in
  84.         STD 16, RFC 1155 [2], STD 16, RFC 1212 [3] and RFC 1215 [4].
  85.         The second version, called SMIv2, is described in RFC 1902 [5],
  86.         RFC 1903 [6] and RFC 1904 [7].
  87.  
  88.    o    Message protocols for transferring management information.  The
  89.         first version of the SNMP message protocol is called SNMPv1 and
  90.         described in STD 15, RFC 1157 [8].  A second version of the SNMP
  91.         message protocol, which is not an Internet standards track
  92.         protocol, is called SNMPv2c and described in RFC 1901 [9] and
  93.         RFC 1906 [10].  The third version of the message protocol is
  94.         called SNMPv3 and described in RFC 1906 [10], RFC 2272 [11] and
  95.         RFC 2274 [12].
  96.  
  97.    o    Protocol operations for accessing management information.  The
  98.         first set of protocol operations and associated PDU formats is
  99.         described in STD 15, RFC 1157 [8].  A second set of protocol
  100.         operations and associated PDU formats is described in RFC 1905
  101.         [13].
  102.  
  103.    o    A set of fundamental applications described in RFC 2273 [14] and
  104.         the view-based access control mechanism described in RFC 2275
  105.         [15].
  106.  
  107.    Managed objects are accessed via a virtual information store, termed
  108.    the Management Information Base or MIB.  Objects in the MIB are
  109.    defined using the mechanisms defined in the SMI.
  110.  
  111.  
  112.  
  113.  
  114. McCloghrie, et. al.         Standards Track                     [Page 2]
  115.  
  116. RFC 2513           Connection-Oriented Accounting MIB      February 1999
  117.  
  118.  
  119.    This memo specifies a MIB module that is compliant to the SMIv2.  A
  120.    MIB conforming to the SMIv1 can be produced through the appropriate
  121.    translations.  The resulting translated MIB must be semantically
  122.    equivalent, except where objects or events are omitted because no
  123.    translation is possible (e.g., use of Counter64).  Some machine
  124.    readable information in SMIv2 will be converted into textual
  125.    descriptions in SMIv1 during the translation process.  However, this
  126.    loss of machine readable information is not considered to change the
  127.    semantics of the MIB.
  128.  
  129. 3.  Overview
  130.  
  131.    In some connection-oriented network environments, there is a need for
  132.    the network administrator to be able to collect accounting data on
  133.    the usage of bandwidth/resources by connections (e.g., ATM
  134.    connections) within the network.  Data collection should be available
  135.    for switched virtual connections (SVCs and SVPs), and permanent
  136.    virtual connections (PVCs and PVPs), including soft-permanent virtual
  137.    connections (SPVCCs and SPVPCs).  This need exists for ATM networks,
  138.    and may well exist for other connection-oriented networks, such as
  139.    Frame Relay.
  140.  
  141.    The potential quantity of such accounting information is such that it
  142.    is not, in general, feasible to retrieve the information via SNMP.  A
  143.    better method is to store the collected accounting information in a
  144.    file which can be subsequently retrieved via a file transfer
  145.    protocol.
  146.  
  147.    It is, however, appropriate to provide management control of the
  148.    selection and collection of such accounting data via SNMP.  This memo
  149.    describes a MIB module which provides such control in a manner
  150.    independent of the type of network.  One or more other documents
  151.    provide definitions of particular items of accounting data which can
  152.    be selected; for example, a particular set of data items which can be
  153.    collected for ATM networks is specified in [19].
  154.  
  155. 3.1.  Operational Model
  156.  
  157.    The requirement is for switches (e.g., ATM switches) to collect data
  158.    concerning the connections which are routed across some subset of
  159.    their interfaces (e.g., ATM UNI and/or NNI interfaces).  The
  160.    collected data is stored into one or more "files".  The use of
  161.    multiple files allows, for example, the data collected for PVCs to be
  162.    different from that collected for SVCs.
  163.  
  164.    In order to retrieve the data currently being stored in a file, the
  165.    administrator instructs the switch to terminate the collection of
  166.    data into that file, and start collecting data into a new file.
  167.  
  168.  
  169.  
  170. McCloghrie, et. al.         Standards Track                     [Page 3]
  171.  
  172. RFC 2513           Connection-Oriented Accounting MIB      February 1999
  173.  
  174.  
  175.    After this operation, the data in the old file is available for
  176.    retrieval via file transfer.
  177.  
  178.    A collection file is defined to have a maximum size.  When the size
  179.    of the file currently being collected exceeds a threshold percentage
  180.    of that maximum size, an SNMP notification (e.g., a trap) can be
  181.    optionally generated.  An SNMP notification might also be generated
  182.    if the file reaches its maximum size.
  183.  
  184.    The accounting data collected for each connection consists of a set
  185.    of objects and their values.  The set of objects and their values are
  186.    collected on one or more of the following occasions:
  187.  
  188.    (1)  on the release (termination) of a connection optionally
  189.         including failed connection attempts;
  190.  
  191.    (2)  for each active connection (having a particular minimum age) on
  192.         a periodic basis;
  193.  
  194.    (3)  for each active connection (having a particular minimum age)
  195.         when so commanded by a management application.
  196.  
  197.    While collecting data to be stored in a particular file, the same set
  198.    of objects is collected for each connection on each occasion.  Having
  199.    the same set of objects stored on each occasion allows the
  200.    optimization of storing only the values of those objects.  This
  201.    results in a significantly smaller file size, since it allows the
  202.    names of the objects to be stored once and only once at the beginning
  203.    of the file, rather than having to store every value as a (name,
  204.    value) pair.
  205.  
  206.    Two modes of agent behaviour are allowed on the event of a file
  207.    reaching its maximum size:
  208.  
  209.    (1)  management application in control:
  210.  
  211.         The agent does not automatically swap to a new file; rather, it
  212.         discards newly collected data until the management application
  213.         subsequently instructs it to swap to a new file.  Before
  214.         swapping to a new file, the name of the file into which data is
  215.         currently being collected is an implementation issue of no
  216.         concern to an NM application; after swapping to a new file, the
  217.         name of the file available for retrieval is as specified by the
  218.         controlling MIB objects.  This behaviour allows the application
  219.         to know exactly how many files need to be retrieved and their
  220.         names without having to perform any type of file directory
  221.         operation, but also results in the possibility that data will be
  222.         discarded if the application does not instruct the agent to swap
  223.  
  224.  
  225.  
  226. McCloghrie, et. al.         Standards Track                     [Page 4]
  227.  
  228. RFC 2513           Connection-Oriented Accounting MIB      February 1999
  229.  
  230.  
  231.         within the required time frame.
  232.  
  233.    (2)  agent automatically swaps to new file:
  234.  
  235.         The agent terminates collection into the current (full) file,
  236.         and begins collecting data into a new version of the same base
  237.         file name.  This behaviour aims to avoid loss of data by
  238.         assuming that additional storage space is actually available to
  239.         create a new version of the file.  To support this behaviour,
  240.         files are named using suffixes, such that when the current
  241.         version of the file becomes full, the agent begins collecting
  242.         data into a file with the same base file-name but with an
  243.         incremented (or otherwise modified) suffix.  This requires the
  244.         application to perform file directory operations prior to
  245.         retrieving completed files in order to know how many and which
  246.         suffixes have been used.
  247.  
  248.    With either behaviour, any completed file must be an integral number
  249.    of connection records (see below).  When a file reaches its maximum
  250.    size, collection into that file is terminated either immediately
  251.    before or immediately after storing the whole of the current
  252.    connection record into the file.  The former causes the file to be
  253.    just less than its maximum size, and the latter causes the file to be
  254.    just greater than its maximum size.
  255.  
  256. 3.2.  Selection of Accounting Data
  257.  
  258.    The items of accounting data to be collected are specified as a set
  259.    of objects.  Which objects are contained in such a set is selectable
  260.    by an administrator through the specification of one or more
  261.    (subtree, list) tuples, where the set of objects to be collected is
  262.    the union of the subsets specified by each tuple:
  263.  
  264.        'subtree' specifies an OBJECT IDENTIFIER value such that every
  265.            object in the subset is named by the subtree's value appended
  266.            with a single additional sub-identifier.
  267.  
  268.        'list' specifies an OCTET STRING value, such that if the N-th bit
  269.            of the string's value is set then the the subset contains the
  270.            object named by appending N as a single additional sub-
  271.            identifier to the subtree.
  272.  
  273.    The rationale for defining each subset as a (subtree,list) tuple is
  274.    that one and only one OBJECT IDENTIFIER and one OCTET STRING is
  275.    needed to define the subset of objects.  This simplifies the MIB
  276.    mechanisms needed for selection: an NM application needs to create
  277.    only one conceptual row in a MIB table for each subset (rather than
  278.    needing to create a conceptual row in a table for each and every
  279.  
  280.  
  281.  
  282. McCloghrie, et. al.         Standards Track                     [Page 5]
  283.  
  284. RFC 2513           Connection-Oriented Accounting MIB      February 1999
  285.  
  286.  
  287.    object in the set).
  288.  
  289.    The number of tuples supported by a particular switch is an
  290.    implementation choice.  One possibility is to support two (subtree,
  291.    list) tuples so that one such tuple can specify a standard 'subtree'
  292.    (e.g., the atmAcctngDataObjects subtree defined in [19]), and the
  293.    second tuple can specify an enterprise-specific 'subtree'; this would
  294.    allow the selected set of objects to be the union of a set of
  295.    standard objects and a set of enterprise-defined objects.
  296.  
  297. 3.3.  Format of Collection File
  298.  
  299.    A collection file generated by this process contains the values of
  300.    MIB objects defined using the SMIv2.  The standard way to encode the
  301.    values of SNMP MIB objects in a device-independent manner is through
  302.    the use of ASN.1's Basic Encoding Rules (BER) [18].  Thus, the
  303.    standard format of an accounting file is defined here using the same
  304.    adapted subset of ASN.1 [17] as the SMIv2.
  305.  
  306.    The file consists of a set of header information followed by a
  307.    sequence of zero or more collection records.  The header information
  308.    identifies (via sysName [16]) the switch which collected the data,
  309.    the date and time at which the collection in to this file started,
  310.    and the sequence of one or more (subtree, list) tuples identifying
  311.    the objects whose values are contained in each connection record.
  312.    The header information also includes a textual description of the
  313.    data contained in the file.
  314.  
  315.    Each connection record contains a sequence of values for each
  316.    identified tuple, in the same order as the tuples are identified in
  317.    the header information.  For each tuple, the sequence of values are
  318.    in ascending order of the sub-identifier which identifies them within
  319.    the subtree.
  320.  
  321.    Formally, an accounting file is an ASN.1 value with the following
  322.    syntax:
  323.  
  324. File ::=
  325.    [1]
  326.       IMPLICIT SEQUENCE {
  327.                            -- header information
  328.           sysName               -- name of the switch
  329.               DisplayString,
  330.  
  331.           description           -- textual description of the collection
  332.               DisplayString,
  333.  
  334.           startTime             -- start time of the collection
  335.  
  336.  
  337.  
  338. McCloghrie, et. al.         Standards Track                     [Page 6]
  339.  
  340. RFC 2513           Connection-Oriented Accounting MIB      February 1999
  341.  
  342.  
  343.               DateAndTime,
  344.  
  345.           SEQUENCE OF {         -- sequence of (subtree, list) tuples
  346.               SEQUENCE {
  347.                   subtree
  348.                       OBJECT IDENTIFIER,
  349.                   list
  350.                       OCTET STRING
  351.               }
  352.           }
  353.                            -- sequence of connection records
  354.           SEQUENCE OF {
  355.                                 -- each record containing a sequence
  356.               SEQUENCE OF {     -- per identified tuple
  357.  
  358.                   SEQUENCE OF {     -- each per-tuple sequence containing
  359.                       value         -- a sequence of object values
  360.                           ObjectSyntax
  361.                   }
  362.               }
  363.           }
  364.       }
  365.  
  366.    where:
  367.  
  368.    (1)  the value of the sysName component is that of the sysName object
  369.         in the System group [16].
  370.  
  371.    (2)  each (subtree, list) specifies the set of objects contained in
  372.         that tuple's sequence within each and every connection record.
  373.  
  374.    (3)  the tuples' sequences within each connection record occur in the
  375.         same order as the (subtree, list) tuples occur in the header
  376.         information.
  377.  
  378.    (4)  the object values within each connection record occur in the
  379.         same order as they are represented by the bits in the
  380.         corresponding list value.
  381.  
  382.    (5)  ObjectSyntax is defined by the SMIv2 [5].
  383.  
  384.    (6)  One particular category of object values deserves special
  385.         attention: an object defined to hold the checksum value of an
  386.         accounting record (e.g., atmAcctngRecordCrc16, defined in [19]).
  387.         An object in this category will generally have a SYNTAX of a
  388.         fixed-length OCTET STRING, and have its value initialized to the
  389.         string of all zeros when composing the accounting record
  390.         containing it, with the location of these zeros being saved.
  391.  
  392.  
  393.  
  394. McCloghrie, et. al.         Standards Track                     [Page 7]
  395.  
  396. RFC 2513           Connection-Oriented Accounting MIB      February 1999
  397.  
  398.  
  399.         Once the record is generated, the checksum is calculated over
  400.         the whole connection record (including the starting SEQUENCE OF
  401.         and the trailing end-of-contents octets, if used), and then the
  402.         zeros are overwritten (at the saved location) by the calculated
  403.         value of the checksum.
  404.  
  405.    The encoding of the above syntax using the Basic Encoding Rules is
  406.    the same as defined by the SNMPv2 [10], with the following exception:
  407.  
  408.      - when encoding the length field for a structured type, i.e., a
  409.        SEQUENCE or SEQUENCE OF, the indefinite form encoding is
  410.        permitted.
  411.  
  412.    For example, the file containing the data:
  413.  
  414.    [1] IMPLICIT SEQUENCE     a1 80
  415.          OCTET STRING        04 09 73 77 69 74 63 68 2d 31 32
  416.          OCTET STRING        04 0a 41 63 63 6f 75 6e 74 69 6e 67
  417.          OCTET STRING        04 08 07 cc 07 14 10 05 00 00
  418.          SEQUENCE OF         30 0e
  419.            SEQUENCE             30 0c
  420.              OBJECT IDENTIFIER     06 07 2b 06 01 03 7f 01 01
  421.              OCTET STRING          04 01 c0
  422.          SEQUENCE OF         30 80
  423.            SEQUENCE OF          30 08
  424.              SEQUENCE OF           30 06
  425.                INTEGER                02 01 00
  426.                INTEGER                02 01 21
  427.            SEQUENCE OF          30 08
  428.              SEQUENCE OF           30 06
  429.                INTEGER                02 01 00
  430.                INTEGER                02 01 22
  431.          end-of-contents     00 00
  432.        end-of-contents       00 00
  433.  
  434.    contains two connection records, each containing one tuple listing
  435.    two (integer) data items in a (fictitious) subtree:
  436.    1.3.6.1.3.127.1.1.  Its header indicates it's for "switch-12", with
  437.    description "Accounting", and was collected at 16:05:00 on 20 July
  438.    1996.
  439.  
  440.    As well as the standard format defined above, the MIB allows other
  441.    enterprise-specific formats to be used.
  442.  
  443.  
  444.  
  445.  
  446.  
  447.  
  448.  
  449.  
  450. McCloghrie, et. al.         Standards Track                     [Page 8]
  451.  
  452. RFC 2513           Connection-Oriented Accounting MIB      February 1999
  453.  
  454.  
  455. 4.  Definitions
  456.  
  457. ACCOUNTING-CONTROL-MIB DEFINITIONS ::= BEGIN
  458.  
  459. IMPORTS
  460.     MODULE-IDENTITY, OBJECT-TYPE, NOTIFICATION-TYPE,
  461.     mib-2, Integer32                              FROM SNMPv2-SMI
  462.     TEXTUAL-CONVENTION, RowStatus, TestAndIncr,
  463.     DisplayString, TruthValue                     FROM SNMPv2-TC
  464.     MODULE-COMPLIANCE, OBJECT-GROUP, NOTIFICATION-GROUP
  465.                                                   FROM SNMPv2-CONF
  466.     ifIndex                                       FROM IF-MIB;
  467.  
  468.  
  469. accountingControlMIB MODULE-IDENTITY
  470.     LAST-UPDATED "9809281000Z"
  471.     ORGANIZATION "IETF AToM MIB Working Group"
  472.     CONTACT-INFO "Keith McCloghrie
  473.                   Cisco Systems, Inc.
  474.                   170 West Tasman Drive,
  475.                   San Jose CA 95134-1706.
  476.                   Phone: +1 408 526 5260
  477.                   Email: kzm@cisco.com"
  478.     DESCRIPTION
  479.             "The MIB module for managing the collection and storage of
  480.             accounting information for connections in a connection-
  481.             oriented network such as ATM."
  482.     ::= { mib-2 60 }
  483.  
  484.  
  485. acctngMIBObjects       OBJECT IDENTIFIER ::= { accountingControlMIB 1 }
  486.  
  487. acctngSelectionControl OBJECT IDENTIFIER ::= { acctngMIBObjects 1 }
  488. acctngFileControl      OBJECT IDENTIFIER ::= { acctngMIBObjects 2 }
  489. acctngInterfaceControl OBJECT IDENTIFIER ::= { acctngMIBObjects 3 }
  490. acctngTrapControl      OBJECT IDENTIFIER ::= { acctngMIBObjects 4 }
  491.  
  492. -- Textual Conventions
  493.  
  494.  
  495. DataCollectionSubtree ::= TEXTUAL-CONVENTION
  496.     STATUS       current
  497.     DESCRIPTION
  498.             "The subtree component of a (subtree, list) tuple.  Such a
  499.             (subtree, list) tuple defines a set of objects and their
  500.             values to be collected as accounting data for a connection.
  501.             The subtree specifies a single OBJECT IDENTIFIER value such
  502.             that each object in the set is named by the subtree value
  503.  
  504.  
  505.  
  506. McCloghrie, et. al.         Standards Track                     [Page 9]
  507.  
  508. RFC 2513           Connection-Oriented Accounting MIB      February 1999
  509.  
  510.  
  511.             appended with a single additional sub-identifier."
  512.     SYNTAX       OBJECT IDENTIFIER
  513.  
  514. DataCollectionList ::= TEXTUAL-CONVENTION
  515.     STATUS       current
  516.     DESCRIPTION
  517.             "The list component of a (subtree, list) tuple.  Such a
  518.             (subtree, list) tuple defines a set of objects and their
  519.             values to be collected as accounting data for a connection.
  520.             The subtree specifies a single OBJECT IDENTIFIER value such
  521.             that each object in the set is named by the subtree value
  522.             appended with a single additional sub-identifier.  The list
  523.             specifies a set of data items, where the presence of an item
  524.             in the list indicates that the item is (to be) present in
  525.             the data collected for a connection; the absence of an item
  526.             from the list indicates that the item is not (to be) present
  527.             in the data collected for a connection.  Each data item is
  528.             represented by an integer which when appended (as as
  529.             additional sub-identifier) to the OBJECT IDENTIFIER value of
  530.             the subtree identified by the tuple, is the name of an
  531.             object defining that data item (its description and its
  532.             syntax).
  533.  
  534.             The list is specified as an OCTET STRING in which each data
  535.             item is represented by a single bit, where data items 1
  536.             through 8 are represented by the bits in the first octet,
  537.             data items 9 through 16 by the bits in the second octet,
  538.             etc.  In each octet, the lowest numbered data item is
  539.             represented by the most significant bit, and the highest
  540.             numbered data item by the least significant bit.  A data
  541.             item is present in the list when its bit is set, and absent
  542.             when its bit is reset.  If the length of an OCTET STRING
  543.             value is too short to represent one or more data items
  544.             defined in a subtree, then those data items are absent from
  545.             the set identified by the tuple of that subtree and that
  546.             OCTET STRING value."
  547.     SYNTAX       OCTET STRING (SIZE(0..8))
  548.  
  549. FileIndex ::= TEXTUAL-CONVENTION
  550.     STATUS       current
  551.     DESCRIPTION
  552.             "An arbitrary integer value identifying a file into which
  553.             accounting data is being collected."
  554.     SYNTAX       Integer32 (1..65535)
  555.  
  556.  
  557. -- The Accounting Information Selection table
  558.  
  559.  
  560.  
  561.  
  562. McCloghrie, et. al.         Standards Track                    [Page 10]
  563.  
  564. RFC 2513           Connection-Oriented Accounting MIB      February 1999
  565.  
  566.  
  567. acctngSelectionTable OBJECT-TYPE
  568.     SYNTAX      SEQUENCE OF AcctngSelectionEntry
  569.     MAX-ACCESS  not-accessible
  570.     STATUS      current
  571.     DESCRIPTION
  572.             "A list of accounting information selection entries.
  573.  
  574.             Note that additions, modifications and deletions of entries
  575.             in this table can occur at any time, but such changes only
  576.             take effect on the next occasion when collection begins into
  577.             a new file.  Thus, between modification and the next 'swap',
  578.             the content of this table does not reflect the current
  579.             selection."
  580.     ::= { acctngSelectionControl 1 }
  581.  
  582. acctngSelectionEntry OBJECT-TYPE
  583.     SYNTAX      AcctngSelectionEntry
  584.     MAX-ACCESS  not-accessible
  585.     STATUS      current
  586.     DESCRIPTION
  587.             "An entry identifying an (subtree, list) tuple used to
  588.             select a set of accounting information which is to be
  589.             collected."
  590.     INDEX   { acctngSelectionIndex }
  591.     ::= { acctngSelectionTable 1 }
  592.  
  593. AcctngSelectionEntry ::=
  594.     SEQUENCE {
  595.         acctngSelectionIndex     Integer32,
  596.         acctngSelectionSubtree   DataCollectionSubtree,
  597.         acctngSelectionList      DataCollectionList,
  598.         acctngSelectionFile      FileIndex,
  599.         acctngSelectionType      BITS,
  600.         acctngSelectionRowStatus RowStatus
  601.     }
  602.  
  603. acctngSelectionIndex OBJECT-TYPE
  604.     SYNTAX      Integer32 (1..65535)
  605.     MAX-ACCESS  not-accessible
  606.     STATUS      current
  607.     DESCRIPTION
  608.             "An arbitrary integer value which uniquely identifies a
  609.             tuple stored in this table.  This value is required to be
  610.             the permanent 'handle' for an entry in this table for as
  611.             long as that entry exists, including across restarts and
  612.             power outages."
  613.     ::= { acctngSelectionEntry 1 }
  614.  
  615.  
  616.  
  617.  
  618. McCloghrie, et. al.         Standards Track                    [Page 11]
  619.  
  620. RFC 2513           Connection-Oriented Accounting MIB      February 1999
  621.  
  622.  
  623. acctngSelectionSubtree OBJECT-TYPE
  624.     SYNTAX      DataCollectionSubtree
  625.     MAX-ACCESS  read-create
  626.     STATUS      current
  627.     DESCRIPTION
  628.             "The combination of acctngSelectionSubtree and
  629.             acctngSelectionList specifies one (subtree, list) tuple
  630.             which is to be collected."
  631.     ::= { acctngSelectionEntry 2 }
  632.  
  633. acctngSelectionList OBJECT-TYPE
  634.     SYNTAX      DataCollectionList
  635.     MAX-ACCESS  read-create
  636.     STATUS      current
  637.     DESCRIPTION
  638.             "The combination of acctngSelectionSubtree and
  639.             acctngSelectionList specifies one (subtree, list) tuple
  640.             which is to be collected."
  641.     ::= { acctngSelectionEntry 3 }
  642.  
  643. acctngSelectionFile OBJECT-TYPE
  644.     SYNTAX      FileIndex
  645.     MAX-ACCESS  read-create
  646.     STATUS      current
  647.     DESCRIPTION
  648.             "An indication of the file into which the accounting
  649.             information identified by this entry is to be stored.  If
  650.             there is no conceptual row in the acctngFileTable for which
  651.             the value of acctngFileIndex has the same value as this
  652.             object, then the information selected by this entry is not
  653.             collected."
  654.     ::= { acctngSelectionEntry 4 }
  655.  
  656. acctngSelectionType OBJECT-TYPE
  657.     SYNTAX      BITS { svcIncoming(0),
  658.                        svcOutgoing(1),
  659.                        svpIncoming(2),
  660.                        svpOutgoing(3),
  661.                        pvc(4),
  662.                        pvp(5),
  663.                        spvcOriginator(6),
  664.                        spvcTarget(7),
  665.                        spvpOriginator(8),
  666.                        spvpTarget(9) }
  667.     MAX-ACCESS  read-create
  668.     STATUS      current
  669.     DESCRIPTION
  670.             "Indicates the types of connections for which the
  671.  
  672.  
  673.  
  674. McCloghrie, et. al.         Standards Track                    [Page 12]
  675.  
  676. RFC 2513           Connection-Oriented Accounting MIB      February 1999
  677.  
  678.  
  679.             information selected by this entry are to be collected."
  680.     DEFVAL      { { svcIncoming, svcOutgoing,
  681.                     svpIncoming, svpOutgoing } }
  682.     ::= { acctngSelectionEntry 5 }
  683.  
  684. acctngSelectionRowStatus OBJECT-TYPE
  685.     SYNTAX      RowStatus
  686.     MAX-ACCESS  read-create
  687.     STATUS      current
  688.     DESCRIPTION
  689.             "The status of this conceptual row.  An agent may refuse to
  690.             create new conceptual rows and/or modify existing conceptual
  691.             rows, if such creation/modification would cause multiple
  692.             rows to have the same values of acctngSelectionSubtree and
  693.             acctngSelectionList.
  694.  
  695.             A conceptual row can not have the status of 'active' until
  696.             values have been assigned to the acctngSelectionSubtree,
  697.             acctngSelectionList and acctngSelectionFile columnar objects
  698.             within that row.
  699.  
  700.             An agent must not refuse to change the values of the
  701.             acctngSelectionSubtree, acctngSelectionList and
  702.             acctngSelectionFile columnar objects within a conceptual row
  703.             even while that row's status is 'active'.  Similarly, an
  704.             agent must not refuse to destroy an existing conceptual row
  705.             while the file referenced by that row's instance of
  706.             acctngSelectionFile is in active use, i.e., while the
  707.             corresponding instance of acctngFileRowStatus has the value
  708.             'active'.  However, such changes only take effect upon the
  709.             next occasion when collection begins into a new (version of
  710.             the) file."
  711.     ::= { acctngSelectionEntry 6 }
  712.  
  713. -- The Accounting File table
  714.  
  715. acctngFileTable OBJECT-TYPE
  716.     SYNTAX      SEQUENCE OF AcctngFileEntry
  717.     MAX-ACCESS  not-accessible
  718.     STATUS      current
  719.     DESCRIPTION
  720.             "A list of files into which accounting information is to be
  721.             stored."
  722.     ::= { acctngFileControl 1 }
  723.  
  724. acctngFileEntry OBJECT-TYPE
  725.     SYNTAX      AcctngFileEntry
  726.     MAX-ACCESS  not-accessible
  727.  
  728.  
  729.  
  730. McCloghrie, et. al.         Standards Track                    [Page 13]
  731.  
  732. RFC 2513           Connection-Oriented Accounting MIB      February 1999
  733.  
  734.  
  735.     STATUS      current
  736.     DESCRIPTION
  737.             "An entry identifying a file into which accounting
  738.             information is to be collected."
  739.     INDEX   { acctngFileIndex }
  740.     ::= { acctngFileTable 1 }
  741.  
  742. AcctngFileEntry ::=
  743.     SEQUENCE {
  744.         acctngFileIndex                 FileIndex,
  745.         acctngFileName                  DisplayString,
  746.         acctngFileNameSuffix            DisplayString,
  747.         acctngFileDescription           DisplayString,
  748.         acctngFileCommand               INTEGER,
  749.         acctngFileMaximumSize           Integer32,
  750.         acctngFileCurrentSize           Integer32,
  751.         acctngFileFormat                INTEGER,
  752.         acctngFileCollectMode           BITS,
  753.         acctngFileCollectFailedAttempts BITS,
  754.         acctngFileInterval              Integer32,
  755.         acctngFileMinAge                Integer32,
  756.         acctngFileRowStatus             RowStatus
  757.     }
  758.  
  759. acctngFileIndex OBJECT-TYPE
  760.     SYNTAX      FileIndex
  761.     MAX-ACCESS  not-accessible
  762.     STATUS      current
  763.     DESCRIPTION
  764.             "A unique value identifying a file into which accounting
  765.             data is to be stored.  This value is required to be the
  766.             permanent 'handle' for an entry in this table for as long as
  767.             that entry exists, including across restarts and power
  768.             outages."
  769.     ::= { acctngFileEntry 1 }
  770.  
  771. acctngFileName OBJECT-TYPE
  772.     SYNTAX      DisplayString (SIZE(1..32))
  773.     MAX-ACCESS  read-create
  774.     STATUS      current
  775.     DESCRIPTION
  776.             "The name of the file into which accounting data is to be
  777.             stored.  If files are named using suffixes, then the name of
  778.             the current file is the concatenation of acctngFileName and
  779.             acctngFileNameSuffix.
  780.  
  781.             An agent will respond with an error (e.g., 'wrongValue') to
  782.             a management set operation which attempts to modify the
  783.  
  784.  
  785.  
  786. McCloghrie, et. al.         Standards Track                    [Page 14]
  787.  
  788. RFC 2513           Connection-Oriented Accounting MIB      February 1999
  789.  
  790.  
  791.             value of this object to the same value as already held by
  792.             another instance of acctngFileName.  An agent will also
  793.             respond with an error (e.g., 'wrongValue') if the new value
  794.             is invalid for use as a file name on the local file system
  795.             (e.g., many file systems do not support white space embedded
  796.             in file names).
  797.  
  798.             The value of this object can not be modified while the
  799.             corresponding instance of acctngFileRowStatus is 'active'."
  800.     ::= { acctngFileEntry 2 }
  801.  
  802. acctngFileNameSuffix OBJECT-TYPE
  803.     SYNTAX      DisplayString (SIZE(0..8))
  804.     MAX-ACCESS  read-only
  805.     STATUS      current
  806.     DESCRIPTION
  807.             "The suffix, if any, of the name of a file into which
  808.             accounting data is currently being stored.  If suffixes are
  809.             not used, then the value of this object is the zero-length
  810.             string.  Note that if a separator, such as a period, is used
  811.             in appending the suffix to the file name, then that
  812.             separator appears as the first character of this value."
  813.     ::= { acctngFileEntry 3 }
  814.  
  815. acctngFileDescription OBJECT-TYPE
  816.     SYNTAX      DisplayString
  817.     MAX-ACCESS  read-create
  818.     STATUS      current
  819.     DESCRIPTION
  820.             "The textual description of the accounting data which will
  821.             be stored (on the next occasion) when header information is
  822.             stored in the file.  The value of this object may be
  823.             modified at any time."
  824.     DEFVAL      { "" }
  825.     ::= { acctngFileEntry 4 }
  826.  
  827. acctngFileCommand OBJECT-TYPE
  828.     SYNTAX      INTEGER {
  829.                     -- the following two values are states:
  830.                     -- they may be read but not written
  831.                     idle(1),
  832.                     cmdInProgress(2),
  833.                     -- the following two values are actions:
  834.                     -- they may be written, but are never read
  835.                     swapToNewFile(3),
  836.                     collectNow(4)
  837.                 }
  838.     MAX-ACCESS  read-create
  839.  
  840.  
  841.  
  842. McCloghrie, et. al.         Standards Track                    [Page 15]
  843.  
  844. RFC 2513           Connection-Oriented Accounting MIB      February 1999
  845.  
  846.  
  847.     STATUS      current
  848.     DESCRIPTION
  849.             "A control object for the collection of accounting data.
  850.             When read the value is either 'idle' or 'cmdInProgress'.
  851.             Writing a value is only allowed when the current value is
  852.             'idle'.  When a value is successfully written, the value
  853.             changes to 'cmdInProgress' until completion of the action,
  854.             at which time the value reverts to 'idle'.  Actions are
  855.             invoked by writing the following values:
  856.  
  857.                'swapToNewFile' - the collection of data into the current
  858.                       file is terminated, and collection continues into
  859.                       a new (version of the) file.
  860.  
  861.                'collectNow' - the agent creates and stores a connection
  862.                       record into the current file for each active
  863.                       connection having a type matching
  864.                       acctngSelectionType and an age greater than
  865.                       acctngFileMinAge."
  866.     DEFVAL      { idle }
  867.     ::= { acctngFileEntry 5 }
  868.  
  869. acctngFileMaximumSize OBJECT-TYPE
  870.     SYNTAX      Integer32 (100..2147483647)
  871.     UNITS       "bytes"
  872.     MAX-ACCESS  read-create
  873.     STATUS      current
  874.     DESCRIPTION
  875.             "The maximum size of the file (including header
  876.             information).  When the file of collected data reaches this
  877.             size, either the agent automatically swaps to a new version
  878.             (i.e., a new value acctngFileNameSuffix) of the file, or new
  879.             records are discarded.  Since a file must contain an
  880.             integral number of connection records, the actual maximum
  881.             size of the file may be just less OR Just greater than the
  882.             value of this object.
  883.  
  884.             The value of this object can not be modified while the
  885.             corresponding instance of acctngFileRowStatus is 'active'.
  886.             The largest value of the maximum file size in some agents
  887.             will be less than 2147483647 bytes."
  888.     DEFVAL      { 5000000 }
  889.     ::= { acctngFileEntry 6 }
  890.  
  891. acctngFileCurrentSize OBJECT-TYPE
  892.     SYNTAX      Integer32 (0..2147483647)
  893.     UNITS       "bytes"
  894.     MAX-ACCESS  read-only
  895.  
  896.  
  897.  
  898. McCloghrie, et. al.         Standards Track                    [Page 16]
  899.  
  900. RFC 2513           Connection-Oriented Accounting MIB      February 1999
  901.  
  902.  
  903.     STATUS      current
  904.     DESCRIPTION
  905.             "The current size of the file into which data is currently
  906.             being collected, including header information."
  907.     ::= { acctngFileEntry 7 }
  908.  
  909. acctngFileFormat OBJECT-TYPE
  910.     SYNTAX      INTEGER { other(1), ber(2) }
  911.     MAX-ACCESS  read-create
  912.     STATUS      current
  913.     DESCRIPTION
  914.             "An indication of the format in which the accounting data is
  915.             to be stored in the file.  If the value is modified, the new
  916.             value takes effect after the next 'swap' to a new file.  The
  917.             value ber(2) indicates the standard format."
  918.     DEFVAL      { ber }
  919.     ::= { acctngFileEntry 8 }
  920.  
  921. acctngFileCollectMode OBJECT-TYPE
  922.     SYNTAX      BITS { onRelease(0), periodically(1) }
  923.     MAX-ACCESS  read-create
  924.     STATUS      current
  925.     DESCRIPTION
  926.             "An indication of when accounting data is to be written into
  927.             this file.  Note that in addition to the occasions indicated
  928.             by the value of this object, an agent always writes
  929.             information on appropriate connections to the file when the
  930.             corresponding instance of acctngFileCommand is set to
  931.             'collectNow'.
  932.  
  933.               - 'onRelease' - whenever a connection (or possibly,
  934.                       connection attempt) is terminated, either through
  935.                       a Release message or through management removal,
  936.                       information on that connection is written.
  937.  
  938.               - 'periodically' - information on appropriate connections
  939.                       is written on the expiry of a periodic timer,
  940.  
  941.             This value may be modified at any time."
  942.     DEFVAL      { { onRelease } }
  943.     ::= { acctngFileEntry 9 }
  944.  
  945. acctngFileCollectFailedAttempts OBJECT-TYPE
  946.     SYNTAX      BITS { soft(0), regular(1) }
  947.     MAX-ACCESS  read-create
  948.     STATUS      current
  949.     DESCRIPTION
  950.             "An indication of whether connection data is to be collected
  951.  
  952.  
  953.  
  954. McCloghrie, et. al.         Standards Track                    [Page 17]
  955.  
  956. RFC 2513           Connection-Oriented Accounting MIB      February 1999
  957.  
  958.  
  959.             for failed connection attempts when the value of the
  960.             corresponding instance of acctngFileCollectMode includes
  961.             'onRelease'.  The individual values have the following
  962.             meaning:
  963.  
  964.               'soft' - indicates that connection data is to be collected
  965.             for failed Soft PVCs/PVPs which originate or terminate at
  966.             the relevant interface.
  967.  
  968.               'regular' - indicates that connection data is to be
  969.             collected for failed SVCs, including Soft PVCs/PVPs not
  970.             originating or terminating at the relevant interface.
  971.  
  972.             This value may be modified at any time."
  973.     DEFVAL      { { soft, regular } }
  974.     ::= { acctngFileEntry 10 }
  975.  
  976. acctngFileInterval OBJECT-TYPE
  977.     SYNTAX      Integer32 (60..86400)
  978.     UNITS       "seconds"
  979.     MAX-ACCESS  read-create
  980.     STATUS      current
  981.     DESCRIPTION
  982.             "The number of seconds between the periodic collections of
  983.             accounting data when the value of the corresponding instance
  984.             of acctngFileCollectMode includes 'periodically'.  Some
  985.             agents may impose restrictions on the range of this
  986.             interval.  This value may be modified at any time."
  987.     DEFVAL     { 3600 }
  988.     ::= { acctngFileEntry 11 }
  989.  
  990. acctngFileMinAge OBJECT-TYPE
  991.     SYNTAX      Integer32 (60..86400)
  992.     UNITS       "seconds"
  993.     MAX-ACCESS  read-create
  994.     STATUS      current
  995.     DESCRIPTION
  996.             "The minimum age of a connection, as used to determine the
  997.             set of connections for which data is to be collected at the
  998.             periodic intervals and/or when acctngFileCommand is set to
  999.             'collectNow'.  The age of a connection is the elapsed time
  1000.             since it was last installed.
  1001.  
  1002.             When the periodic interval expires for a file or when
  1003.             acctngFileCommand is set to 'collectNow', accounting data is
  1004.             collected and stored in the file for each connection having
  1005.             a type matching acctngSelectionType and whose age at that
  1006.             time is greater than the value of acctngFileMinAge
  1007.  
  1008.  
  1009.  
  1010. McCloghrie, et. al.         Standards Track                    [Page 18]
  1011.  
  1012. RFC 2513           Connection-Oriented Accounting MIB      February 1999
  1013.  
  1014.  
  1015.             associated with the file.  This value may be modified at any
  1016.             time."
  1017.     DEFVAL     { 3600 }
  1018.     ::= { acctngFileEntry 12 }
  1019.  
  1020. acctngFileRowStatus OBJECT-TYPE
  1021.     SYNTAX      RowStatus
  1022.     MAX-ACCESS  read-create
  1023.     STATUS      current
  1024.     DESCRIPTION
  1025.             "The status of this conceptual row.
  1026.  
  1027.             This object can not be set to 'active' until a value has
  1028.             been assigned to the corresponding instance of
  1029.             acctngFileName.  Collection of data into the file does not
  1030.             begin until this object has the value 'active' and one or
  1031.             more (active) instances of acctngSelectionFile refer to it.
  1032.             If this value is modified after a collection has begun,
  1033.             collection into this file terminates and a new (or new
  1034.             version of the) file is immediately made ready for future
  1035.             collection (as if acctngFileCommand had been set to
  1036.             'swapToNewFile'), but collection into the new (or new
  1037.             version of the) file does not begin until the value is
  1038.             subsequently set back to active."
  1039.     ::= { acctngFileEntry 13 }
  1040.  
  1041. -- Overall Control
  1042.  
  1043. acctngAdminStatus OBJECT-TYPE
  1044.     SYNTAX      INTEGER { enabled(1), disabled(2) }
  1045.     MAX-ACCESS  read-write
  1046.     STATUS      current
  1047.     DESCRIPTION
  1048.             "A control object to indicate the administratively desired
  1049.             state of the collection of accounting records across all
  1050.             interfaces.
  1051.  
  1052.             Modifying the value of acctngAdminStatus to 'disabled' does
  1053.             not remove or change the current configuration as
  1054.             represented by the active rows in the acctngSelectionTable,
  1055.             acctngFileTable and acctngInterfaceTable tables."
  1056.     ::= { acctngInterfaceControl 1 }
  1057.  
  1058. acctngOperStatus OBJECT-TYPE
  1059.     SYNTAX      INTEGER { enabled(1), disabled(2) }
  1060.     MAX-ACCESS  read-only
  1061.     STATUS      current
  1062.     DESCRIPTION
  1063.  
  1064.  
  1065.  
  1066. McCloghrie, et. al.         Standards Track                    [Page 19]
  1067.  
  1068. RFC 2513           Connection-Oriented Accounting MIB      February 1999
  1069.  
  1070.  
  1071.             "A status object to indicate the operational state of the
  1072.             collection of accounting records across all interfaces.
  1073.  
  1074.             When the value of acctngAdminStatus is modified to be
  1075.             'enabled', the value of this object will change to 'enabled'
  1076.             providing it is possible to begin collecting accounting
  1077.             records.
  1078.  
  1079.             When the value of acctngAdminStatus is modified to be
  1080.             'disabled', the value of this object will change to
  1081.             'disabled' as soon as the collection of accounting records
  1082.             has terminated."
  1083.     ::= { acctngInterfaceControl 2 }
  1084.  
  1085. acctngProtection OBJECT-TYPE
  1086.     SYNTAX      TestAndIncr
  1087.     MAX-ACCESS  read-write
  1088.     STATUS      current
  1089.     DESCRIPTION
  1090.             "A control object to protect against duplication of control
  1091.             commands.  Over some transport/network protocols, it is
  1092.             possible for SNMP messages to get duplicated.  Such
  1093.             duplication, if it occurred at just the wrong time could
  1094.             cause serious disruption to the collection and retrieval of
  1095.             accounting data, e.g., if a SNMP message setting
  1096.             acctngFileCommand to 'swapToNewFile' were to be duplicated,
  1097.             a whole file of accounting data could be lost.
  1098.  
  1099.             To protect against such duplication, a management
  1100.             application should retrieve the value of this object, and
  1101.             include in the Set operation needing protection, a variable
  1102.             binding which sets this object to the retrieved value."
  1103.     ::= { acctngInterfaceControl 3 }
  1104.  
  1105. acctngAgentMode OBJECT-TYPE
  1106.     SYNTAX      INTEGER { swapOnCommand(1), swapOnFull(2) }
  1107.     MAX-ACCESS  read-only
  1108.     STATUS      current
  1109.     DESCRIPTION
  1110.             "An indication of the behaviour mode of the agent when a
  1111.             file becomes full:
  1112.  
  1113.                'swapOnCommand' - the agent does not automatically swap
  1114.                       to a new file; rather, it discards newly collected
  1115.                       data until a management application subsequently
  1116.                       instructs it to swap to a new file.
  1117.  
  1118.                'swapOnFull' - the agent terminates collection into the
  1119.  
  1120.  
  1121.  
  1122. McCloghrie, et. al.         Standards Track                    [Page 20]
  1123.  
  1124. RFC 2513           Connection-Oriented Accounting MIB      February 1999
  1125.  
  1126.  
  1127.                       current file as and when that file becomes full."
  1128.     ::= { acctngInterfaceControl 4 }
  1129.  
  1130.  
  1131. --  Per-interface control table
  1132.  
  1133. acctngInterfaceTable OBJECT-TYPE
  1134.     SYNTAX      SEQUENCE OF AcctngInterfaceEntry
  1135.     MAX-ACCESS  not-accessible
  1136.     STATUS      current
  1137.     DESCRIPTION
  1138.             "A table controlling the collection of accounting data on
  1139.             specific interfaces of the switch."
  1140.     ::= { acctngInterfaceControl 5 }
  1141.  
  1142. acctngInterfaceEntry OBJECT-TYPE
  1143.     SYNTAX      AcctngInterfaceEntry
  1144.     MAX-ACCESS  not-accessible
  1145.     STATUS      current
  1146.     DESCRIPTION
  1147.             "An entry which controls whether accounting data is to be
  1148.             collected on an interface.  The types of interfaces which
  1149.             are represented in this table is implementation-specific."
  1150.     INDEX   { ifIndex }
  1151.     ::= { acctngInterfaceTable 1 }
  1152.  
  1153. AcctngInterfaceEntry ::=
  1154.     SEQUENCE {
  1155.         acctngInterfaceEnable     TruthValue
  1156.     }
  1157.  
  1158. acctngInterfaceEnable OBJECT-TYPE
  1159.     SYNTAX      TruthValue
  1160.     MAX-ACCESS  read-write
  1161.     STATUS      current
  1162.     DESCRIPTION
  1163.             "Indicates whether the collection of accounting data is
  1164.             enabled on this interface."
  1165.     ::= { acctngInterfaceEntry 1 }
  1166.  
  1167. -- Objects for controlling the use of Notifications
  1168.  
  1169. acctngControlTrapThreshold OBJECT-TYPE
  1170.     SYNTAX      INTEGER (0..99)
  1171.     MAX-ACCESS  read-write
  1172.     STATUS      current
  1173.     DESCRIPTION
  1174.             "A percentage of the maximum file size at which a 'nearly-
  1175.  
  1176.  
  1177.  
  1178. McCloghrie, et. al.         Standards Track                    [Page 21]
  1179.  
  1180. RFC 2513           Connection-Oriented Accounting MIB      February 1999
  1181.  
  1182.  
  1183.             full' trap is generated.  The value of 0 indicates that no
  1184.             'nearly-full' trap is to be generated."
  1185.     ::= { acctngTrapControl 1 }
  1186.  
  1187. acctngControlTrapEnable OBJECT-TYPE
  1188.     SYNTAX      TruthValue
  1189.     MAX-ACCESS  read-write
  1190.     STATUS      current
  1191.     DESCRIPTION
  1192.             "An indication of whether the acctngFileNearlyFull and
  1193.             acctngFileFull traps are enabled."
  1194.     ::= { acctngTrapControl 2 }
  1195.  
  1196. -- notifications
  1197.  
  1198. acctngNotifications OBJECT IDENTIFIER ::= { accountingControlMIB 2 }
  1199.  
  1200. acctngNotifyPrefix OBJECT IDENTIFIER ::= { acctngNotifications 0 }
  1201.  
  1202.  
  1203. acctngFileNearlyFull NOTIFICATION-TYPE
  1204.     OBJECTS     { acctngFileName,
  1205.                   acctngFileMaximumSize,
  1206.                   acctngControlTrapThreshold,
  1207.                   acctngFileNameSuffix }
  1208.     STATUS      current
  1209.     DESCRIPTION
  1210.             "An indication that the size of the file into which
  1211.             accounting information is currently being collected has
  1212.             exceeded the threshold percentage of its maximum file size.
  1213.             This notification is generated only at the time of the
  1214.             transition from not-exceeding to exceeding."
  1215.     ::= { acctngNotifyPrefix 1 }
  1216.  
  1217.  
  1218. acctngFileFull NOTIFICATION-TYPE
  1219.     OBJECTS     { acctngFileName,
  1220.                   acctngFileMaximumSize,
  1221.                   acctngFileNameSuffix }
  1222.     STATUS      current
  1223.     DESCRIPTION
  1224.             "An indication that the size of the file into which
  1225.             accounting information is currently being collected has
  1226.             transistioned to its maximum file size.  This notification
  1227.             is generated (for all values of acctngAgentMode) at the time
  1228.             of the transition from not-full to full.  If acctngAgentMode
  1229.             has the value 'swapOnCommand', it is also generated
  1230.             periodically thereafter until such time as collection of
  1231.  
  1232.  
  1233.  
  1234. McCloghrie, et. al.         Standards Track                    [Page 22]
  1235.  
  1236. RFC 2513           Connection-Oriented Accounting MIB      February 1999
  1237.  
  1238.  
  1239.             data is no longer inhibited by the file full condition."
  1240.     ::= { acctngNotifyPrefix 2 }
  1241.  
  1242.  
  1243. -- conformance information
  1244.  
  1245. acctngConformance OBJECT IDENTIFIER ::= { accountingControlMIB 3 }
  1246. acctngGroups      OBJECT IDENTIFIER ::= { acctngConformance 1 }
  1247. acctngCompliances OBJECT IDENTIFIER ::= { acctngConformance 2 }
  1248.  
  1249. acctngCompliance MODULE-COMPLIANCE
  1250.     STATUS  current
  1251.     DESCRIPTION
  1252.             "The compliance statement for switches which implement the
  1253.             Accounting Control MIB."
  1254.  
  1255.     MODULE  -- this module
  1256.         MANDATORY-GROUPS { acctngBasicGroup,
  1257.                            acctngNotificationsGroup }
  1258.  
  1259.         OBJECT      acctngSelectionType
  1260.         SYNTAX      BITS { svcIncoming(0), svcOutgoing(1) }
  1261.         DESCRIPTION "The minimal requirement is collection for SVCs."
  1262.  
  1263.         OBJECT      acctngSelectionRowStatus
  1264.         MIN-ACCESS  read-only
  1265.         DESCRIPTION "Write access is not required."
  1266.  
  1267.         OBJECT      acctngFileName
  1268.         MIN-ACCESS  read-only
  1269.         DESCRIPTION "Write access is not required."
  1270.  
  1271.         OBJECT      acctngFileCommand
  1272.         MIN-ACCESS  read-only
  1273.         DESCRIPTION "Write access is not required."
  1274.  
  1275.         OBJECT      acctngFileFormat
  1276.         SYNTAX      INTEGER { ber(2) }
  1277.         MIN-ACCESS  read-only
  1278.         DESCRIPTION "Only the standard format is required, and write
  1279.                     access is not required."
  1280.  
  1281.         OBJECT      acctngFileMaximumSize
  1282.         MIN-ACCESS  read-only
  1283.         DESCRIPTION "Write access is not required."
  1284.  
  1285.         OBJECT      acctngFileCollectMode
  1286.         SYNTAX      BITS { onRelease(0) }
  1287.  
  1288.  
  1289.  
  1290. McCloghrie, et. al.         Standards Track                    [Page 23]
  1291.  
  1292. RFC 2513           Connection-Oriented Accounting MIB      February 1999
  1293.  
  1294.  
  1295.         MIN-ACCESS  read-only
  1296.         DESCRIPTION "The minimal requirement is for collection on
  1297.                     connection release."
  1298.  
  1299.         OBJECT      acctngFileInterval
  1300.         MIN-ACCESS  read-only
  1301.         DESCRIPTION "Write access is not required."
  1302.  
  1303.         OBJECT      acctngFileCollectFailedAttempts
  1304.         MIN-ACCESS  read-only
  1305.         DESCRIPTION "Write access is not required."
  1306.  
  1307.         OBJECT      acctngFileRowStatus
  1308.         MIN-ACCESS  read-only
  1309.         DESCRIPTION "Write access is not required."
  1310.  
  1311.     ::= { acctngCompliances 1 }
  1312.  
  1313.  
  1314. -- units of conformance
  1315.  
  1316. acctngBasicGroup    OBJECT-GROUP
  1317.     OBJECTS { acctngSelectionSubtree, acctngSelectionList,
  1318.               acctngSelectionFile, acctngSelectionType,
  1319.               acctngSelectionRowStatus, acctngFileName,
  1320.               acctngFileNameSuffix, acctngFileDescription,
  1321.               acctngFileCommand, acctngFileMaximumSize,
  1322.               acctngFileCurrentSize, acctngFileRowStatus,
  1323.               acctngFileFormat, acctngFileCollectMode,
  1324.               acctngFileCollectFailedAttempts, acctngFileInterval,
  1325.               acctngFileMinAge,
  1326.               acctngAdminStatus, acctngOperStatus,
  1327.               acctngProtection, acctngAgentMode,
  1328.               acctngInterfaceEnable,
  1329.               acctngControlTrapThreshold,
  1330.               acctngControlTrapEnable
  1331.             }
  1332.     STATUS  current
  1333.     DESCRIPTION
  1334.             "A collection of objects providing control of the basic
  1335.             collection of accounting data for connection-oriented
  1336.             networks."
  1337.     ::= { acctngGroups 1 }
  1338.  
  1339. acctngNotificationsGroup NOTIFICATION-GROUP
  1340.     NOTIFICATIONS { acctngFileNearlyFull, acctngFileFull }
  1341.     STATUS        current
  1342.     DESCRIPTION
  1343.  
  1344.  
  1345.  
  1346. McCloghrie, et. al.         Standards Track                    [Page 24]
  1347.  
  1348. RFC 2513           Connection-Oriented Accounting MIB      February 1999
  1349.  
  1350.  
  1351.             "The notifications of events relating to controlling the
  1352.             collection of accounting data."
  1353.     ::= { acctngGroups 2 }
  1354.  
  1355. END
  1356.  
  1357. 5.  Acknowledgements
  1358.  
  1359.    The comments of the IETF's AToM MIB Working Group are acknowledged.
  1360.  
  1361. 6.  References
  1362.  
  1363.    [1]  Harrington, D., Presuhn, R. and B. Wijnen, "An Architecture for
  1364.         Describing SNMP Management Frameworks", RFC 2271, January 1998.
  1365.  
  1366.    [2]  Rose, M. and K. McCloghrie, "Structure and Identification of
  1367.         Management Information for TCP/IP-based Internets", STD 16, RFC
  1368.         1155, May 1990.
  1369.  
  1370.    [3]  Rose, M. and K. McCloghrie, "Concise MIB Definitions", STD 16,
  1371.         RFC 1212, March 1991.
  1372.  
  1373.    [4]  Rose, M., "A Convention for Defining Traps for use with the
  1374.         SNMP", RFC 1215, March 1991.
  1375.  
  1376.    [5]  SNMPv2 Working Group, Case, J., McCloghrie, K., Rose, M. and S.
  1377.         Waldbusser, "Structure of Management Information for Version 2
  1378.         of the Simple Network Management Protocol (SNMPv2)", RFC 1902,
  1379.         January 1996.
  1380.  
  1381.    [6]  SNMPv2 Working Group, Case, J., McCloghrie, K., Rose, M. and S.
  1382.         Waldbusser, "Textual Conventions for Version 2 of the Simple
  1383.         Network Management Protocol (SNMPv2)", RFC 1903, January 1996.
  1384.  
  1385.    [7]  SNMPv2 Working Group, Case, J., McCloghrie, K., Rose, M. and S.
  1386.         Waldbusser, "Conformance Statements for Version 2 of the Simple
  1387.         Network Management Protocol (SNMPv2)", RFC 1904, January 1996.
  1388.  
  1389.    [8]  Case, J., Fedor, M., Schoffstall, M. and J. Davin, "Simple
  1390.         Network Management Protocol", STD 15, RFC 1157, May 1990.
  1391.  
  1392.    [9]  SNMPv2 Working Group, Case, J., McCloghrie, K., Rose, M. and S.
  1393.         Waldbusser, "Introduction to Community-based SNMPv2", RFC 1901,
  1394.         January 1996.
  1395.  
  1396.    [10] SNMPv2 Working Group, Case, J., McCloghrie, K., Rose, M. and S.
  1397.         Waldbusser, "Transport Mappings for Version 2 of the Simple
  1398.         Network Management Protocol (SNMPv2)", RFC 1906, January 1996.
  1399.  
  1400.  
  1401.  
  1402. McCloghrie, et. al.         Standards Track                    [Page 25]
  1403.  
  1404. RFC 2513           Connection-Oriented Accounting MIB      February 1999
  1405.  
  1406.  
  1407.    [11] Case, J., Harrington D., Presuhn R. and B. Wijnen, "Message
  1408.         Processing and Dispatching for the Simple Network Management
  1409.         Protocol (SNMP)", RFC 2272, January 1998.
  1410.  
  1411.    [12] Blumenthal, U. and B. Wijnen, "User-based Security Model (USM)
  1412.         for version 3 of the Simple Network Management Protocol
  1413.         (SNMPv3)", RFC 2274, January 1998.
  1414.  
  1415.    [13] SNMPv2 Working Group, Case, J., McCloghrie, K., Rose, M. and S.
  1416.         Waldbusser, "Protocol Operations for Version 2 of the Simple
  1417.         Network Management Protocol (SNMPv2)", RFC 1905, January 1996.
  1418.  
  1419.    [14] Levi, D., Meyer, P. and B. Stewart, "SNMPv3 Applications", RFC
  1420.         2273, January 1998.
  1421.  
  1422.    [15] Wijnen, B., Presuhn, R. and K. McCloghrie, "View-based Access
  1423.         Control Model (VACM) for the Simple Network Management Protocol
  1424.         (SNMP)", RFC 2275, January 1998.
  1425.  
  1426.    [16] SNMPv2 Working Group, Case, J., McCloghrie, K., Rose, M. and S.
  1427.         Waldbusser, "Management Information Base for version 2 of the
  1428.         Simple Network Management Protocol (SNMPv2)", RFC 1907, January
  1429.         1996.
  1430.  
  1431.    [17] Information processing systems - Open Systems Interconnection,
  1432.         "Specification of Abstract Syntax Notation One (ASN.1)",
  1433.         International Organization for Standardization, Internation
  1434.         Standard 8824, December 1987.
  1435.  
  1436.    [18] Information processing systems - Open Systems Interconnection,
  1437.         "Specification of Basic Encoding Rules for Abstract Syntax
  1438.         Notation One (ASN.1)", International Organization for
  1439.         Standardization, Internation Standard 8825, December 1987.
  1440.  
  1441.    [19] McCloghrie, K., Heinanen, J., Greene, W. and A. Prasad,
  1442.         "Accounting Information for ATM Networks", RFC 2512, February
  1443.         1999.
  1444.  
  1445.    [20] Noto, M., Spiegel, E., and K. Tesink, "Definitions of Textual
  1446.         Conventions and OBJECT-IDENTITIES for ATM Management", RFC 2514,
  1447.         February 1999.
  1448.  
  1449.  
  1450.  
  1451.  
  1452.  
  1453.  
  1454.  
  1455.  
  1456.  
  1457.  
  1458. McCloghrie, et. al.         Standards Track                    [Page 26]
  1459.  
  1460. RFC 2513           Connection-Oriented Accounting MIB      February 1999
  1461.  
  1462.  
  1463. 7.  Security Considerations
  1464.  
  1465.    The MIB defined in this memo controls and monitors the collection of
  1466.    accounting data.  Care should be taken to prohibit unauthorized
  1467.    access to this control capability in order to prevent the disruption
  1468.    of data collection, possibly with fraudulent intent.  Example of such
  1469.    disruption are disabling the collection of data, or causing the wrong
  1470.    set of data items to be collected.
  1471.  
  1472.    SNMPv1 by itself is not a secure environment.  Even if the network
  1473.    itself is secure (for example by using IPSec), even then, there is no
  1474.    control as to who on the secure network is allowed to access and
  1475.    GET/SET (read/change/create/delete) the objects in this MIB.
  1476.  
  1477.    It is recommended that the implementers consider the security
  1478.    features as provided by the SNMPv3 framework.  Specifically, the use
  1479.    of the User-based Security Model RFC 2274 [12] and the View-based
  1480.    Access Control Model RFC 2275 [15] is recommended.
  1481.  
  1482.    It is then a customer/user responsibility to ensure that the SNMP
  1483.    entity giving access to an instance of this MIB, is properly
  1484.    configured to give access to the objects only to those principals
  1485.    (users) that have legitimate rights to indeed GET or SET
  1486.    (change/create/delete) them.
  1487.  
  1488. 8.  IANA Considerations
  1489.  
  1490.    Prior to publication of this memo as an RFC, IANA is requested to
  1491.    make a suitable OBJECT IDENTIFIER assignment.
  1492.  
  1493.  
  1494.  
  1495.  
  1496.  
  1497.  
  1498.  
  1499.  
  1500.  
  1501.  
  1502.  
  1503.  
  1504.  
  1505.  
  1506.  
  1507.  
  1508.  
  1509.  
  1510.  
  1511.  
  1512.  
  1513.  
  1514. McCloghrie, et. al.         Standards Track                    [Page 27]
  1515.  
  1516. RFC 2513           Connection-Oriented Accounting MIB      February 1999
  1517.  
  1518.  
  1519. 9.  Authors' Addresses
  1520.  
  1521.    Keith McCloghrie
  1522.    Cisco Systems, Inc.
  1523.    170 West Tasman Drive,
  1524.    San Jose CA 95134
  1525.  
  1526.    Phone: +1 408 526 5260
  1527.    EMail: kzm@cisco.com
  1528.  
  1529.  
  1530.    Juha Heinanen
  1531.    Telia Finland, Inc.
  1532.    Myyrmaentie 2
  1533.    01600 VANTAA
  1534.    Finland
  1535.  
  1536.    Phone +358 303 944 808
  1537.    EMail: jh@telia.fi
  1538.  
  1539.  
  1540.    Wedge Greene
  1541.    MCI Telecommunications Corporation
  1542.    901 International Parkway
  1543.    Richardson, Texas 75081
  1544.  
  1545.    Phone: 214-498-1232 or 972-729-1232
  1546.    EMail: wedge.greene@mci.com
  1547.  
  1548.  
  1549.    Anil Prasad
  1550.    Cisco Systems, Inc.
  1551.    170 West Tasman Drive,
  1552.    San Jose CA 95134
  1553.  
  1554.    Phone: 408 525-7209
  1555.    EMail: aprasad@cisco.com
  1556.  
  1557.  
  1558.  
  1559.  
  1560.  
  1561.  
  1562.  
  1563.  
  1564.  
  1565.  
  1566.  
  1567.  
  1568.  
  1569.  
  1570. McCloghrie, et. al.         Standards Track                    [Page 28]
  1571.  
  1572. RFC 2513           Connection-Oriented Accounting MIB      February 1999
  1573.  
  1574.  
  1575. 10.  Full Copyright Statement
  1576.  
  1577.    Copyright (C) The Internet Society (1999).  All Rights Reserved.
  1578.  
  1579.    This document and translations of it may be copied and furnished to
  1580.    others, and derivative works that comment on or otherwise explain it
  1581.    or assist in its implementation may be prepared, copied, published
  1582.    and distributed, in whole or in part, without restriction of any
  1583.    kind, provided that the above copyright notice and this paragraph are
  1584.    included on all such copies and derivative works.  However, this
  1585.    document itself may not be modified in any way, such as by removing
  1586.    the copyright notice or references to the Internet Society or other
  1587.    Internet organizations, except as needed for the purpose of
  1588.    developing Internet standards in which case the procedures for
  1589.    copyrights defined in the Internet Standards process must be
  1590.    followed, or as required to translate it into languages other than
  1591.    English.
  1592.  
  1593.    The limited permissions granted above are perpetual and will not be
  1594.    revoked by the Internet Society or its successors or assigns.
  1595.  
  1596.    This document and the information contained herein is provided on an
  1597.    "AS IS" basis and THE INTERNET SOCIETY AND THE INTERNET ENGINEERING
  1598.    TASK FORCE DISCLAIMS ALL WARRANTIES, EXPRESS OR IMPLIED, INCLUDING
  1599.    BUT NOT LIMITED TO ANY WARRANTY THAT THE USE OF THE INFORMATION
  1600.    HEREIN WILL NOT INFRINGE ANY RIGHTS OR ANY IMPLIED WARRANTIES OF
  1601.    MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE.
  1602.  
  1603.  
  1604.  
  1605.  
  1606.  
  1607.  
  1608.  
  1609.  
  1610.  
  1611.  
  1612.  
  1613.  
  1614.  
  1615.  
  1616.  
  1617.  
  1618.  
  1619.  
  1620.  
  1621.  
  1622.  
  1623.  
  1624.  
  1625.  
  1626. McCloghrie, et. al.         Standards Track                    [Page 29]
  1627.  
  1628.