G Pankaj G Bhagchandani, VoiceOver internet Protocol ,Pankaj G Bhagchandani,Pankaj G Bhagchandani G,

How to Configure IEC Options

This section contains the following procedures:

•Configuring IEC Options (optional)

•Verifying IEC Options (optional)

Configuring IEC Options

No configuration is required to enable the Cisco VoIP Internal Error Codes feature. Select the following optional configuration tasks:

•Enabling IEC Syslog Reporting

•Configuring Cause Code Mapping

•Troubleshooting Tips

Enabling IEC Syslog Reporting

This task enables IEC syslog reporting.

SUMMARY STEPS

1. enable

2. configure terminal

3. voice iec syslog

DETAILED STEPS

	Command or Action	Purpose
Step 1	enable Example: Router> enable	Enables privileged EXEC mode. •Enter your password if prompted.
Step 2	configure terminal Example: Router# configure terminal	Enters global configuration mode.
Step 3	voice iec syslog Example: Router(config)# voice iec syslog	(Optional) Enables syslog messages as IECs occur.

Configuring Cause Code Mapping

This task enables cause code mapping.

SUMMARY STEPS

1. enable

2. configure terminal

3. voice cause-code

4. error-category number q850-cause number

5. exit

DETAILED STEPS

	Command or Action	Purpose
Step 1	enable Example: Router> enable	Enables privileged EXEC mode. •Enter your password if prompted.
Step 2	configure terminal Router# configure terminal	Enters global configuration mode.
Step 3	voice cause-code Example: Router(config)# voice cause-code	(Optional) Enters voice cause-code configuration mode.
Step 4	error-category number q850-cause number Example: Router(conf-voice-cause)# error-category 128 q850-cause 27	(Optional) Specifies the values to be mapped. •Values for error-category range from 128 to 278. •Values for the Q.850 cause code range from 1 to 127.
Step 5	exit Example: Router(conf-voice-cause)# exit	Exits voice cause-code configuration mode.

Troubleshooting Tips

The IEC feature is itself a troubleshooting tool. By enabling the voice iec syslog command you can display IECs logged in real time, which allows you to isolate a failure cause without turning on debugging. Then, based on the IEC reported, you can selectively enable the appropriate debug tool to gather additional information.

The IEC feature also provides a Cisco.com diagnostic tool that allows you to enter an IEC dotted string and receive an explanation of the component fields. The explanation includes a description of the problem, and depending upon the error type, a recommended course of action. Use the IEC lookup tool at http://www.cisco.com/univercd/cc/td/doc/product/voice/vtgemd.htm.

To troubleshoot specific subsystems that do not generate corresponding IECs, use the following debug and show commands:

•To learn whether the ISDN link is up or down, use the show isdn status command.

•To display information about whether the ISDN link is receiving SETUP, CALLPRO, ALERT, CONNECT, and RELEASE COMPLETE messages, use the debug isdn q931 command.

•To display information about H.225 and RAS messages exchanged between a gateway and gatekeeper, use the debug h225 asn1 command. H.225 debug output for the terminating side, in the initial stage when a setup message is being received, provides an indication if messages are being received from the IP side and if H.323 service is operational. If the H.225 connection is not established from the incoming side, then no IECs are generated.

What to Do Next

Proceed to the section "Verifying IEC Options."

New and Modified Configuration Commands for Gatekeeper IECs in Cisco IOS Release 12.4(4)T

To enable the enhanced capabilities of the gatekeeper-specific IECs in Release 12.4(4)T, there is one new command and one modified command. This section describes only the new information. For complete information on the commands for voice gateways and gatekeepers, refer to the Cisco IOS Voice Configuration Library on Cisco.com.

This release introduces a new command for the gatekeeper configuration that causes retention of call history and enables you to specify the number of records to be kept in the history table.

In gatekeeper configuration mode, enter:

gatekeeper(config)# call-history max-size number

The number argument in this syntax can be any number from 0 to 1200. The default is 15. This represents the maximum number of records of old calls to be stored and available for display.

To display the historical information, enter the following command on the gatekeeper:

gatekeeper# show gatekeeper calls history

This command has been modified with the addition of the history keyword. This keyword was added to display call history information along with internal error codes at the gatekeeper. The number of disconnected calls displayed in response to this command is the number value specified in the call-history max-size number command. Use of this max-size number helps to reduce excessive CPU usage in the storage and reporting of this information.

Verifying IEC Options

You can use show command output to display IEC option configuration, to verify that the feature is working, and to display IEC counter information.

Prerequisites

Before you can display IEC counter information, you must configure voice statistics settings.

SUMMARY STEPS

1. enable

2. voice statistics type iec

3. voice statistics max-storage-duration {day number-of-days | hour number-of-hours | minute number-of-minutes}

4. voice statistics time-range periodic interval-length [start hh:mm] [end hh:mm] [days-of-week days]

5. voice statistics time-range since-reset

DETAILED STEPS

	Command or Action	Purpose
Step 1	enable Example: Router> enable	Enables privileged EXEC mode. •Enter your password if prompted.
Step 2	voice statistics type iec Example: Router# voice statistics type iec	(Optional) Configures the collection of IEC statistics.
Step 3	voice statistics max-storage-duration {day number-of-days| hour number-of-hours | minute number-of-minutes} Example: Router# voice statistics max-storage-duration day 1	(Optional) Configures how long interval counters are kept for display. •If you want to display counters for past intervals, you must configure a storage duration for expired counters. Otherwise, once the interval has expired, the counters are no longer available.
Step 4	voice statistics time-range periodic interval-length [start hh:mm] [end hh:mm] [days-of-week days] Example: Router# voice statistics time-range periodic 30minutes	(Optional) Specifies IEC collection intervals. •The interval-length argument takes one of the following values: –5minutes –15minutes –30minutes –60minutes –1day •The range for hh:mm is 00:00 to 23:59. The default for the start keyword is 00:00. The default for the end keyword is 00:00. •The days argument takes one of the following values: –friday—Friday –monday—Monday –saturday—Saturday –sunday—Sunday –thursday—Thursday –tuesday—Tuesday –wednesday—Wednesday –daily—Every day of the week –weekdays—Monday thru Friday –weekend—Saturday and Sunday The default is daily.
Step 5	voice statistics time-range since-reset Example: Router# voice statistics time-range since-reset	(Optional) Enables the collection of call statistics information accumulated since the last resetting of IEC counters.