Multiservice Applications Commands:
R through Sh

Syntax Description

This command has no keywords or arguments.

Defaults

No E.164 addresses are registered until you enter this command.

Command Modes

Dial-peer configuration

Command History

Release	Modification
12.0(5)T	This command was introduced.

Usage Guidelines

Use this command to register the E.164 address of an analog telephone line attached to an FXS port on a router. The gateway automatically registers fully-qualified E164 addresses. Use the no register e164 command to deregister an address. Use the register e164 command to register a deregistered address.

Before you automatically or manually register an E.164 address with a gatekeeper, you must create a dial peer (dial-peer command), assign an FXS port to the peer (port command), and assign an E.164 address by using the destination-pattern command. The E.164 address must be a fully-qualified address. For example, +5551212, 5551212, and 4085551212 are fully-qualified addresses; 408555.... is not a fully-qualified address. E.164 addresses are only registered for active interfaces---those that are not shut down. If an FXS port or its interface is shut down, the corresponding E.164 address is deregistered.

Tips You can use the show gateway command to find out if the gateway is connected to a gatekeeper and if a fully-qualified E.164 address is assigned to the gateway. Use the zone-prefix command at the gatekeeper to define prefix patterns, such as 408555...., that apply to one or more gateways.

Examples

The following command sequence places the gateway in dial-peer configuration mode, assigns a E.164 address to the interface, and registers that address with the gatekeeper:

dial-peer voice 111 pots
port 1/0/0
destination-pattern 5551212
register e164
 

The following commands deregister an address with the gatekeeper:

dial-peer voice 111 pots
no register e164
 

The following example shows that you must have a connection to a gatekeeper and define a unique E.164 address before you can register an address:

dial-peer voice 222 pots
port 1/0/0
destination 919555....
register e164
 
 
ERROR-register-e164:Dial-peer destination-pattern is not a full E.164 number
 
no gateway
dial-peer voice 111 pots
register e164
 
 
ERROR-register-e164:No gatekeeper

Related Commands

Command	Description
destination-pattern	Specifies either the prefix, the full E.164 telephone number, or an ISDN directory number (depending on the dial plan) to be used for a dial peer.
dial-peer	Enters dial-peer configuration mode, defines the type of dial peer, and defines the tag number associated with a dial peer.
port	Enables an interface on a PA-4R-DTR port adapter to operate as a concentrator port.
show gateway	Displays the current gateway status.
zone prefix	Configures the gatekeeper with knowledge of its own prefix and the prefix of any remote zone.

Syntax Description

all	(Optional) Applies the high- and low- parameter settings to all monitored H.323 resources. This is the default condition.
high percentage-value	(Optional) A resource utilization level that triggers a Resource Availability Indicator (RAI) message that indicates that H.323 resource use is high. Enter a number between 1 and 100 that represents the high-resource utilization percentage. A 100 value specifies high-resource usage when any H.323 resource is unavailable. The default is 90 percent.
low percentage-value	(Optional) Resource utilization level that triggers an RAI message that indicates that H.323 resource usage has dropped below the high usage level. Enter a number between 1 and 100 that represents the acceptable resource utilization percentage. After the gateway sends a high-utilization message, it waits to send the resource recovery message until the resource use drops below the value defined by the low parameter. The default is 90 percent.

Defaults

Reports low resources when 90 percent of resources are in use, and reports resource availability when resource use drops below 90 percent.

Command Modes

Gateway configuration

Command History

Release	Modification
12.0(5)T	This command was introduced.

Usage Guidelines

The resource threshold command defines the resource load levels that trigger Resource Availability Indicator (RAI) messages. To view the monitored resources, enter the show gateway command.

The monitored H.323 resources include digital signal processor (DSP) channels and DS0s. Use the show call resource voice stats command to see the total amount of resources available for H.323 calls.

Note The DS0 resources that are monitored for H.323 calls are limited to the ones that are associated with a voice POTS dial peer.

See the dial-peer configuration commands for details on how to associate a dial peer with a PRI or CAS group.

When any monitored H.323 resources exceed the threshold level defined by the high parameter, the gateway sends an RAI message to the gatekeeper with the AlmostOutOfResources field flagged. This message reports high-resource usage.

When all gateway H.323 resources drop below the level defined by the low parameter, the gateway sends the RAI message to the gatekeeper with the AlmostOutOfResources field cleared.

When a gatekeeper can choose between multiple gateways for call completion, the gatekeeper uses internal priority settings and gateway resource statistics to determine which gateway to use. When all other factors are equal, a gateway that has available resources will be chosen over a gateway that has reported limited resources.

Examples

The following command defines the H.323 resource limits for a gateway:

resource threshold high 70 low 60

Related Commands

Command	Description
show gateway	Displays the current gateway status.
show call resource voice stats	Displays resource statistics for an H.323 gateway.
show call resource voice threshold	Displays the threshold configuration settings and status for an H.323 gateway.

Syntax Description

best-effort	Indicates that Resource Reservation Protocol (RSVP) makes no bandwidth reservation.
controlled-load	Indicates that RSVP guarantees a single level of preferential service, presumed to correlate to a delay boundary. The controlled load service uses admission (or capacity) control to assure that preferential service is received even when the bandwidth is overloaded.
guaranteed-delay	Indicates that RSVP reserves bandwidth and guarantees a minimum bit rate and preferential queueing if the bandwidth reserved is not exceeded.

Defaults

best-effort

Command Modes

Dial-peer configuration

Command History

Release	Modification
11.3(1)T	This command was introduced.

Usage Guidelines

This command is applicable only to VoIP dial peers.

Use the req-qos command to request a specific quality of service to be used in reaching a dial peer. Like acc-qos, when you issue this command, the Cisco IOS software reserves a certain amount of bandwidth so that the selected quality of service can be provided. Cisco IOS software uses Resource Reservation Protocol (RSVP) to request quality of service guarantees from the network.

Examples

The following example configures guaranteed-delay as the desired (requested) quality of service to a dial peer:

dial-peer voice 10 voip
 req-qos guaranteed-delay

Related Commands

Command	Description
acc-qos	Generates an SNMP event if the quality of service for a dial peer drops below a specified level.

Syntax Description

number

Specifies the number of DSPs to be reset. The number of DSPs range from 0 to 30.

Defaults

No default behavior or values.

Command Modes

Global configuration

Command History

12.0(5)XE and 12.0(7)T

This command was introduced.

Examples

The following example displays the reset command configuration for DSP 1:

reset 1
01:24:54:%DSPRM-5-UPDOWN: DSP 1 in slot 1, changed state to up 

Syntax Description

num	Indicates the response waiting time in seconds.

Defaults

The default response timeout is 1 second (one second).

Command Modes

Settlement configuration

Command History

Release	Modification
12.0(4)XH1	This command was introduced.

Usage Guidelines

If no response is received within this time limit, the current connection ends and the router attempts to contact the next service point.

Examples

The following example configures a 1-second time to wait for a response from a server:

settlement 0
 response-timeout 1

Related Commands

Command	Description
connection-timeout	Configures the time that a connection is maintained after completing a communication exchange.
customer-id	Identifies a carrier or ISP with a settlement provider.
device-id	Specifies a gateway associated with a settlement provider.
encryption	Sets the encryption method to be negotiated with the provider.
max-connection	Sets the maximum number of simultaneous connections to be used for communication with a settlement provider.
retry-delay	Sets the time between attempts to connect with the settlement provider.
retry-limit	Sets the maximum number of connection attempts to the provider.
session-timeout	Sets the interval for closing the connection when there is no input or output traffic.
settlement	Enters settlement mode and specifies the attributes specific to a settlement provider.
type	Configures an SAA-RTR operation type.

Syntax Description

num	Length of time (in seconds) between attempts to connect with the settlement provider. The valid range for retry-delay is 1 to 600 seconds.

Defaults

The default retry delay is 2 seconds.

Command Modes

Settlement configuration

Command History

Release	Modification
12.0(4)XH1	This command was introduced.

Usage Guidelines

To set the time between attempts to connect with the settlement provider, use the retry-delay command in the settlement configuration mode. After exhausting all service points for the provider, the router is delayed for this length of time before resuming connection attempts.

Examples

The following example sets a retry value of 15 seconds:

settlement 0
 relay-delay 15

Related Commands

Command	Description
connection-timeout	Configures the time that a connection is maintained after completing a communication exchange.
customer-id	Identifies a carrier or ISP with a settlement provider.
device-id	Specifies a gateway associated with a settlement provider.
encryption	Sets the encryption method to be negotiated with the provider.
max-connection	Sets the maximum number of simultaneous connections to be used for communication with a settlement provider.
response-timeout	Configures the maximum time to wait for a response from a server.
retry-limit	Sets the maximum number of connection attempts to the provider.
session-timeout	Sets the interval for closing the connection when there is no input or output traffic.
settlement	Enters settlement mode and specifies the attributes specific to a settlement provider.
type	Configures an SAA-RTR operation type.

Syntax Description

num	Maximum number of connection attempts in addition to the first attempt.

Defaults

The default retry limit is one (1) retry.

Command Modes

Settlement configuration

Command History

Release	Modification
12.0(4)XH1	This command was introduced.

Usage Guidelines

If no connection is established after the configured retries, the router ceases connection attempts. The retry limit number does not count the initial connection attempt. A retry limit of one (default) results in a total of two connection attempts to every service point.

Examples

The following example sets the number of retries to 1:

settlement 0
 relay-limit 1 

Related Commands

Command	Description
connection-timeout	Configures the time that a connection is maintained after completing a communication exchange.
customer-id	Identifies a carrier or ISP with a settlement provider.
device-id	Specifies a gateway associated with a settlement provider.
encryption	Sets the encryption method to be negotiated with the provider.
max-connection	Sets the maximum number of simultaneous connections to be used for communication with a settlement provider.
response-timeout	Configures the maximum time to wait for a response from a server.
retry-delay	Sets the time between attempts to connect with the settlement provider.
session-timeout	Sets the interval for closing the connection when there is no input or output traffic.
settlement	Enters settlement mode and specifies the attributes specific to a settlement provider.
type	Configures an SAA-RTR operation type.

Syntax Description

cadence-number

Number from 0 through 2: Type 0 is a primary ringing cadence---default ringing cadence for country your router is in. Type 1 is a distinctive ring---0.8 seconds on, 0.4 seconds off, 0.8 seconds on, 0.4 seconds off. Type 2 is a distinctive ring---0.4 seconds on, 0.2 seconds off, 0.4 seconds on, 0.2 seconds off, 0.8 seconds on, 4 seconds off.

Defaults

The default is 0.

Command Modes

Interface configuration

Command History

Release	Modification
12.0(3)T	This command was introduced.

Usage Guidelines

This command applies to Cisco 800 series routers.

You can specify this command when creating a dial peer. This command will not work if it is not specified within the context of a dial peer. For information on creating a dial peer, refer to the Cisco 800 Series Routers Software Configuration Guide.

Examples

The following example specifies the type 1 distinctive ring:

ring 1

Related Commands

Command	Description
destination-pattern	Specifies either the prefix, the full E.164 telephone number, or an ISDN directory number (depending on the dial plan) to be used for a dial peer.
dial-peer voice	Enters dial-peer configuration mode, defines the type of dial peer, and defines the tag number associated with a dial peer.
no call-waiting	Disables call waiting.
port (dial-peer)	Enables an interface on a PA-4R-DTR port adapter to operate as a concentrator port.
pots distinctive-ring-guard-time	Specifies a delay in which a telephone port can be rung after a previous call is disconnected (Cisco 800 series routers).
ring	Sets up a distinctive ring for telephones, fax machines, or modems connected to a Cisco 800 series router.
show dial-peer voice	Displays configuration information and call statistics for dial peers.

Syntax Description

on1	(Optional) Pulses on for 100 milliseconds.
off1	(Optional) Pulses off for 100 milliseconds.
on2	(Optional) Pulses on for 200 milliseconds.
off2	(Optional) Pulses off for 200 milliseconds.
on3	(Optional) Pulses on for 300 milliseconds.
off3	(Optional) Pulses off for 300 milliseconds.
on4	(Optional) Pulses on for 400 milliseconds.
off4	(Optional) Pulses off for 400 milliseconds.
on5	(Optional) Pulses on for 500 milliseconds.
off5	(Optional) Pulses off for 500 milliseconds.
on6	(Optional) Pulses on for 600 milliseconds.
off6	(Optional) Pulses off for 600 milliseconds.

Defaults

on2 off4 (default North American ring pattern)

Command Modes

Voice-port configuration

Command History

Release	Modification
11.3 MA	This command was introduced.

Usage Guidelines

This command applies only to the Cisco MC3810.

Examples

The following example configures the ring cadence for 0.4 seconds on and 0.2 seconds off on voice port 1/1 on the Cisco MC3810:

voice-port 1/1
 ring cadence on4 off2

Related Commands

Command	Description
ring frequency	Specifies the ring frequency for a specified FXS voice port.
ring number	Specifies the number of rings for a specified FXO voice port.

Syntax Description

number

Ring frequency (hertz) used in the FXS interface. Valid entries on the Cisco 3600 series are 25 and 50. Valid entries on the Cisco MC3810 are 20 and 30.

Defaults

25 Hz on the Cisco 3600 series and 20 Hz on the Cisco MC3810

Command Modes

Voice-port configuration

Command History

Release	Modification
11.3(1)T	This command was introduced.

Usage Guidelines

Use the ring frequency command to select a specific ring frequency for an FXS voice port. Use the no form of this command to reset the default value for this command. The ring frequency you select must match the connected equipment. If set incorrectly, the attached phone might not ring or might buzz. In addition, the ring frequency is usually country-dependent and you should take into account the appropriate ring frequency for your area before configuring this command.

This command does not affect ringback, which is the ringing a user hears when placing a remote call.

Examples

The following example configures the ring frequency on the Cisco 3600 series for 25 Hz:

voice-port 1/0/0
 ring frequency 25
 

The following example configures the ring frequency on the Cisco MC3810 for 20 Hz:

voice-port 1/1
 ring frequency 20

Related Commands

Command	Description
ring cadence	Specifies the ring cadence for an FXS voice port on the Cisco MC3810 multiservice concentrator.
ring number	Specifies the number of rings for a specified FXO voice port.

Syntax Description

number

Number of rings detected before answering the call. Valid entries are numbers from 1 to 10. The default is 1.

Defaults

One ring

Command Modes

Voice-port configuration

Command History

Release	Modification
11.3(1)T	This command was introduced.

Usage Guidelines

Use the ring number command to set the maximum number of rings to be detected before answering a call over an FXO voice port. Use the no form of this command to reset the default value, which is one ring.

Normally, this command should be set to the default so that incoming calls are answered quickly. If you have other equipment available on the line to answer incoming calls, you might want to set the value higher to give the equipment sufficient time to respond. In that case, the FXO interface would answer if the equipment on line did not answer the incoming call in the configured number of rings.

This command is not applicable to FXS or E&M interfaces because they do not receive ringing to receive a call.

Examples

The following example on the Cisco 3600 series sets five rings as the maximum number of rings to be detected before closing a connection over this voice port:

voice-port 1/0/0
 ring number 5
 

The following example on the Cisco MC3810 sets five rings as the maximum number of rings to be detected before closing a connection over this voice port:

voice-port 1/1
 ring number 5

Related Commands

Command	Description
ring frequency	Specifies the ring frequency for a specified FXS voice port.

Syntax Description

any	Uses the first alias of an incoming RAS registration, regardless of its type, as the means of identifying the user to RADIUS/TACACS+.
h323-id	Uses the first H.323 ID type alias as the means of identifying the user to RADIUS/TACACS+.
e164	Uses the first E.164 address type alias as the means of identifying the user to RADIUS/TACACS+.
password default password	Specifies the default password that the gatekeeper associates with endpoints when authenticating them with an authentication server. The password must be identical to the password on the authentication server.
password separator character	Specifies the character that endpoints use to separate the H.323-ID from the piggybacked password in the registration. This allows each endpoint to supply a user-specific password. The separator character and password will be stripped from the string before it is treated as an H.323-ID alias to be registered. Note that passwords may only be piggybacked in the H.323-ID, not the E.164 address. This is because the E.164 address allows a limited set of mostly numeric characters. If the endpoint does not wish to register an H.323-ID, it can still supply an H.323-ID consisting of just the separator character and password. This will be understood to be a password mechanism and no H.323-ID will be registered.

Defaults

Disabled

Command Modes

Gatekeeper configuration

Command History

Release	Modification
11.3(2)NA	This command was introduced.

Usage Guidelines

Use the security command to enable identification of registered aliases by RADIUS/TACACS+. If the alias does not exist in RADIUS/TACACS+, the endpoint will not be allowed to register.

A RADIUS/TACACS+ server and encryption key must have been configured in Cisco IOS software for security to work.

Only the first alias of the proper type will be identified. If no alias of the proper type is found, the registration will be rejected.

This command does not allow you to define the password mechanism unless the security type (h323-id or e164 or any) has been defined. While the no security password command undefines the password mechanism, it leaves the security type unchanged, so security is still enabled. However, the no security {h323-id | e164 | any} command disables security entirely, including removing any existing password definitions.

Examples

The following example enables identification of registrations using the first H.323 ID found in any registration:

security h323id
 

The following example enables security, authenticating all users by using their H.323-IDs and a password of qwerty2x:

security h323-id
security password qwerty2x
 

The next example enables security, authenticating all users by using their H.323-IDs and the password entered by the user in the H.323-ID alias he or she registers:

security h323-id
security password separator !
 

Now if a user registers with an H.323-ID of joe!024aqx, the gatekeeper authenticates user joe with password 024aqx, and if that is successful, registers the user with the H.323-ID of joe. If the exclamation mark is not found, the user is authenticated with the default password or a null password if no default has been configured.

The following example enables security, authenticating all users by using their E.164 IDs and the password entered by the user in the H.323-ID alias he or she registers:

security e164
security password separator !
 

Now if a user registers with an E.164 address of 5551212 and an H.323-ID of !hs8473q6, the gatekeeper authenticates user 5551212 and password hs8473q6. Because the H.323-ID string supplied by the user begins with the separator character, no H.323-ID is registered and the user is only known by the E.164 address.

Related Commands

Command	Description
accounting (gatekeeper)	Enables the accounting security feature on the gatekeeper.
radius-server host	Specifies a RADIUS server host.
radius-server key	Sets the authentication and encryption key for all RADIUS communications between the router and the RADIUS daemon.

Syntax Description

This command has no arguments or keywords.

Defaults

Disabled

Command Modes

Dial-peer configuration

Command History

Release	Modification
12.0(4)T	This command was introduced.

Usage Guidelines

Sequence numbers on voice packets allow the digital signal processor (DSP)s at the playout side to detect lost packets, duplicate packets or out-of-sequence packets. This helps the DSP to mask out occasional drop-outs in voice transmission at the cost of one extra byte per packet. The benefit of using sequence numbers versus the cost in bandwidth of adding an extra byte to each voice packet on the Frame Relay network must be weighed to determine whether or not to disable this function for your application.

Another factor to consider is that this command does not affect codecs that require a sequence number, such as G.726. If you are using a codec that requires a sequence number, the DSP will generate one regardless of the configuration of this command.

Examples

The following example shows how to disable the generation of sequence numbers for VoFR frames on a Cisco 2600 series or 3600 series router or on a Cisco MC3810 concentrator for VoFR dial peer 200, starting from global configuration mode:

dial-peer voice 200 vofr
 no sequence-numbers

Related Commands

Command	Description
called-number (dial-peer)	Enables an incoming VoFR call leg to get bridged to the correct POTS call leg when using a static FRF.11 trunk connection.
codec (dial-peer)	Specifies the voice coder rate of speech for a Voice over Frame Relay dial peer.
cptone	Specifies a regional analog voice interface-related tone, ring, and cadence setting.
destination-pattern	Specifies either the prefix, the full E.164 telephone number, or an ISDN directory number (depending on the dial plan) to be used for a dial peer.
dtmf-relay (Voice over Frame Relay)	Enables the generation of FRF.11 Annex A frames for a dial peer.
session protocol (Voice over Frame Relay)	Establishes a session protocol for calls between the local and remote routers via the packet network.
session target	Specifies a network-specific address for a specified dial peer or destination gatekeeper.
signal-type	Sets the signalling type to be used when connecting to a dial peer.

Syntax Description

count

Value from 0 to 900 in seconds. This is the frequency at which the hardware is reset.

Defaults

0 is the default value.

Command Modes

Interface configuration

Command History

Release	Modification
11.2 P	This command was supported.
12.0(5)XK and 12.0(7)T	Support was added for the Cisco MC3810.

Usage Guidelines

The router resets the hardware each time the serial restart timer expires. This command is often used with the dial backup feature and with the pulse-time command, which sets the amount of time to wait before redialing when a DTR dialed device fails to connect.

When the count value is set to the default of 0, the hardware is not reset when it goes down. In this way, if the interface is used to answer a call, it does not cause DTR to drop, which can cause a communications device to disconnect.

Examples

On Cisco MC3810 interface Serial 0, this examples shows the restart delay set to 0:

interface Serial0
 serial restart-delay 0

Related Commands

Command	Description
pulse-time	Enables pulsing DTR signal intervals on the serial interfaces.
show interfaces serial	Displays information about a serial interface.

Syntax Description

protocol

Specifies the call session protocol. The following session protocols are supported: cisco---Specifies Cisco Session Protocol session protocol. smtp---Specifies Simple Mail Transfer Protocol (SMTP) session protocol.

Defaults

cisco

Command Modes

Dial-peer configuration

Command History

Release	Modification
11.3(1)T	This command was introduced.
12.0(4)XJ	This command was modified for Store and Forward Fax.

Usage Guidelines

Cisco Session Protocol (cisco) is the only applicable session protocol for VoIP peers. SMTP is the only applicable session protocol for Store and Forward Fax and applies to both on-ramp and off-ramp Store and Forward Fax functions.

Examples

The following example selects Cisco Session Protocol as the session protocol:

dial-peer voice 10 voip
 session protocol cisco
 

The following example selects SMTP as the session protocol:

dial-peer voice 10 mmoip
 session protocol smtp

Related Commands

Command	Description
session target	Specifies a network-specific address for a specified dial peer.

Syntax Description

cisco-switched	Specifies proprietary Cisco VoFR session protocol. (This is the only valid session protocol for the Cisco 7200 series.)
frf11-trunk	Specifies FRF.11 session protocol.

Defaults

cisco-switched

Command Modes

Dial-peer configuration

Command History

Release	Modification
11.3(1)T	This command was introduced for VoIP.
12.0(4)T	The cisco-switched and frf11-trunk keywords were added for VoFR dial peers.

Usage Guidelines

For Cisco-to-Cisco dial peer connections, Cisco recommends that you use the default session protocol due to the advantages it offers over a pure FRF.11 implementation. When connecting to FRF.11-compliant equipment from other vendors, use the frf11-trunk session protocol.

Note When using the frf11-trunk session protocol on Cisco 2600 series and 3600 series routers, the called-number command must also be used.

Examples

The following example shows how to configure the frf11-trunk session protocol on a Cisco 2600 series or 3600 series router for VoFR dial peer 200:

dial-peer voice 200 vofr
 session protocol frf11-trunk
 called-number 5552150
 

The following example shows how to configure the frf11-trunk session protocol on a Cisco MC3810 concentrator for VoFR dial peer 200:

dial-peer voice 200 vofr
 session protocol frf11-trunk

Related Commands

Command	Description
called-number (dial-peer)	Enables an incoming VoFR call leg to get bridged to the correct POTS call leg when using a static FRF.11 trunk connection.
codec (dial-peer)	Specifies the voice coder rate of speech for a Voice over Frame Relay dial peer.
cptone	Specifies a regional analog voice interface-related tone, ring, and cadence setting.
destination-pattern	Specifies either the prefix, the full E.164 telephone number, or an ISDN directory number (depending on the dial plan) to be used for a dial peer.
dtmf-relay (Voice over Frame Relay)	Enables the generation of FRF.11 Annex A frames for a dial peer.
preference	Indicates the preferred order of a dial peer within a rotary hunt group.
session target	Specifies a network-specific address for a specified dial peer or destination gatekeeper.
signal-type	Sets the signalling type to be used when connecting to a dial peer.

Note This command applies to all dial peers except for POTS dial peers.

Cisco 2600 series and 3600 series Voice over Frame Relay dial peers

session target interface dlci [cid]

no session target

Cisco 2600 series and 3600 series Voice over IP dial peers

session target {ipv4:destination-address | dns:[$s$. | $d$. | $e$. | $u$.] host-name |
loopback:rtp | loopback:compressed | loopback:uncompressed}

no session target

Cisco MC3810 Voice over Frame Relay dial peers

session target interface dlci [cid]

no session target

Cisco MC3810 Voice over ATM dial peers

session target interface pvc {name | vpi/vci | vci}

no session target

Cisco MC3810 Voice over HDLC dial peers

session target interface

no session target

Cisco AS5300 access servers Voice over IP dial peers

session target {ipv4:destination-address | dns:[$s$. | $d$. | $e$. | $u$.] host-name |
loopback:rtp | loopback:compressed | loopback:uncompressed | mailto:{name | $d$}@domain-name | ipv4:destination-address | dns:[$s$. | $d$. | $u$. | $e$.] host-name}

no session target

Cisco AS5800 universal access servers Voice over IP dial peers

session target {ipv4:destination-address | dns:[$s$. | $d$. | $e$. | $u$.] host-name |
loopback:rtp | loopback:compressed | loopback:uncompressed}

no session target

Cisco 7200 series Voice over Frame Relay dial peers

session target interface dlci

no session target

Syntax Description

Cisco 2600 series and 3600 series Voice over Frame Relay dial peers

interface	Specifies the serial interface and interface number (slot number/port number) associated with this dial peer.
dlci	Specifies the data link connection identifier for this dial peer. The valid range is from 16 to 1007.
cid	(Optional) Specifies the DLCI subchannel to be used for data on FRF.11 calls. A CID must be specified only when the session protocol is frf11-trunk. When the session protocol is cisco-switched, the CID is dynamically allocated. The valid range is from 4 to 255. Note By default, CID 4 is used for data; CID 5 is used for call-control. We recommend that you select CID values between 6 and 63 for voice traffic. If the CID is greater than 63, the FRF.11 header will contain an extra byte of data.

Cisco 2600 and Cisco 3600 series Voice over IP dial peers

ipv4:destination-address	IP address of the dial peer.
dns:host-name	Indicates that the domain name server will be used to resolve the name of the IP address. Valid entries for this parameter are characters representing the name of the host device. (Optional) You can use one of the following three wildcards with this keyword when defining the session target for VoIP peers: $s$.---Indicates that the source destination pattern will be used as part of the domain name. $d$.---Indicates that the destination number will be used as part of the domain name. $e$.---Indicates that the digits in the called number will be reversed, periods will be added in-between each digit of the called number, and that this string will be used as part of the domain name. $u$.---Indicates that the unmatched portion of the destination pattern (such as a defined extension number) will be used as part of the domain name.
loopback:rtp	Indicates that all voice data will be looped back to the originating source. This is applicable for VoIP peers.
loopback:compressed	Indicates that all voice data will be looped back in compressed mode to the originating source. This is applicable for POTS peers.
loopback:uncompressed	Indicates that all voice data will be looped-back in uncompressed mode to the originating source. This is applicable for POTS peers.

Cisco MC3810 Voice over Frame Relay dial peers

interface	Specifies the interface type and interface number on the Cisco MC3810. For the range of valid interface numbers for the selected interface type, enter a ? character after the interface type.
dlci	Specifies the Frame Relay DLCI. The valid range is from 16 to 1007.
cid	(Optional) Specifies a subchannel ID for the Frame Relay DLCI. The valid range is from 4 to 255.

Cisco MC3810 Voice over ATM dial peers

interface	Specifies the interface number.
ATM interface	Specifies the ATM interface number on the Cisco MC3810. The only valid number is 0.
pvc	Specifies a permanent virtual circuit (pvc).
name	The PVC name.
vpi/vci	The ATM network virtual path identifier (VPI) and virtual channel identifier (VCI) of this PVC.
vci	The ATM network virtual channel identifier (VCI) of this PVC.

For the Cisco MC3810 Voice over HDLC dial peers

interface	Specifies the interface number.
serial-port-number	Specifies the serial port number on the Cisco MC3810. The valid range is 0 to 1.

Cisco AS5300 access server Voice over IP dial peers

mailto:name	Specific recipient e-mail address, name, or mailing list alias.
mailto	Wildcard that inserts the destination pattern of the recipient.
@domain-name	Specifies the appropriate domain name associated with the e-mail address.
ipv4:destination-address	IP address of the dial peer.
dns:host-name	Indicates that the domain name server will be used to resolve the name of the IP address. Valid entries for this parameter are characters representing the name of the host device. (Optional) You can use one of the following three wildcards with this keyword when defining the session target for VoIP peers: $s$.---Indicates that the source destination pattern will be used as part of the domain name. $d$.---Indicates that the destination number will be used as part of the domain name. $e$.---Indicates that the destination pattern is used as part of the domain name in reverse dotted format for tpc.int DNS format. For example, if the destination number is 310 555-1234 and the session target is configured as $e$.cisco.com, the translated DNS name will be 4.3.2.1.5.5.5.0.1.3.cisco.com. $u$.---Indicates that the unmatched portion of the destination pattern (such as a defined extension number) will be used as part of the domain name.
loopback:rtp	Indicates that all voice data will be looped back to the originating source. This applies to VoIP peers.
loopback:compressed	Indicates that all voice data will be looped back in compressed mode to the originating source. This applies to POTS peers.
loopback:uncompressed	Indicates that all voice data will be looped back in uncompressed mode to the originating source. This applies to POTS peers.

Cisco AS5800 universal access server Voice over IP dial peers

ipv4:destination-address	IP address of the dial peer.
dns:host-name	Indicates that the domain name server will be used to resolve the name of the IP address. Valid entries for this parameter are characters representing the name of the host device. (Optional) You can use one of the following three wildcards with this keyword when defining the session target for VoIP peers: $s$.---Indicates that the source destination pattern will be used as part of the domain name. $d$.---Indicates that the destination number will be used as part of the domain name. $e$.---Indicates that the destination pattern is used as part of the domain name in reverse dotted format for tpc.int DNS format. For example, if the destination number is 310 555-1234 and the session target is configured as $e$.cisco.com, the translated DNS name will be 4.3.2.1.5.5.5.0.1.3.cisco.com. $u$.---Indicates that the unmatched portion of the destination pattern (such as a defined extension number) will be used as part of the domain name.
loopback:rtp	Indicates that all voice data will be looped back to the originating source. This applies to VoIP peers.
loopback:compressed	Indicates that all voice data will be looped back in compressed mode to the originating source. This applies to POTS peers.
loopback:uncompressed	Indicates that all voice data will be looped back in uncompressed mode to the originating source. This applies to POTS peers.

Cisco 7200 series Voice over Frame Relay dial peers

interface	Specifies the interface type and interface number on the Cisco 7200 series router. For the range of valid interface numbers for the selected interface type, enter a ? character after the interface type.
dlci	Specifies the Frame Relay DLCI. The valid range is from 16 to 1007.

Defaults

The default for this command is enabled with no IP address or domain name defined.

Command Modes

Dial-peer configuration

Command History

Release	Modification
11.3(1)T	This command was introduced.
11.3(1)MA	Support was added for VoFR, VoATM, VoHDLC, and POTS dial peers on the Cisco MC3810.
12.0(3)T	Support was added for VoIP and POTS dial peers on the Cisco AS5300.
12.0(3)XG and 12.0(4)T	Support was added for VoFR dial peers on the Cisco 2600 series and 3600 series routers. The cid option was added.
12.0(4)T	Support was added for VoFR and POTS dial peers on the Cisco 7200 series routers.
12.0(4)XJ	Support was added for Store and Forward Fax on the Cisco AS5300 platform.

Usage Guidelines

Use the session target command to specify a network-specific address or domain name for a dial peer. Whether you select a network-specific address or a domain name depends on the session protocol you select.

The session target loopback command is used for testing the voice transmission path of a call. The loopback point will depend on the call origination and the loopback type selected.

The session target dns command can be used with or without the specified wildcards. Using the optional wildcards can reduce the number of VoIP dial peer session targets you need to configure if you have groups of numbers associated with a particular router.

For VoFR dial peers, the cid option is not allowed when using the cisco-switched option for the session protocol command.

Use the session target mailto to deliver fax-mail to multiple recipients by specifying an email alias as the name argument and have that alias expanded by the mailer.

The session target loopback command is used for testing the voice transmission path of a call. The loopback point will depend on the call origination and the loopback type selected.

The session target dns command can be used with or without the specified wildcards. Using the optional wildcards can reduce the number of VoIP dial peer session targets you need to configure if you have groups of numbers associated with a particular router.

This command applies to on-ramp Store and Forward Fax functions.

Examples

The following example configures a session target using DNS for a host, voice_router, in the domain cisco.com:

dial-peer voice 10 voip
 session target dns:voice_router.cisco.com
 

The following example configures a session target using DNS, with the optional $u$. wildcard. In this example, the destination pattern has been configured to allow for any four-digit extension, beginning with the numbers 1310222. The optional wildcard $u$. indicates that the router will use the unmatched portion of the dialed number---in this case, the four-digit extension, to identify the dial peer. As in the previous example, the domain is cisco.com.

dial-peer voice 10 voip
 destination-pattern 1310222....
 session target dns:$u$.cisco.com
 

The following example configures a session target using dns, with the optional $d$. wildcard. In this example, the destination pattern has been configured for 13102221111. The optional wildcard $d$. indicates that the router will use the destination pattern to identify the dial peer in the cisco.com domain.

dial-peer voice 10 voip
 destination-pattern 13102221111
 session target dns:$d$.cisco.com
 

The following example configures a session target using DNS, with the optional $e$. wildcard. In this example, the destination pattern has been configured for 12345. The optional wildcard $e$. indicates that the router will reverse the digits in the destination pattern, add periods between the digits, and then use this reverse-exploded destination pattern to identify the dial peer in the cisco.com domain.

dial-peer voice 10 voip
 destination-pattern 12345
 session target dns:$e$.cisco.com
 

The following example configures a session target for Voice over Frame Relay on a Cisco MC3810 with a session target on serial port1 and a DLCI of 200:

dial-peer voice 11 vofr
 destination-pattern 13102221111
 session target serial1 200
 

The following example shows how to configure serial interface 1/0, DLCI 100 as the session target for VoFR dial peer 200 (an FRF.11 dial peer) on a Cisco 2600 series or 3600 series router, starting from global configuration mode and using the frf11-trunk session protocol:

dial-peer voice 200 vofr
 destination-pattern 13102221111
 called-number 5552150
 session protocol frf11-trunk
 session target serial 1/0 100 20
 

The following example configures a session target for Voice over ATM on a Cisco MC3810. The session target is sent to ATM interface 0, and for a PVC with a VCI of 20.

dial-peer voice 12 voatm
 destination-pattern 13102221111
 session target atm0 pvc 20
 

The following example configures a session target on serial port 0 for Voice over HDLC on a Cisco MC3810:

dial-peer voice 13 vohdlc
 destination-pattern 13102221111
 session target serial0
 

The following example configures a session target using dns for a host, voice_router, in the domain cisco.com:

dial-peer voice 10 voip
 session target dns:voice_router.cisco.com
 

The following example configures a session target using DNS, with the optional $u$. wildcard. In this example, the destination pattern has been configured to allow for any four-digit extension, beginning with the numbers 1310222. The optional wildcard $u$. indicates that the router will use the unmatched portion of the dialed number---in this case, the four-digit extension, to identify the dial peer. As in the previous example, the domain is cisco.com.

dial-peer voice 10 voip
 destination-pattern 1310222....
 session target dns:$u$.cisco.com
 

The following example configures a session target using DNS, with the optional $d$. wildcard. In this example, the destination pattern has been configured for 13105551111. The optional wildcard $d$. indicates that the router will use the destination pattern to identify the dial peer in the "cisco.com" domain.

dial-peer voice 10 voip
 destination-pattern 13105551111
 session target dns:$d$.cisco.com
 

The following example delivers fax-mail to multiple recipients:

dial-peer voice 10 mmoip
 session target marketing-information@mailer.example.com
 

Assuming that mailer.example.com is running sendmail, you can put the following information into its /etc/aliases file:

marketing-information: 
 john@example.com, 
 fax=+14085551212@sj-offramp.example.com

Related Commands

Command	Description
destination-pattern	Specifies either the prefix or the full E.164 telephone number (depending on your dial plan) to be used for a dial peer.
session protocol	Establishes a session protocol for calls between the local and remote routers through the packet network in Voice over IP.

Syntax Description

num	Defines lifetime (in seconds) of a single SSL session key.

Defaults

The default session timeout is 86,400 seconds (one day).

Command Modes

Settlement configuration

Command History

Release	Modification
12.0(4)XH1	This command was introduced.

Usage Guidelines

When this time limit configured by this command is exceeded, the router negotiates a new session key. Communication exchanges in progress are not interrupted when this time limit expires.

Examples

The following example shows how to configure the lifetime of a single SSL session key to one day (86,400 seconds):

settlement 0
 session timeout 86400 

Related Commands

Command	Description
connection-timeout	Configures the time that a connection is maintained after completing a communication exchange.
customer-id	Identifies a carrier or ISP with a settlement provider.
device-id	Specifies a gateway associated with a settlement provider.
encryption	Sets the encryption method to be negotiated with the provider.
max-connection	Sets the maximum number of simultaneous connections to be used for communication with a Settlement provider.
response-timeout	Configures the maximum time to wait for a response from a server.
retry-delay	Sets the time between attempts to connect with the settlement provider.
settlement	Enters settlement mode and specifies the attributes specific to a settlement provider.
type	Configures an SAA-RTR operation type.

Syntax Description

provider-number

Specifies a digit defining a particular settlement server. The only valid entry is 0.

Defaults

The default is 0.

Command Modes

Global configuration

Command History

Release	Modification
12.0(4)XH1	This command was introduced.

Usage Guidelines

The variable provider-number defines a particular Settlement provider. For Cisco IOS Release 12.1, only one clearinghouse per system is allowed, and the only valid value for provider-number is 0.

Examples

This example shows how to enter settlement configuration mode:

settlement 0

Related Commands

Command	Description
connection-timeout	Configures the time that a connection is maintained after completing a communication exchange.
customer-id	Identifies a carrier or ISP with a settlement provider.
device-id	Specifies a gateway associated with a settlement provider.
encryption	Sets the encryption method to be negotiated with the provider.
max-connection	Sets the maximum number of simultaneous connections to be used for communication with a settlement provider.
response-timeout	Configures the maximum time to wait for a response from a server.
retry-delay	Sets the time between attempts to connect with the settlement provider.
session-timeout	Sets the interval for closing the connection when there is no input or output traffic.
type	Configures an SAA-RTR operation type.

Related Commands

Command	Description
show dhcp	Displays the current DHCP settings on point-to-point interfaces.
show interfaces cable-modem	Displays information about the Cisco uBR900 series cable access router cable interface.

Syntax Description

This command has no arguments or keywords.

Defaults

No default behavior or values.

Command Modes

Privileged EXEC

Command History

Release	Modification
11.3 XA	This command was introduced.

Examples

The following is sample output from the show c7200 command. The midplane EEPROM data describes the characteristics of the device's midplane chassis; the CPU EEPROM data describes the characteristics of the device CPU. The fault history buffer data provides diagnostic information used only by Cisco Customer Support Engineers.

router# show c7200
Network IO Interrupt Throttling:
 throttle count=0, timer count=0
 active=0, configured=0
 netint usec=3999, netint mask usec=200
 
UBR7200 Midplane EEPROM:
        Number of Slots          : 6
        Hardware Revision        : 1.1
        Chassis MAC Address      : 0008.cefb.fc00
        MAC Address block size   : 256
        Unknown Field (type 01B9): 2C 1F E0 00 
        Unknown Field (type 01B8): 85 FF FF FF 
        EEPROM format version 4
        EEPROM contents (hex):
          0x00: 04 FF 40 00 F0 01 06 41 01 01 C3 06 00 08 CE FB
          0x10: FC 00 43 01 00 C7 20 45 53 00 29 00 2E 00 3D 00
          0x20: 4C 00 34 00 36 00 87 00 81 00 83 00 86 00 84 00
          0x30: B6 00 E0 00 00 B8 DB 00 B9 2C 1F E0 00 00 B8 85
          0x40: FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF
          0x50: FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF
          0x60: FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF
          0x70: FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF
C7200 CPU EEPROM:
        Hardware revision 2.1           Board revision A0
        Serial number     4371856       Part number    73-1536-03
        Test history      0x0           RMA number     00-00-00
        EEPROM format version 1
        EEPROM contents (hex):
          0x20: 01 15 02 01 00 42 B5 90 49 06 00 03 00 00 00 00
          0x30: 50 00 00 00 FF FF FF FF FF FF FF FF FF FF FF FF
 
Fault History Buffer:
7200 Software (UBR7200-P-M), Experimental Version 11.3(19980514:205205)
[xx-xx_2 232]
Compiled Fri 12-Jun-98 19:20 by johnchen
Signal = 23, Code = 0x24, Uptime 00:02:09
$0 : 00000000, AT : 00000000, v0 : 00000000, v1 : 00000004
a0 : 00000000, a1 : 0000FF00, a2 : 00000006, a3 : 00000002
t0 : 00000020, t1 : 3401FF01, t2 : 3401C100, t3 : FFFF00FF
t4 : 6027E180, t5 : 30443044, t6 : 30384330, t7 : 30783630
s0 : 00000000, s1 : 608BFD88, s2 : 606D9E4C, s3 : 60B43E0C
s4 : 608BFD88, s5 : 0000004A, s6 : 00000000, s7 : 608BFF9C
t8 : 00009BCB, t9 : 00000000, k0 : 3041D001, k1 : BF800000
gp : 6083B400, sp : 60BC4CA0, s8 : 608BFDF8, ra : 602797EC
EP6027AE58, SREG : 3401FF03, Cause : 00000424

Syntax Description

cable-if	(Optional) Specifies the cable interface.
upstream portnum	(Optional) Specifies the upstream port for which you wish to display the frequency hop status.

Defaults

No default behavior or values.

Command Modes

EXEC

Command History

Release	Modification
12.0(4)XI	This command was introduced.

Examples

The following examples show output from the show cable hop and show cable hop upstream commands.

Related Commands

Command	Description
show cable modem	Displays cable modem configuration settings.
show cable host	Displays the statistics for the host behind the cable modem.

Related Commands

Command	Description
show cable burst-profile	Displays the upstream data burst profiles used to configure the upstream PHY.
show cable modulation-profile	Displays modulation profile group information.
show interface cable sid	Displays cable interface information.

Syntax Description

profile	(Optional) Profile number. Valid values are from 1 to 8.
iuc-code	(Optional) Internal usage code. Valid options are: initial---Initial Ranging Burst long---Long Grant Burst request---Request Burst short---Short Grant Burst station---Station Ranging Burst

Defaults

No default behavior or values.

Command Modes

Privileged EXEC

Command History

Release	Modification
11.3 XA	This command was introduced.

Usage Guidelines

This command displays modulation profile group information. A modulation profile is a collection of six burst profiles that are sent out in an upstream channel descriptors (UCD) message to configure a cable modem transmit parameters for the following upstream message types: request, initial maintenance, station maintenance, short grant, and long grant.

Examples

The following is sample output from the show cable modulation-profile command:

CMTS01# show cable modulation-profile 1
Mo IUC     Type  Preamb Diff FEC     FEC   Scrambl Max  Guard Last Scrambl Preamb
                 length enco T       CW    seed    B    time  CW           offset
                                bytes    size           size  size  short
1  request qpsk  64     no   0x0     0x10  0x152   1    8     no   yes     56
1  initial qpsk  128    no   0x5     0x22  0x152   0    48    no   yes     0
1  station qpsk  128    no   0x5     0x22  0x152   0    48    no   yes     0
1  short   qpsk  72     no   0x5     0x4B  0x152   0    8     no   yes     48

Related Commands

Command	Description
show cable burst-profile	Displays the upstream data burst profiles used to configure the upstream PHY.
show cable hop	Displays cable modem configuration settings.
show interface cable sid	Displays cable interface information.

Syntax Description

slot/port

Specifies the slot and port number for which information is to be displayed.

Defaults

No default behavior or values.

Command Modes

EXEC

Command History

Release	Modification
12.0(4)XI	This command was introduced.

Examples

The following example shows how to display cable modem noise statistics:

ubr7223# show cable 6/0 noise

Related Commands

Command	Description
show cable modem	Displays cable modem configuration settings.

Related Commands

Command	Description
cable qos permission	Specifies permission for updating the cable router QoS table.
cable qos profile	Configures a QoS profiles.
show cable qos profile	Displays cable router QoS profiles.

Syntax Description

service class

Displays cable QoS table.

Defaults

No default behavior or values.

Command Modes

Privileged EXEC

Command History

Release	Modification
11.3 NA	This command was introduced.

Examples

The following example displays the QoS tables for profiles 1, 2, 3, and 4:

 
CMTS01# show cable qos profile
Service Prio Max       Guarantee Max        Max tx TOS  TOS   Create     B
class        upstream  upstream  downstream burst  mask value by         priv
             bandwidth bandwidth bandwidth                               enab
1       0    0         0         0          0      0x0  0x0   cmts       no
2       0    64000     0         1000000    0      0x0  0x0   cmts       no
3       0    1000      0         1000       0      0x0  0x0   cmts       no
4       7    2000000   100000    4000000    0      0x0  0x0   cm         yes
 
 

Related Commands

Command	Description
cable qos permission	Configures permissions for updating the QoS table.
cable qos profile	Displays QoS profiles.
show cable noise	Displays the status of permissions for changing QoS tables.

Related Commands

Command	Description
show cable burst-profile	Displays the upstream data burst profiles used to configure the upstream PHY.
show cable hop	Displays cable modem configuration settings.
show cable modulation-profile	Displays modulation profile group information.

Syntax Description

voice	Specifies that the active call table displays voice call information.
fax	Specifies that the active call table displays fax call information.

Defaults

No default behavior or values.

Command Modes

Privileged EXEC

Command History

Release	Modification
11.3(1)T	This command was introduced.
12.0(4)XJ	This command was modified for Store and Forward Fax.

Usage Guidelines

Use the show call active privileged EXEC command to display the contents of the active call table. If you use the voice keyword, the active call table displays information about all of the voice calls currently connected through the router or access server. If you use the fax keyword, the active call table shows all of the fax calls currently connected through the router.

This command applies to both on-ramp and off-ramp Store and Forward Fax functions.

Examples

The following is sample output from the show call active voice command:

router# show call active voice
 GENERIC:
SetupTime=179388054 ms
Index=1
PeerAddress=+5....
PeerSubAddress=
PeerId=5
PeerIfIndex=32
LogicalIfIndex=29
ConnectTime=179389793 ms
CallState=4
CallOrigin=2
ChargedUnits=0
InfoType=2
TransmitPackets=532
TransmitBytes=10640
ReceivePackets=147
ReceiveBytes=2940
 
TELE:
ConnectionId=[0xE3EA3FF8 0xFF6D0105 0x0 0x6AEC71E4]
TxDuration=23230 ms
VoiceTxDuration=2940 ms
FaxTxDuration=0 ms
CoderTypeRate=g729r8
NoiseLevel=-84
ACOMLevel=20
OutSignalLevel=-66
InSignalLevel=-66
InfoActivity=2
ERLLevel=20
SessionTarget=
 
GENERIC:
SetupTime=179388237 ms
Index=1
PeerAddress=+3622
PeerSubAddress=
PeerId=3
PeerIfIndex=31
LogicalIfIndex=0
ConnectTime=179389793 ms
CallState=4
CallOrigin=1
ChargedUnits=0
InfoType=2
TransmitPackets=143
TransmitBytes=2860
ReceivePackets=580
ReceiveBytes=11600
 
VOIP:
ConnectionId[0xE3EA3FF8 0xFF6D0105 0x0 0x6AEC71E4]
RemoteIPAddress=172.24.96.200
RemoteUDPPort=16422
RoundTripDelay=37 ms
SelectedQoS=best-effort
SessionProtocol=cisco
SessionTarget=ipv4:172.24.96.200
OnTimeRvPlayout=9920
GapFillWithSilence=0 ms
GapFillWithPrediction=0 ms
GapFillWithInterpolation=0 ms
GapFillWithRedundancy=0 ms
HiWaterPlayoutDelay=70 ms
LoWaterPlayoutDelay=30 ms
ReceiveDelay=30 ms
VAD = enabled
CoderTypeRate=g729r8

The following is sample output from the show call active fax brief command:

router# show call active fax brief
 
<ID>: <start>hs.<index> +<connect> pid:<peer_id> <dir> <addr> <state> \
  tx:<packets>/<bytes> rx:<packets>/<bytes> <state>
IP <ip>:<udp> rtt:<time>ms pl:<play>/<gap>ms lost:<lost>/<early>/<late>
  delay:<last>/<min>/<max>ms <codec>
FR <protocol> [int dlci cid] vad:<y/n> dtmf:<y/n> seq:<y/n>
  sig:<on/off> <codec> (payload size)
Tele <int>: tx:<tot>/<v>/<fax>ms <codec> noise:<l> acom:<l> i/o:<l>/<l> dBm
 
1    : 22021hs.1 +2263 pid:0 Answer wook song active
tx:0/0 rx:0/41190
IP 0.0.0.0 AcceptedMime:2 DiscardedMime:1
 
1    : 23193hs.1 +1091 pid:3469 Originate 527.... active
tx:10/13838 rx:0/0
Tele : tx:31200/10910/20290ms  noise:-1 acom:-1  i/0:0/0 dBm

The following is sample output from the show call active fax command:

router# show call active fax
 
GENERIC:
SetupTime=22021 ms
Index=1
PeerAddress=wook song
PeerSubAddress=
PeerId=0
PeerIfIndex=0
LogicalIfIndex=0
ConnectTime=24284
CallState=4
CallOrigin=2
ChargedUnits=0
InfoType=10
TransmitPackets=0
TransmitBytes=0
ReceivePackets=0
ReceiveBytes=41190
 
MMOIP:
ConnectionId[0x37EC7F41 0xB0110001 0x0 0x35C34]
RemoteIPAddress=0.0.0.0
SessionProtocol=SMTP
SessionTarget=
MessageId=
AccountId=
ImgEncodingType=MH
ImgResolution=fine
AcceptedMimeTypes=2
DiscardedMimeTypes=1
Notification=None
 
GENERIC:
SetupTime=23193 ms
Index=1
PeerAddress=527....
PeerSubAddress=
PeerId=3469
PeerIfIndex=157
LogicalIfIndex=30
ConnectTime=24284
CallState=4
CallOrigin=1
ChargedUnits=0
InfoType=10
TransmitPackets=5
TransmitBytes=6513
ReceivePackets=0
ReceiveBytes=0
 
TELE:     
ConnectionId=[0x37EC7F41 0xB0110001 0x0 0x35C34]
TxDuration=24010 ms
FaxTxDuration=10910 ms
FaxRate=14400
NoiseLevel=-1
ACOMLevel=-1
OutSignalLevel=0
InSignalLevel=0
InfoActivity=0
ERLLevel=-1
SessionTarget=
ImgPages=0

Related Commands

Command	Description
show call history voice	Displays the Voice over IP call history table.
show dial-peer voice	Displays configuration information for dial peers.
show num-exp	Displays how the number expansions are configured in Voice over IP.
show voice port	Displays configuration information about a specific voice port.

Syntax Description

name	(Optional) The name of the desired IVR application.
summary	(Optional) Enter this field to display a one line summary. If the command is entered without summary, a complete detailed description is displayed of the application.

Defaults

No default behavior or values.

Command Modes

EXEC

Command History

Release	Modification
11.3(6)NA2	This command was introduced.

Usage Guidelines

If the name of a specific application is entered, it will give information about that application.

If the summary keyword is entered a one line summary will be displayed about each application.

If the command is entered without the summary, a detailed description of the entered IVR application is displayed.

Examples

This example shows the output for the clid_authen_collect IVR script:

sblab115> show call application voice clid_authen_collect
Application clid_authen_collect has 10 states with 0 calls active
 State start has 1 actions and 5 events
    Do Action IVR_ACT_AUTHENTICATE. accountName=ani, pinName=dnis
    If Event IVR_EV_DEFAULT goto state end
    If Event IVR_EV_CALL_DIGIT do nothing
    If Event IVR_EV_CALL_SETUP_IND do action IVR_ACT_CALL_SETUP_ACK
          and goto state start
    If Event IVR_EV_AAA_SUCCESS goto state collect_dest
    If Event IVR_EV_AAA_FAIL goto state get_account
 State end has 1 actions and 3 events
    Do Action IVR_ACT_END.
    If Event IVR_EV_DEFAULT goto state end
    If Event IVR_EV_CALL_DIGIT do nothing
    If Event IVR_EV_CALL_DISCONNECT_DONE do action IVR_ACT_CALL_DESTROY
          and do nothing
State get_account has 4 actions and 7 events
    Do Action IVR_ACT_PLAY.
            URL: flash:enter_account.au
            allowInt=1, pContent=0x60E4C564
    Do Action IVR_ACT_ABORT_KEY. abortKey=*
    Do Action IVR_ACT_TERMINATION_KEY. terminationKey=#
    Do Action IVR_ACT_COLLECT_PATTERN. Pattern account is .+
    If Event IVR_EV_DEFAULT goto state end
    If Event IVR_EV_CALL_DIGIT do nothing
    If Event IVR_EV_PAT_COL_SUCCESS goto state get_pin
            patName=account
    If Event IVR_EV_ABORT goto state get_account
    If Event IVR_EV_PLAY_COMPLETE do nothing
    If Event IVR_EV_TIMEOUT goto state get_account count=0
    If Event IVR_EV_PAT_COL_FAIL goto state get_account
 State get_pin has 4 actions and 7 events
    Do Action IVR_ACT_PLAY.
            URL: flash:enter_pin.au
            allowInt=1, pContent=0x0
    Do Action IVR_ACT_ABORT_KEY. abortKey=*
    Do Action IVR_ACT_TERMINATION_KEY. terminationKey=#
    Do Action IVR_ACT_COLLECT_PATTERN. Pattern pin is .+
    If Event IVR_EV_DEFAULT goto state end
    If Event IVR_EV_CALL_DIGIT do nothing
    If Event IVR_EV_PAT_COL_SUCCESS goto state authenticate
            patName=pin
    If Event IVR_EV_PLAY_COMPLETE do nothing
    If Event IVR_EV_ABORT goto state get_account
    If Event IVR_EV_TIMEOUT goto state get_pin count=0
    If Event IVR_EV_PAT_COL_FAIL goto state get_pin
 State authenticate has 1 actions and 5 events
    Do Action IVR_ACT_AUTHENTICATE. accountName=account, pinName=pin
    If Event IVR_EV_DEFAULT goto state end
    If Event IVR_EV_CALL_DIGIT do nothing
    If Event IVR_EV_AAA_SUCCESS goto state collect_dest
    If Event IVR_EV_TIMEOUT do nothing count=0
    If Event IVR_EV_AAA_FAIL goto state authenticate_fail
 State collect_dest has 4 actions and 8 events
    Do Action IVR_ACT_PLAY.
            URL: flash:enter_destination.au
            allowInt=1, pContent=0x0
    Do Action IVR_ACT_ABORT_KEY. abortKey=*
    Do Action IVR_ACT_TERMINATION_KEY. terminationKey=#
    Do Action IVR_ACT_COLLECT_DIALPLAN.
    If Event IVR_EV_DEFAULT goto state end
    If Event IVR_EV_CALL_DIGIT do nothing
    If Event IVR_EV_PLAY_COMPLETE do nothing
    If Event IVR_EV_ABORT goto state collect_dest
    If Event IVR_EV_TIMEOUT goto state collect_dest count=0
    If Event IVR_EV_DIAL_COL_SUCCESS goto state place_call
    If Event IVR_EV_DIAL_COL_FAIL goto state collect_dest
    If Event IVR_EV_TIMEOUT goto state collect_dest count=0
 State place_call has 1 actions and 4 events
    Do Action IVR_ACT_PLACE_CALL.
            destination= called=
            calling=      account=
    If Event IVR_EV_DEFAULT goto state end
    If Event IVR_EV_CALL_DIGIT do nothing
    If Event IVR_EV_CALL_UP goto state active
    If Event IVR_EV_CALL_FAIL goto state place_fail
 State active has 0 actions and 2 events
    If Event IVR_EV_DEFAULT goto state end
    If Event IVR_EV_CALL_DIGIT do nothing
 State authenticate_fail has 1 actions and 2 events
    Do Action IVR_ACT_PLAY.
            URL: flash:auth_failed.au
            allowInt=0, pContent=0x0
    If Event IVR_EV_DEFAULT goto state end
    If Event IVR_EV_CALL_DIGIT do nothing
 State place_fail has 1 actions and 2 events
    Do Action IVR_ACT_PLAY_FAILURE_TONE.
    If Event IVR_EV_DEFAULT goto state end
    If Event IVR_EV_CALL_DIGIT do nothing
 
sblab115> show call application voice clid_authen_collect
Application clid_authen_collect has 10 states with 0 calls active
 State start has 1 actions and 5 events
    Do Action IVR_ACT_AUTHENTICATE. accountName=ani, pinName=dnis
    If Event IVR_EV_DEFAULT goto state end
    If Event IVR_EV_CALL_DIGIT do nothing
    If Event IVR_EV_CALL_SETUP_IND do action IVR_ACT_CALL_SETUP_ACK
          and goto state start
    If Event IVR_EV_AAA_SUCCESS goto state collect_dest
    If Event IVR_EV_AAA_FAIL goto state get_account
 State end has 1 actions and 3 events
    Do Action IVR_ACT_END.
    If Event IVR_EV_DEFAULT goto state end
    If Event IVR_EV_CALL_DIGIT do nothing
    If Event IVR_EV_CALL_DISCONNECT_DONE do action IVR_ACT_CALL_DESTROY
          and do nothing
 State get_account has 4 actions and 7 events
    Do Action IVR_ACT_PLAY.
            URL: flash:enter_account.au
            allowInt=1, pContent=0x60E4C564
    Do Action IVR_ACT_ABORT_KEY. abortKey=*
    Do Action IVR_ACT_TERMINATION_KEY. terminationKey=#
    Do Action IVR_ACT_COLLECT_PATTERN. Pattern account is .+
    If Event IVR_EV_DEFAULT goto state end
    If Event IVR_EV_CALL_DIGIT do nothing
    If Event IVR_EV_PAT_COL_SUCCESS goto state get_pin
            patName=account
    If Event IVR_EV_ABORT goto state get_account
    If Event IVR_EV_PLAY_COMPLETE do nothing
    If Event IVR_EV_TIMEOUT goto state get_account count=0
    If Event IVR_EV_PAT_COL_FAIL goto state get_account
 State get_pin has 4 actions and 7 events
    Do Action IVR_ACT_PLAY.
            URL: flash:enter_pin.au
            allowInt=1, pContent=0x0
    Do Action IVR_ACT_ABORT_KEY. abortKey=*
    Do Action IVR_ACT_TERMINATION_KEY. terminationKey=#
    Do Action IVR_ACT_COLLECT_PATTERN. Pattern pin is .+
    If Event IVR_EV_DEFAULT goto state end
    If Event IVR_EV_CALL_DIGIT do nothing
    If Event IVR_EV_PAT_COL_SUCCESS goto state authenticate
            patName=pin
    If Event IVR_EV_PLAY_COMPLETE do nothing
    If Event IVR_EV_ABORT goto state get_account
    If Event IVR_EV_TIMEOUT goto state get_pin count=0
    If Event IVR_EV_PAT_COL_FAIL goto state get_pin
 State authenticate has 1 actions and 5 events
    Do Action IVR_ACT_AUTHENTICATE. accountName=account, pinName=pin
    If Event IVR_EV_DEFAULT goto state end
    If Event IVR_EV_CALL_DIGIT do nothing
    If Event IVR_EV_AAA_SUCCESS goto state collect_dest
    If Event IVR_EV_TIMEOUT do nothing count=0
    If Event IVR_EV_AAA_FAIL goto state authenticate_fail
 State collect_dest has 4 actions and 8 events
    Do Action IVR_ACT_PLAY.
            URL: flash:enter_destination.au
            allowInt=1, pContent=0x0
    Do Action IVR_ACT_ABORT_KEY. abortKey=*
    Do Action IVR_ACT_TERMINATION_KEY. terminationKey=#
    Do Action IVR_ACT_COLLECT_DIALPLAN.
    If Event IVR_EV_DEFAULT goto state end
    If Event IVR_EV_CALL_DIGIT do nothing
    If Event IVR_EV_PLAY_COMPLETE do nothing
    If Event IVR_EV_ABORT goto state collect_dest
    If Event IVR_EV_TIMEOUT goto state collect_dest count=0
    If Event IVR_EV_DIAL_COL_SUCCESS goto state place_call
    If Event IVR_EV_DIAL_COL_FAIL goto state collect_dest
    If Event IVR_EV_TIMEOUT goto state collect_dest count=0
 State place_call has 1 actions and 4 events
    Do Action IVR_ACT_PLACE_CALL.
            destination= called=
            calling=      account=
    If Event IVR_EV_DEFAULT goto state end
    If Event IVR_EV_CALL_DIGIT do nothing
    If Event IVR_EV_CALL_UP goto state active
    If Event IVR_EV_CALL_FAIL goto state place_fail
 State active has 0 actions and 2 events
    If Event IVR_EV_DEFAULT goto state end
    If Event IVR_EV_CALL_DIGIT do nothing
 State authenticate_fail has 1 actions and 2 events
    Do Action IVR_ACT_PLAY.
            URL: flash:auth_failed.au
            allowInt=0, pContent=0x0
    If Event IVR_EV_DEFAULT goto state end
    If Event IVR_EV_CALL_DIGIT do nothing
 State place_fail has 1 actions and 2 events
    Do Action IVR_ACT_PLAY_FAILURE_TONE.
    If Event IVR_EV_DEFAULT goto state end
    If Event IVR_EV_CALL_DIGIT do nothing
 

Related Commands

Command	Description
call application voice	Defines the name to be used for an application and indicates the location of the appropriate IVR script to be used with this application.
call application voice load	Reloads the designated TCL script.

Syntax Description

voice	Specifies that the call history tables displays voice call information.
fax	Specifies that the call history table displays fax call information.
last number	(Optional) Displays the last calls connected, where the number of calls displayed is defined by the argument number. Valid values are from 1 to 2147483647.
brief	(Optional) Displays a truncated version of the call history table.

Defaults

No default behavior or values.

Command Modes

Privileged EXEC

Command History

Release	Modification
11.3(1)T	This command was introduced.
12.0(4)XJ	This command was modified for Store and Forward Fax.

Usage Guidelines

Use the show call history voice privileged EXEC command to display the voice call history table. The call history table contains a listing of all calls connected through this router in descending time order since Voice over IP was enabled. You can display subsets of the call history table by using specific keywords. To display the last calls connected through this router, use the keyword last, and define the number of calls to be displayed with the argument number.

Use the show call history fax command to display the fax call history table. The fax call history table contains a listing of all fax calls connected through this router in descending time order since Store and Forward Fax was enabled. You can display subsets of the fax call history table by using the show call history command with specific keywords. To display the last calls connected through this router, use the keyword last, and define the number of calls to be displayed with the argument number. To display a truncated version of the call history table, use the brief keyword. This command applies to both on-ramp and off-ramp Store and Forward Fax functions.

Examples

The following is sample output from the show call history voice command:

router# show call history voice brief
<ID>: <start>hs.<index> +<connect> +<disc> pid:<peer_id> <direction> <addr>
 tx:<packets>/<bytes> rx:<packets>/<bytes> <disc-cause>(<text>)
 IP <ip>:<udp> rtt:<time>ms pl:<play>/<gap>ms delay:<last>/<min>/<max>ms <codec>
 Telephony <int>: tx:<tot>/<voice>/<fax>ms <codec> noise:<lvl>dBm acom:<lvl>dBm
 
234  : 158305740hs.1280 +241 +9199 pid:0 Answer +3...
 tx:3804/76080 rx:1358/27160 10  (normal call clearing.)
 IP 172.24.96.200:16468 rtt:33ms pl:25990/0ms delay:30/30/70ms g729r8
 
234  : 158305745hs.1281 +236 +9195 pid:6 Originate +68888
 tx:1358/27160 rx:3804/76080 10  (normal call clearing.)
 Telephony 0:D:22: tx:91850/76080/0ms g729r8 noise:-84dBm acom:20dBm
 
235  : 158344850hs.1282 +230 +28773 pid:0 Answer +3...
 tx:11063/221260 rx:4604/92080 10  (normal call clearing.)
 IP 172.24.96.200:16474 rtt:41ms pl:88260/290ms delay:40/30/130ms g729r8
 
235  : 158344856hs.1283 +224 +28769 pid:6 Originate +68888
 tx:4604/92080 rx:11063/221260 10  (normal call clearing.)
 Telephony 0:D:22: tx:287590/221280/0ms g729r8 noise:-75dBm acom:20dBm

The following is sample output from the show call history fax brief command:

router# show call history fax brief 
<ID>: <start>hs.<index> +<connect> +<disc> pid:<peer_id> <direction> <addr>
 tx:<packets>/<bytes> rx:<packets>/<bytes> <disc-cause>(<text>)
 IP <ip>:<udp> rtt:<time>ms pl:<play>/<gap>ms lost:<lost>/<early>/<late>
  delay:<last>/<min>/<max>ms <codec>
 Telephony <int>: tx:<tot>/<voice>/<fax>ms <codec> noise:<lvl>dBm acom:<lvl>dBm
 
2    : 5996450hs.25 +-1 +3802 pid:100 Answer 408
 tx:0/0 rx:0/0 1F  (T30 T1 EOM timeout)
 Telephony : tx:38020/38020/0ms g729r8 noise:0dBm acom:0dBm
 
2    : 5996752hs.26 +-1 +3500 pid:110 Originate uut1@linux2.allegro.com
 tx:0/0 rx:0/0 3F  (The e-mail was not sent correctly. Remote SMTP server said: 354 )
 IP 14.0.0.1 AcceptedMime:0 DiscardedMime:0
 
3    : 6447851hs.27 +1111 +3616 pid:310 Originate 576341.
 tx:11/14419 rx:0/0 10  (Normal connection)
 Telephony : tx:36160/11110/25050ms g729r8 noise:115dBm acom:-14dBm
 
3    : 6447780hs.28 +1182 +4516 pid:0 Answer 
 tx:0/0 rx:0/0 10  (normal call clearing.)
 IP 0.0.0.0 AcceptedMime:0 DiscardedMime:0
 
4    : 6464816hs.29 +1050 +3555 pid:310 Originate 576341.
 tx:11/14413 rx:0/0 10  (Normal connection)
 Telephony : tx:35550/10500/25050ms g729r8 noise:115dBm acom:-14dBm
 
4    : 6464748hs.30 +1118 +4517 pid:0 Answer 
 tx:0/0 rx:0/0 10  (normal call clearing.)
 IP 0.0.0.0 AcceptedMime:0 DiscardedMime:0
 
5    : 6507900hs.31 +1158 +2392 pid:100 Answer 4085763413
 tx:0/0 rx:3/3224 10  (Normal connection)
 Telephony : tx:23920/11580/12340ms g729r8 noise:0dBm acom:0dBm
 
5    : 6508152hs.32 +1727 +2140 pid:110 Originate uut1@linux2.allegro.com
 tx:0/2754 rx:0/0 3F  (service or option not available, unspecified)
 IP 14.0.0.4 AcceptedMime:0 DiscardedMime:0
 
6    : 6517176hs.33 +1079 +3571 pid:310 Originate 576341.
 tx:11/14447 rx:0/0 10  (Normal connection)
 Telephony : tx:35710/10790/24920ms g729r8 noise:115dBm acom:-14dBm
 
6    : 6517106hs.34 +1149 +4517 pid:0 Answer 
 tx:0/0 rx:0/0 10  (normal call clearing.)
 IP 0.0.0.0 AcceptedMime:0 DiscardedMime:0
 
7    : 6567382hs.35 +1054 +3550 pid:310 Originate 576341.
 tx:11/14411 rx:0/0 10  (Normal connection)
 Telephony : tx:35500/10540/24960ms g729r8 noise:115dBm acom:-14dBm
 
7    : 6567308hs.36 +1128 +4517 pid:0 Answer 
tx:0/0 rx:0/0 10  (normal call clearing.)
 IP 0.0.0.0 AcceptedMime:0 DiscardedMime:0
 

The following is output from the show call history command.

router# show call history fax l 2 
 
GENERIC:
SetupTime=23193 ms
Index=1
PeerAddress=527....
PeerSubAddress=
PeerId=3469
PeerIfIndex=157
LogicalIfIndex=30
DisconnectCause=10  
DisconnectText=normal call clearing.: Normal connection
ConnectTime=24284
DisconectTime=31288
CallOrigin=1
ChargedUnits=0
InfoType=fax
TransmitPackets=62
TransmitBytes=88047
ReceivePackets=0
ReceiveBytes=0
 
TELE:
ConnectionId=[0x37EC7F41 0xB0110001 0x0 0x35C34]
TxDuration=80950 ms
FaxTxDuration=10910 ms
FaxRate=14400
NoiseLevel=-1
ACOMLevel=-1
SessionTarget=
ImgPages=3
 
GENERIC:
SetupTime=22021 ms
Index=2
PeerAddress=wook song
PeerSubAddress=
PeerId=0
PeerIfIndex=0
LogicalIfIndex=0
DisconnectCause=10  
DisconnectText=normal call clearing.
ConnectTime=24284
DisconectTime=31545
CallOrigin=2
ChargedUnits=0
InfoType=fax
TransmitPackets=0
TransmitBytes=0
ReceivePackets=0
ReceiveBytes=41190
 
MMOIP:
ConnectionId[0x37EC7F41 0xB0110001 0x0 0x35C34]
RemoteIPAddress=0.0.0.0
SessionProtocol=SMTP
SessionTarget=
MessageId=
AccountId=
ImgEncodingType=MH
ImgResolution=fine
AcceptedMimeTypes=2
DiscardedMimeTypes=1
Notification=None

Related Commands

Command	Description
show call active	Displays active call information for a fax transmission in progress.

Syntax Description

This command has no arguments or keywords.

Defaults

No default behavior or values.

Command Modes

Privileged EXEC.

Command History

Release	Modification
12.0(5)XK and 12.0(7)T	This command was introduced for the Cisco MC3810.

Usage Guidelines

Use this command to review statistics about recent incoming and outgoing video calls.

Examples

On a Cisco MC3810, the following example displays information about two video calls:

Router# show call history video record
 
CallId = 4
CalledNumber = 221
CallDuration = 39006 seconds
DisconnectText = remote hangup
SVC: call ID = 8598630
Remote NSAP = 47.0091810000000002F26D4901.00107B09C645.C8
Local NSAP = 47.0091810000000002F26D4901.00107B4832E1.C8
vcd = 414, vpi = 0, vci = 158
SerialPort = Serial0
VideoSlot = 1, VideoPort = 0
 
 
CallId = 3
CalledNumber = 221
CallDuration = 557 seconds
DisconnectText = local hangup
SVC: call ID = 8598581
Remote NSAP = 47.0091810000000002F26D4901.00107B09C645.C8
Local NSAP = 47.0091810000000002F26D4901.00107B4832E1.C8
vcd = 364, vpi = 0, vci = 108
SerialPort = Serial0
VideoSlot = 1, VideoPort = 0
 

Syntax Description

This command has no arguments or keywords.

Defaults

No default behavior or values.

Command Modes

Privileged EXEC.

Command History

Release	Modification
12.0(5)XK and 12.0(7)T	This command was introduced for the Cisco MC3810.

Examples

The following example displays a sample of voice call history records showing a local call between two telephones attached to the same Cisco MC3810:

router# show call history voice record
 
ConnectionId=[0x2C7AEFDC 0x59830001 0x0 0xB0AAA3]
Media=TELE, TxDuration= 1418 ms
CallingNumber=2001
SetupTime=1157801 x 10ms
ConnectTime=1158046 x 10ms
DisconectTime=1158188 x 10ms
DisconnectText=local onhook
 
ConnectionId=[0x2C7AEFDC 0x59830001 0x0 0xB0AAA3]
Media=TELE, TxDuration= 1422 ms
CalledNumber=2002
SetupTime=1157802 x 10ms
ConnectTime=1158046 x 10ms
DisconectTime=1158188 x 10ms
DisconnectText=remote onhook

Related Commands

Command	Description
show call active voice	Displays the Voice over IP active call table.
show dial-peer voice	Displays configuration information for dial peers.
show num-exp	Displays how the number expansions are configured in Voice over IP.
show voice port	Displays configuration information about a specific voice port.

Syntax Description

This command has no arguments or keywords.

Defaults

No default behavior or values.

Command Modes

Privileged EXEC

Command History

Release	Modification
12.0(5)T	This command was introduced.

Usage Guidelines

This command displays the H.323 resources that are monitored when the resource threshold command is used to configure and enable resource threshold reporting.

Examples

The following example shows the resource statistics for an H.323 gateway:

gateway1# show call resource voice stats    
 
Resource Monitor -  Dial-up Resource Statistics Information:
 
DSP Statistics:
 
Utilization: 0 percent
Total channels: 48
Inuse channels: 0
Disabled channels 0:
Pending channels: 0
Free channels: 48
 
DS0 Statistics:
 
Total channels: 0
Addressable channels: 0
Inuse channels: 0
Disabled channels: 0
Free channels: 0

Related Commands

Command	Description
resource threshold	Configures a gateway to report H.323 resource availability to the gatekeeper of the gateway.
show call resource voice threshold	Displays the threshold configuration settings and status for an H.323 gateway.

Syntax Description

This command has no arguments or keywords.

Defaults

No default behavior or values.

Command Modes

Privileged EXEC

Command History

Release	Modification
12.0(5)T	This command was introduced.

Usage Guidelines

This command displays the H.323 resource thresholds that are configured with the resource threshold command.

Examples

The following example shows the resource threshold settings and status for an H.323 gateway:

gateway1# show call resource voice threshold
 
Resource Monitor -  Dial-up Resource Threshold Information:
 
DS0 Threshold:
 
Client Type: h323
High Water Mark: 70
Low Water Mark: 60
Threshold State: init
DSP Threshold:
 
Client Type: h323
High Water Mark: 70
Low Water Mark: 60
Threshold State: low_threshold_hit

Related Commands

Command	Description
resource threshold	Configures a gateway to report H.323 resource availability to the gatekeeper of the gateway
show call resource voice stats	Displays resource statistics for an H.323 gateway.

Syntax Description

This command has no arguments or keywords.

Defaults

No default behavior or values.

Command Modes

Privileged EXEC

Command History

Release	Modification
12.0(7)T	This command was introduced.

Usage Guidelines

CDAPI is the internal API that provides an interface between signalling stacks and applications.

Examples

The following is output for the show cdapi command:

Router# show cdapi 
 
Registered CDAPI Applications/Stacks
====================================
Application TSP CDAPI Application
        Application Type(s)  Voice Facility Signaling 
        Application Level    Tunnel
        Application Mode     Enbloc
Signaling Stack ISDN
        Interface Se023
Signaling Stack ISDN
        Interface Se123
Active CDAPI Calls
==================
Interface Se023
        No active calls.
Interface Se123
        Call ID = 0x39, Call Type = VOICE, Application = TSP CDAPI Application
CDAPI Message Buffers
=====================
Used Msg Buffers 0, Free Msg Buffers 1600
Used Raw Buffers 1, Free Raw Buffers 799
Used Large-Raw Buffers 0, Free Large-Raw Buffers 80
scarlatti1# 

Related Commands

Command	Description
isdn protocol-emulate	Configures the Layer 2 and Layer 3 port protocol of a BRI voice port or a PRI interface to emulate NT (network) or TE (user) functionality.
isdn switch type	Configures the Cisco AS5300 PRI interface to support Q.SIG signalling.
pri-group nec-fusion	Configures your NEC PBX to support FCCS.
show rawmsg	Displays the raw messages owned by the required component.

Syntax Description

slot/port	Slot number/port number indicating the location of the Cisco cable modem card.
downstream	(Optional) Displays downstream interface status.
upstream	(Optional) Displays upstream interface status.
port	(Optional) Selects specific upstream port.

Defaults

No default behavior or values.

Command Modes

Privileged EXEC

Command History

Release	Modification
11.3 XA	This command was introduced.
12.0(2)XC	This command was modified.

Examples

The following is sample output from the show controllers cable upstream command for the cable modem located in slot 4, port 0:

CMTS01# show controllers cable 4/0 upstream 2
 Cable4/0 Upstream 2 is administratively down
  Frequency 5.008 MHz, Channel Width 0.200 MHz, QPSK Symbol Rate 0.160 Msps
  Spectrum Group 4
  Nominal Input Power Level 5 dBmV, Tx Timing Offset 0
  Ranging Backoff Start 16, Ranging Backoff End 16, Tx Backoff Start 16
  Tx Backoff End 16, Modulation Profile Group 1
  part_id=0x3137, rev_id=0x01, rev2_id=0xFF
  nb_agc_thr=0x0000, nb_agc_nom=0x0000
  Range Load Reg Size=0x58
  Request Load Reg Size=0x0E
  Minislot Size in number of Timebase Ticks is = 8
  Minislot Size in Symbols =8
  Bandwidth Requests = 0x0
  Piggyback Requests = 0x0
  Invalid BW Requests= 0x0
  Minislots Requested= 0x0
  Minislots Granted  = 0x0
  Minislot Size in Bytes = 2
  UCD Count = 0
  DES Ctrl Reg#0 = C00C0C43, Reg#1 = 0

The following is sample output for the downstream connection for slot 3 on port 0 from the show controllers cable downstream command:

CMTS01# show controllers cable 3/0 downstream
Cable 3/0 Downstream is up
Frequency not set, Channel Width 6 MHz, 64-QAM, 
Symbol Rate 5.056941 Msps
FEC ITU-T J.83 Annex A, R/S Interleave I=12, J=17

Related Commands

Command	Description
show interface cable sid	Displays information about interface controllers for a specific cable access router card slot.

Syntax Description

slot	Slot location of the VDM module. On the Cisco MC3810, this value is either 1 or 2. If you do not enter the correct location, the command is rejected.
port	Port location of the RS-366 interface in the VDM module. On the Cisco MC3810, this value is 0.

Defaults

No default behavior or values.

Command Modes

Privileged EXEC

Command History

Release	Modification
12.0(5)XK and 12.0(7)T	This command was introduced for the Cisco MC3810.

Examples

On a Cisco MC3810, the following example displays information about the RS-366 controller:

Router# show controller rs366 0 1
 
RS366:driver is initialized in slot 1, port 0:
 
STATUS STATE LSR  LCR  ICSR EXT  T1     T2     T3     T4     T5 
0x02   0x01  0x00 0x50 0xE0 0x00 5000   5000   5000   20000  10000  
Dial string:
121C
 

Syntax Description

This command has no arguments or keywords.

Defaults

No default behavior or values.

Command Modes

Privileged EXEC

Command History

Release	Modification
12.0(5)XQ	This command was introduced.

Usage Guidelines

This command displays interface status information that is specific to voice-related hardware, such as, the registers of the TDM switch, the host port interface of the digital signal processor (DSP), and the DSP firmware versions. The information displayed is generally only useful for diagnostic tasks performed by technical support.

Examples

The following is an example of the output from the show controllers voice command:

router# show controllers voice
EPIC Switch registers:
STDA 0xFF STDB 0xFF SARA 0xAD SARB 0xFF SAXA 0xFF SAXB 0x0 STCR 0x3F
MFAIR 0x3F
STAR 0x65 OMDR 0xE2 VNSR 0x0 PMOD 0x4C PBNR 0xFF POFD 0xF0 POFU 0x18
PCSR 0x1 PICM 0x0 CMD1 0xA0 CMD2 0x70 CBNR 0xFF CTAR 0x2 CBSR 0x20 CSCR
0x0
 
DSP 0 Host Port Interface:
HPI Control Register 0x202
InterfaceStatus 0x2A MaxMessageSize 0x80
RxRingBufferSize 0x6 TxRingBufferSize 0x9
pInsertRx 0x4 pRemoveRx 0x4 pInsertTx 0x6 pRemoveTx 0x6
 
Rx Message 0:
packet_length 100 channel_id 2 packet_id 0 process id 0x1
0000:   0000 4AC7 5F08 91D1 0000 0000 7DF1 69E5 63E1 63E2
0020:   6E7C ED67 DE5D DB5C DC60 EC7E 6BE1 58D3 50CD 4DCE
0040:   50D2 5AE5 7868 DA52 CE4A C746 C647 C94B D25A EAF4
0060:   5DD7 4FCD 4ACA 4ACC 4FD3 5DE8 F769 DC58 D352 D253
0080:   D65B E573 6CDF 59D3 4ECF 4FD0
 
Rx Message 1:
packet_length 100 channel_id 1 packet_id 0 process id 0x1
0000:   0000 1CDD 3E48 3B74 0000 0000 3437 3D4C F0C8 BBB5
0020:   B2B3 B7BF D25B 4138 3331 3339 435F CFBD B6B2 B1B4
0040:   BBC8 7E48 3B34 3131 363D 4FDE C3B9 B3B1 B3B8 C2DB
0060:   533F 3833 3235 3B48 71CC BDB7 B4B5 B8BF CF67 483D
0080:   3836 383C 455B DAC6 BDB9 B9BB
 
Rx Message 2:
packet_length 100 channel_id 2 packet_id 0 process id 0x1
0000:   0000 4AC8 5F08 9221 0000 0000 54DA 61F5 EF60 DA53
0020:   CF4F CD4E D256 DB63 FCEE 5FDA 55D1 50CF 4FD3 56D8
0040:   5DE1 6E7C EC60 DC59 D655 D456 D85D DF6A F4F4 69E2
0060:   5CDD 5BDC 5BDE 61E9 6DF1 FF76 F16D E96A E566 EA6A
0080:   EB6F F16D EF79 F776 F5F5 73F0
 
Rx Message 3:
packet_length 100 channel_id 1 packet_id 0 process id 0x1
0000:   0000 1CDE 3E48 3BC4 0000 0000 C0CC EC54 453E 3C3C
0020:   3F47 56F3 D1C7 C1BF C0C6 CEE1 6752 4A46 4648 4E59
0040:   6FE4 D6CF CDCE D2DA E57E 675E 5B5B 5E62 6B76 FCF6
0060:   F6FA 7D75 7373 7BF5 EAE1 DCDA DADD E6FE 6559 514D
0080:   4D4E 5563 EFD9 CDC8 C5C6 CAD1
 
Rx Message 4:
packet_length 100 channel_id 2 packet_id 0 process id 0x1
0000:   0000 4AC6 5F08 9181 0000 0000 DD5B DC5E E161 E468
0020:   FAFD 6CE1 5AD3 53D1 53D7 61EC EA59 CF4A C644 C344
0040:   CA4E D86C 60D0 48C2 3EBD 3CBD 3EC0 47CF 5976 DF4F
0060:   C945 C242 C146 C94E D668 73DB 54CE 4DCC 4DCE 53DB
0080:   64F9 ED63 DC59 DA58 DC5D E46C
 
Rx Message 5:
packet_length 100 channel_id 1 packet_id 0 process id 0x1
0000:   0000 1CDC 3E48 3B24 0000 0000 5B5B 5D62 6A76 FCF5
0020:   F5F9 7D78 7374 7CF5 EAE1 DDDA DBDD E7FE 6559 514E
0040:   4D4F 5663 EFD8 CDC8 C6C6 CAD1 E760 4E46 403F 4047
0060:   5173 D5C7 BFBC BCBE C5D4 6D4C 3F3B 3939 3D46 5ADB
0080:   C5BC B7B6 B8BD C8E8 4F3F 3835
 
Tx Message 0:
packet_length 100 channel_id 1 packet_id 0 process id 0x1
0000:   0000 4AC6 5F08 9181 0000 003C DD5B DC5E E161 E468
0020:   FAFD 6CE1 5AD3 53D1 53D7 61EC EA59 CF4A C644 C344
0040:   CA4E D86C 60D0 48C2 3EBD 3CBD 3EC0 47CF 5976 DF4F
0060:   C945 C242 C146 C94E D668 73DB 54CE 4DCC 4DCE 53DB
0080:   64F9 ED63 DC59 DA58 DC5D E46C
 
Tx Message 1:
packet_length 100 channel_id 2 packet_id 0 process id 0x1
0000:   0000 1CDC 3E48 3B24 0000 003C 5B5B 5D62 6A76 FCF5
0020:   F5F9 7D78 7374 7CF5 EAE1 DDDA DBDD E7FE 6559 514E
0040:   4D4F 5663 EFD8 CDC8 C6C6 CAD1 E760 4E46 403F 4047
0060:   5173 D5C7 BFBC BCBE C5D4 6D4C 3F3B 3939 3D46 5ADB
0080:   C5BC B7B6 B8BD C8E8 4F3F 3835
 
Tx Message 2:
packet_length 100 channel_id 1 packet_id 0 process id 0x1
0000:   0000 4AC7 5F08 91D1 0000 003C 7DF1 69E5 63E1 63E2
0020:   6E7C ED67 DE5D DB5C DC60 EC7E 6BE1 58D3 50CD 4DCE
0040:   50D2 5AE5 7868 DA52 CE4A C746 C647 C94B D25A EAF4
0060:   5DD7 4FCD 4ACA 4ACC 4FD3 5DE8 F769 DC58 D352 D253
0080:   D65B E573 6CDF 59D3 4ECF 4FD0
 
Tx Message 3:
packet_length 100 channel_id 2 packet_id 0 process id 0x1
0000:   0000 1CDD 3E48 3B74 0000 003C 3437 3D4C F0C8 BBB5
0020:   B2B3 B7BF D25B 4138 3331 3339 435F CFBD B6B2 B1B4
0040:   BBC8 7E48 3B34 3131 363D 4FDE C3B9 B3B1 B3B8 C2DB
0060:   533F 3833 3235 3B48 71CC BDB7 B4B5 B8BF CF67 483D
0080:   3836 383C 455B DAC6 BDB9 B9BB
 
Tx Message 4:
packet_length 100 channel_id 1 packet_id 0 process id 0x1
0000:   0000 4AC8 5F08 9221 0000 003C 54DA 61F5 EF60 DA53
0020:   CF4F CD4E D256 DB63 FCEE 5FDA 55D1 50CF 4FD3 56D8
0040:   5DE1 6E7C EC60 DC59 D655 D456 D85D DF6A F4F4 69E2
0060:   5CDD 5BDC 5BDE 61E9 6DF1 FF76 F16D E96A E566 EA6A
0080:   EB6F F16D EF79 F776 F5F5 73F0
 
Tx Message 5:
packet_length 100 channel_id 2 packet_id 0 process id 0x1
0000:   0000 1CDE 3E48 3BC4 0000 003C C0CC EC54 453E 3C3C
0020:   3F47 56F3 D1C7 C1BF C0C6 CEE1 6752 4A46 4648 4E59
0040:   6FE4 D6CF CDCE D2DA E57E 675E 5B5B 5E62 6B76 FCF6
0060:   F6FA 7D75 7373 7BF5 EAE1 DCDA DADD E6FE 6559 514D
0080:   4D4E 5563 EFD9 CDC8 C5C6 CAD1
 
Tx Message 6:
packet_length 100 channel_id 2 packet_id 0 process id 0x1
0000:   0000 1CDA 3E48 3A84 0000 003C E75F 4E46 403F 4147
0020:   5174 D5C7 BFBC BCBE C5D4 6C4C 3F3B 3939 3D46 5BDA
0040:   C5BC B7B6 B8BD C8E9 4F3F 3834 3437 3D4C EEC8 BBB5
0060:   B2B3 B8BF D35A 4138 3331 3339 435F CEBD B6B1 B1B4
0080:   BBC9 7C48 3B34 3131 363D 4FDE
 
Tx Message 7:
packet_length 100 channel_id 1 packet_id 0 process id 0x1
0000:   0000 4AC5 5F08 9131 0000 003C 66DE 66EB 67EE FE6E
0020:   F7E7 6B68 E068 EE6A DF5C DF62 EDF1 6FF2 7A78 67DC
0040:   5EDF 62E7 64E6 66E0 7071 EA69 F86E E260 DE5D E665
0060:   EB75 F0FB 6DE9 64E4 69E3 66EA 67E9 6DF9 F177 EC6E
0080:   EB6E F876 F875 7D6E E966 E05D
 
Tx Message 8:
packet_length 100 channel_id 2 packet_id 0 process id 0x1
0000:   0000 1CDB 3E48 3AD4 0000 003C C2B9 B3B1 B3B8 C2DC
0020:   523F 3733 3235 3C49 72CB BDB7 B4B5 B8BF CF67 483C
0040:   3836 373C 455C DAC6 BDB9 B9BB C0CC EE54 453E 3C3C
0060:   3F47 56F1 D1C7 C1BF C0C6 CEE1 6651 4A46 4648 4D59
0080:   70E3 D6CF CDCE D2D9 E67E 675E
 
Bootloader 1.8, Appn 3.1
Application firmware 3.1.8, Built by claux on Thu Jun 17 11:00:05 1999
 
VIC Interface Foreign Exchange Station 0/0, DSP instance (0x19543C0)
Singalling channel num 128 Signalling proxy 0x0 Signaling dsp 0x19543C0
tx outstanding 0, max tx outstanding 32
ptr 0x0, length 0x0, max length 0x0
dsp_number 0, Channel ID 1
received 0 packets, 0 bytes, 0 gaint packets
0 drops, 0 no buffers, 0 input errors 0 input overruns
650070 bytes output, 4976 frames output, 0 output errors, 0 output
underrun
0 unaligned frames
 
VIC Interface Foreign Exchange Station 0/1, DSP instance (0x1954604)
Singalling channel num 129 Signalling proxy 0x0 Signaling dsp 0x1954604
tx outstanding 0, max tx outstanding 32
ptr 0x0, length 0x0, max length 0x0
dsp_number 0, Channel ID 2
received 0 packets, 0 bytes, 0 gaint packets
0 drops, 0 no buffers, 0 input errors 0 input overruns
393976 bytes output, 3982 frames output, 0 output errors, 0 output
underrun
0 unaligned frames

Related Commands

Command	Description
show dial-peer voice	Displays configuration information and call statistics for dial peers.
show interface dspfarm dsp	Displays hardware information including DRAM, SRAM, and the revision-level information on the line card.
show voice dsp	Displays the current status of all DSP voice channels on the Cisco MC3810 multiservice concentrator.
show voice port	Displays configuration information about a specific voice port.

Cisco AS5300 access server

show csm {modem [slot/port | modem-group-number] | voice [slot/dspm/dsp/dsp-channel]}

Cisco AS5800 universal access server

show csm voice [shelf/slot/port]

Syntax Description

modem	Specifies CSM call statistics for modems.
voice	Specifies CSM call statistics for DSP channels.
slot/port	(Optional) Specifies the location (and thereby the identity) of a specific modem.
modem-group-number	(Optional) Displays configuration for the dial peer identified by the argument number. Valid entries are any integers that identify a specific dial peer, from 1 to 32767.
slot/dspm/dsp/dsp-channel	(Optional) Identifies the location of a particular DSP channel.
shelf/slot/port	(Optional) Identifies the location of the voice interface card.

Defaults

No default behavior or values.

Command Modes

Privileged EXEC

Command History

Release	Modification
11.3 NA	This command was introduced.
12.0(3)T	Port-specific values for the Cisco AS5300 were added.
12.0(7)T	Port-specific values for the Cisco AS5800 were added.

Usage Guidelines

This command shows the information related to CSM, which includes the DSP channel, the start time of the call, the end time of the call, and the channel on the controller used by the call.

Use the show csm modem command to display the CSM call statistic information for a specific modem, for a group of modems, or for all modems. If a slot/port argument is specified, then CSM call statistics are displayed for the specified modem. If the modem-group-number argument is specified, the CSM call statistics for all of the modems associated with that modem group are displayed. If no keyword is specified, CSM call statistics for all modems on the AS5300 are displayed.

Use the show csm voice command to display CSM statistics for a particular DSP channel. If the slot/dspm/dsp/dsp-channel or shelf/slot/port argument is specified, the CSM call statistics for calls using the identified DSP channel will be displayed. If no argument is specified, all CSM call statistics for all DSP channels will be displayed.

Examples

The following is sample output from the Cisco AS5300 for the show csm voice command:

Router# show csm voice 2/4/4/0
 slot 2, dspm 4, dsp 4, dsp channel 0, 
 slot 2, port 56, tone, device_status(0x0002): VDEV_STATUS_ACTIVE_CALL.
 
csm_state(0x0406)=CSM_OC6_CONNECTED, csm_event_proc=0x600E2678, current call thru PRI line
invalid_event_count=0, wdt_timeout_count=0
wdt_timestamp_started is not activated
wait_for_dialing:False, wait_for_bchan:False
pri_chnl=TDM_PRI_STREAM(s0, u0, c22), tdm_chnl=TDM_DSP_STREAM(s2, c27)
dchan_idb_start_index=0, dchan_idb_index=0, call_id=0xA003, bchan_num=22
csm_event=CSM_EVENT_ISDN_CONNECTED, cause=0x0000
ring_no_answer=0, ic_failure=0, ic_complete=0
dial_failure=0, oc_failure=0, oc_complete=3
oc_busy=0, oc_no_dial_tone=0, oc_dial_timeout=0
remote_link_disc=0, stat_busyout=0
oobp_failure=0
call_duration_started=00:06:53, call_duration_ended=00:00:00, total_call_duration=00:00:44
The calling party phone number = 408
The called party phone number  = 5271086
total_free_rbs_timeslot = 0, total_busy_rbs_timeslot = 0, total_dynamic_busy_rbs_timeslot = 0, total_static_busy_rbs_timeslot = 0,
total_sw56_rbs_timeslot = 0, total_sw56_rbs_static_bo_ts = 0,
total_free_isdn_channels = 21, total_busy_isdn_channels = 0,total_auto_busy_isdn_channels = 0, 
min_free_device_threshold = 0
 

The following is sample output from the Cisco AS5800 for the show csm voice command:

5800# show csm voice 1/8/19
 shelf 1, slot 8, port 19
VDEV_INFO:slot 8, port 19
vdev_status(0x00000401):VDEV_STATUS_ACTIVE_CALL.VDEV_STATUS_HASLOCK.
csm_state(0x00000406)=CSM_OC6_CONNECTED, csm_event_proc=0x60868B8C, current
call thru PRI line
invalid_event_count=0, wdt_timeout_count=0
watchdog timer is not activated
wait_for_bchan:False
pri_chnl=(T1 1/0/0:22), vdev_chnl=(s8, c19)
start_chan_p=0, chan_p=62436D58, call_id=0x800D, bchan_num=22
The calling party phone number = 
The called party phone number  = 7511
ring_no_answer=0, ic_failure=0, ic_complete=0
dial_failure=0, oc_failure=0, oc_complete=1
oc_busy=0, oc_no_dial_tone=0, oc_dial_timeout=0
remote_link_disc=0, busyout=0, modem_reset=0
call_duration_started=3d16h, call_duration_ended=00:00:00,
total_call_duration=00:00:00
 

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 num-exp	Displays how number expansions are configured.
show voice port	Displays configuration information about a specific voice port.

The following is sample output for the show dhcp server command:

uBR924# show dhcp server
   DHCP server: ANY (255.255.255.255)
    Leases:   1
    Offers:   1      Requests: 2     Acks: 1     Naks: 0
    Declines: 0      Releases: 0     Bad:  0
    TFTP Server Name: SOHOSERVER
    TIME0: 1.2.0.250,  TIME1: 0.0.0.0
    Subnet: 255.255.255.0

Related Commands

Command	Description
cable-modem voip best-effort	Allows voice calls to be sent upstream over the cable interface via best effort.
show bridge cable-modem	Displays bridging information for a cable modem.
show interfaces cable-modem	Displays information about the cable interface of the Cisco uBR900 series cable access router.

Related Commands

Command	Description
show dial-peer voice	Displays configuration information and call statistics for dial peers.
show voice dsp	Displays the current status of all DSP voice channels on the Cisco MC3810 multiservice concentrator.
show voice port	Displays configuration information about a specific voice port.