ACCOUNTING-CONTROL-MIB

File: ACCOUNTING-CONTROL-MIB.mib (31364 bytes)

Imported modules

SNMPv2-SMI SNMPv2-TC SNMPv2-CONF
CISCO-SMI IF-MIB

Imported symbols

MODULE-IDENTITY OBJECT-TYPE NOTIFICATION-TYPE
Integer32 TEXTUAL-CONVENTION RowStatus
TestAndIncr DisplayString TruthValue
MODULE-COMPLIANCE OBJECT-GROUP ciscoExperiment
ifIndex

Defined Types

DataCollectionSubtree  
The subtree component of a (subtree, list) tuple. Such a (subtree, list) tuple defines a set of objects and their values to be collected as accounting data for a connection. The subtree specifies a single OBJECT IDENTIFIER value such that each object in the set is named by the subtree value appended with a single additional sub-identifier.
TEXTUAL-CONVENTION    
  OBJECT IDENTIFIER  

DataCollectionList  
The list component of a (subtree, list) tuple. Such a (subtree, list) tuple defines a set of objects and their values to be collected as accounting data for a connection. The subtree specifies a single OBJECT IDENTIFIER value such that each object in the set is named by the subtree value appended with a single additional sub-identifier. The list specifies a set of data items, where the presence of an item in the list indicates that the item is (to be) present in the data collected for a connection; the absence of an item from the list indicates that the item is not (to be) present in the data collected for a connection. Each data item is represented by an integer which when appended (as as additional sub-identifier) to the OBJECT IDENTIFIER value of the subtree identified by the tuple, is the name of an object defining that data item (its description and its syntax). The list is specified as an OCTET STRING in which each data item is represented by a single bit, where data items 1 through 8 are represented by the bits in the first octet, data items 9 through 16 by the bits in the second octet, etc. In each octet, the lowest numbered data item is represented by the most significant bit, and the highest numbered data item by the least significant bit. A data item is present in the list when its bit is set, and absent when its bit is reset. If the length of an OCTET STRING value is too short to represent one or more data items defined in a subtree, then those data items are absent from the set identified by the tuple of that subtree and that OCTET STRING value.
TEXTUAL-CONVENTION    
  OCTET STRING Size(0..8)  

FileIndex  
An arbitrary integer value identifying a file into which accounting data is being collected.
TEXTUAL-CONVENTION    
  Integer32 1..65535  

AcctngSelectionEntry  
SEQUENCE    
  acctngSelectionIndex Integer32
  acctngSelectionSubtree DataCollectionSubtree
  acctngSelectionList DataCollectionList
  acctngSelectionFile FileIndex
  acctngSelectionType OCTET STRING Size(16)
  acctngSelectionRowStatus RowStatus

AcctngFileEntry  
SEQUENCE    
  acctngFileIndex FileIndex
  acctngFileName DisplayString
  acctngFileNameSuffix DisplayString
  acctngFileDescription DisplayString
  acctngFileCommand INTEGER
  acctngFileMaximumSize Integer32
  acctngFileCurrentSize Integer32
  acctngFileFormat INTEGER
  acctngFileCollectMode OCTET STRING Size(16)
  acctngFileCollectFailedAttempts OCTET STRING Size(16)
  acctngFileInterval Integer32
  acctngFileMinAge Integer32
  acctngFileRowStatus RowStatus

AcctngInterfaceEntry  
SEQUENCE    
  acctngInterfaceEnable TruthValue

Defined Values

accountingControlMIB 1.3.6.1.4.1.9.10.17
The MIB module for managing the collection and storage of accounting information for connections in a connection- oriented network such as ATM.
MODULE-IDENTITY    

acctngMIBObjects 1.3.6.1.4.1.9.10.17.1
OBJECT IDENTIFIER    

acctngSelectionControl 1.3.6.1.4.1.9.10.17.1.1
OBJECT IDENTIFIER    

acctngFileControl 1.3.6.1.4.1.9.10.17.1.2
OBJECT IDENTIFIER    

acctngInterfaceControl 1.3.6.1.4.1.9.10.17.1.3
OBJECT IDENTIFIER    

acctngTrapControl 1.3.6.1.4.1.9.10.17.1.4
OBJECT IDENTIFIER    

acctngSelectionTable 1.3.6.1.4.1.9.10.17.1.1.1
A list of accounting information selection entries. Note that additions, modifications and deletions of entries in this table can occur at any time, but such changes only take effect on the next occasion when collection begins into a new file. Thus, between modification and the next 'swap', the content of this table does not reflect the current selection.
Status: current Access: not-accessible
OBJECT-TYPE    
  SEQUENCE OF  
    AcctngSelectionEntry

acctngSelectionEntry 1.3.6.1.4.1.9.10.17.1.1.1.1
An entry identifying an (subtree, list) tuple used to select a set of accounting information which is to be collected.
Status: current Access: not-accessible
OBJECT-TYPE    
  AcctngSelectionEntry  

acctngSelectionIndex 1.3.6.1.4.1.9.10.17.1.1.1.1.1
An arbitrary integer value which uniquely identifies a tuple stored in this table. This value is required to be the permanent 'handle' for an entry in this table for as long as that entry exists, including across restarts and power outages.
Status: current Access: not-accessible
OBJECT-TYPE    
  Integer32 1..65535  

acctngSelectionSubtree 1.3.6.1.4.1.9.10.17.1.1.1.1.2
The combination of acctngSelectionSubtree and acctngSelectionList specifies one (subtree, list) tuple which is to be collected.
Status: current Access: read-create
OBJECT-TYPE    
  DataCollectionSubtree  

acctngSelectionList 1.3.6.1.4.1.9.10.17.1.1.1.1.3
The combination of acctngSelectionSubtree and acctngSelectionList specifies one (subtree, list) tuple which is to be collected.
Status: current Access: read-create
OBJECT-TYPE    
  DataCollectionList  

acctngSelectionFile 1.3.6.1.4.1.9.10.17.1.1.1.1.4
An indication of the file into which the accounting information identified by this entry is to be stored. If there is no conceptual row in the acctngFileTable for which the value of acctngFileIndex has the same value as this object, then the information selected by this entry is not collected.
Status: current Access: read-create
OBJECT-TYPE    
  FileIndex  

acctngSelectionType 1.3.6.1.4.1.9.10.17.1.1.1.1.5
Indicates the types of connections for which the information selected by this entry are to be collected.
Status: current Access: read-create
OBJECT-TYPE    
  OCTET STRING Size(16)  

acctngSelectionRowStatus 1.3.6.1.4.1.9.10.17.1.1.1.1.6
The status of this conceptual row. An agent may refuse to create new conceptual rows and/or modify existing conceptual rows, if such creation/modification would cause multiple rows to have the same values of acctngSelectionSubtree and acctngSelectionList. A conceptual row can not have the status of 'active' until values have been assigned to the acctngSelectionSubtree, acctngSelectionList and acctngSelectionFile columnar objects within that row. An agent must not refuse to change the values of the acctngSelectionSubtree, acctngSelectionList and acctngSelectionFile columnar objects within a conceptual row even while that row's status is 'active'. Similarly, an agent must not refuse to destroy an existing conceptual row while the file referenced by that row's instance of acctngSelectionFile is in active use, i.e., while the corresponding instance of acctngFileRowStatus has the value 'active'. However, such changes only take effect upon the next occasion when collection begins into a new (version of the) file.
Status: current Access: read-create
OBJECT-TYPE    
  RowStatus  

acctngFileTable 1.3.6.1.4.1.9.10.17.1.2.1
A list of files into which accounting information is to be stored.
Status: current Access: not-accessible
OBJECT-TYPE    
  SEQUENCE OF  
    AcctngFileEntry

acctngFileEntry 1.3.6.1.4.1.9.10.17.1.2.1.1
An entry identifying a file into which accounting information is to be collected.
Status: current Access: not-accessible
OBJECT-TYPE    
  AcctngFileEntry  

acctngFileIndex 1.3.6.1.4.1.9.10.17.1.2.1.1.1
A unique value identifying a file into which accounting data is to be stored. This value is required to be the permanent 'handle' for an entry in this table for as long as that entry exists, including across restarts and power outages.
Status: current Access: not-accessible
OBJECT-TYPE    
  FileIndex  

acctngFileName 1.3.6.1.4.1.9.10.17.1.2.1.1.2
The name of the file into which accounting data is to be stored. If files are named using suffixes, then the name of the current file is the concatenation of acctngFileName and acctngFileNameSuffix. An agent will respond with an error (e.g., 'wrongValue') to a management set operation which attempts to modify the value of this object to the same value as already held by another instance of acctngFileName. An agent will also respond with an error (e.g., 'wrongValue') if the new value is invalid for use as a file name on the local file system (e.g., many file systems do not support white space embedded in file names). The value of this object can not be modified while the corresponding instance of acctngFileRowStatus is 'active'.
Status: current Access: read-create
OBJECT-TYPE    
  DisplayString Size(1..32)  

acctngFileNameSuffix 1.3.6.1.4.1.9.10.17.1.2.1.1.3
The suffix, if any, of the name of a file into which accounting data is currently being stored. If suffixes are not used, then the value of this object is the zero-length string. Note that if a separator, such as a period, is used in appending the suffix to the file name, then that separator appears as the first character of this value.
Status: current Access: read-only
OBJECT-TYPE    
  DisplayString Size(0..8)  

acctngFileDescription 1.3.6.1.4.1.9.10.17.1.2.1.1.4
The textual description of the accounting data which will be stored (on the next occasion) when header information is stored in the file. The value of this object may be modified at any time.
Status: current Access: read-create
OBJECT-TYPE    
  DisplayString  

acctngFileCommand 1.3.6.1.4.1.9.10.17.1.2.1.1.5
A control object for the collection of accounting data. When read the value is either 'idle' or 'cmdInProgress'. Writing a value is only allowed when the current value is 'idle'. When a value is successfully written, the value changes to 'cmdInProgress' until completion of the action, at which time the value reverts to 'idle'. Actions are invoked by writing the following values: 'swapToNewFile' - the collection of data into the current file is terminated, and collection continues into a new (version of the) file. 'collectNow' - the agent creates and stores a connection record into the current file for each active connection having a type matching acctngSelectionType and an age greater than acctngFileMinAge.
Status: current Access: read-create
OBJECT-TYPE    
  INTEGER idle(1), cmdInProgress(2), swapToNewFile(3), collectNow(4)  

acctngFileMaximumSize 1.3.6.1.4.1.9.10.17.1.2.1.1.6
The maximum size of the file (including header information). When the file of collected data reaches this size, either the agent automatically swaps to a new version (i.e., a new value acctngFileNameSuffix) of the file, or new records are discarded. Since a file must contain an integral number of connection records, the actual maximum size of the file may be just less OR Just greater than the value of this object. The value of this object can not be modified while the corresponding instance of acctngFileRowStatus is 'active'. The largest value of the maximum file size in some agents will be less than 2147483647 bytes.
Status: current Access: read-create
OBJECT-TYPE    
  Integer32 100..2147483647  

acctngFileCurrentSize 1.3.6.1.4.1.9.10.17.1.2.1.1.7
The current size of the file into which data is currently being collected, including header information.
Status: current Access: read-only
OBJECT-TYPE    
  Integer32 0..2147483647  

acctngFileFormat 1.3.6.1.4.1.9.10.17.1.2.1.1.8
An indication of the format by which the accounting data is to stored in the file. If the value is modified, the new value takes effect after the next 'swap' to a new file. The value ber(2) indicates the standard format.
Status: current Access: read-create
OBJECT-TYPE    
  INTEGER other(1), ber(2)  

acctngFileCollectMode 1.3.6.1.4.1.9.10.17.1.2.1.1.9
An indication of when accounting data is to be written into this file. Note that in addition to the occasions indicated by the value of this object, an agent always writes information on appropriate connections to the file when the corresponding instance of acctngFileCommand is set to 'collectNow'. - 'onRelease' - whenever a connection (or possibly, connection attempt) is terminated, either through a Release message or through management removal, information on that connection is written. - 'periodically' - information on appropriate connections is written on the expiry of a periodic timer, This value may be modified at any time.
Status: current Access: read-create
OBJECT-TYPE    
  OCTET STRING Size(16)  

acctngFileCollectFailedAttempts 1.3.6.1.4.1.9.10.17.1.2.1.1.10
An indication of whether connection data is to be collected for failed connection attempts when the value of the corresponding instance of acctngFileCollectMode includes 'onRelease'. The individual values have the following meaning: 'soft' - indicates that connection data is to be collected for failed Soft PVCs/PVPs which originate or terminate at the relevant interface. 'regular' - indicates that connection data is to be collected for failed SVCs, including Soft PVCs/PVPs not originating or terminating at the relevant interface. This value may be modified at any time.
Status: current Access: read-create
OBJECT-TYPE    
  OCTET STRING Size(16)  

acctngFileInterval 1.3.6.1.4.1.9.10.17.1.2.1.1.11
The number of seconds between the periodic collections of accounting data when the value of the corresponding instance of acctngFileCollectMode includes 'periodically'. Some agents may impose restrictions on the range of this interval. This value may be modified at any time.
Status: current Access: read-create
OBJECT-TYPE    
  Integer32 60..86400  

acctngFileMinAge 1.3.6.1.4.1.9.10.17.1.2.1.1.12
The minimum age of a connection, as used to determine the set of connections for which data is to be collected at the periodic intervals and/or when acctngFileCommand is set to 'collectNow'. The age of a connection is the elapsed time since it was last installed. When the periodic interval expires for a file or when acctngFileCommand is set to 'collectNow', accounting data is collected and stored in the file for each connection having a type matching acctngSelectionType and whose age at that time is greater than the value of acctngFileMinAge associated with the file. This value may be modified at any time.
Status: current Access: read-create
OBJECT-TYPE    
  Integer32 60..86400  

acctngFileRowStatus 1.3.6.1.4.1.9.10.17.1.2.1.1.13
The status of this conceptual row. This object can not be set to 'active' until a value has been assigned to the corresponding instance of acctngFileName. Collection of data into the file does not begin until this object has the value 'active' and one or more (active) instances of acctngSelectionFile refer to it. If this value is modified once collection begins, collection into this file terminates and a new (or new version of the) file is immediately made ready for future collection (as if acctngFileCommand had been set to 'swapToNewFile'), but collection into the new (or new version of the) file does not begin until the value is subsequently set back to active.
Status: current Access: read-create
OBJECT-TYPE    
  RowStatus  

acctngAdminStatus 1.3.6.1.4.1.9.10.17.1.3.1
A control object to indicate the administratively desired state of the collection of accounting records across all interfaces. Modifying the value of acctngAdminStatus to 'disabled' does not remove or change the current configuration as represented by the active rows in the acctngSelectionTable, acctngFileTable and acctngInterfaceTable tables.
Status: current Access: read-write
OBJECT-TYPE    
  INTEGER enabled(1), disabled(2)  

acctngOperStatus 1.3.6.1.4.1.9.10.17.1.3.2
A status object to indicate the operational state of the collection of accounting records across all interfaces. When the value of acctngAdminStatus is modified to be 'enabled', the value of this object will change to 'enabled' providing it is possible to begin collecting accounting records. When the value of acctngAdminStatus is modified to be 'disabled', the value of this object will change to 'disabled' as soon as the collection of accounting records has terminated.
Status: current Access: read-only
OBJECT-TYPE    
  INTEGER enabled(1), disabled(2)  

acctngProtection 1.3.6.1.4.1.9.10.17.1.3.3
A control object to protect against duplication of control commands. Over some transport/network protocols, it is possible for SNMP messages to get duplicated. Such duplication, if it occurred at just the wrong time could cause serious disruption to the collection and retrieval of accounting data, e.g., if a SNMP message setting acctngFileCommand to 'swapToNewFile' were to be duplicated, a whole file of accounting data could be lost. To protect against such duplication, a management application should retrieve the value of this object, and include in the Set operation needing protection, a variable binding which sets this object to the retrieved value.
Status: current Access: read-write
OBJECT-TYPE    
  TestAndIncr  

acctngAgentMode 1.3.6.1.4.1.9.10.17.1.3.4
An indication of the behaviour mode of the agent when a file becomes full: 'swapOnCommand' - the agent does not automatically swap to a new file; rather, it discards newly collected data until a management application subsequently instructs it to swap to a new file. 'swapOnFull' - the agent terminates collection into the current file as and when that file becomes full.
Status: current Access: read-only
OBJECT-TYPE    
  INTEGER swapOnCommand(1), swapOnFull(2)  

acctngInterfaceTable 1.3.6.1.4.1.9.10.17.1.3.5
A table controlling the collection of accounting data on specific interfaces of the switch.
Status: current Access: not-accessible
OBJECT-TYPE    
  SEQUENCE OF  
    AcctngInterfaceEntry

acctngInterfaceEntry 1.3.6.1.4.1.9.10.17.1.3.5.1
An entry which controls whether accounting data is to be collected on an interface. The types of interfaces which are represented in this table is implementation-specific.
Status: current Access: not-accessible
OBJECT-TYPE    
  AcctngInterfaceEntry  

acctngInterfaceEnable 1.3.6.1.4.1.9.10.17.1.3.5.1.1
Indicates whether the collection of accounting data is enabled on this interface.
Status: current Access: read-write
OBJECT-TYPE    
  TruthValue  

acctngControlTrapThreshold 1.3.6.1.4.1.9.10.17.1.4.1
A percentage of the maximum file size at which a 'nearly- full' trap is generated. The value of 0 indicates that no 'nearly-full' trap is to be generated.
Status: current Access: read-write
OBJECT-TYPE    
  INTEGER 0..99  

acctngControlTrapEnable 1.3.6.1.4.1.9.10.17.1.4.2
An indication of whether the acctngFileNearlyFull and acctngFileFull traps are enabled.
Status: current Access: read-write
OBJECT-TYPE    
  TruthValue  

acctngNotifications 1.3.6.1.4.1.9.10.17.3
OBJECT IDENTIFIER    

acctngNotifyPrefix 1.3.6.1.4.1.9.10.17.3.0
OBJECT IDENTIFIER    

acctngFileNearlyFull 1.3.6.1.4.1.9.10.17.3.0.1
An indication that the size of the file into which accounting information is currently being collected has exceeded the threshold percentage of its maximum file size. This notification is generated only at the time of the transition from not-exceeding to exceeding.
Status: current Access: read-write
NOTIFICATION-TYPE    

acctngFileFull 1.3.6.1.4.1.9.10.17.3.0.2
An indication that the size of the file into which accounting information is currently being collected has transistioned to its maximum file size. This notification is generated at the time of the transition from not-full to full, and periodically thereafter until such time as collection of data is no longer inhibited by the file full condition.
Status: current Access: read-write
NOTIFICATION-TYPE    

acctngConformance 1.3.6.1.4.1.9.10.17.4
OBJECT IDENTIFIER    

acctngGroups 1.3.6.1.4.1.9.10.17.4.1
OBJECT IDENTIFIER    

acctngCompliances 1.3.6.1.4.1.9.10.17.4.2
OBJECT IDENTIFIER    

acctngCompliance 1.3.6.1.4.1.9.10.17.4.2.1
The compliance statement for switches which implement the Accounting Control MIB.
Status: current Access: read-only
MODULE-COMPLIANCE    

acctngBasicGroup 1.3.6.1.4.1.9.10.17.4.1.1
A collection of objects providing control of the basic collection of accounting data for connection-oriented networks.
Status: current Access: read-only
OBJECT-GROUP