All MIBs › CISCO-DIAL-CONTROL-MIB
Organization: Cisco systems, Inc.
Last Updated: 2005-05-26
Category: Cisco Devices, Telephony and VoIP
Description:
Extends the IETF Dial Control MIB with management of dial peers for voice telephony on both circuit-switched and IP data networks.
Imported Objects
From CISCO-SMI
| ciscoExperiment | OBJECT-IDENTITY |
From DIAL-CONTROL-MIB
| AbsoluteCounter32 |
From IF-MIB
| InterfaceIndexOrZero |
From SNMP-FRAMEWORK-MIB
| SnmpAdminString |
From SNMPv2-CONF
| MODULE-COMPLIANCE | |
| OBJECT-GROUP |
From SNMPv2-SMI
| MODULE-IDENTITY | |
| OBJECT-TYPE | |
| Unsigned32 |
From SNMPv2-TC
| DisplayString | |
| TimeStamp |
What Is CISCO-DIAL-CONTROL-MIB?
CISCO-DIAL-CONTROL-MIB extends the IETF Dial Control MIB to manage dial peers used for voice telephony over both traditional circuit-switched networks and IP data networks on Cisco routers, and records call history for demand-access and similar interfaces. The data it exposes is largely call-event and configuration data: per-call history including setup and connect times, peer addresses and IDs, logical interface indices, and disconnect cause/text, along with global dial-peer configuration objects. As a software/fault-status MIB it lets an administrator review recent call setup and teardown activity and diagnose connectivity problems via disconnect cause codes, which is central to troubleshooting VoIP and dial-backup connectivity rather than physical hardware health. It explicitly extends the IETF Dial Control MIB (RFC 2128-family) and is closely related to CISCO-CALL-HISTORY-MIB, sharing a similar call-record model. It is typically deployed on Cisco voice gateways and routers with dial peers configured for VoIP trunking or ISDN/analog dial-backup scenarios. Browsing the CISCO-DIAL-CONTROL-MIB OID tree alongside cCallHistoryTable entries helps an administrator confirm exactly which objects are populated for a given IOS release.
IPNetwork Monitor allows you to monitor SNMP objects defined in CISCO-DIAL-CONTROL-MIB. Use the built-in SNMP Monitoring Browser to explore available variables, view their current values and descriptions, and select the objects you want to monitor. You can then create SNMP monitors, configure thresholds, and receive alerts when monitored values change.
What Can Be Monitored
- call setup and connect time
- peer address and peer ID
- call disconnect cause and text
- logical interface used per call
Supported Devices
- Cisco ISR 4461 — current-generation Integrated Services Router running Cisco Unified Border Element (CUBE) with configurable dial peers
- Cisco Catalyst 8300 Series Edge Platform — current CUBE-capable voice gateway
- Cisco ISR/Catalyst 8000 series routers and voice gateways running Unified Border Element (CUBE) with dial-peer configuration
Monitoring Examples
An administrator walks cCallHistoryTable / cCallHistoryEntry keyed by cCallHistoryIndex, examining cCallHistorySetupTime and cCallHistoryConnectTime to measure call setup latency for a given cCallHistoryPeerId and cCallHistoryPeerAddress. Persistent non-zero cCallHistoryDisconnectCause values with accompanying cCallHistoryDisconnectText across many entries for the same cCallHistoryLogicalIfIndex would point to a chronic problem with a specific dial peer or trunk. Reviewing cPeerGlobalConfiguration alongside these history entries helps correlate a peer's configuration with observed call-failure patterns.
OIDs
| OID symbolic | OID numeric | Type | Access | Description |
|---|---|---|---|---|
| ciscoDialControlMib | 1.3.6.1.4.1.9.3.25 | The MIB module to describe call history information for demand access and possibly other kinds of interfaces. | ||
| ciscoDialControlMibObjects | 1.3.6.1.4.1.9.3.25.1 | |||
| cCallHistory | 1.3.6.1.4.1.9.3.25.1.4 | |||
| cCallHistoryTable | 1.3.6.1.4.1.9.3.25.1.4.3 | not-accessible | A table containing information about specific calls to a specific destination. | |
| cCallHistoryEntry | 1.3.6.1.4.1.9.3.25.1.4.3.1 | not-accessible | The information regarding a single Connection. | |
| U32 cCallHistoryIndex | 1.3.6.1.4.1.9.3.25.1.4.3.1.1 | Unsigned32 | not-accessible | A monotonically increasing integer for the sole purpose of indexing call disconnection events. When it reaches the maximum value, an extremely unlikely event, the agent wraps the value back to 1 and may flush existing entries. |
| TIM cCallHistorySetupTime | 1.3.6.1.4.1.9.3.25.1.4.3.1.2 | TimeStamp | read-only | The value of sysUpTime when the call setup was started. This will be useful for an NMS to sort the call history entry with call setup time. Also, this object can be useful in finding large delays between the time the call was started and the time the call was connected. For ISDN media, this will be the time when the setup message was received from or sent to the network. The value of this object is the same as callActiveSetupTime in the callActiveTable |
| STR cCallHistoryPeerAddress | 1.3.6.1.4.1.9.3.25.1.4.3.1.3 | DisplayString | read-only | The number this call was connected to. If the number is not available, then it will have a length of zero. |
| STR cCallHistoryPeerSubAddress | 1.3.6.1.4.1.9.3.25.1.4.3.1.4 | DisplayString | read-only | The subaddress this call was connected to. If the subaddress is undefined or not available, this will be a zero length string. |
| INT cCallHistoryPeerId | 1.3.6.1.4.1.9.3.25.1.4.3.1.5 | INTEGER | read-only | This is the Id value of the peer table entry to which this call was made. If a peer table entry for this call does not exist, the value of this object will be zero. |
| INT cCallHistoryPeerIfIndex | 1.3.6.1.4.1.9.3.25.1.4.3.1.6 | INTEGER | read-only | This is the ifIndex value of the peer table entry to which this call was made. If a peer table entry for this call does not exist, the value of this object will be zero. |
| NUM cCallHistoryLogicalIfIndex | 1.3.6.1.4.1.9.3.25.1.4.3.1.7 | InterfaceIndexOrZero | read-only | This is the ifIndex value of the logical interface through which this call was made. For ISDN media, this would be the ifIndex of the B channel which was used for this call. If the ifIndex value is unknown, the value of this object will be zero. For an IP call, the value will be zero. |
| OCT cCallHistoryDisconnectCause | 1.3.6.1.4.1.9.3.25.1.4.3.1.8 | OCTET STRING | read-only | The encoded network cause value associated with this call. The value of this object will depend on the interface type as well as on the protocol and protocol version being used on this interface. Some references for possible cause values are given below. |
| STR cCallHistoryDisconnectText | 1.3.6.1.4.1.9.3.25.1.4.3.1.9 | DisplayString | read-only | ASCII text describing the reason for call termination. This object exists because it would be impossible for a management station to store all possible cause values for all types of interfaces. It should be used only if a management station is unable to decode the value of dialCtlPeerStatsLastDisconnectCause. |
| TIM cCallHistoryConnectTime | 1.3.6.1.4.1.9.3.25.1.4.3.1.10 | TimeStamp | read-only | The value of sysUpTime when the call was connected. |
| TIM cCallHistoryDisconnectTime | 1.3.6.1.4.1.9.3.25.1.4.3.1.11 | TimeStamp | read-only | The value of sysUpTime when the call was disconnected. |
| INT cCallHistoryCallOrigin | 1.3.6.1.4.1.9.3.25.1.4.3.1.12 | INTEGER | read-only | The call origin. |
| NUM cCallHistoryChargedUnits | 1.3.6.1.4.1.9.3.25.1.4.3.1.13 | AbsoluteCounter32 | read-only | The number of charged units for this connection. For incoming calls or if charging information is not supplied by the switch, the value of this object will be zero. |
| INT cCallHistoryInfoType | 1.3.6.1.4.1.9.3.25.1.4.3.1.14 | INTEGER | read-only | The information type for this call. |
| NUM cCallHistoryTransmitPackets | 1.3.6.1.4.1.9.3.25.1.4.3.1.15 | AbsoluteCounter32 | read-only | The number of packets which were transmitted while this call was active. |
| NUM cCallHistoryTransmitBytes | 1.3.6.1.4.1.9.3.25.1.4.3.1.16 | AbsoluteCounter32 | read-only | The number of bytes which were transmitted while this call was active. |
| NUM cCallHistoryReceivePackets | 1.3.6.1.4.1.9.3.25.1.4.3.1.17 | AbsoluteCounter32 | read-only | The number of packets which were received while this call was active. |
| NUM cCallHistoryReceiveBytes | 1.3.6.1.4.1.9.3.25.1.4.3.1.18 | AbsoluteCounter32 | read-only | The number of bytes which were received while this call was active. |
| INT cCallHistoryReleaseSource | 1.3.6.1.4.1.9.3.25.1.4.3.1.19 | INTEGER | read-only | Originator of the call release. |
| INT cCallHistoryReleaseSrc | 1.3.6.1.4.1.9.3.25.1.4.3.1.20 | INTEGER | read-only | Originator of the call release. Indicates the source of the call release as follows : 1) callingPartyInPstn : Calling party in PSTN. 2) callingPartyInVoip : Calling party in VoIP. 3) calledPartyInPstn : Called party in PSTN. 4) calledPartyInVoip : Called party in VoIP. 5) internalReleaseInPotsLeg : Due to an internal error in Telephony call leg. 6) internalReleaseInVoipLeg : Due to an internal error in VoIP call leg. 7) internalCallControlApp : Due to an internal error in Session Application or Tcl or VXML script originated release. 8) internalReleaseInVoipAAA : Due to an internal error in VoIP AAA module. 9) consoleCommand : Due to CLI or MML. 10) externalRadiusServer : Call failed during authorization , authentication or due to receipt of POD from the RADIUS server. 11) externalNmsApp : Due to SNMP request to clear the call. 12) externalCallControlAgent : External Call Control Agent initiated clear. 13) gatekeeper : Gatekeeper initiated clear due to receipt of Admission Reject, Disengage Request message. 14) externalGKTMPServer : External GKTMP server initiated clear due to receipt of Admission Reject message from the gatekeeper, triggered by RESPONSE.ARJ message from the GKTMP server. |
| cCallHistoryIecTable | 1.3.6.1.4.1.9.3.25.1.4.4 | not-accessible | This table contains information about Internal Error Code(s) (IEC) which caused the call to fail. | |
| cCallHistoryIecEntry | 1.3.6.1.4.1.9.3.25.1.4.4.1 | not-accessible | The IEC information regarding a single call. | |
| U32 cCallHistoryIecIndex | 1.3.6.1.4.1.9.3.25.1.4.4.1.1 | Unsigned32 | not-accessible | This object is used to index one or more IECs in the context of a single call. In most cases there will only be one IEC when a call fails. However, it is possible for the software processing the call to generate multiple IECs before the call ultimately fails. In that scenario, there will be multiple entries in this table related to a single call (cCallHistoryIndex) and this object will serve to uniquely identify each IEC. |
| STR cCallHistoryIec | 1.3.6.1.4.1.9.3.25.1.4.4.1.2 | SnmpAdminString | read-only | This object reflects the Internal Error Code. The format is a string of dotted decimal numbers composed of the following components: Version.Entity.Category.Subsystem.Errorcode.Diagnostic Each component is defined as follows: Version : The version of IEC software. Entity : The network entity that originated the error. Category : The category of the error (eg, software error, hardware resource unavailable, ...) Subsystem : The subsystem in which the error occurred. Errorcode : A subsytem-specific error code. Diagnostic : An implementation-specific diagnostic code. |
| cPeerGlobalConfiguration | 1.3.6.1.4.1.9.3.25.1.5 | |||
| INT cPeerSearchType | 1.3.6.1.4.1.9.3.25.1.5.1 | INTEGER | read-write | Specifies the peer search preference based on the type of peers in an universal/integrated port platform. none - both voice and data peers are searched in same preference. datavoice - search data peers first. If no data peers are found, the voice peers are searched. voicedata - search voice peers first. If no voice peers are found, the data peers are searched. |
| ciscoDialControlMibConformance | 1.3.6.1.4.1.9.3.25.3 | |||
| ciscoDialControlMibCompliances | 1.3.6.1.4.1.9.3.25.3.1 | |||
| ciscoDialControlMibCompliance | 1.3.6.1.4.1.9.3.25.3.1.1 | The compliance statement for entities which implement the DIAL CONTROL MIB | ||
| ciscoDialControlMibComplianceRev1 | 1.3.6.1.4.1.9.3.25.3.1.2 | The compliance statement for entities which implement the DIAL CONTROL MIB | ||
| ciscoDialControlMibComplianceRev2 | 1.3.6.1.4.1.9.3.25.3.1.3 | The compliance statement for entities which implement the DIAL CONTROL MIB | ||
| ciscoDialControlMibComplianceRev3 | 1.3.6.1.4.1.9.3.25.3.1.4 | The compliance statement for entities which implement the DIAL CONTROL MIB | ||
| ciscoDialControlMibComplianceRev4 | 1.3.6.1.4.1.9.3.25.3.1.5 | The compliance statement for entities which implement the DIAL CONTROL MIB | ||
| ciscoDialControlMibGroups | 1.3.6.1.4.1.9.3.25.3.2 | |||
| cCallHistoryGroup | 1.3.6.1.4.1.9.3.25.3.2.1 | A collection of objects providing the Call History capability. | ||
| cCallHistoryGroupRev1 | 1.3.6.1.4.1.9.3.25.3.2.2 | A collection of objects providing the Call History capability. | ||
| cCallHistoryGroupRev2 | 1.3.6.1.4.1.9.3.25.3.2.3 | A collection of objects providing the Call History capability. | ||
| cPeerGlobalConfigurationGroup | 1.3.6.1.4.1.9.3.25.3.2.4 | A collection of objects providing the Peer global configuration. | ||
| cCallHistoryIecGroup | 1.3.6.1.4.1.9.3.25.3.2.5 | A collection of objects providing information about Internal Error Code. |
RFC description
Cisco dial control MIB for managing dial-up connections, modem interfaces, and remote access call information.
Start monitoring Cisco ISR/Catalyst 8000 routers and voice gateways with a free 30-day trial of IPNetwork Monitor. Import MIBs, browse SNMP OIDs, create custom SNMP monitors, configure alerts, and monitor any SNMP-enabled network device from a single console.