home *** CD-ROM | disk | FTP | other *** search
/ Internet Info 1997 December / Internet_Info_CD-ROM_Walnut_Creek_December_1997.iso / drafts / draft_ietf_a_c / draft-ietf-atommib-acct-04.txt < prev    next >
Text File  |  1996-11-26  |  56KB  |  1,944 lines
  1.  
  2. Internet-Draft     Connection-Oriented Accounting MIB      November 1996
  3.  
  4.  
  5.  
  6.  
  7.              Managed Objects for Controlling the Collection
  8.                and Storage of Accounting Information for
  9.                       Connection-Oriented Networks
  10.  
  11.                      draft-ietf-atommib-acct-04.txt
  12.  
  13.                             26 November 1996
  14.  
  15.  
  16.                             Keith McCloghrie
  17.                           Cisco Systems, Inc.
  18.                              kzm@cisco.com
  19.  
  20.                              Juha Heinanen
  21.                           Telecom Finland Inc.
  22.                           jh@lohi.dat.tele.fi
  23.  
  24.                               Wedge Greene
  25.                    MCI Telecommunications Corporation
  26.                            wedgeg@mcimail.com
  27.  
  28.                               Anil Prasad
  29.                           Cisco Systems, Inc.
  30.                            aprasad@cisco.com
  31.  
  32.  
  33.  
  34. Status of this Memo
  35.  
  36. This document is an Internet-Draft.  Internet-Drafts are working
  37. documents of the Internet Engineering Task Force (IETF), its areas, and
  38. its working groups.  Note that other groups may also distribute working
  39. documents as Internet-Drafts.
  40.  
  41. Internet-Drafts are draft documents valid for a maximum of six months
  42. and may be updated, replaced, or obsoleted by other documents at any
  43. time.  It is inappropriate to use Internet- Drafts as reference material
  44. or to cite them other than as ``work in progress.''
  45.  
  46. To learn the current status of any Internet-Draft, please check the
  47. ``1id-abstracts.txt'' listing contained in the Internet- Drafts Shadow
  48. Directories on ds.internic.net (US East Coast), nic.nordu.net (Europe),
  49. ftp.isi.edu (US West Coast), or munnari.oz.au (Pacific Rim).
  50.  
  51.  
  52.  
  53.  
  54.  
  55. Expires May 1997                                                [Page 1]
  56.  
  57.  
  58.  
  59.  
  60.  
  61. Internet-Draft     Connection-Oriented Accounting MIB      November 1996
  62.  
  63.  
  64. 1.  Introduction
  65.  
  66. This memo defines an experimental portion of the Management Information
  67. Base (MIB) for use with network management protocols in the Internet
  68. community.  In particular, it describes managed objects used for
  69. controlling the collection and storage of accounting information for
  70. connection-oriented networks such as ATM.  The accounting data is
  71. collected into files for later retrieval via a file transfer protocol.
  72. For information on data which can be collected for ATM networks, see
  73. [9].
  74.  
  75.  
  76.  
  77. 2.  The SNMP Network Management Framework
  78.  
  79. The SNMP Network Management Framework presently consists of three major
  80. components.  They are:
  81.  
  82.   the SMI, described in RFC 1902 [1] - the mechanisms used for
  83.   describing and naming objects for the purpose of management.
  84.  
  85.   the MIB-II, STD 17, RFC 1231 [2] - the core set of managed objects for
  86.   the Internet suite of protocols.
  87.  
  88.   the protocol, RFC 1157 [3] and/or RFC 1905 [4], - the protocol for
  89.   accessing managed objects.
  90.  
  91. The Framework permits new objects to be defined for the purpose of
  92. experimentation and evaluation.
  93.  
  94. 2.1.  Object Definitions
  95.  
  96. Managed objects are accessed via a virtual information store, termed the
  97. Management Information Base or MIB.  Objects in the MIB are defined
  98. using the subset of Abstract Syntax Notation One (ASN.1) defined in the
  99. SMI.  In particular, each object type is named by an OBJECT IDENTIFIER,
  100. an administratively assigned name.  The object type together with an
  101. object instance serves to uniquely identify a specific instantiation of
  102. the object.  For human convenience, we often use a textual string,
  103. termed the descriptor, to refer to the object type.
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114. Expires May 1997                                                [Page 2]
  115.  
  116.  
  117.  
  118.  
  119.  
  120. Internet-Draft     Connection-Oriented Accounting MIB      November 1996
  121.  
  122.  
  123. 3.  Overview
  124.  
  125. In some connected-oriented network environments, there is a need for the
  126. network administrator to be able to collect accounting data on the usage
  127. of bandwidth/resources by connections (e.g., ATM connections) within the
  128. network.  Data collection should be available for switched virtual
  129. connections (SVCs and SVPs), and permanent virtual connections (PVCs and
  130. PVPs), including soft-permanent virtual connections (SPVCCs and SPVPCs).
  131. This need exists for ATM networks, and may well exist for other
  132. connection-oriented networks, such as Frame Relay.
  133.  
  134. The potential quantity of such accounting information is such that it is
  135. not, in general, feasible to retrieve the information via SNMP.  A
  136. better method is to store the collected accounting information in a file
  137. which can be subsequently retrieved via a file transfer protocol.
  138.  
  139. It is, however, appropriate to provide management control of the
  140. selection and collection of such accounting data via SNMP.  This memo
  141. describes a MIB module which provides such control in a manner
  142. independent of the type of network.  One or more other documents provide
  143. definitions of particular items of accounting data which can be
  144. selected; for example, a particular set of data items which can be
  145. collected for ATM networks is specified in [9].
  146.  
  147. 3.1.  Operational Model
  148.  
  149. The requirement is for switches (e.g., ATM switches) to collect data
  150. concerning the connections which are routed across some subset of their
  151. interfaces (e.g., ATM UNI and/or NNI interfaces).  The collected data is
  152. stored into one or more "files".  The use of multiple files allows, for
  153. example, the data collected for PVCs to be different from that collected
  154. for SVCs.
  155.  
  156. In order to retrieve the data currently being stored in a file, the
  157. administrator instructs the switch to terminate the collection of data
  158. into that file, and start collecting data into a new file.  After this
  159. operation, the data in the old file is available for retrieval via file
  160. transfer.
  161.  
  162. A collection file is defined to have a maximum size.  When the size of
  163. the file currently being collected exceeds a threshold percentage of
  164. that maximum size, an SNMP notification (e.g., a trap) can be optionally
  165. generated.  An SNMP notification might also be generated if the file
  166. reaches its maximum size.
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173. Expires May 1997                                                [Page 3]
  174.  
  175.  
  176.  
  177.  
  178.  
  179. Internet-Draft     Connection-Oriented Accounting MIB      November 1996
  180.  
  181.  
  182. The accounting data collected for each connection consists of a set of
  183. objects and their values.  The set of objects and their values are
  184. collected on one or more of the following occasions:
  185.  
  186. (1)  on the release (termination) of a connection optionally including
  187.      failed connection attempts;
  188.  
  189. (2)  for each active connection (having a particular minimum age) on a
  190.      periodic basis;
  191.  
  192. (3)  for each active connection (having a particular minimum age) when
  193.      so commanded by a management application.
  194.  
  195. While collecting data to be stored in a particular file, the same set of
  196. objects is collected for each connection on each occasion.  Having the
  197. same set of objects stored on each occasion allows the optimization of
  198. storing only the values of those objects.  This results in a
  199. significantly smaller file size, since it allows the names of the
  200. objects to be stored once and only once at the beginning of the file,
  201. rather than having to store every value as a (name, value) pair.
  202.  
  203. Two modes of agent behaviour are allowed on the event of a file reaching
  204. its maximum size:
  205.  
  206. (1)  management application in control:
  207.  
  208.      The agent does not automatically swap to a new file; rather, it
  209.      discards newly collected data until the management application
  210.      subsequently instructs it to swap to a new file.  Before swapping
  211.      to a new file, the name of the file into which data is currently
  212.      being collected is an implementation issue of no concern to an NM
  213.      application; after swapping to a new file, the name of the file
  214.      available for retrieval is as specified by the controlling MIB
  215.      objects.  This behaviour allows the application to know exactly how
  216.      many files need to be retrieved and their names without having to
  217.      perform any type of file directory operation, but also results in
  218.      the possibility that data will be discarded if the application does
  219.      not instruct the agent to swap within the required time frame.
  220.  
  221. (2)  agent automatically swaps to new file:
  222.  
  223.      The agent terminates collection into the current (full) file, and
  224.      begins collecting data into a new version of the same base file
  225.      name.  This behaviour aims to avoid loss of data by assuming that
  226.      additional storage space is actually available to create a new
  227.  
  228.  
  229.  
  230.  
  231.  
  232. Expires May 1997                                                [Page 4]
  233.  
  234.  
  235.  
  236.  
  237.  
  238. Internet-Draft     Connection-Oriented Accounting MIB      November 1996
  239.  
  240.  
  241.      version of the file.  To support this behaviour, files are named
  242.      using suffixes, such that when the current version of the file
  243.      becomes full, the agent begins collecting data into a file with the
  244.      same base file-name but with an incremented (or otherwise modified)
  245.      suffix.  This requires the application to perform file directory
  246.      operations prior to retrieving completed files in order to know how
  247.      many and which suffixes have been used.
  248.  
  249. With either behaviour, any completed file must be an integral number of
  250. connection records (see below).  When a file reaches its maximum size,
  251. collection into that file is terminated either immediately before or
  252. immediately after storing the whole of the current connection record
  253. into the file.  The former causes the file to be just less than its
  254. maximum size, and the latter causes the file to be just greater than its
  255. maximum size.
  256.  
  257. 3.2.  Selection of Accounting Data
  258.  
  259. The items of accounting data to be collected are specified as a set of
  260. objects.  Which objects are contained in such a set is selectable by an
  261. administrator through the specification of one or more (subtree, list)
  262. tuples, where the set of objects to be collected is the union of the
  263. subsets specified by each tuple:
  264.  
  265.     'subtree' specifies an OBJECT IDENTIFIER value such that every
  266.         object in the subset is named by the subtree's value appended
  267.         with a single additional sub-identifier.
  268.  
  269.     'list' specifies an OCTET STRING value, such that if the N-th bit of
  270.         the string's value is set then the the subset contains the
  271.         object named by appending N as a single additional sub-
  272.         identifier to the subtree.
  273.  
  274. The rationale for defining each subset as a (subtree,list) tuple is that
  275. one and only one OBJECT IDENTIFIER and one OCTET STRING is needed to
  276. define the subset of objects.  This simplifies the MIB mechanisms needed
  277. for selection: an NM application needs to create only one conceptual row
  278. in a MIB table for each subset (rather than needing to create a
  279. conceptual row in a table for each and every object in the set).
  280.  
  281. The number of tuples supported by a particular switch is an
  282. implementation choice.  One possibility is to support two (subtree,
  283. list) tuples so that one such tuple can specify a standard 'subtree'
  284. (e.g., the atmAcctngDataObjects subtree defined in [9]), and the second
  285. tuple can specify an enterprise-specific 'subtree'; this would allow the
  286.  
  287.  
  288.  
  289.  
  290.  
  291. Expires May 1997                                                [Page 5]
  292.  
  293.  
  294.  
  295.  
  296.  
  297. Internet-Draft     Connection-Oriented Accounting MIB      November 1996
  298.  
  299.  
  300. selected set of objects to be the union of a set of standard objects and
  301. a set of enterprise-defined objects.
  302.  
  303. 3.3.  Format of Collection File
  304.  
  305. A collection file generated by this process contains the values of MIB
  306. objects defined using the SNMPv2 SMI.  The standard way to encode the
  307. values of SNMP MIB objects in a device-independent manner is through the
  308. use of ASN.1's Basic Encoding Rules (BER) [8].  Thus, the standard
  309. format of an accounting file is defined here using ASN.1 [7].
  310.  
  311. The file consists of a set of header information followed by a sequence
  312. of zero or more collection records.  The header information identifies
  313. (via sysName [6]) the switch which collected the data, the date and time
  314. at which the collection in to this file started, and the sequence of one
  315. or more (subtree, list) tuples identifying the objects whose values are
  316. contained in each connection record.  The header information also
  317. includes a textual description of the data contained in the file.
  318.  
  319. Each connection record contains a sequence of values for each identified
  320. tuple, in the same order as the tuples are identified in the header
  321. information.  For each tuple, the sequence of values are in ascending
  322. order of the sub-identifier which identifies them within the subtree.
  323.  
  324.  
  325.  
  326.  
  327.  
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334.  
  335.  
  336.  
  337.  
  338.  
  339.  
  340.  
  341.  
  342.  
  343.  
  344.  
  345.  
  346.  
  347.  
  348.  
  349.  
  350. Expires May 1997                                                [Page 6]
  351.  
  352.  
  353.  
  354.  
  355.  
  356. Internet-Draft     Connection-Oriented Accounting MIB      November 1996
  357.  
  358.  
  359. Formally, an accounting file is an ASN.1 value with the following
  360. syntax:
  361.  
  362.      File ::=
  363.         [1]
  364.            IMPLICIT SEQUENCE {
  365.                                 -- header information
  366.                sysName               -- name of the switch
  367.                    DisplayString,
  368.  
  369.                description           -- textual description of the collection
  370.                    DisplayString,
  371.  
  372.                startTime             -- start time of the collection
  373.                    DateAndTime,
  374.  
  375.                SEQUENCE OF {         -- sequence of (subtree, list) tuples
  376.                    SEQUENCE {
  377.                        subtree
  378.                            OBJECT IDENTIFIER,
  379.                        list
  380.                            OCTET STRING
  381.                    }
  382.                }
  383.                                 -- sequence of connection records
  384.                SEQUENCE OF {
  385.                                      -- each record containing a sequence
  386.                    SEQUENCE OF {     -- per identified tuple
  387.  
  388.                        SEQUENCE OF {     -- each per-tuple sequence containing
  389.                            value         -- a sequence of object values
  390.                                ObjectSyntax
  391.                        }
  392.                    }
  393.                }
  394.            }
  395.  
  396. where:
  397.  
  398. (1)  the value of the sysName component is that of the sysName object in
  399.      the System group [6].
  400.  
  401. (2)  each (subtree, list) specifies the set of objects contained in that
  402.      tuple's sequence within each and every connection record.
  403.  
  404.  
  405.  
  406.  
  407.  
  408.  
  409. Expires May 1997                                                [Page 7]
  410.  
  411.  
  412.  
  413.  
  414.  
  415. Internet-Draft     Connection-Oriented Accounting MIB      November 1996
  416.  
  417.  
  418. (3)  the tuples' sequences within each connection record occur in the
  419.      same order as the (subtree, list) tuples occur in the header
  420.      information.
  421.  
  422. (4)  the object values within each connection record occur in the same
  423.      order as they are represented by the bits in the corresponding list
  424.      value.
  425.  
  426. (5)  ObjectSyntax is defined by the SNMPv2 SMI [1].
  427.  
  428. (6)  One particular category of object values deserves special
  429.      attention: an object defined to hold the checksum value of an
  430.      accounting record (e.g., atmAcctngRecordCrc16, defined in [9]).  An
  431.      object in this category will generally have a SYNTAX of a fixed-
  432.      length OCTET STRING, and have its value initialized to the string
  433.      of all zeros when composing the accounting record containing it,
  434.      with the location of these zeros being saved.  Once the record is
  435.      generated, the checksum is calculated over the whole connection
  436.      record (including the starting SEQUENCE OF and the trailing end-
  437.      of-contents octets, if used), and then the zeros are overwritten
  438.      (at the saved location) by the calculated value of the checksum.
  439.  
  440. The encoding of the above syntax using the Basic Encoding Rules is the
  441. same as defined by the SNMPv2 [5], with the following exception:
  442.  
  443.    - when encoding the length field for a structured type, i.e., a
  444.      SEQUENCE or SEQUENCE OF, the indefinite form encoding is permitted.
  445.  
  446.  
  447.  
  448.  
  449.  
  450.  
  451.  
  452.  
  453.  
  454.  
  455.  
  456.  
  457.  
  458.  
  459.  
  460.  
  461.  
  462.  
  463.  
  464.  
  465.  
  466.  
  467.  
  468. Expires May 1997                                                [Page 8]
  469.  
  470.  
  471.  
  472.  
  473.  
  474. Internet-Draft     Connection-Oriented Accounting MIB      November 1996
  475.  
  476.  
  477. For example, the file containing the data:
  478.  
  479. [1] IMPLICIT SEQUENCE     a1 80
  480.       OCTET STRING        04 09 73 77 69 74 63 68 2d 61 62
  481.       OCTET STRING        04 0a 41 63 63 6f 75 6e 74 69 6e 67
  482.       OCTET STRING        04 08 07 cc 07 14 10 05 00 00
  483.       SEQUENCE OF         30 0e
  484.         SEQUENCE             30 0c
  485.           OBJECT IDENTIFIER     06 06 2b 06 01 03 7f 01 01
  486.           OCTET STRING          04 01 c0
  487.       SEQUENCE OF         30 80
  488.         SEQUENCE OF          30 08
  489.           SEQUENCE OF           30 06
  490.             INTEGER                02 01 00
  491.             INTEGER                02 01 21
  492.         SEQUENCE OF          30 08
  493.           SEQUENCE OF           30 06
  494.             INTEGER                02 01 00
  495.             INTEGER                02 01 22
  496.       end-of-contents     00 00
  497.     end-of-contents       00 00
  498.  
  499. contains two connection records, each containing one tuple listing two
  500. (integer) data items in a (fictitious) subtree: 1.3.6.1.3.127.1.1.  Its
  501. header indicates it's for "switch-12", with description "Accounting",
  502. and was collected at 16:05:00 on 20 July 1996.
  503.  
  504. As well as the standard format defined above, the MIB allows other
  505. enterprise-specific formats to be used.
  506.  
  507.  
  508.  
  509.  
  510.  
  511.  
  512.  
  513.  
  514.  
  515.  
  516.  
  517.  
  518.  
  519.  
  520.  
  521.  
  522.  
  523.  
  524.  
  525.  
  526.  
  527. Expires May 1997                                                [Page 9]
  528.  
  529.  
  530.  
  531.  
  532.  
  533. Internet-Draft     Connection-Oriented Accounting MIB      November 1996
  534.  
  535.  
  536. 4.  Definitions
  537.  
  538. ACCOUNTING-CONTROL-MIB DEFINITIONS ::= BEGIN
  539.  
  540. IMPORTS
  541.     MODULE-IDENTITY, OBJECT-TYPE, NOTIFICATION-TYPE,
  542.     experimental, Integer32                       FROM SNMPv2-SMI
  543.     TEXTUAL-CONVENTION, RowStatus, TestAndIncr,
  544.     DisplayString, TruthValue                     FROM SNMPv2-TC
  545.     MODULE-COMPLIANCE, OBJECT-GROUP               FROM SNMPv2-CONF
  546.     ifIndex                                       FROM IF-MIB;
  547.  
  548.  
  549. accountingControlMIB MODULE-IDENTITY
  550.     LAST-UPDATED "9611052000Z"
  551.     ORGANIZATION "IETF AToM MIB Working Group"
  552.     CONTACT-INFO "Keith McCloghrie
  553.                   Cisco Systems, Inc.
  554.                   170 West Tasman Drive,
  555.                   San Jose CA 95134-1706.
  556.                   Phone: +1 408 526 5260
  557.                   Email: kzm@cisco.com"
  558.     DESCRIPTION
  559.             "The MIB module for managing the collection and storage of
  560.             accounting information for connections in a connection-
  561.             oriented network such as ATM."
  562.     ::= { experimental xx }
  563.  
  564.  
  565. acctngMIBObjects       OBJECT IDENTIFIER ::= { accountingControlMIB 1 }
  566.  
  567. acctngSelectionControl OBJECT IDENTIFIER ::= { acctngMIBObjects 1 }
  568. acctngFileControl      OBJECT IDENTIFIER ::= { acctngMIBObjects 2 }
  569. acctngInterfaceControl OBJECT IDENTIFIER ::= { acctngMIBObjects 3 }
  570. acctngTrapControl      OBJECT IDENTIFIER ::= { acctngMIBObjects 4 }
  571.  
  572.  
  573.  
  574.  
  575.  
  576.  
  577.  
  578.  
  579.  
  580.  
  581.  
  582.  
  583.  
  584.  
  585.  
  586. Expires May 1997                                               [Page 10]
  587.  
  588.  
  589.  
  590.  
  591.  
  592. Internet-Draft     Connection-Oriented Accounting MIB      November 1996
  593.  
  594.  
  595. -- Textual Conventions
  596.  
  597.  
  598. DataCollectionSubtree ::= TEXTUAL-CONVENTION
  599.     STATUS       current
  600.     DESCRIPTION
  601.             "The subtree component of a (subtree, list) tuple.  Such a
  602.             (subtree, list) tuple defines a set of objects and their
  603.             values to be collected as accounting data for a connection.
  604.             The subtree specifies a single OBJECT IDENTIFIER value such
  605.             that each object in the set is named by the subtree value
  606.             appended with a single additional sub-identifier."
  607.     SYNTAX       OBJECT IDENTIFIER
  608.  
  609. DataCollectionList ::= TEXTUAL-CONVENTION
  610.     STATUS       current
  611.     DESCRIPTION
  612.             "The list component of a (subtree, list) tuple.  Such a
  613.             (subtree, list) tuple defines a set of objects and their
  614.             values to be collected as accounting data for a connection.
  615.             The subtree specifies a single OBJECT IDENTIFIER value such
  616.             that each object in the set is named by the subtree value
  617.             appended with a single additional sub-identifier.  The list
  618.             specifies a set of data items, where the presence of an item
  619.             in the list indicates that the item is (to be) present in
  620.             the data collected for a connection; the absence of an item
  621.             from the list indicates that the item is not (to be) present
  622.             in the data collected for a connection.  Each data item is
  623.             represented by an integer which when appended (as as
  624.             additional sub-identifier) to the OBJECT IDENTIFIER value of
  625.             the subtree identified by the tuple, is the name of an
  626.             object defining that data item (its description and its
  627.             syntax).
  628.  
  629.             The list is specified as an OCTET STRING in which each data
  630.             item is represented by a single bit, where data items 1
  631.             through 8 are represented by the bits in the first octet,
  632.             data items 9 through 16 by the bits in the second octet,
  633.             etc.  In each octet, the lowest numbered data item is
  634.             represented by the most significant bit, and the highest
  635.             numbered data item by the least significant bit.  A data
  636.             item is present in the list when its bit is set, and absent
  637.             when its bit is reset.  If the length of an OCTET STRING
  638.             value is too short to represent one or more data items
  639.             defined in a subtree, then those data items are absent from
  640.  
  641.  
  642.  
  643.  
  644.  
  645. Expires May 1997                                               [Page 11]
  646.  
  647.  
  648.  
  649.  
  650.  
  651. Internet-Draft     Connection-Oriented Accounting MIB      November 1996
  652.  
  653.  
  654.             the set identified by the tuple of that subtree and that
  655.             OCTET STRING value."
  656.     SYNTAX       OCTET STRING (SIZE(0..8))
  657.  
  658. FileIndex ::= TEXTUAL-CONVENTION
  659.     STATUS       current
  660.     DESCRIPTION
  661.             "An arbitrary integer value identifying a file into which
  662.             accounting data is being collected."
  663.     SYNTAX       Integer32 (1..65535)
  664.  
  665.  
  666.  
  667.  
  668.  
  669.  
  670.  
  671.  
  672.  
  673.  
  674.  
  675.  
  676.  
  677.  
  678.  
  679.  
  680.  
  681.  
  682.  
  683.  
  684.  
  685.  
  686.  
  687.  
  688.  
  689.  
  690.  
  691.  
  692.  
  693.  
  694.  
  695.  
  696.  
  697.  
  698.  
  699.  
  700.  
  701.  
  702.  
  703.  
  704. Expires May 1997                                               [Page 12]
  705.  
  706.  
  707.  
  708.  
  709.  
  710. Internet-Draft     Connection-Oriented Accounting MIB      November 1996
  711.  
  712.  
  713. -- The Accounting Information Selection table
  714.  
  715. acctngSelectionTable OBJECT-TYPE
  716.     SYNTAX      SEQUENCE OF AcctngSelectionEntry
  717.     MAX-ACCESS  not-accessible
  718.     STATUS      current
  719.     DESCRIPTION
  720.             "A list of accounting information selection entries.
  721.  
  722.             Note that additions, modifications and deletions of entries
  723.             in this table can occur at any time, but such changes only
  724.             take effect on the next occasion when collection begins into
  725.             a new file.  Thus, between modification and the next 'swap',
  726.             the content of this table does not reflect the current
  727.             selection."
  728.     ::= { acctngSelectionControl 1 }
  729.  
  730. acctngSelectionEntry OBJECT-TYPE
  731.     SYNTAX      AcctngSelectionEntry
  732.     MAX-ACCESS  not-accessible
  733.     STATUS      current
  734.     DESCRIPTION
  735.             "An entry identifying an (subtree, list) tuple used to
  736.             select a set of accounting information which is to be
  737.             collected."
  738.     INDEX   { acctngSelectionIndex }
  739.     ::= { acctngSelectionTable 1 }
  740.  
  741. AcctngSelectionEntry ::=
  742.     SEQUENCE {
  743.         acctngSelectionIndex     Integer32,
  744.         acctngSelectionSubtree   DataCollectionSubtree,
  745.         acctngSelectionList      DataCollectionList,
  746.         acctngSelectionFile      FileIndex,
  747.         acctngSelectionType      BITS,
  748.         acctngSelectionRowStatus RowStatus
  749.     }
  750.  
  751. acctngSelectionIndex OBJECT-TYPE
  752.     SYNTAX      Integer32 (1..65535)
  753.     MAX-ACCESS  not-accessible
  754.     STATUS      current
  755.     DESCRIPTION
  756.             "An arbitrary integer value which uniquely identifies a
  757.             tuple stored in this table.  This value is required to be
  758.  
  759.  
  760.  
  761.  
  762.  
  763. Expires May 1997                                               [Page 13]
  764.  
  765.  
  766.  
  767.  
  768.  
  769. Internet-Draft     Connection-Oriented Accounting MIB      November 1996
  770.  
  771.  
  772.             the permanent 'handle' for an entry in this table for as
  773.             long as that entry exists, including across restarts and
  774.             power outages."
  775.     ::= { acctngSelectionEntry 1 }
  776.  
  777. acctngSelectionSubtree OBJECT-TYPE
  778.     SYNTAX      DataCollectionSubtree
  779.     MAX-ACCESS  read-create
  780.     STATUS      current
  781.     DESCRIPTION
  782.             "The combination of acctngSelectionSubtree and
  783.             acctngSelectionList specifies one (subtree, list) tuple
  784.             which is to be collected."
  785.     ::= { acctngSelectionEntry 2 }
  786.  
  787. acctngSelectionList OBJECT-TYPE
  788.     SYNTAX      DataCollectionList
  789.     MAX-ACCESS  read-create
  790.     STATUS      current
  791.     DESCRIPTION
  792.             "The combination of acctngSelectionSubtree and
  793.             acctngSelectionList specifies one (subtree, list) tuple
  794.             which is to be collected."
  795.     ::= { acctngSelectionEntry 3 }
  796.  
  797. acctngSelectionFile OBJECT-TYPE
  798.     SYNTAX      FileIndex
  799.     MAX-ACCESS  read-create
  800.     STATUS      current
  801.     DESCRIPTION
  802.             "An indication of the file into which the accounting
  803.             information identified by this entry is to be stored.  If
  804.             there is no conceptual row in the acctngFileTable for which
  805.             the value of acctngFileIndex has the same value as this
  806.             object, then the information selected by this entry is not
  807.             collected."
  808.     ::= { acctngSelectionEntry 4 }
  809.  
  810. acctngSelectionType OBJECT-TYPE
  811.     SYNTAX      BITS { svcIncoming(0),
  812.                        svcOutgoing(1),
  813.                        svpIncoming(2),
  814.                        svpOutgoing(3),
  815.                        pvc(4),
  816.                        pvp(5),
  817.  
  818.  
  819.  
  820.  
  821.  
  822. Expires May 1997                                               [Page 14]
  823.  
  824.  
  825.  
  826.  
  827.  
  828. Internet-Draft     Connection-Oriented Accounting MIB      November 1996
  829.  
  830.  
  831.                        spvcOriginator(6),
  832.                        spvcTarget(7),
  833.                        spvpOriginator(8),
  834.                        spvpTarget(9) }
  835.     MAX-ACCESS  read-create
  836.     STATUS      current
  837.     DESCRIPTION
  838.             "Indicates the types of connections for which the
  839.             information selected by this entry are to be collected."
  840.     DEFVAL      { { svcIncoming, svcOutgoing,
  841.                     svpIncoming, svpOutgoing } }
  842.     ::= { acctngSelectionEntry 5 }
  843.  
  844. acctngSelectionRowStatus OBJECT-TYPE
  845.     SYNTAX      RowStatus
  846.     MAX-ACCESS  read-create
  847.     STATUS      current
  848.     DESCRIPTION
  849.             "The status of this conceptual row.  An agent may refuse to
  850.             create new conceptual rows and/or modify existing conceptual
  851.             rows, if such creation/modification would cause multiple
  852.             rows to have the same values of acctngSelectionSubtree and
  853.             acctngSelectionList.
  854.  
  855.             A conceptual row can not have the status of 'active' until
  856.             values have been assigned to the acctngSelectionSubtree,
  857.             acctngSelectionList and acctngSelectionFile columnar objects
  858.             within that row.
  859.  
  860.             An agent must not refuse to change the values of the
  861.             acctngSelectionSubtree, acctngSelectionList and
  862.             acctngSelectionFile columnar objects within a conceptual row
  863.             even while that row's status is 'active'.  Similarly, an
  864.             agent must not refuse to destroy an existing conceptual row
  865.             while the file referenced by that row's instance of
  866.             acctngSelectionFile is in active use, i.e., while the
  867.             corresponding instance of acctngFileRowStatus has the value
  868.             'active'.  However, such changes only take effect upon the
  869.             next occasion when collection begins into a new (version of
  870.             the) file."
  871.     ::= { acctngSelectionEntry 6 }
  872.  
  873.  
  874.  
  875.  
  876.  
  877.  
  878.  
  879.  
  880.  
  881. Expires May 1997                                               [Page 15]
  882.  
  883.  
  884.  
  885.  
  886.  
  887. Internet-Draft     Connection-Oriented Accounting MIB      November 1996
  888.  
  889.  
  890. -- The Accounting File table
  891.  
  892. acctngFileTable OBJECT-TYPE
  893.     SYNTAX      SEQUENCE OF AcctngFileEntry
  894.     MAX-ACCESS  not-accessible
  895.     STATUS      current
  896.     DESCRIPTION
  897.             "A list of files into which accounting information is to be
  898.             stored."
  899.     ::= { acctngFileControl 1 }
  900.  
  901. acctngFileEntry OBJECT-TYPE
  902.     SYNTAX      AcctngFileEntry
  903.     MAX-ACCESS  not-accessible
  904.     STATUS      current
  905.     DESCRIPTION
  906.             "An entry identifying a file into which accounting
  907.             information is to be collected."
  908.     INDEX   { acctngFileIndex }
  909.     ::= { acctngFileTable 1 }
  910.  
  911. AcctngFileEntry ::=
  912.     SEQUENCE {
  913.         acctngFileIndex                 FileIndex,
  914.         acctngFileName                  DisplayString,
  915.         acctngFileNameSuffix            DisplayString,
  916.         acctngFileDescription           DisplayString,
  917.         acctngFileCommand               INTEGER,
  918.         acctngFileMaximumSize           Integer32,
  919.         acctngFileCurrentSize           Integer32,
  920.         acctngFileFormat                INTEGER,
  921.         acctngFileCollectMode           BITS,
  922.         acctngFileCollectFailedAttempts BITS,
  923.         acctngFileInterval              Integer32,
  924.         acctngFileMinAge                Integer32,
  925.         acctngFileRowStatus             RowStatus
  926.     }
  927.  
  928. acctngFileIndex OBJECT-TYPE
  929.     SYNTAX      FileIndex
  930.     MAX-ACCESS  not-accessible
  931.     STATUS      current
  932.     DESCRIPTION
  933.             "A unique value identifying a file into which accounting
  934.             data is to be stored.  This value is required to be the
  935.  
  936.  
  937.  
  938.  
  939.  
  940. Expires May 1997                                               [Page 16]
  941.  
  942.  
  943.  
  944.  
  945.  
  946. Internet-Draft     Connection-Oriented Accounting MIB      November 1996
  947.  
  948.  
  949.             permanent 'handle' for an entry in this table for as long as
  950.             that entry exists, including across restarts and power
  951.             outages."
  952.     ::= { acctngFileEntry 1 }
  953.  
  954. acctngFileName OBJECT-TYPE
  955.     SYNTAX      DisplayString (SIZE(1..32))
  956.     MAX-ACCESS  read-create
  957.     STATUS      current
  958.     DESCRIPTION
  959.             "The name of the file into which accounting data is to be
  960.             stored.  If files are named using suffixes, then the name of
  961.             the current file is the concatenation of acctngFileName and
  962.             acctngFileNameSuffix.
  963.  
  964.             An agent will respond with an error (e.g., 'wrongValue') to
  965.             a management set operation which attempts to modify the
  966.             value of this object to the same value as already held by
  967.             another instance of acctngFileName.  An agent will also
  968.             respond with an error (e.g., 'wrongValue') if the new value
  969.             is invalid for use as a file name on the local file system
  970.             (e.g., many file systems do not support white space embedded
  971.             in file names).
  972.  
  973.             The value of this object can not be modified while the
  974.             corresponding instance of acctngFileRowStatus is 'active'."
  975.     ::= { acctngFileEntry 2 }
  976.  
  977. acctngFileNameSuffix OBJECT-TYPE
  978.     SYNTAX      DisplayString (SIZE(0..8))
  979.     MAX-ACCESS  read-only
  980.     STATUS      current
  981.     DESCRIPTION
  982.             "The suffix, if any, of the name of a file into which
  983.             accounting data is currently being stored.  If suffixes are
  984.             not used, then the value of this object is the zero-length
  985.             string.  Note that if a separator, such as a period, is used
  986.             in appending the suffix to the file name, then that
  987.             separator appears as the first character of this value."
  988.     ::= { acctngFileEntry 3 }
  989.  
  990. acctngFileDescription OBJECT-TYPE
  991.     SYNTAX      DisplayString
  992.     MAX-ACCESS  read-create
  993.     STATUS      current
  994.  
  995.  
  996.  
  997.  
  998.  
  999. Expires May 1997                                               [Page 17]
  1000.  
  1001.  
  1002.  
  1003.  
  1004.  
  1005. Internet-Draft     Connection-Oriented Accounting MIB      November 1996
  1006.  
  1007.  
  1008.     DESCRIPTION
  1009.             "The textual description of the accounting data which will
  1010.             be stored (on the next occasion) when header information is
  1011.             stored in the file.  The value of this object may be
  1012.             modified at any time."
  1013.     DEFVAL      { "" }
  1014.     ::= { acctngFileEntry 4 }
  1015.  
  1016. acctngFileCommand OBJECT-TYPE
  1017.     SYNTAX      INTEGER {
  1018.                     -- the following two values are states:
  1019.                     -- they may be read but not written
  1020.                     idle(1),
  1021.                     cmdInProgress(2),
  1022.                     -- the following two values are actions:
  1023.                     -- they may be written, but are never read
  1024.                     swapToNewFile(3),
  1025.                     collectNow(4)
  1026.                 }
  1027.     MAX-ACCESS  read-create
  1028.     STATUS      current
  1029.     DESCRIPTION
  1030.             "A control object for the collection of accounting data.
  1031.             When read the value is either 'idle' or 'cmdInProgress'.
  1032.             Writing a value is only allowed when the current value is
  1033.             'idle'.  When a value is successfully written, the value
  1034.             changes to 'cmdInProgress' until completion of the action,
  1035.             at which time the value reverts to 'idle'.  Actions are
  1036.             invoked by writing the following values:
  1037.  
  1038.                'swapToNewFile' - the collection of data into the current
  1039.                       file is terminated, and collection continues into
  1040.                       a new (version of the) file.
  1041.  
  1042.                'collectNow' - the agent creates and stores a connection
  1043.                       record into the current file for each active
  1044.                       connection having a type matching
  1045.                       acctngSelectionType and an age greater than
  1046.                       acctngFileMinAge."
  1047.     DEFVAL      { idle }
  1048.     ::= { acctngFileEntry 5 }
  1049.  
  1050. acctngFileMaximumSize OBJECT-TYPE
  1051.     SYNTAX      Integer32 (100..2147483647)
  1052.     UNITS       "bytes"
  1053.  
  1054.  
  1055.  
  1056.  
  1057.  
  1058. Expires May 1997                                               [Page 18]
  1059.  
  1060.  
  1061.  
  1062.  
  1063.  
  1064. Internet-Draft     Connection-Oriented Accounting MIB      November 1996
  1065.  
  1066.  
  1067.     MAX-ACCESS  read-create
  1068.     STATUS      current
  1069.     DESCRIPTION
  1070.             "The maximum size of the file (including header
  1071.             information).  When the file of collected data reaches this
  1072.             size, either the agent automatically swaps to a new version
  1073.             (i.e., a new value acctngFileNameSuffix) of the file, or new
  1074.             records are discarded.  Since a file must contain an
  1075.             integral number of connection records, the actual maximum
  1076.             size of the file may be just less OR Just greater than the
  1077.             value of this object.
  1078.  
  1079.             The value of this object can not be modified while the
  1080.             corresponding instance of acctngFileRowStatus is 'active'.
  1081.             The largest value of the maximum file size in some agents
  1082.             will be less than 2147483647 bytes."
  1083.     DEFVAL      { 5000000 }
  1084.     ::= { acctngFileEntry 6 }
  1085.  
  1086. acctngFileCurrentSize OBJECT-TYPE
  1087.     SYNTAX      Integer32 (0..2147483647)
  1088.     UNITS       "bytes"
  1089.     MAX-ACCESS  read-only
  1090.     STATUS      current
  1091.     DESCRIPTION
  1092.             "The current size of the file into which data is currently
  1093.             being collected, including header information."
  1094.     ::= { acctngFileEntry 7 }
  1095.  
  1096. acctngFileFormat OBJECT-TYPE
  1097.     SYNTAX      INTEGER { other(1), ber(2) }
  1098.     MAX-ACCESS  read-create
  1099.     STATUS      current
  1100.     DESCRIPTION
  1101.             "An indication of the format by which the accounting data is
  1102.             to stored in the file.  If the value is modified, the new
  1103.             value takes effect after the next 'swap' to a new file.  The
  1104.             value ber(2) indicates the standard format."
  1105.     DEFVAL      { ber }
  1106.     ::= { acctngFileEntry 8 }
  1107.  
  1108. acctngFileCollectMode OBJECT-TYPE
  1109.     SYNTAX      BITS { onRelease(0), periodically(1) }
  1110.     MAX-ACCESS  read-create
  1111.     STATUS      current
  1112.  
  1113.  
  1114.  
  1115.  
  1116.  
  1117. Expires May 1997                                               [Page 19]
  1118.  
  1119.  
  1120.  
  1121.  
  1122.  
  1123. Internet-Draft     Connection-Oriented Accounting MIB      November 1996
  1124.  
  1125.  
  1126.     DESCRIPTION
  1127.             "An indication of when accounting data is to be written into
  1128.             this file.  Note that in addition to the occasions indicated
  1129.             by the value of this object, an agent always writes
  1130.             information on appropriate connections to the file when the
  1131.             corresponding instance of acctngFileCommand is set to
  1132.             'collectNow'.
  1133.  
  1134.               - 'onRelease' - whenever a connection (or possibly,
  1135.                       connection attempt) is terminated, either through
  1136.                       a Release message or through management removal,
  1137.                       information on that connection is written.
  1138.  
  1139.               - 'periodically' - information on appropriate connections
  1140.                       is written on the expiry of a periodic timer,
  1141.  
  1142.             This value may be modified at any time."
  1143.     DEFVAL      { { onRelease } }
  1144.     ::= { acctngFileEntry 9 }
  1145.  
  1146. acctngFileCollectFailedAttempts OBJECT-TYPE
  1147.     SYNTAX      BITS { soft(0), regular(1) }
  1148.     MAX-ACCESS  read-create
  1149.     STATUS      current
  1150.     DESCRIPTION
  1151.             "An indication of whether connection data is to be collected
  1152.             for failed connection attempts when the value of the
  1153.             corresponding instance of acctngFileCollectMode includes
  1154.             'onRelease'.  The individual values have the following
  1155.             meaning:
  1156.  
  1157.               'soft' - indicates that connection data is to be collected
  1158.             for failed Soft PVCs/PVPs which originate or terminate at
  1159.             the relevant interface.
  1160.  
  1161.               'regular' - indicates that connection data is to be
  1162.             collected for failed SVCs, including Soft PVCs/PVPs not
  1163.             originating or terminating at the relevant interface.
  1164.  
  1165.             This value may be modified at any time."
  1166.     DEFVAL      { { soft, regular } }
  1167.     ::= { acctngFileEntry 10 }
  1168.  
  1169. acctngFileInterval OBJECT-TYPE
  1170.     SYNTAX      Integer32 (60..86400)
  1171.  
  1172.  
  1173.  
  1174.  
  1175.  
  1176. Expires May 1997                                               [Page 20]
  1177.  
  1178.  
  1179.  
  1180.  
  1181.  
  1182. Internet-Draft     Connection-Oriented Accounting MIB      November 1996
  1183.  
  1184.  
  1185.     UNITS       "seconds"
  1186.     MAX-ACCESS  read-create
  1187.     STATUS      current
  1188.     DESCRIPTION
  1189.             "The number of seconds between the periodic collections of
  1190.             accounting data when the value of the corresponding instance
  1191.             of acctngFileCollectMode includes 'periodically'.  Some
  1192.             agents may impose restrictions on the range of this
  1193.             interval.  This value may be modified at any time."
  1194.     DEFVAL     { 3600 }
  1195.     ::= { acctngFileEntry 11 }
  1196.  
  1197. acctngFileMinAge OBJECT-TYPE
  1198.     SYNTAX      Integer32 (60..86400)
  1199.     UNITS       "seconds"
  1200.     MAX-ACCESS  read-create
  1201.     STATUS      current
  1202.     DESCRIPTION
  1203.             "The minimum age of a connection, as used to determine the
  1204.             set of connections for which data is to be collected at the
  1205.             periodic intervals and/or when acctngFileCommand is set to
  1206.             'collectNow'.  The age of a connection is the elapsed time
  1207.             since it was last installed.
  1208.  
  1209.             When the periodic interval expires for a file or when
  1210.             acctngFileCommand is set to 'collectNow', accounting data is
  1211.             collected and stored in the file for each connection having
  1212.             a type matching acctngSelectionType and whose age at that
  1213.             time is greater than the value of acctngFileMinAge
  1214.             associated with the file.  This value may be modified at any
  1215.             time."
  1216.     DEFVAL     { 3600 }
  1217.     ::= { acctngFileEntry 12 }
  1218.  
  1219. acctngFileRowStatus OBJECT-TYPE
  1220.     SYNTAX      RowStatus
  1221.     MAX-ACCESS  read-create
  1222.     STATUS      current
  1223.     DESCRIPTION
  1224.             "The status of this conceptual row.
  1225.  
  1226.             This object can not be set to 'active' until a value has
  1227.             been assigned to the corresponding instance of
  1228.             acctngFileName.  Collection of data into the file does not
  1229.             begin until this object has the value 'active' and one or
  1230.  
  1231.  
  1232.  
  1233.  
  1234.  
  1235. Expires May 1997                                               [Page 21]
  1236.  
  1237.  
  1238.  
  1239.  
  1240.  
  1241. Internet-Draft     Connection-Oriented Accounting MIB      November 1996
  1242.  
  1243.  
  1244.             more (active) instances of acctngSelectionFile refer to it.
  1245.             If this value is modified once collection begins, collection
  1246.             into this file terminates and a new (or new version of the)
  1247.             file is immediately made ready for future collection (as if
  1248.             acctngFileCommand had been set to 'swapToNewFile'), but
  1249.             collection into the new (or new version of the) file does
  1250.             not begin until the value is subsequently set back to
  1251.             active."
  1252.     ::= { acctngFileEntry 13 }
  1253.  
  1254.  
  1255.  
  1256.  
  1257.  
  1258.  
  1259.  
  1260.  
  1261.  
  1262.  
  1263.  
  1264.  
  1265.  
  1266.  
  1267.  
  1268.  
  1269.  
  1270.  
  1271.  
  1272.  
  1273.  
  1274.  
  1275.  
  1276.  
  1277.  
  1278.  
  1279.  
  1280.  
  1281.  
  1282.  
  1283.  
  1284.  
  1285.  
  1286.  
  1287.  
  1288.  
  1289.  
  1290.  
  1291.  
  1292.  
  1293.  
  1294. Expires May 1997                                               [Page 22]
  1295.  
  1296.  
  1297.  
  1298.  
  1299.  
  1300. Internet-Draft     Connection-Oriented Accounting MIB      November 1996
  1301.  
  1302.  
  1303. -- Overall Control
  1304.  
  1305. acctngAdminStatus OBJECT-TYPE
  1306.     SYNTAX      INTEGER { enabled(1), disabled(2) }
  1307.     MAX-ACCESS  read-write
  1308.     STATUS      current
  1309.     DESCRIPTION
  1310.             "A control object to indicate the administratively desired
  1311.             state of the collection of accounting records across all
  1312.             interfaces.
  1313.  
  1314.             Modifying the value of acctngAdminStatus to 'disabled' does
  1315.             not remove or change the current configuration as
  1316.             represented by the active rows in the acctngSelectionTable,
  1317.             acctngFileTable and acctngInterfaceTable tables."
  1318.     ::= { acctngInterfaceControl 1 }
  1319.  
  1320. acctngOperStatus OBJECT-TYPE
  1321.     SYNTAX      INTEGER { enabled(1), disabled(2) }
  1322.     MAX-ACCESS  read-only
  1323.     STATUS      current
  1324.     DESCRIPTION
  1325.             "A status object to indicate the operational state of the
  1326.             collection of accounting records across all interfaces.
  1327.  
  1328.             When the value of acctngAdminStatus is modified to be
  1329.             'enabled', the value of this object will change to 'enabled'
  1330.             providing it is possible to begin collecting accounting
  1331.             records.
  1332.  
  1333.             When the value of acctngAdminStatus is modified to be
  1334.             'disabled', the value of this object will change to
  1335.             'disabled' as soon as the collection of accounting records
  1336.             has terminated."
  1337.     ::= { acctngInterfaceControl 2 }
  1338.  
  1339. acctngProtection OBJECT-TYPE
  1340.     SYNTAX      TestAndIncr
  1341.     MAX-ACCESS  read-write
  1342.     STATUS      current
  1343.     DESCRIPTION
  1344.             "A control object to protect against duplication of control
  1345.             commands.  Over some transport/network protocols, it is
  1346.             possible for SNMP messages to get duplicated.  Such
  1347.             duplication, if it occurred at just the wrong time could
  1348.  
  1349.  
  1350.  
  1351.  
  1352.  
  1353. Expires May 1997                                               [Page 23]
  1354.  
  1355.  
  1356.  
  1357.  
  1358.  
  1359. Internet-Draft     Connection-Oriented Accounting MIB      November 1996
  1360.  
  1361.  
  1362.             cause serious disruption to the collection and retrieval of
  1363.             accounting data, e.g., if a SNMP message setting
  1364.             acctngFileCommand to 'swapToNewFile' were to be duplicated,
  1365.             a whole file of accounting data could be lost.
  1366.  
  1367.             To protect against such duplication, a management
  1368.             application should retrieve the value of this object, and
  1369.             include in the Set operation needing protection, a variable
  1370.             binding which sets this object to the retrieved value."
  1371.     ::= { acctngInterfaceControl 3 }
  1372.  
  1373. acctngAgentMode OBJECT-TYPE
  1374.     SYNTAX      INTEGER { swapOnCommand(1), swapOnFull(2) }
  1375.     MAX-ACCESS  read-only
  1376.     STATUS      current
  1377.     DESCRIPTION
  1378.             "An indication of the behaviour mode of the agent when a
  1379.             file becomes full:
  1380.  
  1381.                'swapOnCommand' - the agent does not automatically swap
  1382.                       to a new file; rather, it discards newly collected
  1383.                       data until a management application subsequently
  1384.                       instructs it to swap to a new file.
  1385.  
  1386.                'swapOnFull' - the agent terminates collection into the
  1387.                       current file as and when that file becomes full."
  1388.     ::= { acctngInterfaceControl 4 }
  1389.  
  1390.  
  1391. --  Per-interface control table
  1392.  
  1393. acctngInterfaceTable OBJECT-TYPE
  1394.     SYNTAX      SEQUENCE OF AcctngInterfaceEntry
  1395.     MAX-ACCESS  not-accessible
  1396.     STATUS      current
  1397.     DESCRIPTION
  1398.             "A table controlling the collection of accounting data on
  1399.             specific interfaces of the switch."
  1400.     ::= { acctngInterfaceControl 5 }
  1401.  
  1402. acctngInterfaceEntry OBJECT-TYPE
  1403.     SYNTAX      AcctngInterfaceEntry
  1404.     MAX-ACCESS  not-accessible
  1405.     STATUS      current
  1406.     DESCRIPTION
  1407.  
  1408.  
  1409.  
  1410.  
  1411.  
  1412. Expires May 1997                                               [Page 24]
  1413.  
  1414.  
  1415.  
  1416.  
  1417.  
  1418. Internet-Draft     Connection-Oriented Accounting MIB      November 1996
  1419.  
  1420.  
  1421.             "An entry which controls whether accounting data is to be
  1422.             collected on an interface.  The types of interfaces which
  1423.             are represented in this table is implementation-specific."
  1424.     INDEX   { ifIndex }
  1425.     ::= { acctngInterfaceTable 1 }
  1426.  
  1427. AcctngInterfaceEntry ::=
  1428.     SEQUENCE {
  1429.         acctngInterfaceEnable     TruthValue
  1430.     }
  1431.  
  1432. acctngInterfaceEnable OBJECT-TYPE
  1433.     SYNTAX      TruthValue
  1434.     MAX-ACCESS  read-write
  1435.     STATUS      current
  1436.     DESCRIPTION
  1437.             "Indicates whether the collection of accounting data is
  1438.             enabled on this interface."
  1439.     ::= { acctngInterfaceEntry 1 }
  1440.  
  1441.  
  1442.  
  1443.  
  1444.  
  1445.  
  1446.  
  1447.  
  1448.  
  1449.  
  1450.  
  1451.  
  1452.  
  1453.  
  1454.  
  1455.  
  1456.  
  1457.  
  1458.  
  1459.  
  1460.  
  1461.  
  1462.  
  1463.  
  1464.  
  1465.  
  1466.  
  1467.  
  1468.  
  1469.  
  1470.  
  1471. Expires May 1997                                               [Page 25]
  1472.  
  1473.  
  1474.  
  1475.  
  1476.  
  1477. Internet-Draft     Connection-Oriented Accounting MIB      November 1996
  1478.  
  1479.  
  1480. -- Objects for controlling the use of Notifications
  1481.  
  1482. acctngControlTrapThreshold OBJECT-TYPE
  1483.     SYNTAX      INTEGER (0..99)
  1484.     MAX-ACCESS  read-write
  1485.     STATUS      current
  1486.     DESCRIPTION
  1487.             "A percentage of the maximum file size at which a 'nearly-
  1488.             full' trap is generated.  The value of 0 indicates that no
  1489.             'nearly-full' trap is to be generated."
  1490.     ::= { acctngTrapControl 1 }
  1491.  
  1492. acctngControlTrapEnable OBJECT-TYPE
  1493.     SYNTAX      TruthValue
  1494.     MAX-ACCESS  read-write
  1495.     STATUS      current
  1496.     DESCRIPTION
  1497.             "An indication of whether the acctngFileNearlyFull and
  1498.             acctngFileFull traps are enabled."
  1499.     ::= { acctngTrapControl 2 }
  1500.  
  1501.  
  1502.  
  1503.  
  1504.  
  1505.  
  1506.  
  1507.  
  1508.  
  1509.  
  1510.  
  1511.  
  1512.  
  1513.  
  1514.  
  1515.  
  1516.  
  1517.  
  1518.  
  1519.  
  1520.  
  1521.  
  1522.  
  1523.  
  1524.  
  1525.  
  1526.  
  1527.  
  1528.  
  1529.  
  1530. Expires May 1997                                               [Page 26]
  1531.  
  1532.  
  1533.  
  1534.  
  1535.  
  1536. Internet-Draft     Connection-Oriented Accounting MIB      November 1996
  1537.  
  1538.  
  1539. -- notifications
  1540.  
  1541. acctngNotifications OBJECT IDENTIFIER ::= { accountingControlMIB 3 }
  1542.  
  1543. acctngNotifyPrefix OBJECT IDENTIFIER ::= { acctngNotifications 0 }
  1544.  
  1545.  
  1546. acctngFileNearlyFull NOTIFICATION-TYPE
  1547.     OBJECTS     { acctngFileIndex,
  1548.                   acctngFileName,
  1549.                   acctngFileMaximumSize,
  1550.                   acctngControlTrapThreshold }
  1551.     STATUS      current
  1552.     DESCRIPTION
  1553.             "An indication that the size of the file into which
  1554.             accounting information is currently being collected has
  1555.             exceeded the threshold percentage of its maximum file size.
  1556.             This notification is generated only at the time of the
  1557.             transition from not-exceeding to exceeding."
  1558.     ::= { acctngNotifyPrefix 1 }
  1559.  
  1560.  
  1561. acctngFileFull NOTIFICATION-TYPE
  1562.     OBJECTS     { acctngFileIndex,
  1563.                   acctngFileName,
  1564.                   acctngFileMaximumSize }
  1565.     STATUS      current
  1566.     DESCRIPTION
  1567.             "An indication that the size of the file into which
  1568.             accounting information is currently being collected has
  1569.             transistioned to its maximum file size.  This notification
  1570.             is generated at the time of the transition from not-full to
  1571.             full, and periodically thereafter until such time as
  1572.             collection of data is no longer inhibited by the file full
  1573.             condition."
  1574.     ::= { acctngNotifyPrefix 2 }
  1575.  
  1576.  
  1577.  
  1578.  
  1579.  
  1580.  
  1581.  
  1582.  
  1583.  
  1584.  
  1585.  
  1586.  
  1587.  
  1588.  
  1589. Expires May 1997                                               [Page 27]
  1590.  
  1591.  
  1592.  
  1593.  
  1594.  
  1595. Internet-Draft     Connection-Oriented Accounting MIB      November 1996
  1596.  
  1597.  
  1598. -- conformance information
  1599.  
  1600. acctngConformance OBJECT IDENTIFIER ::= { accountingControlMIB 4 }
  1601. acctngGroups      OBJECT IDENTIFIER ::= { acctngConformance 1 }
  1602. acctngCompliances OBJECT IDENTIFIER ::= { acctngConformance 2 }
  1603.  
  1604. acctngCompliance MODULE-COMPLIANCE
  1605.     STATUS  current
  1606.     DESCRIPTION
  1607.             "The compliance statement for switches which implement the
  1608.             Accounting Control MIB."
  1609.  
  1610.     MODULE  -- this module
  1611.         MANDATORY-GROUPS { acctngBasicGroup,
  1612.                            acctngNotificationsGroup }
  1613.  
  1614.         OBJECT      acctngSelectionType
  1615.         SYNTAX      BITS { svcIncoming(0), svcOutgoing(1) }
  1616.         DESCRIPTION "The minimal requirement is collection for SVCs."
  1617.  
  1618.         OBJECT      acctngSelectionRowStatus
  1619.         MIN-ACCESS  read-only
  1620.         DESCRIPTION "Write access is not required."
  1621.  
  1622.         OBJECT      acctngFileName
  1623.         MIN-ACCESS  read-only
  1624.         DESCRIPTION "Write access is not required."
  1625.  
  1626.         OBJECT      acctngFileCommand
  1627.         MIN-ACCESS  read-only
  1628.         DESCRIPTION "Write access is not required."
  1629.  
  1630.         OBJECT      acctngFileFormat
  1631.         SYNTAX      INTEGER { ber(2) }
  1632.         MIN-ACCESS  read-only
  1633.         DESCRIPTION "Only the standard format is required, and write
  1634.                     access is not required."
  1635.  
  1636.         OBJECT      acctngFileMaximumSize
  1637.         MIN-ACCESS  read-only
  1638.         DESCRIPTION "Write access is not required."
  1639.  
  1640.         OBJECT      acctngFileCollectMode
  1641.         SYNTAX      BITS { onRelease(0) }
  1642.         MIN-ACCESS  read-only
  1643.  
  1644.  
  1645.  
  1646.  
  1647.  
  1648. Expires May 1997                                               [Page 28]
  1649.  
  1650.  
  1651.  
  1652.  
  1653.  
  1654. Internet-Draft     Connection-Oriented Accounting MIB      November 1996
  1655.  
  1656.  
  1657.         DESCRIPTION "The minimal requirement is for collection on
  1658.                     connection release."
  1659.  
  1660.         OBJECT      acctngFileInterval
  1661.         MIN-ACCESS  read-only
  1662.         DESCRIPTION "Write access is not required."
  1663.  
  1664.         OBJECT      acctngFileCollectFailedAttempts
  1665.         MIN-ACCESS  read-only
  1666.         DESCRIPTION "Write access is not required."
  1667.  
  1668.         OBJECT      acctngFileRowStatus
  1669.         MIN-ACCESS  read-only
  1670.         DESCRIPTION "Write access is not required."
  1671.  
  1672.     ::= { acctngCompliances 1 }
  1673.  
  1674.  
  1675.  
  1676.  
  1677.  
  1678.  
  1679.  
  1680.  
  1681.  
  1682.  
  1683.  
  1684.  
  1685.  
  1686.  
  1687.  
  1688.  
  1689.  
  1690.  
  1691.  
  1692.  
  1693.  
  1694.  
  1695.  
  1696.  
  1697.  
  1698.  
  1699.  
  1700.  
  1701.  
  1702.  
  1703.  
  1704.  
  1705.  
  1706.  
  1707. Expires May 1997                                               [Page 29]
  1708.  
  1709.  
  1710.  
  1711.  
  1712.  
  1713. Internet-Draft     Connection-Oriented Accounting MIB      November 1996
  1714.  
  1715.  
  1716. -- units of conformance
  1717.  
  1718. acctngBasicGroup    OBJECT-GROUP
  1719.     OBJECTS { acctngSelectionSubtree, acctngSelectionList,
  1720.               acctngSelectionFile, acctngSelectionType,
  1721.               acctngSelectionRowStatus, acctngFileName,
  1722.               acctngFileNameSuffix, acctngFileDescription,
  1723.               acctngFileCommand, acctngFileMaximumSize,
  1724.               acctngFileCurrentSize, acctngFileRowStatus,
  1725.               acctngFileFormat, acctngFileCollectMode,
  1726.               acctngFileCollectFailedAttempts, acctngFileInterval,
  1727.               acctngFileMinAge,
  1728.               acctngAdminStatus, acctngOperStatus,
  1729.               acctngProtection, acctngAgentMode,
  1730.               acctngInterfaceEnable,
  1731.               acctngControlTrapThreshold,
  1732.               acctngControlTrapEnable
  1733.             }
  1734.     STATUS  current
  1735.     DESCRIPTION
  1736.             "A collection of objects providing control of the basic
  1737.             collection of accounting data for connection-oriented
  1738.             networks."
  1739.     ::= { acctngGroups 1 }
  1740.  
  1741. acctngNotificationsGroup NOTIFICATIONS-GROUP
  1742.     OBJECTS { acctngFileNearlyFull,
  1743.               acctngFileFull
  1744.             }
  1745.     STATUS  current
  1746.     DESCRIPTION
  1747.             "The notifications of events relating to controlling the
  1748.             collection of accounting data."
  1749.     ::= { acctngGroups 2 }
  1750.  
  1751. END
  1752.  
  1753.  
  1754.  
  1755.  
  1756.  
  1757.  
  1758.  
  1759.  
  1760.  
  1761.  
  1762.  
  1763.  
  1764.  
  1765.  
  1766. Expires May 1997                                               [Page 30]
  1767.  
  1768.  
  1769.  
  1770.  
  1771.  
  1772. Internet-Draft     Connection-Oriented Accounting MIB      November 1996
  1773.  
  1774.  
  1775. 5.  Acknowledgements
  1776.  
  1777. The comments of the IETF's AToM MIB Working Group are acknowledged.
  1778.  
  1779.  
  1780. 6.  References
  1781.  
  1782. [1]  SNMPv2 Working Group, Case, J., McCloghrie, K., Rose, M., and
  1783.      S. Waldbusser, "Structure of Management Information for version 2
  1784.      of the Simple Network Management Protocol (SNMPv2)", RFC 1902,
  1785.      January 1996.
  1786.  
  1787. [2]  McCloghrie, K., and M. Rose, Editors, "Management Information Base
  1788.      for Network Management of TCP/IP-based internets: MIB-II", STD 17,
  1789.      RFC 1213, March 1991.
  1790.  
  1791. [3]  Case, J., Fedor, M., Schoffstall, M., and J. Davin, "Simple Network
  1792.      Management Protocol", RFC 1157, May 1990.
  1793.  
  1794. [4]  SNMPv2 Working Group, Case, J., McCloghrie, K., Rose, M., and
  1795.      S. Waldbusser, "Protocol Operations for version 2 of the Simple
  1796.      Network Management Protocol (SNMPv2)", RFC 1905, January 1996.
  1797.  
  1798. [5]  SNMPv2 Working Group, Case, J., McCloghrie, K., Rose, M., and
  1799.      S. Waldbusser, "Transport Mappings for version 2 of the Simple
  1800.      Network Management Protocol (SNMPv2)", RFC 1906, January 1996.
  1801.  
  1802. [6]  SNMPv2 Working Group, Case, J., McCloghrie, K., Rose, M., and
  1803.      S. Waldbusser, "Management Information Base for version 2 of the
  1804.      Simple Network Management Protocol (SNMPv2)", RFC 1907, January
  1805.      1996.
  1806.  
  1807. [7]  Information processing systems - Open Systems Interconnection,
  1808.      "Specification of Abstract Syntax Notation One (ASN.1)",
  1809.      International Organization for Standardization, Internation
  1810.      Standard 8824, December 1987.
  1811.  
  1812. [8]  Information processing systems - Open Systems Interconnection,
  1813.      "Specification of Basic Encoding Rules for Abstract Syntax Notation
  1814.      One (ASN.1)", International Organization for Standardization,
  1815.      Internation Standard 8825, December 1987.
  1816.  
  1817. [9]  McCloghrie, K., Heinanen, J., Greene, W., and A. Prasad,
  1818.      "Accounting Information for ATM Networks", Internet Draft, November
  1819.      1996.
  1820.  
  1821.  
  1822.  
  1823.  
  1824.  
  1825. Expires May 1997                                               [Page 31]
  1826.  
  1827.  
  1828.  
  1829.  
  1830.  
  1831. Internet-Draft     Connection-Oriented Accounting MIB      November 1996
  1832.  
  1833.  
  1834. 7.  Security Considerations
  1835.  
  1836. Security issues are not discussed in this memo.
  1837.  
  1838.  
  1839. 8.  Authors' Addresses
  1840.  
  1841.      Keith McCloghrie
  1842.      Cisco Systems, Inc.
  1843.      170 West Tasman Drive,
  1844.      San Jose CA 95134-1706.
  1845.      Phone: +1 408 526 5260
  1846.      Email: kzm@cisco.com
  1847.  
  1848.      Juha Heinanen
  1849.      Telecom Finland Inc.
  1850.      PO Box 228
  1851.      SF-33101 Tampere
  1852.      Finland
  1853.      Phone: +358 49 500 958
  1854.      EMail: jh@lohi.dat.tele.fi
  1855.  
  1856.      Wedge Greene
  1857.      MCI Telecommunications Corporation
  1858.      901 International Parkway
  1859.      Richardson, Texas 75081
  1860.      Phone: 214-498-1232
  1861.      Email: wedgeg@mcimail.com
  1862.  
  1863.      Anil Prasad
  1864.      Cisco Systems, Inc.
  1865.      1400 Parkmoor Avenue
  1866.      San Jose, CA 95126
  1867.      Phone: 408-882-7209
  1868.      E-mail: aprasad@strata.com
  1869.  
  1870.  
  1871.  
  1872.  
  1873.  
  1874.  
  1875.  
  1876.  
  1877.  
  1878.  
  1879.  
  1880.  
  1881.  
  1882.  
  1883.  
  1884. Expires May 1997                                               [Page 32]
  1885.  
  1886.  
  1887.  
  1888.  
  1889.  
  1890. Internet-Draft     Connection-Oriented Accounting MIB      November 1996
  1891.  
  1892.  
  1893. Table of Contents
  1894.  
  1895.  
  1896. 1 Introduction ....................................................    2
  1897. 2 The SNMP Network Management Framework ...........................    2
  1898. 2.1 Object Definitions ............................................    2
  1899. 3 Overview ........................................................    3
  1900. 3.1 Operational Model .............................................    3
  1901. 3.2 Selection of Accounting Data ..................................    5
  1902. 3.3 Format of Collection File .....................................    6
  1903. 4 Definitions .....................................................   10
  1904. 5 Acknowledgements ................................................   31
  1905. 6 References ......................................................   31
  1906. 7 Security Considerations .........................................   32
  1907. 8 Authors' Addresses ..............................................   32
  1908.  
  1909.  
  1910.  
  1911.  
  1912.  
  1913.  
  1914.  
  1915.  
  1916.  
  1917.  
  1918.  
  1919.  
  1920.  
  1921.  
  1922.  
  1923.  
  1924.  
  1925.  
  1926.  
  1927.  
  1928.  
  1929.  
  1930.  
  1931.  
  1932.  
  1933.  
  1934.  
  1935.  
  1936.  
  1937.  
  1938.  
  1939.  
  1940.  
  1941.  
  1942.  
  1943. Expires May 1997                                               [Page 33]
  1944.