Cisco IOS Voice Command Reference
Commands: show dial-peer video through show gatekeeper zone status

Table Of Contents

show dial-peer video

show dial-peer voice

show dialplan dialpeer

show dialplan incall

show dialplan incall uri

show dialplan in-carrier

show dialplan in-trunk-group-label

show dialplan number

show dialplan uri

show dspfarm

show dspfarm profile

show event-manager consumers

show frame-relay vofr

show gatekeeper calls

show gatekeeper circuits

show gatekeeper cluster

show gatekeeper endpoint circuits

show gatekeeper endpoints

show gatekeeper gw-type-prefix

show gatekeeper performance statistics

show gatekeeper servers

show gatekeeper status

show gatekeeper status cluster

show gatekeeper zone cluster

show gatekeeper zone prefix

show gatekeeper zone status


show dial-peer video

To display configuration information for video dial peers, use the show dial-peer video command in privileged EXEC mode.

show dial-peer video [number] [summary]

Syntax Description

number

(Optional) A specific video dial peer. Output displays information about that dial peer.

summary

(Optional) Output displays a one-line summary of each video dial peer.


Defaults

If both the name argument and summary keyword are omitted, command output displays detailed information about all video dial peers.

Command Modes

Privileged EXEC

Command History

Release
Modification

12.0(5)XK

This command was introduced on the Cisco MC3810.

12.0(7)T

This command was integrated into Cisco IOS Release 12.0(7)T.


Usage Guidelines

Use this command to display the configuration for all video dial peers configured for a router. To show configuration information for only one specific dial peer, use the number argument to identify the dial peer.

Examples

The following sample output displays detailed information about all configured video dial peers:

Router# show dial-peer video

Video Dial-Peer 1
      type = videocodec, destination-pattern = 111
      port signal = 1/0, port media = Serial1
      nsap = 47.0091810000000050E201B101.00107B09C6F2.C8
Video Dial-Peer 2
      type = videoatm,   destination-pattern = 222
      session-target = ATM0 svc nsap 47.0091810000000050E201B101.00E01E92ADC2.C8
Video Dial-Peer 3
      type = videoatm,   destination-pattern = 333
      session-target = ATM0 pvc 70/70

show dial-peer voice

To display information for voice dial peers, use the show dial-peer voice command in user EXEC or privileged EXEC mode.

show dial-peer voice [number | summary]

Syntax Description

number

(Optional) A specific voice dial peer. Output displays detailed information about that dial peer.

summary

(Optional) Output displays a short summary of each voice dial peer.


Command Default

If both the name argument and summary keyword are omitted, output displays detailed information about all voice dial peers.

Command Modes

User EXEC
Privileged EXEC

Command History

Release
Modification

11.3(1)T

This command was introduced.

11.3(1)MA

The summary keyword was added for Cisco MC3810.

12.0(3)XG

This command was implemented for Voice over Frame Relay (VoFR) on the Cisco 2600 series and Cisco 3600 series.

12.0(4)T

This command was implemented for VoFR on the Cisco 7200 series.

12.1(3)T

This command was implemented for Modem Passthrough over VoIP on the Cisco AS5300.

12.2(2)XB

This command was modified to support VoiceXML applications.

12.2(4)T

This command was implemented on the Cisco 1750.

12.2(8)T

This command was implemented on the Cisco 1751, Cisco 2600 series, Cisco 3600 series, Cisco 3725, and Cisco 3745.

12.2(2)XN

Support for enhanced MGCP voice gateway interoperability was added to Cisco CallManager 3.1 for the Cisco 2600 series, Cisco 3600 series, and Cisco VG200.

12.2(11)T

This command was integrated into Cisco IOS Release 12.2(11)T and Cisco CallManager 3.2 and implemented on the and Cisco IAD2420.

12.4(11)T

This command was enhanced to display configuration information for bandwidth, video codec, and rtp payload-type for H.263+ and H.264 video codec.


Usage Guidelines

Use this command to display the configuration for all VoIP and POTS dial peers configured for a gateway. To show configuration information for only one specific dial peer, use the number argument to identify the dial peer. To show summary information for all dial peers, use the summary keyword.

Examples

The following is sample output from the show dial-peer voice command for a POTS dial peer:

Router# show dial-peer voice 100

VoiceEncapPeer3201
peer type = voice, information type = video,
description = `',
tag = 3201, destination-pattern = `86001',
answer-address = `', preference=0,
CLID Restriction = None
CLID Network Number = `'
CLID Second Number sent 
CLID Override RDNIS = disabled,
source carrier-id = `',	target carrier-id = `',
source trunk-group-label = `',	target trunk-group-label = `',
numbering Type = `unknown'
group = 3201, Admin state is up, Operation state is up,
Outbound state is up,
incoming called-number = `', connections/maximum = 0/unlimited,
DTMF Relay = disabled,
URI classes:
	    Destination = 
huntstop = disabled,
in bound application associated: 'DEFAULT'
out bound application associated: ''
dnis-map = 
permission :both
        incoming COR list:maximum capability
outgoing COR list:minimum requirement
Translation profile (Incoming):
Translation profile (Outgoing):
incoming call blocking:
translation-profile = `'
disconnect-cause = `no-service'
advertise 0x40 capacity_update_timer 25 addrFamily 4 oldAddrFamily 4
type = pots, prefix = `',
forward-digits 4
session-target = `', voice-port = `2/0:23',
direct-inward-dial = enabled,
digit_strip = enabled,
register E.164 number with H323 GK and/or SIP Registrar = TRUE
fax rate = system,   payload size =  20 bytes
supported-language = ''
preemption level = `routine'
bandwidth:
	    maximum = 384 KBits/sec, minimum = 64 KBits/sec
voice class called-number:
	    inbound = `', outbound = `1'
Time elapsed since last clearing of voice call statistics never
        Connect Time = 0, Charged Units = 0,
Successful Calls = 0, Failed Calls = 0, Incomplete Calls = 0
Accepted Calls = 0, Refused Calls = 0,
Last Disconnect Cause is "",
Last Disconnect Text is "",
Last Setup Time = 0.

The following is sample output from this command for a VoIP dial peer:

Router# show dial-peer voice 101

VoiceOverIpPeer101
        peer type = voice, information type = voice,
        description = `',
        tag = 6001, destination-pattern = `6001',
        answer-address = `', preference=0,
        CLID Restriction = None
        CLID Network Number = `'
        CLID Second Number sent 
        CLID Override RDNIS = disabled,
        source carrier-id = `', target carrier-id = `',
        source trunk-group-label = `',  target trunk-group-label = `',
        numbering Type = `unknown'
        group = 6001, Admin state is up, Operation state is up,
        incoming called-number = `', connections/maximum = 0/unlimited,
        DTMF Relay = disabled,
        modem transport = system,
        URI classes:
            Incoming (Called) = 
            Incoming (Calling) = 
            Destination = 
        huntstop = disabled,
        in bound application associated: 'DEFAULT'
        out bound application associated: ''
        dnis-map = 
        permission :both
        incoming COR list:maximum capability
        outgoing COR list:minimum requirement
        Translation profile (Incoming):
        Translation profile (Outgoing):
        incoming call blocking:
        translation-profile = `'
        disconnect-cause = `no-service'
        advertise 0x40 capacity_update_timer 25 addrFamily 4 oldAddrFamily 4
        type = voip, session-target = `ipv4:1.7.50.50',
        technology prefix: 
        settle-call = disabled
        ip media DSCP = ef, ip signaling DSCP = af31,
        ip video rsvp-none DSCP = af41,ip video rsvp-pass DSCP = af41
        ip video rsvp-fail DSCP = af41,
        UDP checksum = disabled,
        session-protocol = cisco, session-transport = system,
        req-qos = best-effort, acc-qos = best-effort,
        req-qos video = best-effort, acc-qos video = best-effort,
        req-qos audio def bandwidth = 64, req-qos audio max bandwidth = 0,
        req-qos video def bandwidth = 384, req-qos video max bandwidth = 0, 
        RTP dynamic payload type values: NTE = 101
        Cisco: NSE=100, fax=96, fax-ack=97, dtmf=121, fax-relay=122
               CAS=123, ClearChan=125, PCM switch over u-law=0,A-law=8
               h263+=118, h264=119
        RTP comfort noise payload type = 19
        fax rate = fax,   payload size =  20 bytes
        fax protocol = system
        fax-relay ecm enable
        fax NSF = 0xAD0051 (default)
        codec = g711ulaw,   payload size =  160 bytes,
        video codec = h263+
        voice class codec = `'
        Media Setting = flow-through (global)
        Expect factor = 10, Icpif = 20,
        Playout Mode is set to adaptive,
        Initial 60 ms, Max 250 ms
        Playout-delay Minimum mode is set to default, value 40 ms 
        Fax nominal 300 ms
        Max Redirects = 1, signaling-type = cas,
        VAD = enabled, Poor QOV Trap = disabled, 
        Source Interface = NONE
        voice class sip url = system,
        voice class sip rel1xx = system,
        redirect ip2ip = disabled
        probe disabled,
        voice class perm tag = `'
        Time elapsed since last clearing of voice call statistics never
        Connect Time = 0, Charged Units = 0,
        Successful Calls = 0, Failed Calls = 0, Incomplete Calls = 0
        Accepted Calls = 0, Refused Calls = 0,
        Last Disconnect Cause is "",
        Last Disconnect Text is "",
        Last Setup Time = 0.

Table 87 describes significant fields shown in this output.

Table 87 show dial-peer voice Field Descriptions 

Field
Description

Accepted Calls

Number of calls accepted from this peer since system startup.

acc-qos

Lowest acceptable quality of service configured for calls for this peer.

Admin state

Administrative state of this peer.

answer-address

Answer address configured for this dial peer.

bandwidth maximum/minimum

The maximum and minimum bandwidth.

Charged Units

Total number of charging units that have applied to this peer since system startup, in hundredths of a second.

CLID Restriction

Indicates if CLID restriction is enabled.

CLID Network Number

Displays the network number sent as CLID, if configured.

CLID Second Number sent

Displays whether a second calling number is stripped from the call setup.

CLID Override RDNIS

Indicates whether the CLID is overridden by the redirecting number.

codec

Default voice codec rate of speech.

Connect Time

Accumulated connect time to the peer since system startup for both incoming and outgoing calls, in hundredths of a second.

connections/maximum

Indicates maximum call connections per peer

Destination

Indicates the voice class which is used to match destination url

destination-pattern

Destination pattern (telephone number) for this peer.

digit_strip

Indicates if digit stripping is enabled.

direct-inward-dial

Indicates if direct-inward-dial is enabled.

disconnect-cause

Indicates the disconnect cause code to be used when an incoming call is blocked

dnis-map

Name of the dialed-number identification service (DNIS) map.

DTMF Relay

Indicates if dual-tone multifrequency (DTMF) relay is enabled.

Expect factor

User-requested expectation factor of voice quality for calls through this peer.

Failed Calls

Number of failed call attempts to this peer since system startup.

fax rate

Fax transmission rate configured for this peer.

forward-digits

Indicates the destination digits to be forwarded of this peer

group

Group number associated with this peer.

huntstop

Indicates whether dial-peer hunting is turned on, by using the huntstop command, for this dial peer.

Icpif

Configured calculated planning impairment factor (ICPIF) value for calls sent by a dial peer.

in bound application associated

Interactive voice response (IVR) application that is configured to handle inbound calls to this dial peer.

incall-number

Full E.164 telephone number to be used to identify the dial peer.

incoming call blocking

Indicates the incoming call blocking setup of this peer

incoming called-number

Indicates the incoming called number if it has been set.

incoming COR list

Indicates the level of Class of Restrictions for incoming calls of this peer

Incomplete calls

Indicates number of outgoing disconnected calls with user busy (17), no user response (18) or no answer (19) cause code

information type

Information type for this call (voice, fax, video)

Last Disconnect Cause

Encoded network cause associated with the last call. This value is updated whenever a call is started or cleared and depends on the interface type and session protocol being used on this interface.

Last Disconnect Text

ASCII text describing the reason for the last call termination.

Last Setup Time

Value of the system uptime when the last call to this peer was started.

Modem passthrough

Modem pass-through signaling method is named signaling event (NSE).

numbering type

Indicates the numbering type for a peer call leg

Operation state

Operational state of this peer.

outgoing COR list

Indicates the level of Class of Restrictions for outgoing calls of this peer

outbound application associated

The voice application that is configured to handle outbound calls from this dial peer. Outbound calls are handed off to the named application.

Outbound state

Indicates the current outbound status of a POTS peer

payload size

Indicates the size of payload of fax rate or codec setup

Payload type

NSE payload type.

peer type

Dial peer type (voice, data).

permission

Configured permission level for this peer.

Poor QOV Trap

Indicates if poor quality of voice trap messages is enabled.

preemption level

Indicates the call preemption level of this peer

prefix

Indicates dialed digits prefix of this peer

Redundancy

Packet redundancy (RFC 2198) for modem traffic.

Refused Calls

Number of calls from this peer refused since system startup.

register E.164 number with H.323 GK and/or SIP Registrar

Indicates "register e.164" option of this peer

req-qos

Configured requested quality of service for calls for this dial peer.

session-target

Session target of this peer.

sess-proto

Session protocol to be used for Internet calls between local and remote routers through the IP backbone.

source carrier-id

Indicates source carrier-id of this peer which will be used to match the source carrier-id of an incoming call

source trunk-group label

Indicates source trunk-group-label of this peer which can be used to match the source trunk-group-label of an incoming call

Successful Calls

Number of completed calls to this peer.

supported-language

Indicates list of supported languages of this peer

tag

Unique dial peer ID number.

target carrier-id

Indicates target carrier-id of this peer which will be used to match the target carrier-id for an outgoing call

target trunkgroup label

Indicates target trunk-group-label of this peer which can be used to match the target trunk-group-label of an outgoing call

Time elapsed since last clearing of voice call statistics

Elapsed time between the current time and the time when the
"clear dial-peer voice" command was executed

Translation profile (Incoming)

Indicate translation profile for incoming calls

Translation profile (Outgoing)

Indicate translation profile for outgoing calls

translation-profile

Indicate number translation profile of this peer

type

Indicate peer encapsulation type such as pots, voip, vofr, voatm or mmoip

VAD

Whether voice activation detection (VAD) is enabled for this dial peer.

voice class called-number inbound/outbound

Indicates voice-class called-number inbound or outbound setup of this peer

voice-port

Indicates the voice interface setting of this POTS peer


The following is sample output from this command with the summary keyword:

Router# show dial-peer voice summary

dial-peer hunt 0
                                                      PASS
  TAG TYPE   ADMIN OPER PREFIX   DEST-PATTERN     PREF THRU SESS-TARGET    PORT
  100 pots   up    up                              0
  101 voip   up    up            5550112           0   syst ipv4:10.10.1.1
  102 voip   up    up            5550134           0   syst ipv4:10.10.1.1
   99 voip   up    down                            0   syst
   33 pots   up    down                            0

Table 88 describes significant fields shown in this output.

Table 88 show dial-peer voice summary Field Descriptions

Field
Description

dial-peer hunt

Hunt group selection order that is defined for the dial peer by using the dial-peer hunt command.

TAG

Unique identifier assigned to the dial peer when it was created.

TYPE

Type of dial peer: POTS, VoIP, VoFR, VoATM, or MMoIP.

ADMIN

Whether the administrative state is up or down.

OPER

Whether the operational state is up or down.

PREFIX

Prefix that is configured in the dial peer by using the prefix command.

DEST-PATTERN

Destination pattern that is configured in the dial peer by using the destination-pattern command.

PREF

Hunt group preference that is configured in the dial peer by using the preference command.

PASS THRU

Modem pass-through method that is configured in the dial peer by using the modem passthrough command.

SESS-TARGET

Destination that is configured in the dial peer by using the session target command.

PORT

Router voice port that is configured for the dial peer. Valid only for POTS dial peers.


Related Commands

Command
Description

show call active voice

Displays the VoIP active call table.

show call history voice

Displays the VoIP call history table.

show dialplan incall number

Displays which POTS dial peer is matched for a specific calling number or voice port.

show dialplan number

Displays which dial peer is reached when a specific telephone number is dialed.

show num-exp

Displays how the number expansions are configured in VoIP.

show voice port

Displays configuration information about a specific voice port.


show dialplan dialpeer

To display the outbound dial peers that are matched to an incoming dial peer based on the class of restriction (COR) criteria and the dialed number, use the show dialplan dialpeer command in privileged EXEC mode.

show dialplan dialpeer incoming-dialpeer-tag number number [timeout]

Syntax Description

incoming-dialpeer-tag

The dial peer COR identifier used to determine the matching outbound dial peer.

number number

The dialed number used in conjunction with the COR identifier to determine the matching outbound dial peer.

timeout

(Optional) Allows matching for variable-length destination patterns.


Command Modes

Privileged EXEC

Command History

Release
Modification

12.1(3)T

This command was introduced on the Cisco 2600 series and Cisco 3600 series routers and on Cisco AS5800 access servers.

12.2(11)T

This command was implemented on the Cisco 1751 and Cisco 3700 series routers and on Cisco AS5300 access servers.


Usage Guidelines

Use this command as a troubleshooting tool to determine which outbound dial peer is matched for an incoming call, based on the COR criteria and dialed number specified in the command line. Use the timeout keyword to enable matching variable-length destination patters associated with dial peers. This can increase your chances of finding a match for the dial peer number you specify.


Note For actual voice calls coming into the router, the incoming corlist of a specified inbound dial peer and the outgoing called number will be used to match the outbound dial peer.


Examples

The following sample output shows an incoming call with a dialed number of 19001111 and meeting the COR criteria as part of dial peer 300 with incoming COR-list has been matched to an outbound dial peer with IP address 1.8.50.7:

Router# show dialplan dialpeer 300 number 1900111

VoiceOverIpPeer900
        information type = voice,
        description = `',
        tag = 900, destination-pattern = `1900',
        answer-address = `', preference=0,
        numbering Type = `unknown'
        group = 900, Admin state is up, Operation state is up,
        incoming called-number = `', connections/maximum = 0/unlimited,
        DTMF Relay = disabled,
        modem passthrough = system,
        huntstop = disabled,
        in bound application associated: 'DEFAULT'
        out bound application associated: ''
        dnis-map = 
        permission :both
        incoming COR list:maximum capability
        outgoing COR list:to900
        type = voip, session-target = `ipv4:1.8.50.7',
        technology prefix: 
        settle-call = disabled
        ...
        Time elapsed since last clearing of voice call statistics never
        Connect Time = 0, Charged Units = 0,
        Successful Calls = 0, Failed Calls = 0, Incomplete Calls = 0
        Accepted Calls = 0, Refused Calls = 0,
        Last Disconnect Cause is "",
        Last Disconnect Text is "",
        Last Setup Time = 0.
Matched: 19001111   Digits: 4
Target: ipv4:1.8.50.7

Table 89 describes the significant fields shown in the display.

Table 89 show dialplan command Field Descriptions 

Field
Description

Macro Exp.

Expected destination pattern for this dial peer.

VoiceEncapPeer

Dial peer associated with the calling number entered.

VoiceOverIpPeer

Dial peer associated with the calling number entered.

peer type

Type of this dial peer (voice or data).

information type

Information type for this dial peer (voice or data).

description

Any additional information for this dial peer entered using the description dial peer command.

tag

Unique number identifying the dial peer.

destination-pattern

Destination pattern (telephone number) configured for this dial peer.

answer-address

Answer address (calling number) configured for this dial peer.

preference

Hunt group preference order set for this dial peer.

CLID restriction

Indicates the Caller ID restriction (if any) configured for this dial peer.

CLID Network Number

Indicates the originating network of the Caller ID source.

CLID Second Number sent

Indicates the digits in the second number (if any) forwarded for this dial peer.

source carrier-id

VoIP or POTS source carrier identifier.

source trunk-group-label

VoIP or POTS source trunk group identifier.

numbering Type

Identifies the numbering scheme employed for this dial peer.

group

Dial peer group in which this dial peer is a member.

Admin state

Administrative state of this dial peer.

Operation state

Operational state of this dial peer.

incoming called-number

Called number (DNIS) configured for this dial peer.

connections/maximum

Number of actual and maximum allowable connections associated with this dial peer.

DTMF Relay

Whether the dtmf-relay command is enabled or disabled for this dial peer.

URI classes: Incoming (Request)

URI voice class used for matching dial peer to Request-URI in an incoming SIP Invite message.

URI classes: Incoming (To)

URI voice class used for matching dial peer to the To header in an incoming SIP Invite message.

URI classes: Incoming (From)

URI voice class used for matching dial peer to the From header in an incoming SIP Invite message.

URI classes: Destination

URI voice class used to match the dial peer to the destination URI for an outgoing call.

modem transport

Transport method configured for modem calls. The default is system, which means that the value configured globally is used.

huntstop

Whether the huntstop command is enabled or disabled for this dial peer.

in bound application associated

IVR application that is associated with this dial peer when this dial peer is used for an inbound call leg.

out bound application associated

IVR application that is associated with this dial peer when this dial peer is used for an outbound call leg.

dnis-map

Name of the dialed-number identification service (DNIS) map that is configured in the dial peer with the dnis-map command.

permission

Configured permission level for this dial peer.

incoming COR list

Class of restriction (COR) criteria associated when matching an incoming dial peer.

outgoing COR list

COR criteria used to determine the appropriate outbound dial peer.

Translation profile (Incoming)

Incoming translation criteria applied to this dial peer.

Translation profile (Outgoing)

Translation criteria applied to this dial peer when matching an outbound dial peer.

incoming call blocking

Indicates whether or not incoming call blocking has been applied for this dial peer.

translation-profile

The predefined translation profile associated with this dial peer.

disconnect-cause

Encoded network cause associated with the last call.

voice-port

Voice port through which calls come into this dial peer.

type

Type of dial peer (POTS or VoIP).

prefix

Prefix number that is added to the front of the dial string before it is forwarded to the telephony device.

forward-digits

Which digits are forwarded to the telephony interface as configured using the forward-digits command.

session-target

Configured session target (IP address or host name) for this dial peer.

direct-inward-dial

Whether the direct-inward-dial command is enabled or disabled for this dial peer.

digit_strip

Whether digit stripping is enabled or disabled in the dial peer. Enabled is the default.

register E.164 number with GK

Indicates whether or not the dial peer has been configured to register its full E.164-format number with the local gatekeeper.

fax rate

The transmission speed configured for fax calls. The default is system, which means that the value configured globally is used.

payload size

The size (in bytes) for a fax transmission payload.

session-protocol

Session protocol to be used for Internet calls between local and remote router via the IP backbone.

req-qos

Configured requested quality of service for calls for this dial peer.

acc-qos

Lowest acceptable quality of service configured for calls for this dial peer.

codec

Voice codec configured for this dial peer. Default is G.729 (8 kbps).

Expect factor

User-requested expectation factor of voice quality for calls through this dial peer.

Icpif

Configured calculated planning impairment factor (ICPIF) value for calls sent by this dial peer.

VAD

Indicates whether or not voice activation detection (VAD) is enabled for this dial peer.

voice class sip url

URL format (SIP or TEL) used for SIP calls to this dial peer, as configured with the voice-class sip url command. The default is system, which means that the value configured globally with the url command in voice service VoIP SIP mode is used.

voice class sip rel1xx

Indicates whether or not reliable provisional responses are supported, as configured with the voice-class sip rel1xx command. The default is system, which means that the value configured globally with the rel1xx command in voice service VoIP SIP mode is used.

voice class perm tag

Voice class for a trunk that is assigned to this dial peer with the voice-class permanent command.

Connect Time

Unit of measure indicating the call connection time associated with this dial peer.

Charged Units

Number of call units charged to this dial peer.

Successful Calls

Number of completed calls to this dial peer since system startup.

Failed Calls

Number of uncompleted (failed) calls to this dial peer since system startup.

Incomplete Calls

Number of incomplete calls to this dial peer since system startup.

Accepted Calls

Number of calls from this dial peer accepted since system startup.

Refused Calls

Number of calls from this dial peer refused since system startup.

Last Disconnect Cause

Encoded network cause associated with the last call. This value is updated whenever a call is started or cleared and depends on the interface type and session protocol being used on this interface.

Last Disconnect Text

ASCII text describing the reason for the last call termination.

Last Setup Time

Value of the System Up Time when the last call to this peer was started.

Matched

Destination pattern matched for this dial peer.

Digits

Number of digits in this destination pattern matched for this dial peer.

Target

Matched session target (IP address or host name) for this dial peer.


Related Commands

Command
Description

show dialplan in-carrier

Displays which VoIP or POTS dial peer is matched for a specific source carrier.

show dialplan in-trunk-group-label

Displays which VoIP or POTS dial peer is matched for a specific source trunk group.

show dialplan incall

Displays which POTS dial peer is matched for a specific calling number or voice port.

show dialplan number

Displays which dial peer is matched for a particular telephone number.


show dialplan incall

To display which incoming POTS dial peer is matched for a specific calling number or voice port, use the show dialplan incall number command in privileged EXEC mode.

show dialplan incall voice-port number calling-number [timeout]

Syntax Description

voice-port

Voice port location. The syntax of this argument is platform-specific. For information on the syntax for a particular platform, see the voice-port command.

calling-number

E.164 Calling number or ANI of the incoming voice call.

timeout

(Optional) Allows matching for variable-length destination patterns.


Command Modes

Privileged EXEC

Command History

Release
Modification

11.3(1)T

This command was introduced on the Cisco 3600 series.

12.2(8)T

This command was implemented on the Cisco 1751, Cisco 2600 series, Cisco 3725, and Cisco 3745 and the timeout keyword was added.


Usage Guidelines

Use this command as a troubleshooting tool to determine which POTS dial peer is matched for an incoming call, for the selected calling number and voice port. The router attempts to match these items in the order listed:

1. Calling number with answer-address configured in dial peer

2. Calling number with destination-pattern configured in dial peer

3. Voice port with voice port configured in dial peer

The router first attempts to match a dial peer based on the calling number (ANI). If the router is unable to match a dial peer based on the calling number, it matches the call to a POTS dial peer based on the selected voice interface. If more than one dial peer uses the same voice port, the router selects the first matching dial peer. Use the timeout keyword to enable matching variable-length destination patters associated with dial peers. This can increase you r chances of finding a match for the dial peer number you specify.


Note For actual voice calls coming into the router, the router attempts to match the called number (the dialed number identification service [DNIS] number) with the incoming called-number configured in a dial peer. The router, however, does not consider the called number when using the show dialplan incall number command.


Examples

The following sample output shows that an incoming call from interface 1/0/0:D with a calling number of 12345 is matched to POTS dial peer 10:

Router# show dialplan incall 1/0/0:D number 12345

Macro Exp.: 12345

VoiceEncapPeer10
        information type = voice,
        tag = 10, destination-pattern = `123..',
        answer-address = `', preference=0,
        numbering Type = `unknown'
        group = 10, Admin state is up, Operation state is up,
        incoming called-number = `', connections/maximum = 0/unlimited,
        DTMF Relay = disabled,
        huntstop = disabled,
        in bound application associated: DEFAULT
        out bound application associated:
        permission :both
        incoming COR list:maximum capability
        outgoing COR list:minimum requirement
        type = pots, prefix = `',
        forward-digits default
        session-target = `', voice-port = `1/0/0:D',
        direct-inward-dial = disabled,
        digit_strip = enabled,

        register E.164 number with GK = TRUE
        Connect Time = 0, Charged Units = 0,

        register E.164 number with GK = TRUE
        Connect Time = 0, Charged Units = 0,
        Successful Calls = 0, Failed Calls = 0,
        Accepted Calls = 0, Refused Calls = 0,
        Last Disconnect Cause is "",
        Last Disconnect Text is "",
        Last Setup Time = 0.
Matched: 12345   Digits: 3
Target:

The following sample output shows that, if no dial peer has a destination pattern or answer address that matches the calling number of 888, the incoming call is matched to POTS dial peer 99, because the call comes in on voice port 1/0/1:D, which is the voice port configured for this dial peer:

Router# show dialplan incall 1/0/1:D number 888

Macro Exp.: 888

VoiceEncapPeer99
        information type = voice,
        tag = 99, destination-pattern = `99...',
        answer-address = `', preference=1,
        numbering Type = `national'
        group = 99, Admin state is up, Operation state is up,
        incoming called-number = `', connections/maximum = 0/unlimited,
        DTMF Relay = disabled,
        huntstop = disabled,
        in bound application associated: DEFAULT
        out bound application associated:
        permission :both
        incoming COR list:maximum capability
        outgoing COR list:minimum requirement
        type = pots, prefix = `5',
        forward-digits 4
        session-target = `', voice-port = `1/0/1:D',
        direct-inward-dial = enabled,
        digit_strip = enabled,
register E.164 number with GK = TRUE
        Connect Time = 0, Charged Units = 0,
        Successful Calls = 0, Failed Calls = 0,
        Accepted Calls = 0, Refused Calls = 0,
        Last Disconnect Cause is "",
        Last Disconnect Text is "",
        Last Setup Time = 0.
Matched:    Digits: 0
Target:

Note Table 89 describes the significant fields shown in the display.


Related Commands

Command
Description

show dialplan dialpeer

Displays which outbound dial peer is matched based upon the incoming dialed number and the COR criteria specified in the command line.

show dialplan in-carrier

Displays which VoIP or POTS dial peer is matched for a specific source carrier.

show dialplan in-trunk-group-label

Displays which VoIP or POTS dial peer is matched for a specific source trunk group.

show dialplan number

Displays which dial peer is matched for a particular telephone number.


show dialplan incall uri

To display which dial peer is matched for a specific uniform resource identifier (URI) in an incoming voice call, use the show dialplan incall uri command in privileged EXEC mode.

H.323 Session Protocol

show dialplan incall uri h323 {called | calling} uri

SIP Session Protocol

show dialplan incall uri sip {from | request | to} uri

Syntax Description

called

Voice class that is configured in dial peers with the incoming uri called command.

calling

Voice class that is configured in dial peers with the incoming uri calling command.

from

Voice class that is configured in dial peers with the incoming uri from command.

request

Voice class that is configured in dial peers with the incoming uri request command.

to

Voice class that is configured in dial peers with the incoming uri to command.

uri

URI of the incoming call.


Defaults

No default behavior or values

Command Modes

Privileged EXEC

Command History

Release
Modification

12.3(4)T

This command was introduced.


Usage Guidelines

Use this command for troubleshooting to determine which dial peer is matched for an incoming call, based on the selected URI and the specified field in the call message.

To set the URI format for matching calls, use the voice class uri command. To set the URI voice class in the inbound dial peer, use the incoming uri command.

Examples

The following is sample output from this command for a SIP URI:

Router# show dialplan incall uri sip from sip:5551234

Inbound VoIP dialpeer matching based on SIP URI's

VoiceOverIpPeer10
        peer type = voice, information type = voice,
        description = `',
        tag = 10, destination-pattern = `',
        answer-address = `', preference=0,
        CLID Restriction = None
        CLID Network Number = `'
        CLID Second Number sent 
        source carrier-id = `', target carrier-id = `',
        source trunk-group-label = `',  target trunk-group-label = `',
        numbering Type = `unknown'
        group = 10, Admin state is up, Operation state is up,
        incoming called-number = `', connections/maximum = 0/unlimited,
        DTMF Relay = disabled,
        modem transport = system,
        URI classes:
            Incoming (Request) = 
            Incoming (To) = 
            Incoming (From) = 101
            Destination = 
        huntstop = disabled,
        in bound application associated: 'get_headers_tcl'
        out bound application associated: ''
        dnis-map = 
        permission :both
        incoming COR list:maximum capability
        outgoing COR list:minimum requirement
        Translation profile (Incoming):
        Translation profile (Outgoing):
        incoming call blocking:
        translation-profile = `'
        disconnect-cause = `no-service'
        type = voip, session-target = `',
        technology prefix: 
        settle-call = disabled
        ip media DSCP = ef, ip signaling DSCP = af31, UDP checksum = disabled,
        session-protocol = sipv2, session-transport = system, req-qos = best-ef 
        acc-qos = best-effort, 
        RTP dynamic payload type values: NTE = 101
        Cisco: NSE=100, fax=96, fax-ack=97, dtmf=121, fax-relay=122
               CAS=123, ClearChan=125, PCM switch over u-law=0,A-law=8
        RTP comfort noise payload type = 19
        fax rate = voice,   payload size =  20 bytes
        fax protocol = system
        fax-relay ecm enable
        fax NSF = 0xAD0051 (default)
        codec = g729r8,   payload size =  20 bytes,
        Expect factor = 0, Icpif = 20,
        Playout Mode is set to default,
        Initial 60 ms, Max 300 ms
        Playout-delay Minimum mode is set to default, value 40 ms 
        Fax nominal 300 ms
        Max Redirects = 1, signaling-type = ext-signal,
        VAD = enabled, Poor QOV Trap = disabled, 
        Source Interface = NONE
        voice class sip url = system,
        voice class sip rel1xx = system,
        voice class perm tag = `'
        Time elapsed since last clearing of voice call statistics never
        Connect Time = 0, Charged Units = 0,
        Successful Calls = 0, Failed Calls = 0, Incomplete Calls = 0
        Accepted Calls = 0, Refused Calls = 0,
        Last Disconnect Cause is "",
        Last Disconnect Text is "",
        Last Setup Time = 0.
Matched:    Digits: 0
Target: 

The following is sample output from this command for a TEL URI:

Router# show dialplan incall uri h323 called tel:1234567

 Inbound VoIP dialpeer matching based on H323 URI's

VoiceOverIpPeer25
        peer type = voice, information type = voice,
        description = `',
        tag = 25, destination-pattern = `',
        answer-address = `', preference=0,
        CLID Restriction = None
        CLID Network Number = `'
        CLID Second Number sent 
        source carrier-id = `', target carrier-id = `',
        source trunk-group-label = `',  target trunk-group-label = `',
        numbering Type = `unknown'
        group = 25, Admin state is up, Operation state is up,
        incoming called-number = `', connections/maximum = 0/unlimited,
        DTMF Relay = disabled,
        modem transport = system,
        URI classes:
            Incoming (Called) = 103
            Incoming (Calling) = 
            Destination = 
        huntstop = disabled,
        in bound application associated: 'callme'
        out bound application associated: ''
        dnis-map = 
        permission :both
        incoming COR list:maximum capability
        outgoing COR list:minimum requirement
        Translation profile (Incoming):
        Translation profile (Outgoing):
        incoming call blocking:
        translation-profile = `'
        disconnect-cause = `no-service'
        type = voip, session-target = `ipv4:10.10.1.1',
        technology prefix: 
        settle-call = disabled
        ip media DSCP = ef, ip signaling DSCP = af31, UDP checksum = disabled,
        session-protocol = cisco, session-transport = system, req-qos = best-ef 
        acc-qos = best-effort, 
        RTP dynamic payload type values: NTE = 101
        Cisco: NSE=100, fax=96, fax-ack=97, dtmf=121, fax-relay=122
               CAS=123, ClearChan=125, PCM switch over u-law=0,A-law=8
        RTP comfort noise payload type = 19
        fax rate = voice,   payload size =  20 bytes
        fax protocol = system
        fax-relay ecm enable
        fax NSF = 0xAD0051 (default)
        codec = g729r8,   payload size =  20 bytes,
        Expect factor = 0, Icpif = 20,
        Playout Mode is set to default,
        Initial 60 ms, Max 300 ms
        Playout-delay Minimum mode is set to default, value 40 ms 
        Fax nominal 300 ms
        Max Redirects = 1, signaling-type = ext-signal,
        VAD = enabled, Poor QOV Trap = disabled, 
        Source Interface = NONE
        voice class sip url = system,
        voice class sip rel1xx = system,
        voice class perm tag = `'
        Time elapsed since last clearing of voice call statistics never
        Connect Time = 0, Charged Units = 0,
        Successful Calls = 0, Failed Calls = 0, Incomplete Calls = 0
        Accepted Calls = 0, Refused Calls = 0,
        Last Disconnect Cause is "",
        Last Disconnect Text is "",
        Last Setup Time = 0.
Matched:    Digits: 0
Target: 

Table 90 describes significant fields in the displays.

Table 90 show dialplan incall uri Field Descriptions 

Field
Description

VoiceOverIpPeer

Dial peer associated with the calling number entered.

information type

Information type for this call; for example, voice or fax.

tag

Unique number that identifies the dial peer.

destination-pattern

Destination pattern (called number) configured for this dial peer.

answer-address

Answer address (calling number) configured for this dial peer.

preference

Hunt group preference order set for this dial peer.

Admin state

Administrative state of this dial peer.

Operation state

Operational state of this dial peer.

incoming called-number

Called number (DNIS) configured for this dial peer.

DTMF Relay

Whether the dtmf-relay command is enabled or disabled for this dial peer.

URI classes: Incoming (Request)

URI voice class used for matching dial peer to Request-URI in an incoming SIP Invite message.

URI classes: Incoming (To)

URI voice class used for matching dial peer to the To header in an incoming SIP Invite message.

URI classes: Incoming (From)

URI voice class used for matching dial peer to the From header in an incoming SIP Invite message.

URI classes: Destination

URI voice class used to match the dial peer to the destination URI for an outgoing call.

huntstop

Whether the huntstop command is enabled or disabled for this dial peer.

in bound application associated

IVR application that is associated with this dial peer when this dial peer is used for an inbound call leg.

out bound application associated

IVR application that is associated with this dial peer when this dial peer is used for an outbound call leg.

dnis-map

Name of the dialed-number identification service (DNIS) map that is configured in the dial peer with the dnis-map command.

permission

Configured permission level for this peer.

type

Type of dial peer (POTS or VoIP).

session-target

Configured session target (IP address or host name) for this dial peer.

session-protocol

Session protocol to be used for Internet calls between local and remote router via the IP backbone.

req-qos

Configured requested quality of service for calls for this dial peer.

acc-qos

Lowest acceptable quality of service configured for calls for this peer.

codec

Voice codec configured for this dial peer. Default is G.729 (8 kbps).

Expect factor

User-requested expectation factor of voice quality for calls through this peer.

Icpif

Configured calculated planning impairment factor (ICPIF) value for calls sent by a dial peer.

VAD

Whether voice activation detection (VAD) is enabled for this dial peer.

voice class sip url

URL format (SIP or TEL) used for SIP calls to this dial peer, as configured with the voice-class sip url command. The default is system, which means that the value configured globally with the url command in voice service VoIP SIP mode is used.

voice class sip rel1xx

Whether reliable provisional responses are supported, as configured with the voice-class sip rel1xx command. The default is system, which means that the value configured globally with the rel1xx command in voice service VoIP SIP mode is used.

voice class perm tag

Voice class for a trunk that is assigned to this dial peer with the voice-class permanent command.

Connect Time

Unit of measure indicating the call connection time associated with this dial peer.

Charged Units

Number of call units charged to this dial peer.

Successful Calls

Number of completed calls to this peer since system startup.

Failed Calls

Number of uncompleted (failed) calls to this peer since system startup.

Accepted Calls

Number of calls from this peer accepted since system startup.

Refused Calls

Number of calls from this peer refused since system startup.

Last Disconnect Cause

Encoded network cause associated with the last call. This value is updated whenever a call is started or cleared and depends on the interface type and session protocol being used on this interface.

Last Disconnect Text

ASCII text describing the reason for the last call termination.

Last Setup Time

Value of the System Up Time when the last call to this peer was started.

Matched

Destination pattern matched for this dial peer.

Target

Matched session target (IP address or host name) for this dial peer.


Related Commands

Command
Description

debug voice uri

Displays debugging messages related to URI voice classes.

incoming uri

Specifies the voice class used to match a VoIP dial peer to the URI of an incoming call.

session protocol

Specifies the session protocol in the dial peer for calls between the local and remote router.

show dial-peer voice

Displays detailed and summary information about voice dial peers.

show dialplan uri

Displays which outbound dial peer is matched for a specific destination URI.

voice class uri

Creates or modifies a voice class for matching dial peers to calls containing a SIP or TEL URI.

voice class uri sip preference

Sets a preference for selecting voice classes for a SIP URI.


show dialplan in-carrier

To display which incoming VoIP or POTS dial peer is matched for a specific source carrier or voice port, use the show dialplan in-carrier command in privileged EXEC mode.

show dialplan in-carrier carrier-id [voip | pots]

Syntax Description

carrier-id

VoIP or POTS source carrier identifier.

voip

(Optional) Allows you to limit the search criteria to only VoIP dial peers.

pots

(Optional) Allows you to limit the search criteria to only POTS dial peers.


Command Modes

Privileged EXEC

Command History

Release
Modification

12.2(13)T

This command was introduced on the Cisco 2600 series and Cisco 3600 series routers and on Cisco AS5300, Cisco AS5400, and Cisco AS5800 access servers.


Usage Guidelines

Use this command as a troubleshooting tool to determine which VoIP or POTS dial peer is matched for an incoming call, based on the carrier identifier specified in the command line. Use the voip or pots keywords to further limit the scope of possible matches for the dial peer specified in the show dialplan command line.

Examples

The following sample output shows a VoIP or POTS dial peer being matched to another POTS dial peer based on its carrier identifier, "aaa":

Router# show dialplan in-carrier aaa pots

 Inbound pots dialpeer Matching based on source carrier-id

VoiceEncapPeer7777
        information type = voice,
        description = `',
        tag = 7777, destination-pattern = `',
        answer-address = `', preference=0,
        CLID Restriction = None
        CLID Network Number = `'
        CLID Second Number sent 
        source carrier-id = `aaa',      target carrier-id = `',
        source trunk-group-label = `',  target trunk-group-label = `',
        numbering Type = `unknown'
        group = 7777, Admin state is up, Operation state is up,
        incoming called-number = `', connections/maximum = 0/unlimited,
        DTMF Relay = disabled,
        huntstop = disabled,
        in bound application associated:'DEFAULT'
        out bound application associated:''
        dnis-map = 
        permission :both
        incoming COR list:maximum capability
        outgoing COR list:minimum requirement
        Translation profile (Incoming):
        Translation profile (Outgoing):
        incoming call blocking:
        translation-profile = `'
        disconnect-cause = `no-service'
voice-port = `'
        type = pots, prefix = `',
        forward-digits default
        session-target = `', up,
        direct-inward-dial = disabled,
        digit_strip = enabled,
        register E.164 number with GK = TRUE
        fax rate = system,   payload size =  20 bytes

        Time elapsed since last clearing of voice call statistics never
        Connect Time = 0, Charged Units = 0,
        Successful Calls = 0, Failed Calls = 0, Incomplete Calls = 0
        Accepted Calls = 0, Refused Calls = 0,
        Last Disconnect Cause is "",
        Last Disconnect Text is "",
        Last Setup Time = 0.
Matched:   Digits:0
Target:

Note Table 89 describes the significant fields shown in the display.


Related Commands

Command
Description

show dialplan dialpeer

Displays which outbound dial peer is matched based upon the incoming dialed number and the COR criteria specified in the command line.

show dialplan in-trunk-group-label

Displays which VoIP or POTS dial peer is matched for a specific source trunk group.

show dialplan incall

Displays which POTS dial peer is matched for a specific calling number or voice port.

show dialplan number

Displays which dial peer is matched for a particular telephone number.


show dialplan in-trunk-group-label

To display which incoming VoIP or POTS dial peer is matched for a specific trunk group label, use the show dialplan in-trunk-group-label command in privileged EXEC mode.

show dialplan in-trunk-group-label trunk-group-label [pots | voip]

Syntax Description

trunk-group-label

VoIP or POTS source trunk group identifier.

voip

(Optional) Allows you to limit the search criteria to only VoIP dial peers.

pots

(Optional) Allows you to limit the search criteria to only POTS dial peers.


Command Modes

Privileged EXEC

Command History

Release
Modification

12.2(13)T

This command was introduced on the Cisco 2600 series and Cisco 3600 series routers and on Cisco AS5300, Cisco AS5400, and Cisco AS5800 access servers.


Usage Guidelines

Use this command to determine which VoIP or POTS dial peer is matched for an incoming call, based on the identifier of the source trunk group. The router attempts to match these items in the order listed. Use the voip or pots keywords to further limit the scope of possible matches for the dial peer specified in the show dialplan command line.

Examples

The following sample output shows an inbound VoIP or POTS dial peer being matched to an outbound POTS dial peer based on the trunk group label "NYtrunk":

Router# show dialplan in-trunk-group-label NYtrunk pots

 Inbound pots dialpeer Matching based on source trunk-group-label

VoiceEncapPeer2003
        information type = voice,
        description = `',
        tag = 2003, destination-pattern = `',
        answer-address = `', preference=0,
        CLID Restriction = None
        CLID Network Number = `'
        CLID Second Number sent 
        source carrier-id = `', target carrier-id = `',
        source trunk-group-label = `NYtrunk',   target trunk-group-label = `',
        numbering Type = `unknown'
        group = 2003, Admin state is up, Operation state is up,
        incoming called-number = `', connections/maximum = 0/unlimited,
        DTMF Relay = disabled,
        huntstop = disabled,
        in bound application associated:'debit-card'
        out bound application associated:''
        dnis-map = 
        permission :both
        incoming COR list:maximum capability
        outgoing COR list:minimum requirement
        Translation profile (Incoming):
        Translation profile (Outgoing):
        incoming call blocking:
        translation-profile = `'
        disconnect-cause = `no-service'
voice-port = `'
        type = pots, prefix = `',
        forward-digits default
        session-target = `', up,
        direct-inward-dial = disabled,
        digit_strip = enabled,
        register E.164 number with GK = TRUE
        fax rate = system,   payload size =  20 bytes

        Time elapsed since last clearing of voice call statistics never
        Connect Time = 0, Charged Units = 0,
        Successful Calls = 0, Failed Calls = 0, Incomplete Calls = 0
        Accepted Calls = 0, Refused Calls = 0,
        Last Disconnect Cause is "",
        Last Disconnect Text is "",
        Last Setup Time = 0.
Matched:   Digits:0
Target:

Note Table 89 describes the significant fields shown in the display.


Related Commands

Command
Description

show dialplan dialpeer

Displays which outbound dial peer is matched based upon the incoming dialed number and the COR criteria specified in the command line.

show dialplan in-carrier

Displays which VoIP or POTS dial peer is matched for a specific source carrier.

show dialplan incall

Displays which POTS dial peer is matched for a specific calling number or voice port.

show dialplan number

Displays which dial peer is matched for a particular telephone number.


show dialplan number

To display which outgoing dial peer is reached when a particular telephone number is dialed, use the show dialplan number command in privileged EXEC mode.

show dialplan number dial-string [carrier identifier] [fax | huntstop | voice] [timeout]

Syntax Description

dial-string

Particular destination pattern (E.164 telephone number).

carrier

(Optional) Indicates that you wish to base your search for applicable dial peers on the source carrier identifier.

identifier

(Optional) Source carrier identifier to accompany the carrier keyword.

fax

(Optional) Fax information type.

huntstop

(Optional) Terminates further dial-peer hunting upon encountering the first dial-string match.

timeout

(Optional) Allows matching for variable-length destination patterns.

voice

(Optional) Voice information type.


Command Modes

Privileged EXEC

Command History

Release
Modification

11.3(1)T

This command was introduced on the Cisco 3600 series.

12.2(1)

The huntstop keyword was added.

12.2(8)T

This command was implemented on the Cisco 1751, Cisco 2600 series, Cisco 3725, and Cisco 3745 and the timeout keyword was added.

12.2(11)T

The carrier, fax, and voice keywords were added.


Usage Guidelines

Use this command to test whether the dial plan configuration is valid and working as expected. Use the timeout keyword to enable matching variable-length destination patters associated with dial peers. This can increase you r chances of finding a match for the dial peer number you specify.

Examples

The following is sample output from this command using a destination pattern of 1001:

Router# show dialplan number 1001

Macro Exp.: 1001

VoiceEncapPeer1003
         information type = voice,
         tag = 1003, destination-pattern = `1001',
         answer-address = `', preference=0,
         numbering Type = `unknown'
         group = 1003, Admin state is up, Operation state is up,
         incoming called-number = `', connections/maximum = 0/unlimited,
         DTMF Relay = disabled,
         huntstop = enabled,
         type = pots, prefix = `',
         forward-digits default
         session-target = `', voice-port = `1/1',
         direct-inward-dial = disabled,
         Connect Time = 0, Charged Units = 0,
         Successful Calls = 0, Failed Calls = 0, Incomplete Calls = 0
         Accepted Calls = 0, Refused Calls = 0,
         Last Disconnect Cause is "",
         Last Disconnect Text is "",
         Last Setup Time = 0.
Matched: 1001   Digits: 4
Target:

VoiceEncapPeer1004
         information type = voice,
         tag = 1004, destination-pattern = `1001',
         answer-address = `', preference=0,
         numbering Type = `unknown'
         group = 1004, Admin state is up, Operation state is up,
...
Matched: 1001   Digits: 4
Target:

VoiceEncapPeer1002
         information type = voice,
         tag = 1002, destination-pattern = `1001',
         answer-address = `', preference=0,
         numbering Type = `unknown'
         group = 1002, Admin state is up, Operation state is up,
...
Matched: 1001   Digits: 4
Target:

VoiceEncapPeer1001
         information type = voice,
         tag = 1001, destination-pattern = `1001',
         answer-address = `', preference=0,
         numbering Type = `unknown'
         group = 1001, Admin state is up, Operation state is up,
...
Matched: 1001   Digits: 4
Target:

The following is sample output from this command using a destination pattern of 1001 and the huntstop keyword:

Router# show dialplan number 1001 huntstop

 Macro Exp.: 1001

 VoiceEncapPeer1003
         information type = voice,
         tag = 1003, destination-pattern = `1001',
         answer-address = `', preference=0,
         numbering Type = `unknown'
         group = 1003, Admin state is up, Operation state is up,
         incoming called-number = `', connections/maximum = 0/unlimited,
         DTMF Relay = disabled,
         huntstop = enabled,
         type = pots, prefix = `',
         forward-digits default
         session-target = `', voice-port = `1/1',
         direct-inward-dial = disabled,
         Connect Time = 0, Charged Units = 0,
         Successful Calls = 0, Failed Calls = 0, Incomplete Calls = 0
         Accepted Calls = 0, Refused Calls = 0,
         Last Disconnect Cause is "",
         Last Disconnect Text is "",
         Last Setup Time = 0.
 Matched: 1001   Digits: 4
 Target:

Note Table 89 describes the significant fields shown in the display.


Related Commands

Command
Description

show dialplan dialpeer

Displays which outbound dial peer is matched based upon the incoming dialed number and the COR criteria specified in the command line.

show dialplan in-carrier

Displays which VoIP or POTS dial peer is matched for a specific source carrier.

show dialplan in-trunk-group-label

Displays which VoIP or POTS dial peer is matched for a specific source trunk group.

show dialplan incall

Displays which POTS dial peer is matched for a specific calling number or voice port.


show dialplan uri

To display which outbound dial peer is matched for a specific destination uniform resource identifier (URI), use the show dialplan uri command in privileged EXEC mode.

show dialplan uri uri

Syntax Description

uri

Destination Session Initiation Protocol (SIP) or telephone (TEL) URI for the outgoing call.


Defaults

No default behavior or values

Command Modes

Privileged EXEC

Command History

Release
Modification

12.3(4)T

This command was introduced.


Usage Guidelines

Use this command for troubleshooting to determine which dial peer is matched for an outgoing call, based on the selected URI.

To set the URI format used to match calls, use the voice class uri command. To set the URI voice class in the outbound dial peer, use the destination uri command.

Examples

The following is sample output from this command:

Router# show dialplan uri sip:123456

 Outbound dialpeer matching based on destination URI

VoiceOverIpPeer99
        peer type = voice, information type = voice,
        description = `',
        tag = 99, destination-pattern = `',
        answer-address = `', preference=0,
        CLID Restriction = None
        CLID Network Number = `'
        CLID Second Number sent 
        source carrier-id = `', target carrier-id = `',
        source trunk-group-label = `',  target trunk-group-label = `',
        numbering Type = `unknown'
        group = 99, Admin state is up, Operation state is up,
        incoming called-number = `', connections/maximum = 0/unlimited,
        DTMF Relay = disabled,
        modem transport = system,
        URI classes:
            Incoming (Request) = 
            Incoming (To) = 
            Incoming (From) = 
            Destination = 100
        huntstop = disabled,
        in bound application associated: 'DEFAULT'
        out bound application associated: ''
        dnis-map = 
        permission :both
        incoming COR list:maximum capability
        outgoing COR list:minimum requirement
        Translation profile (Incoming):
        Translation profile (Outgoing):
        incoming call blocking:
        translation-profile = `'
        disconnect-cause = `no-service'
        type = voip, session-target = `',
        technology prefix: 
        settle-call = disabled
        ip media DSCP = ef, ip signaling DSCP = af31, UDP checksum = disabled,
        session-protocol = sipv2, session-transport = system, req-qos = best-ef 
        acc-qos = best-effort, 
        RTP dynamic payload type values: NTE = 101
        Cisco: NSE=100, fax=96, fax-ack=97, dtmf=121, fax-relay=122
               CAS=123, ClearChan=125, PCM switch over u-law=0,A-law=8
        RTP comfort noise payload type = 19
        fax rate = voice,   payload size =  20 bytes
        fax protocol = system
        fax-relay ecm enable
        fax NSF = 0xAD0051 (default)
        codec = g729r8,   payload size =  20 bytes,
        Expect factor = 0, Icpif = 20,
        Playout Mode is set to default,
        Initial 60 ms, Max 300 ms
        Playout-delay Minimum mode is set to default, value 40 ms 
        Fax nominal 300 ms
        Max Redirects = 1, signaling-type = ext-signal,
        VAD = enabled, Poor QOV Trap = disabled, 
        Source Interface = NONE
        voice class sip url = system,
        voice class sip rel1xx = system,
        voice class perm tag = `'
        Time elapsed since last clearing of voice call statistics never
        Connect Time = 0, Charged Units = 0,
        Successful Calls = 0, Failed Calls = 0, Incomplete Calls = 0
        Accepted Calls = 0, Refused Calls = 0,
        Last Disconnect Cause is "",
        Last Disconnect Text is "",
        Last Setup Time = 0.
Matched:    Digits: 0
Target: 

Table 90 describes significant fields in the display.

Related Commands

Command
Description

debug voice uri

Displays debugging messages related to URI voice classes.

destination uri

Specifies the voice class used to match the dial peer to the destination URI for an outgoing call.

show dialplan incall uri

Displays which dial peer is matched for a specific URI in an incoming call.

voice class uri

Creates or modifies a voice class for matching dial peers to a SIP or TEL URI.

voice class uri sip preference

Sets a preference for selecting voice classes for a SIP URI.


show dspfarm

To display digital-signal-processor (DSP) farm-service information such as operational status and DSP resource allocation for transcoding and conferencing, use the show dspfarm command in privileged EXEC mode.

show dspfarm [all | dsp {active | all | idle} | sessions]

Syntax Description

all

(Optional) All DSP-farm global information.

dsp

(Optional) DSP-farm DSP information.

active

(Optional) Information about active DSPs.

all

(Optional) Information about all DSP-farm DSPs.

idle

(Optional) Information about the idle DSPs.

sessions

(Optional) Information about DSP-farm sessions and connections.


Command Modes

Privileged EXEC

Command History

Release
Modification

12.1(5)YH

This command was introduced on the Cisco VG200.

12.2(13)T

This command was implemented on the Cisco 2600 series, Cisco 3620, Cisco 3640, Cisco 3660, and Cisco 3700 series.


Usage Guidelines

The router on which this command is used must be equipped with one or more digital T1/E1 packet voice trunk network modules (NM-HDVs) or high-density voice (HDV) transcoding/conferencing DSP farms (NM-HDV-FARMs) to provide DSP resources.

Examples

The following is sample output from this command:

Router# show dspfarm

DSPFARM Configuration Information: 
Admin State: UP, Oper Status: ACTIVE - Cause code: NONE 
Transcoding Sessions: 4, Conferencing Sessions: 0 
RTP Timeout: 600

Router# show dspfarm all

DSPFARM Configuration Information:
Admin State: UP, Oper Status: ACTIVE - Cause code: NONE
Transcoding Sessions: 4, Conferencing Sessions: 2
RTP Timeout: 1200
Connection average duration: 3600, Connection check interval 600
Codec G729 VAD: ENABLED

Total number of active session(s) 0, and connection(s) 0

SLOT  DSP   CHNL  STATUS USE   TYPE   SESS-ID   CONN-ID   PKTS-RXED PKTS-TXED

1     3     1     UP     FREE  conf   -         -         -         -
1     3     2     UP     FREE  conf   -         -         -         -
1     3     3     UP     FREE  conf   -         -         -         -
1     3     4     UP     FREE  conf   -         -         -         -
1     3     5     UP     FREE  conf   -         -         -         -
1     3     6     UP     FREE  conf   -         -         -         -
1     4     1     UP     FREE  conf   -         -         -         -
1     4     2     UP     FREE  conf   -         -         -         -
1     4     3     UP     FREE  conf   -         -         -         -
1     4     4     UP     FREE  conf   -         -         -         -
1     4     5     UP     FREE  conf   -         -         -         -
1     4     6     UP     FREE  conf   -         -         -         -
1     5     1     UP     FREE  xcode  -         -         -         -
1     5     2     UP     FREE  xcode  -         -         -         -
1     5     3     UP     FREE  xcode  -         -         -         -
1     5     4     UP     FREE  xcode  -         -         -         -
1     5     5     UP     FREE  xcode  -         -         -         -
1     5     6     UP     FREE  xcode  -         -         -         -
1     5     7     UP     FREE  xcode  -         -         -         -
1     5     8     UP     FREE  xcode  -         -         -         -

Total number of DSPFARM DSP channel(s) 20

Router# show dspfarm dsp all

DSPFARM Configuration Information:
Admin State: UP, Oper Status: ACTIVE - Cause code: NONE
Transcoding Sessions: 4, Conferencing Sessions: 2
RTP Timeout: 1200
Connection average duration: 3600, Connection check interval 600
Codec G729 VAD: ENABLED

Total number of active session(s) 0, and connection(s) 0

SLOT  DSP  CHNL  STATUS  USE   TYPE   SESS-ID  CONN-ID  PKTS-RXED  PKTS-TXED

1     3    1     UP      FREE  conf   -        -        -          -
1     3    2     UP      FREE  conf   -        -        -          -
1     3    3     UP      FREE  conf   -        -        -          -
1     3    4     UP      FREE  conf   -        -        -          -
1     3    5     UP      FREE  conf   -        -        -          -
1     3    6     UP      FREE  conf   -        -        -          -
1     4    1     UP      FREE  conf   -        -        -          -
1     4    2     UP      FREE  conf   -        -        -          -
1     4    3     UP      FREE  conf   -        -        -          -
1     4    4     UP      FREE  conf   -        -        -          -
1     4    5     UP      FREE  conf   -        -        -          -
1     4    6     UP      FREE  conf   -        -        -          -
1     5    1     UP      FREE  xcode  -        -        -          -
1     5    2     UP      FREE  xcode  -        -        -          -
1     5    3     UP      FREE  xcode  -        -        -          -
1     5    4     UP      FREE  xcode  -        -        -          -
1     5    5     UP      FREE  xcode  -        -        -          -
1     5    6     UP      FREE  xcode  -        -        -          -
1     5    7     UP      FREE  xcode  -        -        -          -
1     5    8     UP      FREE  xcode  -        -        -          -

Total number of DSPFARM DSP channel(s) 20




Router# show dspfarm sessions

sess_id  conn_id  stype  mode      codec  pkt  ripaddr      rport  sport
4        145      xcode  sendrecv  g711a  20   10.10.10.19  19460  21284
4        161      xcode  sendrecv  g729   10   10.10.10.28  19414  20382
5        177      xcode  sendrecv  g711u  20   10.10.10.17  18290  21170
5        193      xcode  sendrecv  g729b  10   10.10.10.18  19150  18968

Related Commands

Command
Description

dspfarm (DSP farm)

Enables DSP-farm service.


show dspfarm profile

To display configured digital signal processor (DSP) farm profile information for a selected Cisco CallManager group, use the show dspfarm profile command in privileged EXEC mode.

show dspfarm profile [profile-identifier]

Syntax Description

profile-identifier

(Optional) number that uniquely identifies a profile. Range is from 1 to 65535. There is no default.


Command Modes

Privileged EXEC

Command History

Release
Modification

12.3(8)T

This command was introduced.


Usage Guidelines

Use the show dspfarm profile command to verify that the association between SCCP Cisco Unified CallManger and the DSP farm profiles match your organizational plan.

Examples

The following output show how to display DSP farm information for profile 6.

Router# show dspfarm profile 6

Dspfarm Profile Configuration

 Profile ID = 6, Service = TRANSCODING, Resource ID = 1   
 Profile Admin State : UP 
 Profile Operation State : ACTIVE 
 Application : SCCP   Status : ASSOCIATED 
 Resource Provider : FLEX_DSPRM   Status : UP 
 Number of Resource Configured : 4 
 Number of Resource Available : 4
 Codec Configuration 
 Codec : g711ulaw, Maximum Packetization Period : 30 
 Codec : g711alaw, Maximum Packetization Period : 30 
 Codec : g729ar8, Maximum Packetization Period : 60 
 Codec : g729abr8, Maximum Packetization Period : 60 
 Codec : g729br8, Maximum Packetization Period : 60 


Table 91 describes significant fields shown in this output.

Table 91 show dspfarm profile Field Descriptions  

Field
Description

Profile ID

Displays the profile ID number.

Service

Displays the service that is associated with the profile.

Resource ID

Displays the ID number that the profile is associated with in the Cisco CallManager register.

Profile Admin State

Shows the status of the profile. If the Profile Admin State is DOWN, use the no shutdown command in the dspfarm profile configuration.

Profile Operation State

Shows the status of the DSP farm profiles registration process with the Cisco CallManager. Status options are as follows:

ACTIVE IN PROGRESS—the profile is still registering with the Cisco Unified CallManager. Wait for the profile to finish registering.

DOWN—The profile is not registering with the Cisco CallManager. Check the connectivity between the DSP farm gateway and the Cisco Unified CallManager.

ACTIVE—The profile is registered with the Cisco Unified CallManager.

Application

Displays the routing protocol being used.

Number of Resource Available

Total number of resources that are configurable.

Number of Resource Configured

Maximum number of sessions that are supported by a profile.

Codec Configuration

Lists the codecs that are configured.

Note MTP profile supports only one codec per profile.


Related Commands

Command
Description

dspfarm profile

Enters DSP farm profile configuration mode and defines a profile for DSP farm services.

dsp services dspfarm

Configures DSP farm services for a specified voice card.

show media resource status

Displays the current media resource status.


show event-manager consumers

To display event-manager statistics for debugging purposes, use the show event-manager consumers command in privileged EXEC mode.

show event-manager consumers

Syntax Description

This command has no arguments or keywords.

Command Modes

Privileged EXEC

Command History

Release
Modification

12.3(4)T

This command was introduced.


Examples

The following example shows one call (two call legs) going through the gateway:

Router# show event-manager consumers

Hash table indexed by AAA_UNIQUE_ID
Uid        Consumer_id  Consumer_hdl  evt_type
00000015   0002         65B35570      START
00000015   0002         65B35570      STOP
00000016   0002         65B34ECC      START
00000016   0002         65B34ECC      STOP

Table 1 lists and describes the significant output fields.

Field
Description

Uid

User ID.

Consumer_id

ID of the consumer client process.

Consumer_hdl

Handler of the consumer client process.

evt_type

Event type.


Related Commands

Command
Description

show voice statistics csr interval accounting

Displays all accounting CSRs specified by interval number.

show voice statistics csr interval aggregation

Displays signaling CSRs specified by interval number.

show voice statistics csr since-reset accounting

Displays all accounting CSRs since the last reset.

show voice statistics csr since-reset aggregation-level

Displays all signaling CSRs since the last reset.

show voice statistics csr since-reset all

Displays all CSRs since the last reset.

show voice statistics interval-tag

Displays the configured interval numbers.

show voice statistics memory-usage

Displays current memory usage.


show frame-relay vofr

To display information about the FRF.11 subchannels being used on Voice over Frame Relay (VoFR) data link connection identifiers (DLCIs), use the show frame-relay vofr command in privileged EXEC mode.

show frame-relay vofr [interface [dlci [cid]]]

Syntax Description

interface

(Optional) Specific interface type and number for which you wish to display FRF.11 subchannel information.

dlci

(Optional) Specific data link connection identifier for which you wish to display FRF.11 subchannel information.

cid

(Optional) Specific subchannel for which you wish to display information.


Defaults

If this command is entered without a specified interface, FRF.11 subchannel information is displayed for all VoFR interfaces and DLCIs configured on the router.

Command Modes

Privileged EXEC

Command History

Release
Modification

12.0(4)T

This command was introduced on the Cisco 2600 series, Cisco 3600 series, and Cisco MC3810 series.

12.0(4)T

This command was integrated into Cisco IOS Release 12.0(4)T.


Examples

The following is sample output from this command when an interface is not specified:

Router# show frame-relay vofr

interface         vofr-type   dlci   cid   cid-type
Serial0/0.1       VoFR        16     4     data
Serial0/0.1       VoFR        16     5     call-control
Serial0/0.1       VoFR        16     10    voice
Serial0/1.1       VoFR cisco  17     4     data

The following is sample output from this command when an interface is specified:

Router# show frame-relay vofr serial0

interface         vofr-type   dlci   cid   cid-type
Serial0           VoFR        16     4     data
Serial0           VoFR        16     5     call-control
Serial0           VoFR        16     10    voice

The following is sample output from this command when an interface and a DLCI are specified:

Router# show frame-relay vofr serial0 16

VoFR Configuration for interface Serial0

dlci vofr-type  cid cid-type          input-pkts    output-pkts   dropped-pkts
16   VoFR       4   data              0             0             0
16   VoFR       5   call-control      85982         86099         0
16   VoFR       10  voice             2172293       6370815       0

The following is sample output from this command when an interface, a DLCI, and a CID are specified:

Router# show frame-relay vofr serial0 16 10

VoFR Configuration for interface Serial0 dlci 16

  vofr-type  VoFR     cid 10      cid-type voice
  input-pkts 2172293   output-pkts 6370815   dropped-pkts 0

Table 92 describes significant fields shown in this output.

Table 92 show frame-relay vofr Field Descriptions

Field
Description

interface

Number of the interface that has been selected for observation of FRF.11 subchannels.

vofr-type

Type of VoFR DLCI being observed.

cid

Portion of the specified DLCI that is carrying the designated traffic type. A DLCI can be subdivided into 255 subchannels.

cid-type

Type of traffic carried on this subchannel.

input-pkts

Number of packets received by this subchannel.

output-pkts

Number of packets sent on this subchannel.

dropped-pkts

Total number of packets discarded by this subchannel.


Related Commands

Command
Description

show call active voice

Displays the contents of the active call table.

show call history voice

Displays the contents of the call history table.

show dial-peer voice

Displays configuration information and call statistics for dial peers.

show frame-relay fragment

Displays Frame Relay fragmentation details.

show frame-relay pvc

Displays statistics about PVCs for Frame Relay interfaces.

show voice-port

Displays configuration information about a specific voice port.


show gatekeeper calls

To display the status of each ongoing call of which a gatekeeper is aware, use the show gatekeeper calls command in privileged EXEC mode.

show gatekeeper calls [history]

Syntax Description

history

(Optional) Displays 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 specified in the call-history max-size number command. Use of this max-size number helps to reduce CPU usage in the storage and reporting of this information.


Command Default

The default expression of this command displays information for all active calls detected on the gatekeeper.

Command Modes

Privileged EXEC

Command History

Release
Modification

11.3(2)NA

This command was introduced.

12.0(3)T

This command was integrated into Cisco IOS Release 12.0(3)T.

12.0(5)T

The output for this command was changed.

12.1(5)XM2

This command was implemented on the Cisco AS5350 and Cisco AS5400.

12.2(4)T

Support for the Cisco AS5300, Cisco AS5350, and Cisco AS5400 is not included in this release.

12.2(2)XB1

This command was implemented on the Cisco AS5850.

12.2(11)T

This command was integrated into Cisco IOS Release 12.2(11)T. This command is supported on the Cisco AS5300, Cisco AS5350, Cisco AS5400, and Cisco AS5850 in this release.

12.4(4)T

The history keyword was added to display historical information on disconnected calls.


Usage Guidelines

Use this command to show all active calls currently being handled by a particular Multimedia Conference Manager (MCM) gatekeeper. If you force a disconnect for either a particular call or all calls associated with a particular MCM gatekeeper by using the clear h323 gatekeeper call command, the system does not display information about those calls.

Using the history keyword displays the number of disconnected calls specified in the call-history max-size number command. Use of this max-size number helps to reduce CPU usage in the storage and reporting of this information.

Examples

The following is sample output showing active calls:

Router# show gatekeeper calls

Total number of active calls = 1.
                         GATEKEEPER CALL INFO
                         ====================
LocalCallID                        Age(secs)   BW
12-3339                            94          768(Kbps)
 Endpt(s):Alias        E.164Addr     CallSignalAddr  Port  RASSignalAddr   Port
   src EP:epA                        10.0.0.0        1720  10.0.0.0        1700
   dst EP:epB@zoneB.com
   src PX:pxA                        10.0.0.0        1720  10.0.0.00       24999
   dst PX:pxB                        255.255.255.0   1720  255.255.255.0   24999

Table 93 describes the significant fields shown in the display.

Table 93 show gatekeeper calls Field Descriptions 

Field
Description

LocalCallID

Identification number of the call.

Age(secs)

Age of the call, in seconds.

BW(Kbps)

Bandwidth in use, in kilobytes per second.

Endpt

Role of each endpoint (terminal, gateway, or proxy) in the call (originator, target, or proxy) and the call signaling and Registration, Admission, and Status (RAS) protocol address.

Alias

H.323-Identification (ID) or Email-ID of the endpoint.

E.164Addr

E.164 address of the endpoint.

CallSignalAddr

Call-signaling IP address of the endpoint.

Port

Call-signaling port number of the endpoint.

RASSignalAddr

RAS IP address of the endpoint.

Port

RAS port number of the endpoint.


Related Commands

Command
Description

clear h323 gatekeeper call

Forces the disconnection of a specific call or of all calls active on a particular gatekeeper.

call history max

Specifies the number of records to be kept in the history table.


show gatekeeper circuits

To display the circuit information on a gatekeeper, use the show gatekeeper circuits command in privileged EXEC mode.

show gatekeeper circuits [{begin | exclude | include} expression]

Syntax Description

|begin

(Optional) Displays all circuits, beginning with the line containing the expression.

|exclude

(Optional) Displays all circuits, excluding those containing the expression.

|include

(Optional) Displays all circuits, including those containing the expression.

expression

(Optional) Word or phrase used to determine what lines are displayed.


Defaults

Shows all circuit information.

Command Modes

Privileged EXEC

Command History

Release
Modification

12.2(11)T

This command was introduced.


Usage Guidelines

Use this command to display current configuration information about the circuits that are registered with the gatekeeper.

Examples

The following command displays the circuit information for the gatekeeper:

Router# show gatekeeper circuits

Circuit       Endpoint   Max Calls Avail Calls Resources     Zone
-------       --------   --------- ----------- ---------     ----
CarrierA      Total Endpoints: 2
              3640-gw1   25        25          Available
              5400-gw1   23        19          Unavailable
CarrierB      Total Zones: 1
                                                             MsPacmanGK

Table 94 describes the fields shown in this output.

Table 94 show gatekeeper circuits Field Descriptions 

Field
Description

Circuit

Name of the each circuit connected to the gatekeeper.

Endpoint

Name of each H.323 endpoint.

Max Calls

Maximum number of calls that circuit can handle.

Avail Calls

Number of new calls that the circuit can handle at the current time.

Resources

Whether the circuit's resources have exceeded the defined threshold limits. The endpoint resource-threshold command defines these thresholds.

Zone

Zone that supports the endpoint. The zone circuit-id command assigns a zone to an endpoint.

Total Endpoints

Total number of endpoints supported by the circuit.

Total Zones

Total number of zones supported by the circuit.


Related Commands

Command
Description

endpoint resource-threshold

Sets a gateway's capacity thresholds in the gatekeeper.

zone circuit-id

Assigns a remote zone to a carrier.


show gatekeeper cluster

To display all the configured clusters and to provide validation of the configuration, use the show gatekeeper cluster command in privileged EXEC mode.

show gatekeeper cluster

Syntax Description

This command has no arguments or keywords.

Command Modes

Privileged EXEC

Command History

Release1.25
Modification

12.1(5)XM

This command was introduced.

12.2(2)T

This command was integrated into Cisco IOS Release 12.2(2)T.

12.2(2)XB1

This command was implemented on the Cisco AS5850.


Examples

The following is sample output from this command:

Router# show gatekeeper cluster

                    CONFIGURED CLUSTERS
                    ===================
Cluster Name    Type     Local Zone   Elements  IP
------------    ----     ----------   --------  --
Cluster A       Local    AGK1         AGK2      192.168.200.254 1719
                                      AGK3      192.168.200.223 1719
Cluster B       Remote                BGK1      192.168.200.257 1719
                                      BGK2      192.168.200.258 1719
                                      BGK3      192.168.200.259 1719

Related Commands

Command
Description

show gatekeeper endpoints

Displays the status of all registered endpoints for a gatekeeper.

show gatekeeper performance statistics

Displays information about the number of calls accepted and rejected and finds the number of endpoints sent to other gatekeepers.

show gatekeeper zone cluster

Displays the dynamic status of all local clusters.


show gatekeeper endpoint circuits

To display the information of all registered endpoints and carriers or trunk groups for a gatekeeper, use the show gatekeeper endpoint circuits command in privileged EXEC mode.

show gatekeeper endpoint circuits [{begin | exclude | include} expression]

Syntax Description

| begin

(Optional) Displays all circuits, beginning with the line that contains expression.

| exclude

(Optional) Displays all circuits, excluding those that contain expression.

| include

(Optional) Displays all circuits, including those that contain expression.

expression

(Optional) Word or phrase used to determine what lines are displayed.


Command Modes

Privileged EXEC

Command History

Release
Modification

11.3(2)NA

This command was introduced.

12.0(5)T

The display format was modified for H.323 Version 2.

12.2(11)T

The display format was modified to show the E.164 ID, carrier and trunk group data, and total number of active calls.


Usage Guidelines

Use this command to display current configuration information about the endpoints and carriers registered with the gatekeeper. Note that you must type the pipe (|) before any of the optional keywords.

Examples

The following command displays the circuit information for the gatekeeper:

Router# show gatekeeper endpoint circuits

                    GATEKEEPER ENDPOINT REGISTRATION
                    ================================
CallSignalAddr  Port  RASSignalAddr   Port  Zone Name         Type    Flags
--------------- ----- --------------- ----- ---------         ----    -----
172.18.195.120  1720  172.18.195.120  51059 LavenderGK        VOIP-GW
    E164-ID: 4081234
    H323-ID: 3640-gw1
    Carrier: CarrierA, Max Calls: 25, Available: 25
172.18.197.143  1720  172.18.197.143  57071 LavenderGK        VOIP-GW
    H323-ID: 5400-gw1
    Carrier: CarrierB, Max Calls: 23, Available: 19
    Carrier: CarrierA, Max Calls: 25, Available: 25
Total number of active registrations = 2

Table 95 describes the fields shown in this output.

Table 95 show gatekeeper endpoint circuits Fields

Field
Description

CallsignalAddr

Call signaling IP address of the endpoint. If the endpoint is also registered with an alias, a list of all aliases registered for that endpoint should be listed on the line below.

Port

Call signaling port number of the endpoint.

RASSignalAddr

RAS IP address of the endpoint.

Port

RAS port number of the endpoint.

Zone Name

Zone name (gatekeeper ID) that this endpoint registered in.

Type

Endpoint type (for example, terminal, gateway, or MCU).

Flags

S—Endpoint is statically entered from the alias command rather than being dynamically registered through RAS messages.

O—Endpoint, which is a gateway, has sent notification that it is nearly out of resources.

E164-ID

E.164 ID of the endpoint.

H323-ID

H.323 ID of the endpoint.

Carrier

Carrier associated with the endpoint.

Max Calls

Maximum number of calls the circuit can handle.

Available

Number of new calls the circuit can handle currently.


Related Commands

Command
Description

endpoint circuit-id h323id

Assigns a circuit to a non-Cisco endpoint.

endpoint resource-threshold

Sets a gateway's capacity thresholds in the gatekeeper.

zone circuit-id

Assigns a circuit to a remote zone.


show gatekeeper endpoints

To display the status of all registered endpoints for a gatekeeper, use the show gatekeeper endpoints command in privileged EXEC mode.

show gatekeeper endpoints [alternates]

Syntax Description

alternates

(Optional) Displays information about alternate endpoints. All information normally included with this command is also displayed.


Command Modes

Privileged EXEC

Command History

Release
Modification

11.3(2)NA

This command was introduced.

12.0(5)T

The display format was modified for H.323 Version 2.

12.1(5)XM

The alternates keyword was added.

12.1(5)XM2

This command was implemented on the Cisco AS5350 and Cisco AS5400.

12.2(2)T

This command was integrated into Cisco IOS Release 12.2(2)T.

12.2(4)T

This command was not supported on the Cisco AS5300, Cisco AS5350, and Cisco AS5400 in this release.

12.2(2)XB1

This command was implemented on the Cisco AS5850.

12.2(11)T

This command was integrated into Cisco IOS Release 12.2(11)T. The registration and call capacity values were added to the output display.

12.3(1)

This command was modified to reflect concurrent calls for the endpoints.


Examples

The following is sample output from this command:

Router# show gatekeeper endpoints

CallsignalAddr   Port  RASSignalAddr   Port   Zone Name    Type     F
---------------  ----  -------------   -----  ----------   -----    --
172.21.127.8     1720  172.21.127.8    24999  sj-gk        MCU 
           H323-ID:joe@cisco.com
           Voice Capacity Max.=23  Avail.=23
           Total number of active registrations = 1
172.21.13.88     1720  172.21.13.88    1719   sj-gk        VOIP-GW   O    H323-ID:la-gw

Table 96 describes significant fields shown in this output.

Table 96 show gatekeeper endpoints Field Descriptions 

Field
Description

CallsignalAddr

Call signaling IP address of the endpoint. If the endpoint is also registered with an alias (or aliases), a list of all aliases registered for that endpoint should be listed on the line below.

Port

Call signaling port number of the endpoint.

RASSignalAddr

Registration, Admission, and Status (RAS) protocol IP address of the endpoint.

Port

RAS port number of the endpoint.

Zone Name

Zone name (gatekeeper identification [ID]) to which this endpoint is registered.

Type

Endpoint type (for example, terminal, gateway, or multipoint control unit [MCU]).

F

S—Endpoint is statically entered from the alias command rather than being dynamically registered through RAS messages.
O—Endpoint, which is a gateway, has sent notification that it is nearly out of resources.

Voice Capacity Max.

Maximum number of channels available on the endpoint.

Avail.

Current number of channels available on the endpoint.

Total number of active registrations

Total number of endpoints registered with the gatekeeper.


In the following example, the show gatekeeper endpoints output has been modified to reflect concurrent calls for the endpoint. If an endpoint is not reporting capacity and the endpoint max-calls h323id command is not configured, "Voice Capacity Max." and "Avail." will not be shown. "Current.= 2" indicates that the current active calls for the endpoint are 2.

Router# show gatekeeper endpoints
!
                    GATEKEEPER ENDPOINT REGISTRATION
                    ================================
CallSignalAddr  Port  RASSignalAddr   Port  Zone Name         Type    Flags 
--------------- ----  -------------   ----  ---------         ----    ----- 
172.18.200.27   1720  172.18.200.27   49918 GK-1              VOIP-GW 
    H323-ID:GW1
    Voice Capacity Max.=  Avail.=  Current.= 2

If an endpoint is reporting capacity but the endpoint max-calls h323id command is not configured, "Voice Capacity Max." and "Avail." will show reported call capacity of the endpoint as follows:

Router# show gatekeeper endpoints
!
                    GATEKEEPER ENDPOINT REGISTRATION
                    ================================
CallSignalAddr  Port  RASSignalAddr  Port  Zone Name          Type  Flags
--------------  ----  -------------  ----  ---------          ----  ----- 
172.18.200.29   1720  172.18.200.29  53152 GK-2               VOIP-GW 
    H323-ID:GW2
    Voice Capacity Max.= 23 Avail.= 22 Current.= 1

If an endpoint is reporting capacity but the endpoint max-calls h323id command is not configured, "Voice Capacity Max." will show the maximum calls configured and "Avail." will show the available calls of the endpoint. In this example, "Voice Capacity Max.= 10" is showing that the maximum calls configured for the endpoint are 10. "Avail.= 2" shows that currently available calls for the endpoint are 2. "Current.= 8" shows that current active calls for the endpoint are 8.

Router# show gatekeeper endpoints
!
                    GATEKEEPER ENDPOINT REGISTRATION
                    ================================
CallSignalAddr  Port  RASSignalAddr   Port  Zone Name         Type     Flags 
--------------  ----  -------------   ----  ---------         ----     ----- 
172.18.200.27   1720  172.18.200.27   49918 GK-1              VOIP-GW
    H323-ID:GW1
    Voice Capacity Max.= 10  Avail.= 2  Current.= 8

Table 97 describes significant fields in the output examples.

Table 97 show gatekeeper endpoints Field Descriptions 

Field
Description

CallsignalAddr

Call signaling IP address of the endpoint. If the endpoint is also registered with an alias (or aliases), a list of all aliases registered for that endpoint should be listed on the line below.

Port

Call signaling port number of the endpoint.

RASSignalAddr

Registration, Admission, and Status (RAS) protocol IP address of the endpoint.

Port

RAS port number of the endpoint.

Zone Name

Zone name (gatekeeper ID) to which this endpoint is registered.

Type

The endpoint type (for example, terminal, gateway, or multipoint control unit [MCU]).

Flags

S—Endpoint is statically entered from the alias command rather than being dynamically registered through RAS messages.
O—Endpoint, which is a gateway, has sent notification that it is nearly out of resources.


Related Commands

Command
Description

endpoint resource-threshold

Sets a gateway's capacity thresholds in the gatekeeper.

show gatekeeper endpoint circuits

Displays endpoint and carrier or trunk group call capacities.

show gatekeeper gw-type-prefix

Displays the gateway technology prefix table.

show gatekeeper zone status

Displays the status of zones related to a gatekeeper.

show gateway

Displays the current gateway status.


show gatekeeper gw-type-prefix

To display the gateway technology prefix table, use the show gatekeeper gw-type-prefix command in privileged EXEC mode.

show gatekeeper gw-type-prefix

Syntax Description

This command has no arguments or keywords.

Command Modes

Privileged EXEC

Command History

Release
Modification

11.3(2)NA

This command was introduced.

12.0(5)T

The display format was modified for H.323 Version 2.

12.1(5)XM2

This command was implemented on the Cisco AS5350 and Cisco AS5400.

12.2(4)T

This command was not supported on the Cisco AS5300, Cisco AS5350, and Cisco AS5400 in this release.

12.2(2)XB1

This command was implemented on the Cisco AS5850.

12.2(11)T

This command was integrated into Cisco IOS Release 12.2(11)T.


Examples

The following is sample output from this command for a gatekeeper that controls two local zones, sj-gk and la-gk:

Router# show gatekeeper gw-type-prefix

GATEWAY TYPE PREFIX TABLE
===========================
Prefix:12#*     (Default gateway-technology)
  Zone sj-gk master gateway list:
    10.0.0.0:1720 sj-gw1
    10.0.0.0:1720 sj-gw2 (out-of-resources)
    10.0.0.0:1720 sj-gw3
  Zone sj-gk prefix 408....... priority gateway list(s):
   Priority 10:
    10.0.0.0:1720 sj-gw1
   Priority 5:
    10.0.0.0:1720 sj-gw2 (out-of-resources)
    10.0.0.0:1720 sj-gw3
Prefix:7#*     (Hopoff zone la-gk)
  Statically-configured gateways (not necessarily currently registered):
    10.0.0.0:1720
    10.0.0.0:1720
  Zone la-gk master gateway list:
    10.0.0.0:1720 la-gw1
    10.0.0.0:1720 la-gw2

Table 98 describes significant fields shown in this output.

Table 98 show gatekeeper gw-type-prefix Field Descriptions 

Field
Description

Prefix

Technology prefix defined with the gw-type-prefix command.

Zone sj-gk master gateway list

List of all the gateways registered to zone sj-gk with the technology prefix under which they are listed. (This display shows that gateways sj-gw1, sj-gw2, and sj-gw3 have registered in zone sj-gk with the technology prefix 12#.)

Zone sj-gk prefix 408....... priority gateway list(s)

List of prioritized gateways to handle calls to area code 408.

Priority 10

Highest priority level. Gateways listed following "Priority 10" are given the highest priority when selecting a gateway to service calls to the specified area code. (In this display, gateway sj-gw1 is given the highest priority to handle calls to the 408 area code.)

Priority 5

Any gateway that does not have a priority level assigned to it defaults to priority 5.

(out-of-resources)

Indication that the displayed gateway has sent a "low-in-resources" notification.

(Hopoff zone la-gk)

Any call that specifies this technology prefix should be directed to hop off in the la-gk zone, no matter what the area code of the called number is. (In this display, calls that specify technology prefix 7# are always routed to zone la-gk, regardless of the actual zone prefix in the destination address.)

Zone la-gk master gateway list

List of all the gateways registered to la-gk with the technology prefix under which they are listed. (This display shows that gateways la-gw1 and la-gw2 have registered in zone la-gk with the technology prefix 7#. No priority lists are displayed here because none were defined for zone la-gk.)

(Default gateway-technology)

If no gateway-type prefix is specified in a called number, then gateways that register with 12# are the default type to be used for the call.

Statically-configured gateways

List of all IP addresses and port numbers of gateways that are incapable of supplying technology-prefix information when they register. This display shows that, when gateways 1.1.1.1:1720 and 2.2.2.2:1720 register, they are considered to be of type 7#.


Related Commands

Command
Description

show gatekeeper calls

Displays the status of each ongoing call of which a gatekeeper is aware.

show gatekeeper endpoints

Displays the status of all registered endpoints for a gatekeeper.

show gateway

Displays the current gateway status.


show gatekeeper performance statistics

To display information about the number of calls accepted and rejected and to find the number of endpoints sent to other gatekeepers, use the show gatekeeper performance statistics command in privileged EXEC mode.

show gatekeeper performance statistics [zone [name zone-name]] [cumulative]

Syntax Description

zone

(Optional) Zone statistics for the gatekeeper.

name

(Optional) Zone name or gatekeeper name.

zone-name

Local zone name.

cumulative

(Optional) Total statistics collected by the gatekeeper since the last reload. These values are not reset by the clear h323 gatekeeper statistics command.


Command Modes

Privileged EXEC

Command History

Release
Modification

12.1(5)XM

This command was introduced.

12.2(2)T1

This command was integrated into Cisco IOS Release 12.2(2)T.

12.2(2)XB1

This command was implemented on the Cisco AS5850.

12.2(15)T

The zone, name, and cumulative keywords were added and zone-name argument was added.

12.4(5)

Command output was enhanced to include counters for:

ARJs sent due to ARQ access-list denial

LRJs sent due to LRQ access-list denial


Usage Guidelines

Use this command to display the number of calls accepted, the number of calls rejected because of overload, and the number of endpoints sent to other gatekeepers.

When you enter this command, statistical data that relates to the router is displayed. You can identify the number of call initiation events using the following:

Automatic repeat request (ARQ)

Admission confirmation (ACF)

Admission rejection (ARJ)

You can identify endpoint contact events that have been requested and either confirmed or rejected on the router using the following:

Location request (LRQ)

Location confirm (LCF)

Location reject (LRJ)

The counts associated with overload and the number of endpoints sent to alternate gatekeepers that are associated with overload conditions are also displayed. Only when the router experiences an overload condition do these counters reveal a value other than zero. The real endpoint count simply displays the number of endpoints registered on this router platform. The time stamp displays the start time when the counters started capturing the data. When you want to request a new start period, enter the clear h323 gatekeeper statistics command. The counters are reset and the time stamp is updated with the new time.

You can identify endpoint contact events that have been requested and either confirmed or rejected on the router using the following:

Location confirm (LCF)

Location rejection (LRJ)

Location request (LRQ)

You can identify zone-level registration statistics using the following:

Registration confirmation (RCF)

Registration rejection (RRJ)

Registration request (RRQ)

You can identify zone-level unregistration statistics using the following:

Unregistration confirmation (UCF)

Unregistration rejection (URJ)

Unregistration request (URQ)

Examples

The following is sample output from this command:

Router# show gatekeeper performance statistics

Performance statistics captured since:00:14:02 UTC Mon Mar 1 1993

RAS inbound message counters:
        Originating ARQ:4      Terminating ARQ:1      LRQ:7
RAS outbound message counters:
        ACF:5  ARJ:0  LCF:7  LRJ:0
        ARJ due to overload:0
        LRJ due to overload:0

Load balancing events:0
Real endpoints:2

The following is sample BASIC output from the show gatekeeper performance stats command:

Router# show gatekeeper performance stats

-----Gatekeeper Performance Statistics-----

Performance statistics captured since: 20:09:00 UTC Thu Sep 15 2005


Gatekeeper level Admission Statistics:
        ARQs received: 1
        ARQs received from originating endpoints: 0
        ACFs sent: 1
        ACFs sent to the originating endpoint: 0
        ARJs sent: 0
        ARJs sent to the originating endpoint: 0
        ARJs sent due to overload: 0
        ARJs sent due to ARQ access-list denial: 0
        Number of concurrent calls: 0
        Number of concurrent originating calls: 0

Gatekeeper level Location Statistics:
        LRQs received: 3
        LRQs sent: 0
        LCFs received: 0
        LCFs sent: 1
        LRJs received: 0
        LRJs sent: 2
        LRJs sent due to overload: 0
        LRJs sent due to LRQ access-list denial: 2

Gatekeeper level Registration Statistics:
        RRJ due to overload: 0
        Total Registered  Endpoints: 2

Gatekeeper level Disengage Statistics:
        DRQs received: 1
        DRQs sent: 0
        DCFs received: 0
        DCFs sent: 1
        DRJs received: 0
        DRJs sent: 0

Gatekeeper viazone message counters:
        inARQ: 0
        infwdARQ: 0
        inerrARQ: 0
        inLRQ: 0
        infwdLRQ: 0
        inerrLRQ: 0
        outLRQ: 0
        outfwdLRQ: 0
        outerrLRQ: 0
        outARQ: 0
        outfwdARQ: 0
        outerrARQ: 0

Load balancing events: 0


The following CUMULATIVE sample output is the same as for BASIC output; the difference is that the BASIC counters are cleared by the clear h323 gatekeeper statistics command and CUMULATIVE counters are not.

Router# show gatekeeper performance stats zone name voip3-2600-2

Performance statistics for zone voip3-2600-2

-----Zone Level Performance Statistics-----

Performance statistics captured since: 00:17:00 UTC Mon Mar 1 1993 

Zone level Admission Statistics:
        ARQs received: 1 
        ARQs received from originating endpoints: 0 
        ACFs sent: 1 
        ACFs sent to the originating endpoint: 0 
        ARJs sent: 0 
        ARJs sent to the originating endpoint: 0 
        Number of concurrent total calls: 0 
        Number of concurrent originating calls: 0

Zone level Location Statistics:
        LRQs received: 1 
        LRQs sent: 0 
        LCFs received: 0 
        LCFs sent: 1 
        LRJs received: 0 
        LRJs sent: 0

Zone level Registration Statistics:
        Full RRQs received: 1 
        Light RRQs received: 574 
        RCFs sent: 576 
        RRJs sent: 0 
        Total Registered Endpoints: 1

Zone level UnRegistration Statistics:
        URQs received: 0 
        URQs sent: 0 
        UCFs received: 0 
        UCFs sent: 0 
        URJs received: 0 
        URJs sent: 0 
        URQs sent due to timeout: 0

Zone level Disengage Statistics:
        DRQs received: 1 
        DRQs sent: 0 
        DCFs received: 0 
        DCFs sent: 1 
        DRJs received: 0 
        DRJs sent: 0

Table 99 shows significant fields shown in the displays. Most of the fields are self-explanatory and are not listed the table.

Table 99 show gatekeeper performance statistics Field Descriptions

Field
Description

Full RRQs received

A full registration request (RRQ) contains all registration information that is used to establish or change a registration.

Light RRQs received

A light RRQ contains abbreviated registration information that is used to maintain an existing registration.


Related Commands

Command
Description

clear h323 gatekeeper statistics

Clears statistics about gatekeeper performance.


show gatekeeper servers

To display a list of currently registered and statically configured triggers on a gatekeeper router, use the show gatekeeper servers command in EXEC mode.

show gatekeeper servers [gkid]

Syntax Description

gkid

(Optional) Local gatekeeper name to which this trigger applies.


Command Modes

EXEC

Command History

Release
Modification

12.1(1)T

This command was introduced on the Cisco 2500 series, Cisco 2600 series, Cisco 3600 series, Cisco 7200, and Cisco MC3810.

12.2(2)XB

The output of this command was modified to show additional server statistics, including the following: gatekeeper server timeout value; Gatekeeper Transaction Message Protocol (GKTMP) version installed; number of Registration Request (RRQ), Registration Response (RRQ), Response Confirmation (RCF), and Response Reject (RRJ) messages received; timeouts encountered; average response time; and if the server is usable.

12.2(8)T

This command was integrated into Cisco IOS Release 12.2(8)T.

12.2(11)T

This command was implemented on the Cisco 3700 series.

12.2(15)T12

The command was modified to show additional server statistics.

12.3(8)T

The command was modified to show additional server statistics.

12.3(9)

The command was modified to show additional server statistics.


Usage Guidelines

Use this command to show all server triggers (whether dynamically registered from the external servers or statically configured from the command-line interface) on this gatekeeper. If the gatekeeper ID is specified, only triggers applied to the specified gatekeeper zone appear. If the gatekeeper ID is not specified, server triggers for all local zones on this gatekeeper appear.

Examples

The following is sample output from this command:

Router# show gatekeeper servers

            GATEKEEPER SERVERS STATUS
            =========================

Gatekeeper Server listening port: 8250
Gatekeeper Server timeout value: 30 (100ms)
GateKeeper GKTMP version: 4.1

Gatekeeper-ID: Gatekeeper1
------------------------
RRQ Priority: 5
Server-ID: Server43
Server IP address: 209.165.200.254:40118
Server type: dynamically registered
Connection Status: active
Trigger Information:
Trigger unconditionally
Server Statistics:
REQUEST RRQ Sent=0
RESPONSE RRQ Received = 0
RESPONSE RCF Received = 0
RESPONSE RRJ Received = 0
Average response time(ms)=0
Server Usable=TRUE

Timeout Statistics:

Server-ID: Server43
Server IP address: 209.165.200.254:40118
Server type: dynamically registered
Connection Status: active
Timeout Encountered=0

Table 100 describes significant fields shown in this output.

Table 100 show gatekeeper servers Field Descriptions

Field
Description

GateKeeper GKTMP version

Version of Gatekeeper Transaction Message Protocol installed.

RRQ Priority

Registration priority.

Server-ID

Server ID name.

Server IP address

Server IP address.

Server type

Type of server.

Connection Status

Whether the connection is active or inactive.

Trigger Information

Which Registration, Admission, and Status (RAS) messages the Cisco IOS gatekeeper forwards to the external application.

REQUEST RRQ

Registration requests received.

RESPONSE RRQ

Registration responses received.

RESPONSE RCF

Response confirmations received.

RESPONSE RRJ

Response reject messages received.


Related Commands

Command
Description

debug gatekeeper server

Traces all the message exchanges between the Cisco IOS gatekeeper and the external applications.

endpoint circuit-id h323id

Tracks call capacity information on the gatekeeper.

server registration-port

Configures a listening port on the gatekeeper for server registration.

server trigger arq

Configures static triggers on the gatekeeper.


show gatekeeper status

To display overall gatekeeper status, including authorization and authentication status and zone status, use the show gatekeeper status command in EXEC mode.

show gatekeeper status

Syntax Description

This command has no arguments or keywords.

Command Modes

EXEC

Command History

Release
Modification

11.3(2)NA

This command was introduced.

12.0(3)T

This command was integrated into Cisco IOS Release 12.0(3)T.

12.1(5)XM

This command was modified to show information about load balancing and vendor-specific attributes.

12.2(2)T

This command was integrated into Cisco IOS Release 12.2(2)T.

12.2(2)XB

This command was modified to show information about server flow control.

12.2(8)T

This command was integrated into Cisco IOS Release 12.2(8)T.


Examples

The following is sample output from this command:

Router# show gatekeeper status

Gatekeeper State: UP
    Load Balancing:   DISABLED
    Flow Control:     ENABLED
    Zone Name:        snet-3660-3
    Accounting:       DISABLED
    Endpoint Throttling:        DISABLED
    Security:         DISABLED
    Maximum Remote Bandwidth:              unlimited
    Current Remote Bandwidth:              0 kbps
    Current Remote Bandwidth (w/ Alt GKs): 0 kbps

Table 101 describes significant fields shown in this output.

Table 101 Show Gatekeeper Status Field Descriptions

Field
Description

Gatekeeper State

Gatekeeper state has the following values:

UP is operational.

DOWN is administratively shut down.

INACTIVE is administratively enabled; that is, the no shutdown command has been issued, but no local zones have been configured.

HSRP STANDBY indicates that the gatekeeper is on hot standby and will take over when the currently active gatekeeper fails.

Load Balancing

Whether load balancing is enabled.

Flow Control

Whether server flow control is enabled.

Zone Name

Zone name to which the gatekeeper belongs.

Accounting

Whether authorization and accounting features are enabled.

Endpoint Throttling

Whether endpoint throttling is enabled.

Security

Whether security features are enabled.

Bandwidth

Maximum remote bandwidth, current remote bandwidth, and current remote bandwidth with alternate gatekeepers.


Related Commands

Command
Description

show gatekeeper servers

Displays statistics about the gatekeeper.


show gatekeeper status cluster

To display information about each element of a local cluster, such as the amount of memory used, the number of active calls, and the number of endpoints registered on the element, use the show gatekeeper status cluster command in privileged EXEC mode.

show gatekeeper status cluster

Syntax Description

This command has no arguments or keywords.

Command Modes

Privileged EXEC

Command History

Release
Modification

12.1(5)XM1

This command was introduced.

12.2(2)T

This command was integrated into Cisco IOS Release 12.2(2)T.

12.2(2)XB1

This command was implemented on the Cisco AS5850.


Examples

The following command displays information about elements of a local cluster, two of whose components are RoseGK and LavenderGK:

Router# show gatekeeper status cluster

                   CLUSTER INFORMATION
                   ===================
                           Active     Endpoint       Last
Hostname     %Mem   %CPU    Calls        Count   Announce
--------     ----   ----   ------     --------   --------
RoseGK         72      0        1   Local Host
LavenderGK     30      1        0            4        14s

Related Commands

Command
Description

show gatekeeper endpoints

Displays the status of all registered endpoints for a gatekeeper.

show gatekeeper performance statistics

Displays information about the number of calls accepted and rejected, and finds the number of endpoints sent to other gatekeepers.

show gatekeeper zone cluster

Displays the dynamic status of all local clusters.


show gatekeeper zone cluster

To display the dynamic status of all local clusters, use the show gatekeeper zone cluster command in privileged EXEC mode.

show gatekeeper zone cluster

Syntax Description

This command has no arguments or keywords.

Command Modes

Privileged EXEC

Command History

Release
Modification

12.1(5)XM1

This command was introduced.

12.2(2)T

This command was integrated into Cisco IOS Release 12.2(2)T.

12.2(2)XB1

This command was implemented on the Cisco AS5850.


Examples

The following command displays information about the current bandwidth values and about when the last announcement message from the alternate gatekeeper was received. In the following example, PRI represents the priority value assigned to an alternate gatekeeper. This field ranges from 0 to 127, with 127 representing the lowest priority.

Router# show gatekeeper zone cluster

                  LOCAL CLUSTER INFORMATION¸6t
                  ============================
                                   TOT BW   INT BW   REM BW   LAST       ALT GK
LOCAL GK NAME   ALT GK NAME   PRI  (kbps)   (kbps)   (kbps)   ANNOUNCE   STATUS
-------------   -----------   ---  ------   ------   ------   --------   ------
ParisGK         GenevaGK      120  0        0        0        7s         CONNECTED
NiceGK          ZurichGK      100  0        0        0        7s         CONNECTED

Related Commands

Command
Description

timer cluster-element announce

Defines the time interval between successive announcement messages exchanged between elements of a local cluster.

zone cluster local

Defines a local grouping of gatekeepers.

zone remote

Statically specifies a remote zone if DNS is unavailable or undesirable.


show gatekeeper zone prefix

To display the zone prefix table, use the show gatekeeper zone prefix command in privileged EXEC mode.

show gatekeeper zone prefix [all]

Syntax Description

all

(Optional) Displays the dynamic zone prefixes registered by each gateway.


Command Modes

Privileged EXEC

Command History

Release
Modification

11.3(2)NA

This command was introduced.

12.2(15)T

The all keyword was added.


Usage Guidelines

If the all keyword is not specified, the show gatekeeper zone prefix command displays the static zone prefixes only. Use the include filter with the all keyword to display the prefixes associated with a particular gateway. For example, the show gatekeeper zone prefix all | include GW1 command displays the dynamic prefixes associated with gateway GW1.

Examples

The following command displays the zone prefix table for the gatekeeper:

Router# show gatekeeper zone prefix

      ZONE PREFIX TABLE
      =================
GK-NAME               E164-PREFIX
-------               -----------
gk2                   408*       
gk2                   5551001*   
gk2                   5551002*   
gk2                   5553020*   
gk2                   5553020*   
gk1                   555....    
gk2                   719*       
gk2                   919*       

The following command displays the zone prefix table, including the dynamic zone prefixes, for the gatekeeper:

Router# show gatekeeper zone prefix all

                    ZONE PREFIX TABLE
      ===============================================
GK-NAME               E164-PREFIX       Dynamic GW-priority
-------               -----------       -------------------
gk2                  408*
gk2                  5551001*             GW1 /5
gk2                  5551002*             GW1 /5 GW2 /10
gk2                  5553020*             GW1 /8 
gk2                  5553020*
gk1                  555....
gk2                  719*
gk2                  919*                 GW2 /5

Table 102 describes significant fields shown in this output.

Table 102 show gatekeeper zone prefix Field Descriptions

Field
Description

GK-NAME

Gatekeeper name.

E164-PREFIX

E.164 prefix and a dot that acts as a wildcard for matching each remaining number in the telephone number.

Dynamic GW-priority

Gateway that serves this E164 prefix.

Gateway priority. A 0 value prevents the gatekeeper from using the gateway for that prefix. Value 10 places the highest priority on the gateway. The default priority value for a dynamic gateway is 5.


show gatekeeper zone status

To display the status of zones related to a gatekeeper, use the show gatekeeper zone status command in privileged EXEC mode.

show gatekeeper zone status

Syntax Description

This command has no arguments or keywords.

Command Modes

Privileged EXEC

Command History

Release
Modification

11.3(2)NA

This command was introduced.

12.0(5)T

The display format was modified for H.323 Version 2.

12.1(5)XM2

This command was implemented on the Cisco AS5350 and Cisco AS5400.

12.2(4)T

This command was not supported on the Cisco AS5300, Cisco AS5350, and Cisco AS5400 in this release.

12.2(2)XB1

This command was implemented on the Cisco AS5850.

12.2(11)T

This command was integrated into Cisco IOS Release 12.2(11)T.


Examples

The following is sample output from this command:

Router# show gatekeeper zone status

                      GATEKEEPER ZONES
                      ================
GK name      Domain Name   RAS Address     PORT  FLAGS MAX-BW   CUR-BW
                                                       (kbps)   (kbps)
-------      -----------   -----------     ----  ----- ------   ------
sj.xyz.com   xyz.com       10.0.0.0        1719  LS             0
  SUBNET ATTRIBUTES :
    All Other Subnets :(Enabled)
  PROXY USAGE CONFIGURATION :
    inbound Calls from germany.xyz.com :
      to terminals in local zone sj.xyz.com :use proxy
      to gateways in local zone sj.xyz.com  :do not use proxy
    Outbound Calls to germany.xyz.com
      from terminals in local zone germany.xyz.com :use proxy
      from gateways in local zone germany.xyz.com  :do not use proxy
    Inbound Calls from all other zones :
      to terminals in local zone sj.xyz.com :use proxy
      to gateways in local zone sj.xyz.com  :do not use proxy
    Outbound Calls to all other zones :
      from terminals in local zone sj.xyz.com :do not use proxy
      from gateways in local zone sj.xyz.com  :do not use proxy
tokyo.xyz.co xyz.com         10.0.0.0        1719  RS             0
milan.xyz.co xyz.com         10.0.0.0        1719  RS             0

Table 103 describes significant fields shown in this output.

Table 103 show gatekeeper zone status Field Descriptions 

Field
Description

GK name

Gatekeeper name (also known as the zone name), which is truncated after 12 characters in the display.

Domain Name

Domain with which the gatekeeper is associated.

RAS Address

Registration, Admission, and Status (RAS) protocol address of the gatekeeper.

FLAGS

Displays the following information:

S = static (CLI-configured, not DNS-discovered)

L = local

R = remote

MAX-BW

Maximum bandwidth for the zone, in kbps.

CUR-BW

Current bandwidth in use, in kbps.

SUBNET ATTRIBUTES

List of subnets controlled by the local gatekeeper.

PROXY USAGE CONFIGURATION

Inbound and outbound proxy policies as configured for the local gatekeeper (or zone).


Related Commands

Command
Description

show gatekeeper calls

Displays the status of each ongoing call of which a gatekeeper is aware.

show gatekeeper endpoints

Displays the status of registered endpoints for a gatekeeper.

show gateway

Displays the current gateway status.