CISCO-VOICE-TONE-CADENCE-MIB

All MIBs › CISCO-VOICE-TONE-CADENCE-MIB

Organization: Cisco Systems, Inc.

Last Updated: 2003-05-28

Category: Telephony and VoIP, Vendor: Cisco Devices

Description: Manages Cisco voice tone and cadence plans defining call progress tones for telephony signaling.

Start monitoring vendor-neutral, standards-based MIB, any SNMPv3-capable network device (SNMP engine identity/boot/clock status) 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.

What Is CISCO-VOICE-TONE-CADENCE-MIB?

CISCO-VOICE-TONE-CADENCE-MIB is a Cisco voice-gateway MIB that manages programmable call-progress tone plans (dial tone, busy tone, ring-back tone) as specified by ITU-T E.180, used in telephony signaling on Cisco voice equipment. It exposes tone-plan configuration data -- per-country tone plan files, versions, storage type, and individual tone IDs with their frequency/cadence/amplitude/duration attributes. Its monitoring value is primarily configuration-status focused rather than hardware health -- cvtcTonePlanRowStatus and cvtcTonePlanVersion let an operator confirm the correct country-specific tone plan file is loaded and active on a voice gateway, verifying the software configuration driving call-progress tone generation is correct and up to date. It is built on ITU-T E.180 Supplement 2 tone specifications and is part of Cisco's broader voice/telephony enterprise MIB suite, likely used alongside other Cisco voice gateway MIBs for call signaling. It is deployed on Cisco voice gateways and routers with voice interface cards in telephony/VoIP environments requiring country-specific call-progress tone generation, where engineers can complete a CISCO-VOICE-TONE-CADENCE-MIB download to load it into their MIB browser.

IPNetwork Monitor allows you to monitor SNMP objects defined in CISCO-VOICE-TONE-CADENCE-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.

Supported Devices

Cisco voice gateway/router with voice interface

Monitoring Examples

An administrator would poll cvtcTonePlanTable/cvtcTonePlanEntry, keyed by cvtcTonePlanId, to check cvtcTonePlanCountry, cvtcTonePlanVersion, and cvtcTonePlanFileName, confirming the gateway has loaded the correct tone plan for its deployed country and that cvtcTonePlanRowStatus shows the entry as active. Checking cvtcToneIdTable/cvtcToneIdEntry for a given cvtcToneId would reveal whether a specific tone (e.g., busy tone) is defined and correctly attributed to the loaded plan, helping diagnose a misconfigured or missing tone definition causing incorrect call-progress signaling.

What Can Be Monitored

loaded tone plan country/version
tone plan file name and storage type
tone plan row status
individual tone ID definitions

Imported Objects

From CISCO-MEDIA-GATEWAY-MIB

CVoiceTonePlanIndex
cmgwIndex	OBJECT-TYPE

From CISCO-SMI

ciscoMgmt

OBJECT-IDENTITY

From CISCO-TC

CountryCode

From SNMP-FRAMEWORK-MIB

SnmpAdminString

From SNMPv2-CONF

MODULE-COMPLIANCE
OBJECT-GROUP

From SNMPv2-SMI

Gauge32
MODULE-IDENTITY
OBJECT-TYPE
Unsigned32

From SNMPv2-TC

RowStatus
StorageType
TEXTUAL-CONVENTION

How to Use in IPNetwork Monitor

Example using cvtcTonePlanVifCount OID:

Select a Cisco voice gateway/router with voice interface (tone plans) as the target host to create a monitor — the SNMP service should be up and running on it. Click New Monitor, then check SNMP Custom on the Favorites tab, click Next, and confirm the host. On the next page, click Select... to open the built-in SNMP MIB Browser and type cvtcTonePlanVifCount into the Find box to locate it in the OID tree, selecting the specific row/instance you want to monitor since this is a table column, then select it and click OK. This object indicates the number of voice interfaces are using the tone plan. On the monitor's Main parameters page you can set the target's SNMP port (default 161), credentials, polling interval, and other settings — see the SNMP Monitor help for details. On the State conditions and Alerting tabs, configure when the monitor should change state and trigger an alert; since this is a Gauge32-type OID, Value bounds is the most useful condition here — trigger an alert if the counter increases sharply between polls relative to its normal baseline, since an unexpected spike often reflects a real change in traffic or activity. Click Finish to create the monitor; you can adjust any parameter later.

OIDs

OID symbolic	OID numeric	Type	Access	Description
ciscoVoiceToneCadenceMIB	1.3.6.1.4.1.9.9.356			The MIB defines the attributes of the programmable tones specified in ITU-T E.180 Supplement 2. Each country has its own regulation to the generation and detection of the call progressing tones such as dial tone, busy tone, ring back tone. The tone attributes are programmable, for example frequency, amplitude, cadence and duration of the tone.
ciscoVoiceToneCadenceMIBNotifs	1.3.6.1.4.1.9.9.356.0
ciscoVoiceToneCadenceMIBObjects	1.3.6.1.4.1.9.9.356.1
cVoiceToneCadenceConfig	1.3.6.1.4.1.9.9.356.1.1
cvtcTonePlanTable	1.3.6.1.4.1.9.9.356.1.1.1		not-accessible	This table contains the configuration of tone plans for the programmable tones in different countries.
cvtcTonePlanEntry	1.3.6.1.4.1.9.9.356.1.1.1.1		not-accessible	An entry represents one tone plan which defines attributes of the programmable tones for a country. Each country can have more than one tone plans with different version. Each entry should have the unique combination of cvtcTonePlanCountry and cvtcTonePlanVersion. There are some system built-in tone plans. The built-in tone plans will be populated by the system automatically at the system start-up. They can not be created, deleted or modified by user. When an entry is created, the following objects must be provided: cvtcTonePlanCountry, cvtcTonePlanVersion, cvtcTonePlanFileName When an entry is active, it can not be modified. A system built-in tone plan can not be deleted. Only the entries added by user can be deleted.
CVO cvtcTonePlanId	1.3.6.1.4.1.9.9.356.1.1.1.1.1	CVoiceTonePlanIndex	not-accessible	This object uniquely identifies the tone plan in the table.
G32 cvtcTonePlanVifCountEx	1.3.6.1.4.1.9.9.356.1.1.1.1.2	Gauge32	read-only	This object indicates the number of voice interfaces are using the tone plan.
COU cvtcTonePlanCountry	1.3.6.1.4.1.9.9.356.1.1.1.1.3	CountryCode	read-create	This object specifies the country code (defined in ISO-3166) of the country that the tone plan is used for. The country specified by the country code should be registered in ITU E.180 Supplement 2. Any other entry in this table may have the identical country code, but the combination of cvtcTonePlanCountry and cvtcTonePlanVersion must be unique.
U32 cvtcTonePlanVersion	1.3.6.1.4.1.9.9.356.1.1.1.1.4	Unsigned32	read-create	This object specifies the version of the tone plan for a country. One country may have many tone plans, therefore they may have the same country name, but the combination of cvtcTonePlanCountry and cvtcTonePlanVersion must be unique.
STR cvtcTonePlanFileName	1.3.6.1.4.1.9.9.356.1.1.1.1.5	SnmpAdminString	read-create	This object specifies the valid file name stored on the media gateway's harddisk. The tone plan file can be transferred to the media gateway via FTP text file transfer mechanism. When creating a conceptual row, the tone plan file must be transferred to the media gateway already. If the entry is a built-in tone plan predefined in system, then this object will have the value of 'BUILT-IN'. Other provision-able tone plan files are not allowed to have the string 'BUILT-IN' as their names.
STO cvtcTonePlanStorageType	1.3.6.1.4.1.9.9.356.1.1.1.1.6	StorageType	read-only	This object specifies the storage type for this conceptual row. If this conceptual row represents a system built-in tone plan, the value of this object is readOnly (5). If this conceptual row represents an user defined tone plan, the value of this object is nonVolatile (3). The built-in tone plans will be added by the system automatically at the system start-up. They can not be added, deleted or modified by user.
ROW cvtcTonePlanRowStatus	1.3.6.1.4.1.9.9.356.1.1.1.1.7	RowStatus	read-create	The entries for The system built-in tone plans will be added by the system at start-up, they can not be added, modified or deleted by user.
cvtcToneIdTable	1.3.6.1.4.1.9.9.356.1.1.2		not-accessible	This table contains the identification of the programmable tones.
cvtcToneIdEntry	1.3.6.1.4.1.9.9.356.1.1.2.1		not-accessible	An entry represents the identification for one programmable tone in a tone plan.
U32 cvtcToneId	1.3.6.1.4.1.9.9.356.1.1.2.1.1	Unsigned32	not-accessible	This object uniquely identifies the programmable tone in a tone plan.
STR cvtcToneName	1.3.6.1.4.1.9.9.356.1.1.2.1.2	SnmpAdminString	read-create	This object specified the name of the programmable tone.
ROW cvtcToneIdRowStatus	1.3.6.1.4.1.9.9.356.1.1.2.1.3	RowStatus	read-create	The entries for ITU defined tones will be added by the system at start-up.
cvtcProgrammableToneTable	1.3.6.1.4.1.9.9.356.1.1.3		not-accessible	This table contains the configurable attributes of the programmable tones for tone plan.
cvtcProgrammableToneEntry	1.3.6.1.4.1.9.9.356.1.1.3.1		not-accessible	An entry represents the configurable attributes for one programmable tone in a tone plan. The tone attributes are specified in ITU E.180 Supplement 2.
CTO cvtcProgrammableToneFrequency	1.3.6.1.4.1.9.9.356.1.1.3.1.1	CToneFrequency	read-create	This object specified the frequency of the tone to be played or detected.
CTO cvtcProgrammableToneAmplitude	1.3.6.1.4.1.9.9.356.1.1.3.1.2	CToneAmplitude	read-create	This object specified the amplitude expression of the tone to be played or detected.
CTO cvtcProgrammableToneCadence	1.3.6.1.4.1.9.9.356.1.1.3.1.3	CToneCadence	read-create	This object specified the cadence of the tone to be played or detected.
U32 cvtcProgrammableToneDuration	1.3.6.1.4.1.9.9.356.1.1.3.1.4	Unsigned32	read-create	This object specified the duration of the tone will be played. The value of 0 indicates that the tone will be played infinitely unless interrupted.
STO cvtcProgrammableToneStorageType	1.3.6.1.4.1.9.9.356.1.1.3.1.5	StorageType	read-create	This object specifies the storage type for this conceptual row. If this conceptual row represents a programmable tone in a system built-in tone plan, the value of this object is permanent (4). If this conceptual row represents a programmable tone in an user defined tone plan, the value of this object is nonVolatile (3). If the value of this object is permanent (4), cvtcProgrammableToneDuration is the only object can be modified by the user.
ROW cvtcProgrammableToneRowStatus	1.3.6.1.4.1.9.9.356.1.1.3.1.6	RowStatus	read-create	This object is used to add, delete or modify the entry of the table. When an entry is created, the following objects have to be provided: cvtcProgrammableToneFrequency, cvtcProgrammableToneAmplitude, cvtcProgrammableToneCadence.
ciscoVoiceToneCadenceMIBConform	1.3.6.1.4.1.9.9.356.3
cVoiceToneCadenceCompliances	1.3.6.1.4.1.9.9.356.3.1
cVoiceToneCadenceCompliance	1.3.6.1.4.1.9.9.356.3.1.1			The compliance statement for entities which implement the CISCO-VOICE-TONE-CADENCE-MIB
cVoiceToneCadenceGroups	1.3.6.1.4.1.9.9.356.3.2
cvtcToneConfigGroup	1.3.6.1.4.1.9.9.356.3.2.1			The collection of objects providing programmable tones and tone plans.

RFC description

Manages programmable tone attributes (frequency, amplitude, cadence) for voice gateways per ITU-T.

Start monitoring Cisco voice gateway/router with voice interface (tone plans) 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 CISCO-VOICE-TONE-CADENCE-MIB