DIAL-CONTROL-MIB

MIB Reference — IPNetwork Monitor

All MIBsDIAL-CONTROL-MIB

Organization: IETF ISDN Working Group

Last Updated: 1996-09-23

Category: Telephony and VoIP

Description:

Defines managed objects for managing demand access circuits including ISDN, covering peer configuration, active call monitoring, and call history tracking.

Imported Objects

From IANAifType-MIB

IANAifType

From IF-MIB

InterfaceIndex
InterfaceIndexOrZero
ifIndexOBJECT-TYPE
ifOperStatusOBJECT-TYPE

From RFC1213-MIB

transmission

From SNMPv2-CONF

MODULE-COMPLIANCE
OBJECT-GROUP

From SNMPv2-SMI

Gauge32
MODULE-IDENTITY
NOTIFICATION-TYPE
OBJECT-TYPE

From SNMPv2-TC

DisplayString
RowStatus
TEXTUAL-CONVENTION
TimeStamp

What Is DIAL-CONTROL-MIB?

DIAL-CONTROL-MIB is a vendor-neutral IETF standards MIB (RFC 2128) for managing demand-access dial circuits such as ISDN, modem, and other on-demand WAN links, covering peer configuration, active call state, and call history. It exposes configuration data for each dial peer -- accept mode, originate/answer addresses, sub-address, closed user group, and link speed -- as well as global controls like trap enablement for the dial-control subsystem. Administrators use it to monitor the operational status of demand-access links: whether a peer is configured to dial or answer correctly, what addresses and speeds are negotiated, and (via associated call-active/call-history objects) whether calls are succeeding, failing, or flapping, which is central to diagnosing intermittent WAN backup or ISDN dial-on-demand connectivity. It is explicitly designed to work alongside the standard ifTable (RFC 1573/MIB-II) for each dial interface's underlying interface entry, and layers on top of whatever physical dial technology (ISDN BRI/PRI, modem) is in use. It is deployed on routers and access servers using dial-on-demand or ISDN backup circuits in legacy WAN environments, and any network management platform that supports the DIAL-CONTROL-MIB MIB can poll these objects to confirm dial peer and call status without vendor-specific extensions.

IPNetwork Monitor allows you to monitor SNMP objects defined in 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

  • dial peer configuration (originate/answer address)
  • dial peer link speed and interface type
  • dial control trap/notification enablement
  • closed user group settings
  • call accept mode

Supported Devices

  • vendor-neutral, standards-based MIB, not tied to a specific manufacturer
  • routers and access servers with ISDN/dial-on-demand WAN interfaces

Monitoring Examples

An admin can poll dialCtlPeerCfgTable/dialCtlPeerCfgEntry to check a given dialCtlPeerCfgId's dialCtlPeerCfgOriginateAddress and dialCtlPeerCfgAnswerAddress, confirming a dial peer is configured with the correct number for ISDN dial-on-demand backup. dialCtlPeerCfgSpeed and dialCtlPeerCfgIfType reveal the negotiated link type and speed, useful for diagnosing why a backup circuit isn't reaching expected throughput. dialCtlTrapEnable controls whether call state-change traps fire, letting an operator get proactively notified when a backup dial link activates or drops.

OIDs
OID symbolicOID numericTypeAccessDescription
dialControlMib1.3.6.1.2.1.10.21The MIB module to describe peer information for demand access and possibly other kinds of interfaces.
dialControlMibObjects1.3.6.1.2.1.10.21.1
dialCtlConfiguration1.3.6.1.2.1.10.21.1.1
INT dialCtlAcceptMode1.3.6.1.2.1.10.21.1.1.1INTEGERread-writeThe security level for acceptance of incoming calls. acceptNone(1) - incoming calls will not be accepted acceptAll(2) - incoming calls will be accepted, even if there is no matching entry in the dialCtlPeerCfgTable acceptKnown(3) - incoming calls will be accepted only if there is a matching entry in the dialCtlPeerCfgTable
INT dialCtlTrapEnable1.3.6.1.2.1.10.21.1.1.2INTEGERread-writeThis object indicates whether dialCtlPeerCallInformation and dialCtlPeerCallSetup traps should be generated for all peers. If the value of this object is enabled(1), traps will be generated for all peers. If the value of this object is disabled(2), traps will be generated only for peers having dialCtlPeerCfgTrapEnable set to enabled(1).
dialCtlPeer1.3.6.1.2.1.10.21.1.2
dialCtlPeerCfgTable1.3.6.1.2.1.10.21.1.2.1not-accessibleThe list of peers from which the managed device will accept calls or to which it will place them.
dialCtlPeerCfgEntry1.3.6.1.2.1.10.21.1.2.1.1not-accessibleConfiguration data for a single Peer. This entry is effectively permanent, and contains information to identify the peer, how to connect to the peer, how to identify the peer and its permissions. The value of dialCtlPeerCfgOriginateAddress must be specified before a new row in this table can become active(1). Any writeable parameters in an existing entry can be modified while the entry is active. The modification will take effect when the peer in question will be called the next time. An entry in this table can only be created if the associated ifEntry already exists.
INT dialCtlPeerCfgId1.3.6.1.2.1.10.21.1.2.1.1.1INTEGERnot-accessibleThis object identifies a single peer. There may be several entries in this table for one peer, defining different ways of reaching this peer. Thus, there may be several entries in this table with the same value of dialCtlPeerCfgId. Multiple entries for one peer may be used to support multilink as well as backup lines. A single peer will be identified by a unique value of this object. Several entries for one peer MUST have the same value of dialCtlPeerCfgId, but different ifEntries and thus different values of ifIndex.
IAN dialCtlPeerCfgIfType1.3.6.1.2.1.10.21.1.2.1.1.2IANAifTyperead-createThe interface type to be used for calling this peer. In case of ISDN, the value of isdn(63) is to be used.
NUM dialCtlPeerCfgLowerIf1.3.6.1.2.1.10.21.1.2.1.1.3InterfaceIndexOrZeroread-createifIndex value of an interface the peer will have to be called on. For example, on an ISDN interface, this can be the ifIndex value of a D channel or the ifIndex value of a B channel, whatever is appropriate for a given peer. As an example, for Basic Rate leased lines it will be necessary to specify a B channel ifIndex, while for semi-permanent connections the D channel ifIndex has to be specified. If the interface can be dynamically assigned, this object has a value of zero.
STR dialCtlPeerCfgOriginateAddress1.3.6.1.2.1.10.21.1.2.1.1.4DisplayStringread-createCall Address at which the peer will be called. Think of this as the set of characters following 'ATDT ' or the 'phone number' included in a D channel call request. The structure of this information will be switch type specific. If there is no address information required for reaching the peer, i.e., for leased lines, this object will be a zero length string.
STR dialCtlPeerCfgAnswerAddress1.3.6.1.2.1.10.21.1.2.1.1.5DisplayStringread-createCalling Party Number information element, as for example passed in an ISDN SETUP message by a PBX or switch, for incoming calls. This address can be used to identify the peer. If this address is either unknown or identical to dialCtlPeerCfgOriginateAddress, this object will be a zero length string.
STR dialCtlPeerCfgSubAddress1.3.6.1.2.1.10.21.1.2.1.1.6DisplayStringread-createSubaddress at which the peer will be called. If the subaddress is undefined for the given media or unused, this is a zero length string.
STR dialCtlPeerCfgClosedUserGroup1.3.6.1.2.1.10.21.1.2.1.1.7DisplayStringread-createClosed User Group at which the peer will be called. If the Closed User Group is undefined for the given media or unused, this is a zero length string.
INT dialCtlPeerCfgSpeed1.3.6.1.2.1.10.21.1.2.1.1.8INTEGERread-createThe desired information transfer speed in bits/second when calling this peer. The detailed media specific information, e.g. information type and information transfer rate for ISDN circuits, has to be extracted from this object. If the transfer speed to be used is unknown or the default speed for this type of interfaces, the value of this object may be zero.
INT dialCtlPeerCfgInfoType1.3.6.1.2.1.10.21.1.2.1.1.9INTEGERread-createThe Information Transfer Capability to be used when calling this peer. speech(2) refers to a non-data connection, whereas audio31(6) and audio7(7) refer to data mode connections.
INT dialCtlPeerCfgPermission1.3.6.1.2.1.10.21.1.2.1.1.10INTEGERread-createApplicable permissions. callback(4) either rejects the call and then calls back, or uses the 'Reverse charging' information element if it is available. Note that callback(4) is supposed to control charging, not security, and applies to callback prior to accepting a call. Callback for security reasons can be handled using PPP callback.
INT dialCtlPeerCfgInactivityTimer1.3.6.1.2.1.10.21.1.2.1.1.11INTEGERread-createThe connection will be automatically disconnected if no longer carrying useful data for a time period, in seconds, specified in this object. Useful data in this context refers to forwarding packets, including routing information; it excludes the encapsulator maintenance frames. A value of zero means the connection will not be automatically taken down due to inactivity, which implies that it is a dedicated circuit.
INT dialCtlPeerCfgMinDuration1.3.6.1.2.1.10.21.1.2.1.1.12INTEGERread-createMinimum duration of a call in seconds, starting from the time the call is connected until the call is disconnected. This is to accomplish the fact that in most countries charging applies to units of time, which should be matched as closely as possible.
INT dialCtlPeerCfgMaxDuration1.3.6.1.2.1.10.21.1.2.1.1.13INTEGERread-createMaximum call duration in seconds. Zero means 'unlimited'.
INT dialCtlPeerCfgCarrierDelay1.3.6.1.2.1.10.21.1.2.1.1.14INTEGERread-createThe call timeout time in seconds. The default value of zero means that the call timeout as specified for the media in question will apply.
INT dialCtlPeerCfgCallRetries1.3.6.1.2.1.10.21.1.2.1.1.15INTEGERread-createThe number of calls to a non-responding address that may be made. A retry count of zero means there is no bound. The intent is to bound the number of successive calls to an address which is inaccessible, or which refuses those calls. Some countries regulate the number of call retries to a given peer that can be made.
INT dialCtlPeerCfgRetryDelay1.3.6.1.2.1.10.21.1.2.1.1.16INTEGERread-createThe time in seconds between call retries if a peer cannot be reached. A value of zero means that call retries may be done without any delay.
INT dialCtlPeerCfgFailureDelay1.3.6.1.2.1.10.21.1.2.1.1.17INTEGERread-createThe time in seconds after which call attempts are to be placed again after a peer has been noticed to be unreachable, i.e. after dialCtlPeerCfgCallRetries unsuccessful call attempts. A value of zero means that a peer will not be called again after dialCtlPeerCfgCallRetries unsuccessful call attempts.
INT dialCtlPeerCfgTrapEnable1.3.6.1.2.1.10.21.1.2.1.1.18INTEGERread-createThis object indicates whether dialCtlPeerCallInformation and dialCtlPeerCallSetup traps should be generated for this peer.
ROW dialCtlPeerCfgStatus1.3.6.1.2.1.10.21.1.2.1.1.19RowStatusread-createStatus of one row in this table.
dialCtlPeerStatsTable1.3.6.1.2.1.10.21.1.2.2not-accessibleStatistics information for each peer entry. There will be one entry in this table for each entry in the dialCtlPeerCfgTable.
dialCtlPeerStatsEntry1.3.6.1.2.1.10.21.1.2.2.1not-accessibleStatistics information for a single Peer. This entry is effectively permanent, and contains information describing the last call attempt as well as supplying statistical information.
NUM dialCtlPeerStatsConnectTime1.3.6.1.2.1.10.21.1.2.2.1.1AbsoluteCounter32read-onlyAccumulated connect time to the peer since system startup. This is the total connect time, i.e. the connect time for outgoing calls plus the time for incoming calls.
NUM dialCtlPeerStatsChargedUnits1.3.6.1.2.1.10.21.1.2.2.1.2AbsoluteCounter32read-onlyThe total number of charging units applying to this peer since system startup. Only the charging units applying to the local interface, i.e. for originated calls or for calls with 'Reverse charging' being active, will be counted here.
NUM dialCtlPeerStatsSuccessCalls1.3.6.1.2.1.10.21.1.2.2.1.3AbsoluteCounter32read-onlyNumber of completed calls to this peer.
NUM dialCtlPeerStatsFailCalls1.3.6.1.2.1.10.21.1.2.2.1.4AbsoluteCounter32read-onlyNumber of failed call attempts to this peer since system startup.
NUM dialCtlPeerStatsAcceptCalls1.3.6.1.2.1.10.21.1.2.2.1.5AbsoluteCounter32read-onlyNumber of calls from this peer accepted since system startup.
NUM dialCtlPeerStatsRefuseCalls1.3.6.1.2.1.10.21.1.2.2.1.6AbsoluteCounter32read-onlyNumber of calls from this peer refused since system startup.
OCT dialCtlPeerStatsLastDisconnectCause1.3.6.1.2.1.10.21.1.2.2.1.7OCTET STRINGread-onlyThe encoded network cause value associated with the last call. This object will be updated whenever a call is started or cleared. 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 dialCtlPeerStatsLastDisconnectText1.3.6.1.2.1.10.21.1.2.2.1.8DisplayStringread-onlyASCII text describing the reason for the last 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. This object will be updated whenever a call is started or cleared.
TIM dialCtlPeerStatsLastSetupTime1.3.6.1.2.1.10.21.1.2.2.1.9TimeStampread-onlyThe value of sysUpTime when the last call to this peer was started. For ISDN media, this will be the time when the setup message was received from or sent to the network. This object will be updated whenever a call is started or cleared.
callActive1.3.6.1.2.1.10.21.1.3
callActiveTable1.3.6.1.2.1.10.21.1.3.1not-accessibleA table containing information about active calls to a specific destination.
callActiveEntry1.3.6.1.2.1.10.21.1.3.1.1not-accessibleThe information regarding a single active Connection. An entry in this table will be created when a call is started. An entry in this table will be deleted when an active call clears.
TIM callActiveSetupTime1.3.6.1.2.1.10.21.1.3.1.1.1TimeStampnot-accessibleThe value of sysUpTime when the call associated to this entry was started. This will be useful for an NMS to retrieve all calls after a specific 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.
INT callActiveIndex1.3.6.1.2.1.10.21.1.3.1.1.2INTEGERnot-accessibleSmall index variable to distinguish calls that start in the same hundredth of a second.
STR callActivePeerAddress1.3.6.1.2.1.10.21.1.3.1.1.3DisplayStringread-onlyThe number this call is connected to. If the number is not available, then it will have a length of zero.
STR callActivePeerSubAddress1.3.6.1.2.1.10.21.1.3.1.1.4DisplayStringread-onlyThe subaddress this call is connected to. If the subaddress is undefined or not available, this will be a zero length string.
INT callActivePeerId1.3.6.1.2.1.10.21.1.3.1.1.5INTEGERread-onlyThis 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 or is unknown, the value of this object will be zero.
INT callActivePeerIfIndex1.3.6.1.2.1.10.21.1.3.1.1.6INTEGERread-onlyThis 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 or is unknown, the value of this object will be zero.
NUM callActiveLogicalIfIndex1.3.6.1.2.1.10.21.1.3.1.1.7InterfaceIndexOrZeroread-onlyThis 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.
TIM callActiveConnectTime1.3.6.1.2.1.10.21.1.3.1.1.8TimeStampread-onlyThe value of sysUpTime when the call was connected. If the call is not connected, this object will have a value of zero.
INT callActiveCallState1.3.6.1.2.1.10.21.1.3.1.1.9INTEGERread-onlyThe current call state. unknown(1) - The call state is unknown. connecting(2) - A connection attempt (outgoing call) is being made. connected(3) - An incoming call is in the process of validation. active(4) - The call is active.
INT callActiveCallOrigin1.3.6.1.2.1.10.21.1.3.1.1.10INTEGERread-onlyThe call origin.
NUM callActiveChargedUnits1.3.6.1.2.1.10.21.1.3.1.1.11AbsoluteCounter32read-onlyThe 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 callActiveInfoType1.3.6.1.2.1.10.21.1.3.1.1.12INTEGERread-onlyThe information type for this call.
NUM callActiveTransmitPackets1.3.6.1.2.1.10.21.1.3.1.1.13AbsoluteCounter32read-onlyThe number of packets which were transmitted for this call.
NUM callActiveTransmitBytes1.3.6.1.2.1.10.21.1.3.1.1.14AbsoluteCounter32read-onlyThe number of bytes which were transmitted for this call.
NUM callActiveReceivePackets1.3.6.1.2.1.10.21.1.3.1.1.15AbsoluteCounter32read-onlyThe number of packets which were received for this call.
NUM callActiveReceiveBytes1.3.6.1.2.1.10.21.1.3.1.1.16AbsoluteCounter32read-onlyThe number of bytes which were received for this call.
callHistory1.3.6.1.2.1.10.21.1.4
INT callHistoryTableMaxLength1.3.6.1.2.1.10.21.1.4.1INTEGERread-writeThe upper limit on the number of entries that the callHistoryTable may contain. A value of 0 will prevent any history from being retained. When this table is full, the oldest entry will be deleted and the new one will be created.
INT callHistoryRetainTimer1.3.6.1.2.1.10.21.1.4.2INTEGERread-writeThe minimum amount of time that an callHistoryEntry will be maintained before being deleted. A value of 0 will prevent any history from being retained in the callHistoryTable, but will neither prevent callCompletion traps being generated nor affect other tables.
callHistoryTable1.3.6.1.2.1.10.21.1.4.3not-accessibleA table containing information about specific calls to a specific destination.
callHistoryEntry1.3.6.1.2.1.10.21.1.4.3.1not-accessibleThe information regarding a single Connection.
STR callHistoryPeerAddress1.3.6.1.2.1.10.21.1.4.3.1.1DisplayStringread-onlyThe number this call was connected to. If the number is not available, then it will have a length of zero.
STR callHistoryPeerSubAddress1.3.6.1.2.1.10.21.1.4.3.1.2DisplayStringread-onlyThe subaddress this call was connected to. If the subaddress is undefined or not available, this will be a zero length string.
INT callHistoryPeerId1.3.6.1.2.1.10.21.1.4.3.1.3INTEGERread-onlyThis 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 callHistoryPeerIfIndex1.3.6.1.2.1.10.21.1.4.3.1.4INTEGERread-onlyThis 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 callHistoryLogicalIfIndex1.3.6.1.2.1.10.21.1.4.3.1.5InterfaceIndexread-onlyThis 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.
OCT callHistoryDisconnectCause1.3.6.1.2.1.10.21.1.4.3.1.6OCTET STRINGread-onlyThe 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 callHistoryDisconnectText1.3.6.1.2.1.10.21.1.4.3.1.7DisplayStringread-onlyASCII 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 callHistoryConnectTime1.3.6.1.2.1.10.21.1.4.3.1.8TimeStampread-onlyThe value of sysUpTime when the call was connected.
TIM callHistoryDisconnectTime1.3.6.1.2.1.10.21.1.4.3.1.9TimeStampread-onlyThe value of sysUpTime when the call was disconnected.
INT callHistoryCallOrigin1.3.6.1.2.1.10.21.1.4.3.1.10INTEGERread-onlyThe call origin.
NUM callHistoryChargedUnits1.3.6.1.2.1.10.21.1.4.3.1.11AbsoluteCounter32read-onlyThe 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 callHistoryInfoType1.3.6.1.2.1.10.21.1.4.3.1.12INTEGERread-onlyThe information type for this call.
NUM callHistoryTransmitPackets1.3.6.1.2.1.10.21.1.4.3.1.13AbsoluteCounter32read-onlyThe number of packets which were transmitted while this call was active.
NUM callHistoryTransmitBytes1.3.6.1.2.1.10.21.1.4.3.1.14AbsoluteCounter32read-onlyThe number of bytes which were transmitted while this call was active.
NUM callHistoryReceivePackets1.3.6.1.2.1.10.21.1.4.3.1.15AbsoluteCounter32read-onlyThe number of packets which were received while this call was active.
NUM callHistoryReceiveBytes1.3.6.1.2.1.10.21.1.4.3.1.16AbsoluteCounter32read-onlyThe number of bytes which were received while this call was active.
dialControlMibTrapPrefix1.3.6.1.2.1.10.21.2
dialControlMibTraps1.3.6.1.2.1.10.21.2.0
NTF dialCtlPeerCallInformation1.3.6.1.2.1.10.21.2.0.1This trap/inform is sent to the manager whenever a successful call clears, or a failed call attempt is determined to have ultimately failed. In the event that call retry is active, then this is after all retry attempts have failed. However, only one such trap is sent in between successful call attempts; subsequent call attempts result in no trap. ifOperStatus will return the operational status of the virtual interface associated with the peer to whom this call was made to.
NTF dialCtlPeerCallSetup1.3.6.1.2.1.10.21.2.0.2This trap/inform is sent to the manager whenever a call setup message is received or sent. ifOperStatus will return the operational status of the virtual interface associated with the peer to whom this call was made to.
dialControlMibConformance1.3.6.1.2.1.10.21.3
dialControlMibCompliances1.3.6.1.2.1.10.21.3.1
dialControlMibCompliance1.3.6.1.2.1.10.21.3.1.1The compliance statement for entities which implement the DIAL CONTROL MIB
dialControlMibGroups1.3.6.1.2.1.10.21.3.2
dialControlGroup1.3.6.1.2.1.10.21.3.2.1A collection of objects providing the DIAL CONTROL capability.
callActiveGroup1.3.6.1.2.1.10.21.3.2.2A collection of objects providing the active call capability.
callHistoryGroup1.3.6.1.2.1.10.21.3.2.3A collection of objects providing the Call History capability.

FAQ

How is DIAL-CONTROL-MIB used to monitor an ISDN dial-on-demand backup link?
It exposes per-peer configuration such as accept mode, originate/answer addresses, sub-address, and link speed, letting an admin confirm a dial peer is set up to dial or answer correctly, and via associated call-active/call-history data, see whether calls are succeeding, failing, or flapping.

What role does DIAL-CONTROL-MIB play alongside the standard interfaces MIB when troubleshooting a WAN backup circuit?
It layers on top of ifTable from MIB-II/RFC 1573, adding dial-specific peer configuration and call-control data - like closed user group settings and dial control trap enablement - not present in the generic interface table, giving a fuller picture of a demand-access link's health.

RFC description

IETF standard MIB (RFC 2128) for managing dial-up connections including modems and ISDN interfaces.

Start monitoring Router/access server with ISDN/dial-on-demand WAN interface (vendor-neutral, RFC 2128) 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.

Download DIAL-CONTROL-MIB