Pankaj G Bhagchandani G, Voice over internet protocol G Pankaj G Bhagchandani, pankaj Bhagchandani G: 2014

Displaying IEC Options

Perform this task to verify that the Cisco VoIP Internal Error Codes feature is working.

SUMMARY STEPS

enable

show running-config

show voice cause-code category-q850

show voice iec description string

show voice statistics iec {interval number | since-reboot | since-reset}

clear voice statistics iec

DETAILED STEPS


	Command or Action	Purpose
Step 1	enable Example: Router> enable	Enables privileged EXEC mode. •Enter your password if prompted.
Step 2	show running-config Example: Router# show running-config	(Optional) Displays the configuration information currently running on the router.
Step 3	show voice cause-code category-q850 Example: Router# show voice cause-code category-q850	(Optional) Displays Q.850 cause code mapping.
Step 4	show voice iec description string Example: Router# show voice iec description 1.1.128.1.5.0	(Optional) Displays an IEC description.
Step 5	show voice statistics iec {interval number\| since-reboot\|since-reset} Example: Router# show voice statistics iec interval 15	(Optional) Displays IEC statistics. •Specify the following displays: statistics by selected time interval, or statistics since the last router reboot, or statistics since the last instance when counters were cleared.
Step 6	clear voice statistics iec Example: Router# clear voice statistics iec	(Optional) Resets IEC counters.

Configuration Examples for Cisco VoIP Internal Error Codes

This section provides configuration examples for the tasks identified in the previous section.

•

Enabling IEC Syslog Reporting and Configuring Cause Code Mapping: Example

•

Verifying IEC Configuration: Example

Enabling IEC Syslog Reporting and Configuring Cause Code Mapping: Example

In the following example, IEC syslog reporting and cause-code mapping are enabled:

enable

configure terminal

voice iec syslog

voice cause-code

error-category 128 q850-cause 27

Verifying IEC Configuration: Example

In the following examples, the output is displayed for each command used to verify IEC configuration:

Sample Output from the show running-config Command: Example

Router# show running-config

Building configuration...

Current configuration :2791 bytes

version 12.2

no parser cache

no service pad

service timestamps debug uptime

service timestamps log uptime

no service password-encryption

service internal

hostname GW-1

no boot startup-test

resource-pool disable

spe default-firmware spe-firmware-1

aaa new-model

aaa group server radius h323

aaa authentication login h323 group radius group h323

aaa authorization config-commands

aaa authorization exec h323 group h323

aaa accounting connection h323 start-stop group radius group h323

aaa session-id common

isdn switch-type primary-5ess

The following lines show optional IEC configuration information:

voice iec syslog

voice cause-code

 error-category 128 q850-cause 27

 error-category 129 q850-cause 38

controller T1 3/0

 framing esf

 linecode b8zs

 pri-group timeslots 1-24

controller T1 3/1

 shutdown

 framing sf

 linecode ami

gw-accounting aaa

interface FastEthernet0/0

 ip address 172.18.195.28 255.255.255.0

 no ip route-cache

 no ip mroute-cache

 duplex full

 speed 100

 no cdp enable

 h323-gateway voip interface

 h323-gateway voip id GK-1 ipaddr 172.18.195.41 1718

 h323-gateway voip h323-id GW-1

interface FastEthernet0/1

 no ip address

 no ip route-cache

 no ip mroute-cache

 shutdown

 duplex auto

 speed auto

 no cdp enable

interface Serial0/0

 no ip address

 no ip route-cache

 no ip mroute-cache

 shutdown

 clockrate 2000000

 no cdp enable

interface Serial0/1

 no ip address

 no ip route-cache

 no ip mroute-cache

 shutdown

 clockrate 2000000

 no cdp enable

interface Serial3/0:23

 no ip address

 dialer-group 1

 isdn switch-type primary-5ess

 isdn incoming-voice modem

 no cdp enable

ip classless

ip route 0.0.0.0 0.0.0.0 172.18.195.1

no ip http server

radius-server host 172.18.200.222 auth-port 1645 acct-port 1646

radius-server key lab

radius-server authorization permit missing Service-Type

radius-server vsa send accounting

call rsvp-sync

voice-port 3/0:D

mgcp profile default

dial-peer cor custom

dial-peer voice 100 pots

 destination-pattern 1#919....

 direct-inward-dial

 port 3/0:D

 prefix 919

dial-peer voice 301 voip

 destination-pattern 7190003

 session target ras

gateway

line con 0

 exec-timeout 0 0

 logging synchronous

line aux 0

 logging synchronous

line vty 0 4

 password lab

line 1/00 1/59

 no flush-at-activation

 modem InOut

scheduler allocate 10000 400

end

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

enable

configure terminal

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

enable

configure terminal

voice cause-code

error-category number q850-cause number

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

enable

voice statistics type iec

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

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

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.