CISCO-DATA-COLLECTION-MIB Table View

Table-centric layout grouping table, row, and column objects.

Tables
6
Rows
6
Columns
53
.1.3.6.1.4.1.9.9.312.1.1.3 · 1 row entry · 15 columns
A table for setting up VFiles for collecting data.
cdcVFileEntry entry .1.3.6.1.4.1.9.9.312.1.1.3.1
An entry in the cdcVFileTable. Each entry contains
application specified configuration that is used to create
virtual files (VFile) and start data collection operations.

A VFile is used to store data (val…
Indexes
cdcVFileIndex
Column Syntax OID
cdcVFileIndex
An arbitrary integer for uniquely identifying this
entry. When creating a row, the application should pick a
random number.

If the configuration in this entry is persisted across
system/agent restarts th…
Unsigned32
Constraints:
range: 1-4294967295
.1.3.6.1.4.1.9.9.312.1.1.3.1.1
cdcVFileName
The base-name of the VFiles (created by data collection
operations corresponding to this entry) into which data is to
be collected.

When a VFile is created, it's full name is obtained by the
concatentati…
OctetStringr/w
Constraints:
range: 0-255
.1.3.6.1.4.1.9.9.312.1.1.3.1.2
cdcVFileDescription
A string that can be used for administrative purposes.
This object's value may be modified at any time.
SNMP-FRAMEWORK-MIBSnmpAdminStringr/w
Textual Convention: SNMP-FRAMEWORK-MIBSnmpAdminString OctetString
Type Constraints:
range: 0..255
.1.3.6.1.4.1.9.9.312.1.1.3.1.3
cdcVFileCommand
An object for controlling collection of data.

'idle' Indicates that no command is in progress.

'swapToNewFile' When written, the current VFile is frozen,
and …
Enumerationr/w
Enumerated Values:
1idle
2swapToNewFile
3collectNow
.1.3.6.1.4.1.9.9.312.1.1.3.1.4
cdcVFileMaxSize
The maximum size of a VFile.

The agent maintains an internal counter for each
cdcVFileEntry. This counter counts the number of consecutive
times the size of a VFile has exceeded the value of this
object.…
bytesUnsigned32r/w
Constraints:
range: 512-4294967295
.1.3.6.1.4.1.9.9.312.1.1.3.1.5
cdcVFileCurrentSize
The size of the current VFile.
bytesUnsigned32
Constraints:
range: 0-4294967295
.1.3.6.1.4.1.9.9.312.1.1.3.1.6
cdcVFileFormat
The format in which data is stored into the current VFile.

This object's value cannot be modified while the entry
is in the 'activated' state.
CdcFileFormatr/w
Textual Convention: CdcFileFormat Enumeration
Type Values:
1cdcBulkASCII
2cdcBulkBinary
3cdcSchemaASCII
.1.3.6.1.4.1.9.9.312.1.1.3.1.7
cdcVFileCollectMode
Determines the mode of data collection.

'auto' Data is periodically fetched for all data
groups associated with this entry. This is
done at data group specific period…
Enumerationr/w
Enumerated Values:
1auto
2manual
.1.3.6.1.4.1.9.9.312.1.1.3.1.8
cdcVFileCollectionPeriod
Specifies the period of a collection interval. The value
of this object is used only when the data collection mode is
automatic (see cdcVFileCollectMode).

A periodic timer (one per entry) is started when…
secondsUnsigned32r/w
Constraints:
range: 60-604800
.1.3.6.1.4.1.9.9.312.1.1.3.1.9
cdcVFileRetentionPeriod
The time for which a frozen VFile is retained by the
agent. When a VFile is frozen, a timer (one per frozen VFile)
is started to keep track of the retention period for the
VFile. Once this timer expires, the VFile is d…
secondsUnsigned32r/w
Constraints:
range: 60-86400
.1.3.6.1.4.1.9.9.312.1.1.3.1.10
cdcVFileAdminStatus
A control object to indicate the administratively desired
state of data collection for this entry. On setting the value
to 'disabled' data collection operations for this
entry are stopped, the current VFile is frozen a…
Enumerationr/w
Enumerated Values:
1enabled
2disabled
.1.3.6.1.4.1.9.9.312.1.1.3.1.11
cdcVFileOperStatus
A status object to indicate the operational state of
collection for this entry.

When the value of cdcVFileAdminStatus is modified to be
'enabled', the value of this object will change to 'enabled'
providi…
Enumeration
Enumerated Values:
1enabled
2disabled
3error
.1.3.6.1.4.1.9.9.312.1.1.3.1.12
cdcVFileErrorCode
A value indicating the type of error that has occurred during
data collection operations for this entry.

noError The value is 'noError' when
the corresponding value o…
Enumeration
Enumerated Values:
1noError
2otherError
3noSpace
4openError
5tooSmallMaxSize
6tooManyMaxSizeHits
7noResource
.1.3.6.1.4.1.9.9.312.1.1.3.1.13
cdcVFileCollectionErrorEnable
When set to 'true', cdcVFileCollectionError notification will
be sent out in the event of a data collection error.
SNMPv2-TCTruthValuer/w
Textual Convention: SNMPv2-TCTruthValue Enumeration
Type Values:
1true
2false
.1.3.6.1.4.1.9.9.312.1.1.3.1.14
cdcVFileRowStatus
The status of this conceptual row.
A valid cdcVFileName is only mandatory object for setting
this object to 'active'. But collection of data in to active
vfile starts only on setting cdcVFileAdminStatus
to 'enabled'.
SNMPv2-TCRowStatusr/w
Textual Convention: SNMPv2-TCRowStatus Enumeration
Type Values:
1active
2notInService
3notReady
4createAndGo
5createAndWait
6destroy
.1.3.6.1.4.1.9.9.312.1.1.3.1.15
.1.3.6.1.4.1.9.9.312.1.1.4 · 1 row entry · 8 columns
A table to manage frozen VFiles.
cdcVFileMgmtEntry entry .1.3.6.1.4.1.9.9.312.1.1.4.1
An entry in cdcVFileMgmtTable. Each entry corresponds to a
frozen VFile. An entry is created in this table, whenever a
VFile is frozen. An entry is removed from this table whenever
a frozen VFile is deleted either becau…
Indexes
cdcVFileIndex cdcVFileMgmtIndex
Column Syntax OID
cdcVFileMgmtIndex
This value is a running counter starting at 1,
generated by the agent so that the combination of
cdcVFileIndex and cdcVFileMgmtIndex uniquely
identifies a frozen VFile. The deleted file indicies
do not get reused.
Unsigned32
Constraints:
range: 1-4294967295
.1.3.6.1.4.1.9.9.312.1.1.4.1.1
cdcVFileMgmtName
The full name of the VFile. If the VFile is stored as a file
in the agent's filesystem, then this value also contains the
absolute path of the file.
SNMPv2-TCDisplayString
Textual Convention: SNMPv2-TCDisplayString OctetString
Type Constraints:
range: 0..255
.1.3.6.1.4.1.9.9.312.1.1.4.1.2
cdcVFileMgmtTimestamp
The timestamp when this VFile was created, in the date-time
format.
SNMPv2-TCDateAndTime
Textual Convention: SNMPv2-TCDateAndTime OctetString
Type Constraints:
range: 8
range: 11
.1.3.6.1.4.1.9.9.312.1.1.4.1.3
cdcVFileMgmtTimeToLive
The time left before this VFile is deleted (see
cdcVFileRetentionPeriod).
secondsUnsigned32
Constraints:
range: 60-86400
.1.3.6.1.4.1.9.9.312.1.1.4.1.4
cdcVFileMgmtCommand
A control to manage VFiles.

idle This value can be only be read. It indicates
that no management action is currently being
performed on this VFile.

Enumerationr/w
Enumerated Values:
1idle
2delete
3transfer
4abortTransfer
.1.3.6.1.4.1.9.9.312.1.1.4.1.5
cdcVFileMgmtXferURL
The complete URL of the destination to which this VFile will
be transferred in the next attempt. The URL also includes the
complete filename of the remote file that will be
created. When the default value of this object…
CdcUrlr/w
Textual Convention: CdcUrl OctetString
Type Constraints:
range: 0..255
.1.3.6.1.4.1.9.9.312.1.1.4.1.6
cdcVFileMgmtLastXferStatus
Indicates the status of the last completed transfer.
CdcFileXferStatus
Textual Convention: CdcFileXferStatus Enumeration
Type Values:
1notStarted
2success
3aborted
4fileOpenFailRemote
5badDomainName
6unreachableIpAddress
7networkFailed
8fileWriteFailed
9authFailed
.1.3.6.1.4.1.9.9.312.1.1.4.1.7
cdcVFileMgmtLastXferURL
Indicates the URL of the destination to which the last
(completed) transfer was initiated.
CdcUrl
Textual Convention: CdcUrl OctetString
Type Constraints:
range: 0..255
.1.3.6.1.4.1.9.9.312.1.1.4.1.8
.1.3.6.1.4.1.9.9.312.1.2.1 · 1 row entry · 11 columns
A table for specifying data groups.
cdcDGEntry entry .1.3.6.1.4.1.9.9.312.1.2.1.1
An entry in this table. Each entry corresponds to a data
group. A data group is used to select data that needs to be
collected into VFiles. The selection is done by specifying
the base objects and their instances for wh…
Indexes
cdcDGIndex
Column Syntax OID
cdcDGIndex
An arbitrary integer used to uniquely identify this entry.
When creating an entry, a management application should pick a
random number.
Unsigned32
Constraints:
range: 1-4294967295
.1.3.6.1.4.1.9.9.312.1.2.1.1.1
cdcDGComment
A descriptive string. This object's value may be modified at
any time.
SNMP-FRAMEWORK-MIBSnmpAdminStringr/w
Textual Convention: SNMP-FRAMEWORK-MIBSnmpAdminString OctetString
Type Constraints:
range: 0..255
.1.3.6.1.4.1.9.9.312.1.2.1.1.2
cdcDGType
Identifies the type of this data group.
object Data is a single MIB object. The fully
instantiated OID is specified in
cdcDGBaseObject.

table Data is a logic…
Enumerationr/w
Enumerated Values:
1object
2table
.1.3.6.1.4.1.9.9.312.1.2.1.1.3
cdcDGVFileIndex
Corresponds to a value of cdcVFileIndex.
It is used to associate this data group with a
cdcVFileEntry. The values of the base objects for
this data group are stored into the current VFile of the
associated cdcVFileEntr…
Unsigned32r/w
Constraints:
range: 1-4294967295
.1.3.6.1.4.1.9.9.312.1.2.1.1.4
cdcDGTargetTag
The tag for the target from which to obtain the data for
this data group.

A length of 0 indicates the local system. In this case,
access to the objects of this data group is under
the security credential…
SNMP-TARGET-MIBSnmpTagValuer/w
Textual Convention: SNMP-TARGET-MIBSnmpTagValue OctetString
Type Constraints:
range: 0..255
.1.3.6.1.4.1.9.9.312.1.2.1.1.5
cdcDGContextName
The management context from which to obtain data for this
data group.

This object's value may be modified at any time. The change
takes effect the next time data is fetched for this data
group.
SNMP-FRAMEWORK-MIBSnmpAdminStringr/w
Textual Convention: SNMP-FRAMEWORK-MIBSnmpAdminString OctetString
Type Constraints:
range: 0..255
.1.3.6.1.4.1.9.9.312.1.2.1.1.6
cdcDGObject
The fully instantiated name of the MIB object whose value
needs to be fetched. This object's value is used only when
cdcDGType is of type 'object'.

This object's value may be modified at any time. The ch…
SNMPv2-TCVariablePointerr/w
Textual Convention: SNMPv2-TCVariablePointer ObjectIdentifier
.1.3.6.1.4.1.9.9.312.1.2.1.1.7
cdcDGObjectGrpIndex
Corresponds to a value of cdcDGBaseObjectGrpIndex, thus
identifying a set of entries in cdcDGBaseObjectTable, having
this value of cdcDGBaseObjectGrpIndex. This object's value is
used only when cdcDGType is of type 'tab…
Unsigned32r/w
Constraints:
range: 1-4294967295
.1.3.6.1.4.1.9.9.312.1.2.1.1.8
cdcDGInstGrpIndex
Corresponds to a value of cdcDGInstanceGrpIndex, thus
identifying a set of entries in cdcDGInstanceTable, having
this value of cdcDGInstanceGrpIndex. This object's value is
used only when cdcDGType is of type 'table'.
Unsigned32r/w
Constraints:
range: 0-4294967295
.1.3.6.1.4.1.9.9.312.1.2.1.1.9
cdcDGPollPeriod
Specifies the time intervals at which the data should be
fetched for this data group.
This object's value is used only when the collection
mode of the associated cdcVFileEntry is automatic (see
cdcVFileCollectMode).
secondsUnsigned32r/w
Constraints:
range: 1-86400
.1.3.6.1.4.1.9.9.312.1.2.1.1.10
cdcDGRowStatus
The status of this conceptual row.

This object cannot be set to 'active' until values have been
assigned to cdcDGVFileIndex & cdcDGColGrpIndex.
SNMPv2-TCRowStatusr/w
Textual Convention: SNMPv2-TCRowStatus Enumeration
Type Values:
1active
2notInService
3notReady
4createAndGo
5createAndWait
6destroy
.1.3.6.1.4.1.9.9.312.1.2.1.1.11
.1.3.6.1.4.1.9.9.312.1.2.2 · 1 row entry · 5 columns
A table specifying the base objects of a 'table' type
data group.
cdcDGBaseObjectEntry entry .1.3.6.1.4.1.9.9.312.1.2.2.1
An individual entry in this table. Each entry is a
{subtree, list} tuple. Each tuple identifies a set of
base objects for the associated data group.
Indexes
cdcDGBaseObjectGrpIndex cdcDGBaseObjectIndex
Column Syntax OID
cdcDGBaseObjectGrpIndex
This object's value when combined with the value of
cdcDGBaseObjectIndex uniquely identifies an entry in
this table. An application must use the same value (can
be randomly picked) for this object while creating a grou…
Unsigned32
Constraints:
range: 1-4294967295
.1.3.6.1.4.1.9.9.312.1.2.2.1.1
cdcDGBaseObjectIndex
This object's value when combined with the value of
cdcDGBaseObjectGrpIndex uniquely identifies an entry in
this table.

A managment application can assign incremental values
starting from one, when creati…
Unsigned32
Constraints:
range: 1-4294967295
.1.3.6.1.4.1.9.9.312.1.2.2.1.2
cdcDGBaseObjectSubtree
The subtree component of a {subtree, list} tuple.

This object's value may be modified at any time. The change
takes effect the next time data is fetched for this data
group.
CdcCollectionSubtreer/w
Textual Convention: CdcCollectionSubtree ObjectIdentifier
.1.3.6.1.4.1.9.9.312.1.2.2.1.3
cdcDGBaseObjectList
The list component of a {subtree, list} tuple.

This object's value may be modified at any time. The change
takes effect the next time data is fetched for this data
group.
CdcCollectionListr/w
Textual Convention: CdcCollectionList OctetString
Type Constraints:
range: 0..16
.1.3.6.1.4.1.9.9.312.1.2.2.1.4
cdcDGBaseObjectRowStatus
The status of this conceptual row.

This object cannot be set to 'active' until values have been
assigned to cdcDGBaseObjectSubtree & cdcDGBaseObjectList.
SNMPv2-TCRowStatusr/w
Textual Convention: SNMPv2-TCRowStatus Enumeration
Type Values:
1active
2notInService
3notReady
4createAndGo
5createAndWait
6destroy
.1.3.6.1.4.1.9.9.312.1.2.2.1.5
.1.3.6.1.4.1.9.9.312.1.2.3 · 1 row entry · 8 columns
Identifies the instances of the base objects that need to
be fetched for a 'table' type data group.
          
The agent is not responsible for verifying that the instances
specified for a data group do not overlap.
cdcDGInstanceEntry entry .1.3.6.1.4.1.9.9.312.1.2.3.1
An entry in this table. Each entry identifies one or more
instances of the base objects that need to be fetched.
An instance is represented by an OID fragment.
Indexes
cdcDGInstanceGrpIndex cdcDGInstanceIndex
Column Syntax OID
cdcDGInstanceGrpIndex
This object's value when combined with the value of
cdcDGInstanceIndex uniquely identifies an entry in
this table. An application must use the same value (can
be randomly picked) for this object while creating a group …
Unsigned32
Constraints:
range: 1-4294967295
.1.3.6.1.4.1.9.9.312.1.2.3.1.1
cdcDGInstanceIndex
This object's value when combined with the value of
cdcDGInstanceGrpIndex uniquely identifies an entry in
this table.

A managment application can assign incremental values
starting from one, when creating…
Unsigned32
Constraints:
range: 1-4294967295
.1.3.6.1.4.1.9.9.312.1.2.3.1.2
cdcDGInstanceType
Specifies the way in which the instances are to be used while
collecting data.


individual The value of cdcDGInstanceOid is
appended to each base object of the
Enumerationr/w
Enumerated Values:
1individual
2range
3repititions
4subTree
5other
.1.3.6.1.4.1.9.9.312.1.2.3.1.3
cdcDGInstanceOid
Contains the OBJECT IDENTIFIER fragment that identifies the
instances of the base objects that need to be collected.

If cdcDGInstanceType is 'individual' then this value
should be the OID fragment that, w…
CdcRowInstanceIdr/w
Textual Convention: CdcRowInstanceId ObjectIdentifier
.1.3.6.1.4.1.9.9.312.1.2.3.1.4
cdcDGInstanceOidEnd
Contains the OID fragment that, when appended to each base
object gives the end of the range of object instances that
needs to be fetched.
This value is used only when the value of cdcDGInstanceType
is of type 'range'.…
CdcRowInstanceIdr/w
Textual Convention: CdcRowInstanceId ObjectIdentifier
.1.3.6.1.4.1.9.9.312.1.2.3.1.5
cdcDGInstanceNumRepititions
Specifies the number of lexicographically consecutive object
instances to fetch.
This value is used only when the value of cdcDGInstanceType
is of type 'repititions'.

This object's value may be modifie…
SNMPv2-SMIUnsigned32r/w
Textual Convention: SNMPv2-SMIUnsigned32 Unsigned32
Type Constraints:
range: 0..4294967295
.1.3.6.1.4.1.9.9.312.1.2.3.1.6
cdcDGInstanceOtherPtr
Contains a pointer to a row in another MIB table that
contains MIB specific criteria for selecting instances.
This value is used only when the value of cdcDGInstanceType
is of type 'other'.

This object'…
SNMPv2-TCRowPointerr/w
Textual Convention: SNMPv2-TCRowPointer ObjectIdentifier
.1.3.6.1.4.1.9.9.312.1.2.3.1.7
cdcDGInstanceRowStatus
The status of this conceptual row.
SNMPv2-TCRowStatusr/w
Textual Convention: SNMPv2-TCRowStatus Enumeration
Type Values:
1active
2notInService
3notReady
4createAndGo
5createAndWait
6destroy
.1.3.6.1.4.1.9.9.312.1.2.3.1.8
.1.3.6.1.4.1.9.9.312.1.3.1 · 1 row entry · 6 columns
A table for configuring file transfer operations.
cdcFileXferConfEntry entry .1.3.6.1.4.1.9.9.312.1.3.1.1
An individual entry in the cdcFileXferConfTable. Each entry
identifies a primary and an optional secondary destination.

An entry is automatically created in this table, whenever an
entry is created in the c…
Indexes
cdcVFileIndex
Column Syntax OID
cdcFileXferConfPriUrl
The URL which specifies the primary destination to which
the file has to be transferred. The URL should contain the
base-name of the remote file, the suffix will be carried over
from the name of the VFile being tranferr…
CdcUrlr/w
Textual Convention: CdcUrl OctetString
Type Constraints:
range: 0..255
.1.3.6.1.4.1.9.9.312.1.3.1.1.1
cdcFileXferConfSecUrl
The URL which specifies the secondary destination to which
the file has to be transferred if the transfer to the
primary destination fails. Failure occurs when the file
cannot be transferred in it's entirety to the sp…
CdcUrlr/w
Textual Convention: CdcUrl OctetString
Type Constraints:
range: 0..255
.1.3.6.1.4.1.9.9.312.1.3.1.1.2
cdcFileXferConfRetryPeriod
Specifies the time interval after which transfer has to be
retried. Transfer needs to be retried only if in a previous
attempt the file could not be successfully transferred to
either the primary destination or the se…
secondsUnsigned32r/w
Constraints:
range: 60-86400
.1.3.6.1.4.1.9.9.312.1.3.1.1.3
cdcFileXferConfRetryCount
Maximum number of times, transfer has to be retried. If the
retry count exceeds this value, then no further attempts will
be made.

This object's value may be modified at any time.
secondsUnsigned32r/w
Constraints:
range: 0-256
.1.3.6.1.4.1.9.9.312.1.3.1.1.4
cdcFileXferConfSuccessEnable
When set to 'true', cdcFileXferComplete notification will
be sent out in the event of a successful file transfer.
SNMPv2-TCTruthValuer/w
Textual Convention: SNMPv2-TCTruthValue Enumeration
Type Values:
1true
2false
.1.3.6.1.4.1.9.9.312.1.3.1.1.5
cdcFileXferConfFailureEnable
When set to 'true', cdcFileXferComplete notification will
be sent out in the event of a file transfer failure.
SNMPv2-TCTruthValuer/w
Textual Convention: SNMPv2-TCTruthValue Enumeration
Type Values:
1true
2false
.1.3.6.1.4.1.9.9.312.1.3.1.1.6