cc/td/doc/product/software/ios121/121cgcr
hometocprevnextglossaryfeedbacksearchhelp
PDF

Table of Contents

Multiservice Applications Commands:
Cb through D

Multiservice Applications Commands:
Cb through D

This book documents commands used to configure Voice over ATM, Voice over Frame Relay, Voice over HDLC, Voice over IP, video, head-end universal broadband features, and subscriber-end universal broadband features. Commands in this book are listed alphabetically. For information on how to configure Voice over ATM, Voice over Frame Relay, Voice over HDLC, Voice over IP, video, head-end universal broadband features, and subscriber-end universal broadband features, refer to the
Cisco IOS Multiservice Applications Configuration Guide.

cbr

To configure the constant bit rate (CBR) for the ATM circuit emulation service (CES) for an ATM permanent virtual circuit (PVC) on the Cisco MC3810, use the cbr command in ATM virtual circuit configuration mode. To restore the default, use the no form of this command.

cbr rate

no cbr rate

Syntax Description

rate

Constant bit bate (also known as the average cell rate) for ATM CES. The valid range for this command is from 56 to 10,000 kbps.

Defaults

0

Command Modes

ATM virtual circuit configuration

Command History
Release Modification

12.0

This command was introduced.

Usage Guidelines

This command applies to ATM configuration on the Cisco MC3810.

Examples

The following example configures the constant bit rate on ATM PVC 20 on the Cisco MC3810:

pvc 20
 cbr 56

Related Commands
Command Description

ces cell-loss-integration-period

Sets the CES cell-loss integration period on the Cisco MC3810 multiservice concentrator.

ces clockmode synchronous

Configures the ATM CES synchronous clock mode on the Cisco MC3810 multiservice concentrator.

ces connect

Maps the CES service to an ATM PVC on the Cisco MC3810 multiservice concentrator.

ces initial-delay

Configures the size of the receive buffer of a CES circuit on the Cisco MC3810 multiservice concentrator.

ces max-buf-size

Configures the send buffer of a CES circuit on the Cisco MC3810 multiservice concentrator.

ces max-buf-size

Configures the send buffer of a CES circuit on the Cisco MC3810 multiservice concentrator.

ces partial-fill

Configures the number of user octets per cell for the ATM CES on the Cisco MC3810 multiservice concentrator.

ces service

Configures the ATM CES type on the Cisco MC3810 multiservice concentrator.

encapsulation atm-ces

Enables CES ATM encapsulation on the Cisco MC3810 multiservice concentrator.

ccs connect

To configure a CCS connection on an interface configured to support CCS frame forwarding, use the ccs connect command in controller interface configuration mode. To disable the CCS connection on the interface, use the no form of this command.

ccs connect {serial | atm} number [dlci dlci | pvc vci | pvc vcd | pvc vpi/vci | pvc string]

no ccs connect {serial | atm} number [dlci dlci | pvc vci | pvc vcd | pvc vpi/vci | pvc string]

Syntax Description

serial

Make a serial CCS connection.

atm

Make an ATM CCS connection.

number

Specifies the connection number.

dlci dlci

(Optional) Specifies the DLCI number.

pvc vci

(Optional) Specifies the PVC virtual circuit identifier.

pvc vcd

(Optional) Specifies the PVC virtual circuit descriptor.

pvc vpi/vci

(Optional) Specifies the PVC virtual path identifier/virtual channel identifier.

pvc string

(Optional) Specifies the PVC string.

Defaults

No CCS connection is made.

Command Modes

Controller interface configuration

Command History
Release Modification

12.0(2)T

This command was introduced.

Examples

The following example shows how to configure a CCS frame-forwarding connection on DLCI 100:

ccs connect serial 1 dlci 100
 

The following example shows how to configure a CCS frame-forwarding connection over an ATM PVC:

ccs connect atm0 pvc 100

Related Commands
Command Description

mode ccs

Configures the T1/E1 controller to support CCS cross-connect or CCS frame-forwarding.

ces cell-loss-integration-period

To set the circuit emulation service (CES) cell-loss integration period, use the ces cell-loss-integration-period command in interface configuration mode.To delete the cell-loss integration period, use the no form of this command.

ces cell-loss-integration-period period

no ces cell-loss-integration-period period

Syntax Description

period

Time in milliseconds for the cell loss integration period. Possible values are from 1 to MAXINT.

Defaults

2500

Command Modes

Interface configuration

Command History
Release Modification

11.3 MA

This command was introduced.

Usage Guidelines

This command applies to ATM configuration on the Cisco MC3810.

This command is supported on serial ports 0 and 1 with encapsulation atm-ces.

Examples

The following example configures the CES cell-loss integration period on serial port 0 to 1056:

interface serial 0
 ces cell-loss-integration-period 1056

Related Commands
Command Description

cbr

Configures the CBR for the ATM CES for an ATM PVC on the Cisco MC3810 multiservice concentrator.

ces clockmode synchronous

Configures the ATM CES synchronous clock mode on the Cisco MC3810 multiservice concentrator.

ces connect

Maps the CES service to an ATM PVC on the Cisco MC3810 multiservice concentrator.

ces initial-delay

Configures the size of the receive buffer of a CES circuit on the Cisco MC3810 multiservice concentrator.

ces max-buf-size

Configures the send buffer of a CES circuit on the Cisco MC3810 multiservice concentrator.

ces partial-fill

Configures the number of user octets per cell for the ATM CES on the Cisco MC3810 multiservice concentrator.

ces service

Configures the ATM CES type on the Cisco MC3810 multiservice concentrator.

encapsulation atm-ces

Enables CES ATM encapsulation on the Cisco MC3810 multiservice concentrator.

ces clockmode synchronous

To configure the ATM circuit emulation service (CES) synchronous clock mode, use the ces clockmode synchronous command in interface configuration mode. To restore the default value, use the no form of this command.

ces clockmode synchronous

no ces clockmode synchronous

Syntax Description

This command has no arguments or keywords.

Defaults

Enabled

Command Modes

Interface configuration

Command History
Release Modification

11.3 MA

This command was introduced.

Usage Guidelines

This command applies to ATM configuration on the Cisco MC3810.

This command maps into the transmit clock source of the CBR interface. This command is supported on serial ports 0 and 1 when set for CES ATM encapsulation.

Examples

The following example sets the ATM CES clock to synchronous mode on serial port 0:

interface serial 0
 ces clockmode synchronous

Related Commands
Command Description

encapsulation atm-ces

Enables CES ATM encapsulation on the Cisco MC3810 multiservice concentrator.

ces connect

To map the circuit emulation service (CES) service to an ATM PVC on the Cisco MC3810, use the ces connect command in interface configuration mode. To delete the CES map to the ATM PVC, use the no form of this command.

ces connect atm-interface pvc [name | [vpi/]vci]

no ces connect atm-interface pvc [name | [vpi/]vci]

Syntax Description

atm-interface

Number of the ATM interface. The only valid option on the Cisco MC3810 is ATM0.

pvc

Specifies that the connection is to an ATM PVC.

name

(Optional) The name of the ATM PVC.

vpi/

(Optional) The virtual path identifier value.

vci

(Optional) The virtual channel identifier value.

Defaults

No ATM interface is defined.

Command Modes

Interface configuration

Command History
Release Modification

11.3 MA

This command was introduced.

Usage Guidelines

This command applies to ATM configuration on the Cisco MC3810.

This command is supported on serial ports 0 and 1. The ATM interface must be configured to encapsulation atm-ces, and the vpi/vci must be defined on the interface.

Examples

The following example maps the CES service to PVC 20 on ATM port 0:

ces connect atm0 pvc 20

Related Commands
Command Description

cbr

Configures the CBR for the ATM CES for an ATM PVC on the Cisco MC3810 multiservice concentrator.

ces cell-loss-integration-period

Sets the CES cell-loss integration period on the Cisco MC3810 multiservice concentrator.

ces clockmode synchronous

Configures the ATM CES synchronous clock mode on the Cisco MC3810 multiservice concentrator.

ces initial-delay

Configures the size of the receive buffer of a CES circuit on the Cisco MC3810 multiservice concentrator.

ces max-buf-size

Configures the send buffer of a CES circuit on the Cisco MC3810 multiservice concentrator.

ces partial-fill

Configures the number of user octets per cell for the ATM CES on the Cisco MC3810 multiservice concentrator.

ces service

Configures the ATM CES type on the Cisco MC3810 multiservice concentrator.

encapsulation atm-ces

Enables CES ATM encapsulation on the Cisco MC3810 multiservice concentrator.

ces initial-delay

To configure the size of the receive buffer of a circuit emulation service (CES) circuit, use the ces initial-delay command in interface configuration mode. To remove the initial-delay value, use the no form of this command.

ces initial-delay bytes

no ces initial-delay bytes

Syntax Description

bytes

The size of the receive buffer of the CES circuit. The valid range is from 1 to 16,000 bytes. This command is used to accommodate cell jitter on the network. Bytes received from the ATM network are buffered by this amount before being sent to the CES port.

Defaults

4000 bytes

Command Modes

Interface configuration

Command History
Release Modification

11.3 MA

This command was introduced.

Usage Guidelines

This command applies to ATM configuration on the Cisco MC3810.

Examples

The following example configures the transmit buffer of the CES circuit to 8000 bytes:

ces initial-delay 8000

Related Commands
Command Description

ces cell-loss-integration-period

Sets the CES cell-loss integration period on the Cisco MC3810 multiservice concentrator.

ces clockmode synchronous

Configures the ATM CES synchronous clock mode on the Cisco MC3810 multiservice concentrator.

ces connect

Maps the CES service to an ATM PVC on the Cisco MC3810 multiservice concentrator.

ces max-buf-size

Configures the send buffer of a CES circuit on the Cisco MC3810 multiservice concentrator.

ces partial-fill

Configures the number of user octets per cell for the ATM CES on the Cisco MC3810 multiservice concentrator.

ces service

Configures the ATM CES type on the Cisco MC3810 multiservice concentrator.

ces max-buf-size

To configure the transmit buffer of a circuit emulation service (CES) circuit, use the ces max-buf-size command in interface configuration mode. To delete the CES transmit buffer size, use the no form of this command.

ces max-buf-size size

no ces max-buf-size size

Syntax Description

size

Maximum size of the transmit buffer for the CES. Possible values are from 80 to 1520.

Defaults

256

Command Modes

Interface configuration

Command History
Release Modification

11.3 MA

This command was introduced.

Usage Guidelines

This command applies to ATM configuration on the Cisco MC3810.

Using this command, incoming bytes received on a CES port are buffered by the amount configured, and sent to the AAL1 process as a block of data.

This command is supported on serial ports 0 and 1 when the encapsulation atm-ces command is enabled.

Examples

The following example configures the maximum CES reassembly buffer size to 1520:

ces max-buf-size 1520

Related Commands
Command Description

ces cell-loss-integration-period

Sets the CES cell-loss integration period on the Cisco MC3810 multiservice concentrator.

ces clockmode synchronous

Configures the ATM CES synchronous clock mode on the Cisco MC3810 multiservice concentrator.

ces connect

Maps the CES service to an ATM PVC on the Cisco MC3810 multiservice concentrator.

ces initial-delay

Configures the size of the receive buffer of a CES circuit on the Cisco MC3810 multiservice concentrator.

ces partial-fill

Configures the number of user octets per cell for the ATM CES on the Cisco MC3810 multiservice concentrator.

ces service

Configures the ATM CES type on the Cisco MC3810 multiservice concentrator.

ces partial-fill

To configure the number of user octets per cell for the ATM circuit emulation service (CES), use the ces partial-fill command in interface configuration mode. To delete the CES partial-fill value, use the no form of this command.

ces partial-fill octet

no ces partial-fill octet

Syntax Description

octet

Number of user octets per cell for the CES. Possible values of octet range from 0 to 47. Setting this number to zero disables partial cell fill and causes all cells to be completely filled before they are sent.

Defaults

47

Command Modes

Interface configuration

Command History
Release Modification

11.3 MA

This command was introduced.

Usage Guidelines

This command applies to ATM configuration on the Cisco MC3810.

Setting the value of the ces partial-fill command to zero disables partial cell fill and causes all cells to be completely filled before they are sent. This command is supported on serial ports 0 and 1 when the encapsulation atm-ces command is enabled.

Examples

The following example sets the CES partial cell fill to 20 octets per cell for serial port 0:

interface serial 0
 ces partial-fill 20

Related Commands
Command Description

ces cell-loss-integration-period

Sets the CES cell-loss integration period on the Cisco MC3810 multiservice concentrator.

ces clockmode synchronous

Configures the ATM CES synchronous clock mode on the Cisco MC3810 multiservice concentrator.

ces connect

Maps the CES service to an ATM PVC on the Cisco MC3810 multiservice concentrator.

ces initial-delay

Configures the size of the receive buffer of a CES circuit on the Cisco MC3810 multiservice concentrator.

ces max-buf-size

Configures the send buffer of a CES circuit on the Cisco MC3810 multiservice concentrator.

ces service

Configures the ATM CES type on the Cisco MC3810 multiservice concentrator.

ces service

To configure the ATM circuit emulation service (CES) type, use the ces service command in interface configuration mode. To stop the ATM CES service type, use the no form of this command.

ces service structured

no ces service structured

Syntax Description

structured

Specifies that the ATM CES type is structured. Structured is the only option supported in this release.

Defaults

Structured

Command Modes

Interface configuration

Command History
Release Modification

11.3 MA

This command was introduced.

Usage Guidelines

This command applies to ATM configuration on the Cisco MC3810.

This command is supported on serial ports 0 and 1 when the encapsulation atm-ces command is enabled.

Examples

The following example sets the CES service to structured for serial port 0:

interface serial 0
 ces service structured

Related Commands
Command Description

ces cell-loss-integration-period

Sets the CES cell-loss integration period on the Cisco MC3810 multiservice concentrator.

ces clockmode synchronous

Configures the ATM CES synchronous clock mode on the Cisco MC3810 multiservice concentrator.

ces connect

Maps the CES service to an ATM PVC on the Cisco MC3810 multiservice concentrator.

ces initial-delay

Configures the size of the receive buffer of a CES circuit on the Cisco MC3810 multiservice concentrator.

ces max-buf-size

Configures the send buffer of a CES circuit on the Cisco MC3810 multiservice concentrator.

ces partial-fill

Configures the number of user octets per cell for the ATM CES on the Cisco MC3810 multiservice concentrator.

clear cable flap-list

To reset the flap-list table for a specific cable modem or for all cable modems connected to the Cisco uBR7200 series, use the clear cable flap-list command in privileged EXEC mode.

clear cable flap-list [mac-addr | all]

Syntax Description

mac-addr

(Optional) MAC address. Specify the 48-bit hardware address of an individual cable modem.

all

(Optional) Remove all cable modems from the flap-list table.

Defaults

No default behavior or values.

Command Modes

Privileged EXEC

Command History
Release Modification

11.3 NA

This command was introduced.

Usage Guidelines

Cable modems are removed from the flap-list table after the number of days (between 1 and 60) specified by the cable flap-list aging global configuration command. Use the clear cable flap-list command to remove individual cable modems from the flap-list while retaining flapping activity for other cable modems, or to clear the entire flap-list table.

Examples

The following example removes all the cable modems from the flap-list table:

clear cable flap-list all

Related Commands
Command Description

cable flap-list aging

Specifies how many days to record and retain flapping activity on a cable modem before aging the cable modem out of the flap-list table.

cable flap-list insertion-time

Sets the insertion time interval that determines whether a cable modem is placed in the flap list.

cable flap-list power-adjust threshold

Specifies the power-adjust threshold for recording a cable modem flap-list event.

cable flap-list size

Specifies the maximum number of cable modems reported in the flap-list table.

clear cable modem counters

To reset the cable modem flapping counters to zero, use the clear cable modem counters command in privileged EXEC mode.

clear cable modem {mac-addr | ip-addr | all} counters

Syntax Description

mac-addr

MAC address. Specify the 48-bit hardware address of an individual cable modem.

ip-addr

IP address. Specify the IP address of an individual cable modem.

all

Resets the flapping data for all modems.

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 clears the counters for the cable modem at IP address 172.00.00.00:

clear cable modem 172.00.00.00 counters

Related Commands
Command Description

clear cable modem reset

Removes a cable modem from the Station Maintenance List and resets the cable modem.

clear cable modem reset

To remove a cable modem from the Station Maintenance List and reset it, use the clear cable modem reset command in privileged EXEC mode.

clear cable modem {mac-addr | ip-addr | all} reset

Syntax Description

mac-addr

MAC address. Specify the 48-bit hardware address of an individual cable modem.

ip-addr

IP address. Specify the IP address of an individual cable modem.

all

Removes all the cable modems from the Station Maintenance List.

Defaults

No default behavior or values.

Command Modes

Privileged EXEC

Command History
Release Modification

11.3 NA

This command was introduced.

Usage Guidelines

This command causes the link to the cable modem to drop. The cable modem responds by resetting itself. It can take up to 30 seconds for the reset sequence to begin.

Examples

The following example removes the cable modem at 172.00.00.00 from the Station Maintenance List and causes it to reset:

clear cable modem 172.00.00.00 reset

Related Commands
Command Description

clear cable modem counters

Resets the flapping counters of a cable modem to zero.

clear csm-statistics modem

To clear the CSM statistics for a modem or group of modems, use the clear csm-statistics modem command in privileged EXEC mode.

clear csm-statistics modem [slot/port | modem-group-number]

Syntax Description

slot/port

(Optional) Identifies the location (and thereby the identity) of a specific modem.

modem-group-number

(Optional) Designates a defined modem group.

Command Modes

Privileged EXEC

Command History
Release Modification

11.3 NA

This command was introduced.

Usage Guidelines

Use the clear csm-statistics modem command to clear CSM statistics for a particular modem or group of modems. If the slot/port argument is specified, the CSM call statistics for calls using the identified modem will be cleared. If a modem group number is specified, then the CSM call statistics for calls using the modems associated with that group will be cleared. If no argument is specified, all CSM call statistics for all modems will be cleared.

Examples

The following example clears CSM call statistics for calls coming in on modems associated with modem group 2:

config terminal
 clear csm-statistics modem 2

Related Commands
Command Description

clear csm-statistics voice

Clears the CSM statistics for a particular or all DSP channels.

clear csm-statistics voice

To clear the CSM statistics for a particular or all digital signal processor (DSP) channels, use the clear csm-statistics voice command in privileged EXEC mode.

clear csm-statistics voice [slot/dspm/dsp/dsp-channel]

Syntax Description

slot/dspm/dsp/dsp-channel

(Optional) Identifies the location of a particular DSP channel.

Command Modes

Privileged EXEC

Command History
Release Modification

11.3 NA

This command was introduced.

Usage Guidelines

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

Examples

The following example clears CSM call statistics for calls coming in on all DSP channels:

config terminal
 clear csm-statistics voice

Related Commands
Command Description

clear csm-statistics modem

Clears the CSM statistics for a modem or group of modems.

clear h323 gatekeeper call

To force a disconnect on a specific call or all calls active on a particular Multimedia Conference Manager (MCM) gateway, use the clear h323 gatekeeper call command in privileged EXEC mode.

clear h323 gatekeeper call {all | local-callID local-callID}

Syntax Description

all

Forces all active calls currently associated with this MCM gatekeeper to be disconnected.

local-callID

Forces a single active call associated with this MCM gatekeeper to be disconnected.

local-callID

The local call identification number (CallID) that identifies the call to be disconnected.

Defaults

No default behavior or values.

Command Modes

Privileged EXEC

Command History
Release Modification

12.0(5)T

This command was introduced.

Usage Guidelines

If you want to force a particular call to be disconnected (as opposed to all active calls on the MCM gateway), use the CallID number to identify that specific call. You can find the local CallID number for a specific call by using the show gatekeeper calls command; the ID number is displayed in the LocalCallID column. Figure 1 shows output from the show gatekeeper calls command.


Figure 1: show gatekeeper calls Command Output
router# show gatekeeper calls
 
Total number of active calls =1
                    Gatekeeper Call Info
                    ====================
LocalCallID                    Age (secs)      BW
12-3339                        94              768 (Kbps)
 Endpt(s): Alias    E.164Addr     CallSignalAddr   Port   RASSignalAddr    Port
   src EP: epA                    10.0.0.11        1720   10.0.0.11        1700
   dst EP: epB2zoneB.com
   src PX: pxA                    10.0.0.1         1720   10.0.0.11        24999
   dst PX: pxB                    172.21.139.90    1720   172.21.139.90    24999

Examples

The following example forces an active call on the MCM gateway to be disconnected. The local ID number of the active call is 12-3339.

enable
clear h323 gatekeeper call local-callID 12-3339

The following example forces all active calls on the MCM gateway to be disconnected:

enable
clear h323 gatekeeper call all

Related Commands
Command Description

show gatekeeper calls

Shows the status of each ongoing call that a gatekeeper is aware of.

clear voice port

To clear voice port calls in progress on the Cisco MC3810, use the clear voice port command in privileged EXEC mode.

clear voice port [slot/port]

Syntax Description

slot/port

(Optional) The voice port slot number and port number. If you do not specify a voice port, all calls on all voice ports are cleared.

Command Modes

Privileged EXEC

Command History
Release Modification

11.3 MA

This command was introduced.

Usage Guidelines

This command applies to Voice over Frame Relay, Voice over ATM, and Voice over HDLC on the Cisco MC3810.

If you do not specify a voice port, all calls on all voice ports are cleared. A confirmation prompt is displayed.

Examples

The following example clears all calls on voice port 1/2 on the Cisco MC3810:

clear voice port 1/2

clock rate line

To configure the line clock rate for serial ports 0 or 1 in DTE mode on the Cisco MC3810, use the clock rate line command in interface configuration mode. To cancel the clock rate line value, use the no form of this command.

clock rate line rate

no clock rate line rate

Syntax Description

rate

Network clock line rate in bits per second. The range is from 56 kbps to 2048 kbps. The value entered should be a multiple of 8,000 of the value set for the network-clock base-rate command. There is no default rate.

Defaults

No clock rate is set.

Command Modes

Interface configuration

Command History
Release Modification

11.3 MA

This command was introduced.

Usage Guidelines

This command specifies the rate of the incoming clock so that the appropriate internal clock scaling can be performed.

To configure the clock rate for a serial port in DTE mode, use the clock rate network-clock command.

Examples

The following configures the clock rate on serial 1 in DTE mode:

interface serial 1
 clock rate line 2048

Related Commands
Command Description

clock rate network-clock

Configures the network clock speed for serial ports 0 or 1 in DCE mode.

clock source (MC3810 multiservice concentrator)

Specifies the clock source of a DS1 link on the Cisco MC3810 multiservice concentrator.

network-clock base-rate

Configures the network clock base rate for universal I/O serial ports 0 and 1 on the Cisco  MC3810 multiservice concentrator.

clock rate network-clock

To configure the network clock speed for serial ports 0 or 1 in DCE mode on the Cisco MC3810, use the clock rate network-clock command in interface configuration mode. To cancel the network clock speed value, use the no form of this command.

clock rate network-clock rate

no clock rate network-clock rate

Syntax Description

rate

Network clock speed in bits per second. The range is from 56 kbps to 2048 kbps. The value entered should be a multiple of the value set for the network-clock base-rate command. There is no default rate.

Defaults

No clock rate is set.

Command Modes

Interface configuration

Command History
Release Modification

11.3 MA

This command was introduced.

Usage Guidelines

This command uses a synchronized clock on the serial port. The use of this command allows the clock on the serial port to be synchronized with the clock source of controller T1 0.

To configure the clock rate for a serial port in DTE mode, use the clock rate line command.

Examples

The following configures the clock rate on serial 1 in DCE mode:

interface serial 1
 clock rate network-clock 2048

Related Commands
Command Description

clock rate line

Configures the line clock rate for serial ports 0 or 1 in DTE mode.

clock source (MC3810 multiservice concentrator)

Specifies the clock source of a DS1 link on the Cisco MC3810 multiservice concentrator.

network-clock base-rate

Configures the network clock base rate for universal I/O serial ports 0 and 1 on the Cisco  MC3810 multiservice concentrator.

codec (Cisco 7200 series)

To specify call density and codec complexity based on a particular codec standard, use the codec command in DSP interface dsp farm mode. To reset the card type to the default, use the no form of the command.

codec {high | low | medium}

no codec {high | low | medium}

Syntax Description

high

Specifies high complexity: Two channels of any mix of codec.

low

Specifies low complexity: Eight channels of g711.

medium

Specifies medium complexity: Four channels of g711/g726/g729a/fax.

Defaults

Medium

Command Modes

DSP interface dsp farm

Command History
Release Modification

12.0(5)XE and 12.0(7)T

This command was introduced.

Usage Guidelines

Codec complexity refers to the amount of processing required in order to perform compression. Codec complexity affects the number of calls that can take place on the DSPfarm interfaces, referred to as call density. The greater the codec complexity, the fewer calls are handled. For example, G.711 requires less DSP processing than G.728, so that as long as the bandwidth is available, more calls can be handled simultaneously by using the G.711 standard than using G.728.

The DSP interface dspfarm codec complexity setting affects the options available for the codec dial-peer configuration command.

To change codec complexity, you must first remove any configured CAS or DS0 groups, and then reinstate them after the change.

Examples

The following example configures the DSPfarm interface 1/0 on the Cisco 7200 series routers to support high compression:

dspint dspfarm 1/0 
codec high 0-30

Related Commands
Command Description

command-type

Specifies the companding standard used to convert between analog and digital signals in PCM systems.

codec (dial-peer)

To specify the voice coder rate of speech for a dial peer, use the codec command in dial-peer configuration mode. To reset the default value, use the no form of this command.

Cisco 2600 and 3600 series routers, Cisco AS5300 access servers, and AS5800 access servers

codec {g711alaw | g711ulaw | g723ar53 | g723ar63 | g723r53 | g723r63 | g726r16 | g726r24 |
g726r32 | g728 | g729br8 | g729r8} [bytes | bytes payload_size] [pre-ietf]

no codec {g711alaw | g711ulaw | g723ar53 | g723ar63 | g723r53 | g723r63 | g726r16 | g726r24 |
g726r32 | g728 | g729br8 | g729r8} [bytes | bytes payload_size] [pre-ietf]

Cisco MC3810

codec {g711alaw | g711ulaw | g726r32 | g729ar8 | g729r8} [bytes | bytes payload_size]

no codec {g711alaw | g711ulaw | g726r32 | g729ar8 | g729r8} [bytes | bytes payload_size]

Syntax Description

g711alaw

G.711 a-Law at 64000 bits per second (bps).

g711ulaw

G.711 u-Law at 64000 bps.

g723ar53

G.723.1 ANNEX A at 5300 bps.

g723ar63

G.723.1 ANNEX A at 6300 bps.

g723r53

G.723.1 at 5300 bps.

g723r63

G.723.1 at 6300 bps.

g726r16

G.726 at 16000 bps.

g726r24

G.726 at 24000 bps.

g726r32

G.726 at 32000 bps.

g728

G.728 at 16000 bps.

g729br8

G.729 ANNEX B at 8000 bps.

g729r8

G.729 at 8000 bps. This is the default codec.

bytes

(Optional) Specifies the voice data bytes per frame for VoIP dial peers. Acceptable values are from 10 to 240 in increments of 10 (10, 20, 30 ... 220, 230, 240). Any other value is rounded down.

bytes

(Optional) Used to specify the number of bytes in the voice payload of each VoFR frame of a VoFR dial peer.

payload_size

(Optional) The number of bytes in the voice payload of each VoFR frame. Enter a ? character after the keyword bytes to get a list of valid payload values for your specific VoFR dial peer.

pre-ietf

(Optional) Specifies pre-Internet Engineering Task Force (IETF) bit-ordering. This keyword is valid only on the Cisco 2600, 3600, or AS5300 routers when the g729r8 codec is specified.

You must specify this keyword for connection to a Cisco 2600 series, 3600 series, 7200 series router, or AS5300 access server running a Cisco IOS release prior to 12.0(5)T or 12.0(4)XH.

Cisco 2600 and 3600 series routers, Cisco AS5300 access servers, and AS5800 access servers


g711alaw

G.711 a-Law at 64,000 bits per second (bps).

g711ulaw

G.711 u-Law at 64,000 bps.

g726r32

G.726 at 32000 bps.

g729ar8

G.729 ANNEX A at 8000 bps.

g729r8

G.729 at 8000 bps. This is the default codec.

bytes

(Optional) Specifies the voice data bytes per frame for VoIP dial peers. Acceptable values are from 10 to 240 in increments of 10 (10, 20, 30 ... 220, 230, 240). Any other value is rounded down.

bytes

(Optional) Used to specify the number of bytes in the voice payload of each VoFR frame of a VoFR dial peer.

payload_size

(Optional) The number of bytes in the voice payload of each VoFR frame. Enter a ? character after the keyword bytes to get a list of valid payload values for your specific VoFR dial peer.

Cisco MC3810


Defaults

g729r8, 30-byte payload for VoFR, VoATM, and VoHDLC

g729r8, 20-byte payload for VoIP

Command Modes

Dial-peer configuration

Command History
Release Modification

11.3(1)T

This command was introduced.

11.3(3)T

Support for Cisco 2600 series routers was added.

12.0(3)T

Support for the Cisco AS5300 access server was added.

12.0(4)T

This command was modified for VoFR dial peers, and support for this command was extended to the Cisco MC3810.

12.0(5)XK and 12.0(7)T

Additional codec choices and other options were added.

Usage Guidelines

Use this command to define a specific voice coder rate of speech and payload size for a VoIP dial peer or for a VoFR dial peer.

A specific codec type can be configured on the dial-peer as long as it is supported by the setting used with the codec complexity voice-card configuration command. The codec complexity command is voice-card-specific and platform-specific.

The codec dial-peer configuration command is particularly useful when you must change to a small-bandwidth codec. Large-bandwidth codecs, such as G.711, do not fit in a small-bandwidth link. However, the g711alaw and g711ulaw codecs provide higher-quality voice transmission than other codecs. The g729r8 codec provides near-toll quality with considerable bandwidth savings.

If codec values for the dial peers of a connection do not match, the call fails.

You can change the payload of each VoIP frame by using the bytes setting; you can change the payload of each VoFR frame by using the bytes keyword with the payload_size setting. However, increasing the payload size can add processing delay for each voice packet.

For toll quality, use the g711alaw or g711ulaw keyword. These values provide high-quality voice transmission but use a significant amount of bandwidth. For almost toll quality (and a significant savings in bandwidth), use the g729r8 keyword.

On the Cisco MC3810, this command was first supported as a voice port command. This command does not apply to the Cisco 7200 series routers.

On the Cisco MC3810, you can also assign codec values to the voice port. If configuring calls to a Cisco MC3810 running software versions prior to 12.0(4)T, configure the codec command on the voice port. If configuring Cisco-trunk permanent calls, configure the codec command on the dial peer. If you configure the codec command on the dial peer for Voice over Frame Relay permanent calls on the Cisco MC3810, the dial peer codec command setting overrides the codec setting configured on the voice port.


Note For regular switched calls on the Cisco MC3810, the codec value must be configured on the voice port, and the voice payload size is not configurable.

Examples

The following example shows how to configure a voice coder rate that provides toll quality voice with a payload of 120 bytes per voice frame on a Cisco 2600 series or 3600 series router acting as a terminating node. The example configuration begins in global configuration mode and is for VoFR dial peer 200.

dial-peer voice 200 vofr
 codec g711alaw bytes 120

The following example configures a voice coder rate for VoIP dial peer 10 that provides toll quality but uses a relatively high amount of bandwidth:

dial-peer voice 10 voip
 codec g711alaw

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 complexity

Sets codec complexity and call density for voice cards.

connection

Specifies a connection mode for a voice port.

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.

fax-rate

Establishes the rate at which a fax will be sent to the specified dial peer.

preference

Indicates the preferred order of a dial peer within a rotary hunt group.

session protocol

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.

session target

Specifies a network-specific address for a specified dial peer or destination gatekeeper.

show dial-peer voice

Displays the codec setting for dial peers.

vad (dial peer)

Enables VAD for the calls using a particular dial peer.

codec (voice-port)

To configure voice compression on the Cisco MC3810 voice port, use the codec command in voice-port configuration mode. To restore the default value, use the no form of this command.

codec {g729r8 | g729ar8 | g726r32 | g711alaw | g711ulaw}

no codec {g729r8 | g729ar8 | g726r32 | g711alaw | g711ulaw}

Syntax Description

g729r8

Specifies G729, 8k CSA-CELP compression. This is the default.

g729ar8

Specifies G729, 8k CSA-CELP Annex A compression.

g726r32

Specifies G.726 32K ADCPM compression.

g711alaw

Specifies G.711 64K PCM a-Law compression.

g711ulaw

Specifies G.711 64K PCM u-Law compression.

Defaults

The default is g729ar8 compression mode.

Command Modes

Voice-port configuration

Command History
Release Modification

11.3 MA

This command was introduced.

Usage Guidelines

The g729ar8 compression mode can support a maximum of 24 simultaneously active on-net voice calls on the Cisco MC3810 while the g729r8 compression mode can only support a maximum of 12. Both compression modes have a nominal data rate of 8 kbps.

This command applies to both analog and digital voice ports on the Cisco MC3810.


Note On the Cisco 3600 series, the codec compression values are assigned to the dial peer using the codec dial-peer configuration command.

Examples

The following example configures voice port 1/1 on the Cisco MC3810 to support g729r8 compression:

voice-port 1/1
 codec g729r8

Related Commands
Command Description

compand-type

Specifies the companding standard used to convert between analog and digital signals in PCM systems on the Cisco MC3810 multiservice concentrator.

codec complexity

To specify call density and codec complexity based on the codec standard you are using, use the codec complexity command in voice-card configuration mode. To reset the voice card to the default, use the no form of the command.

codec complexity {high | medium}

no codec complexity {high | medium}

Syntax Description

high

High-complexity codecs support the following services: G.711, G.726, G.729, G.729 Annex B, G.723.1, G.723.1 Annex A, G.728, and fax relay.

medium

Medium-complexity codecs support the following services: G.711, G.726, G.729 Annex A, G.729 Annex B with Annex A, and fax relay.

Defaults

medium

Command Modes

Voice-card configuration

Command History
Release Modification

12.0(5)XK and 12.0(7)T

The command was introduced for the Cisco 2600 and 3600 series.

Usage Guidelines

Codec complexity refers to the amount of processing required in order to perform compression. Codec complexity affects the number of calls that can take place on a voice card's digital signal processors (DSPs), referred to as call density. The greater the codec complexity, the fewer calls are handled. For example, G.711 requires less DSP processing than G.728, so that as long as the bandwidth is available, more calls can be handled simultaneously by using the G.711 standard than using G.728.

All voice cards in a router must use the same codec complexity. The voice-card codec complexity setting affects the options available for the codec dial-peer configuration command.

To change codec complexity, you must first remove any configured CAS or DS0 groups, then reinstate them after the change.

If you set codec complexity to high, the following options are available:

If you set codec complexity to medium, the following options are valid:

Examples

The following example configures a voice card for high-complexity codecs:

voice-card 1
 codec complexity high

Related Commands
Command Description

ds0-group

Defines T1/E1 channels for compressed voice calls and the CAS method by which the router connects to the PBX or PSTN.

codec preference

To specify a list of preferred codecs to use on a dial peer, use the codec preference command in class configuration mode. To restore the default, use the no form of this command.

codec preference value codec_type bytes size

no codec preference value codec_type bytes size

Syntax Description

value

Specifies the order of preference with 1 being the most preferred and 12 being the least preferred.

codec_type

Specifies the type of codec preferred.

bytes

Specifies that the size of the voice frame is in bytes.

size

Number of voice data bytes per frame. Valid sizes vary by codec.

Defaults

No default behavior or values.

Command Modes

Class configuration

Command History
Release Modification

12.0(2)XH

This command was introduced.

Examples

The following example illustrates a list of 12 codecs in order of preference:

voice class codec 99
 codec preference 1 g711alaw
 codec preference 2 g711ulaw bytes 80
 codec preference 3 g723ar53
 codec preference 4 g723ar63 bytes 144
 codec preference 5 g723r53
 codec preference 6 g723r63 bytes 120
 codec preference 7 g726r16
 codec preference 8 g726r24
 codec preference 9 g726r32 bytes 80
 codec preference 10 g728
 codec preference 11 g729br8
 codec preference 12 g729r8 bytes 50

Related Commands
Command Description

codec

Specifies the voice coder rate of speech for a dial peer.

voice-class codec

Applies a codec preference list to a specific dial peer.

voice-card

Creates a codec preference list that is independent of a dial peer and can be used on multiple dial peers.

comfort-noise

To generate background noise to fill silent gaps during calls if voice activity detection (VAD) is activated, use the comfort-noise command in voice-port configuration mode. To provide silence when the remote party is not speaking and VAD is enabled at the remote end of the connection, use the no form of this command.

comfort-noise

no comfort-noise

Syntax Description

This command has no arguments or keywords.

Defaults

Enabled

Command Modes

Voice-port configuration

Command History
Release Modification

11.3(1)T

This command was introduced.

Usage Guidelines

Use the comfort-noise command to generate background noise to fill silent gaps during calls if VAD is activated. If the comfort-noise command is not enabled, and VAD is enabled at the remote end of the connection, the user will hear dead silence when the remote party is not speaking.

The configuration of the comfort-noise command only affects the silence generated at the local interface; it does not affect the use of VAD on either end of the connection or the silence generated at the remote end of the connection.


Note On the Cisco MC3810, this command cannot be disabled.

Examples

The following example enables background noise on the Cisco 3600 series:

voice-port 1/0/0
 comfort-noise

Related Commands
Command Description

vad (dial-peer configuration)

Enables VAD for the calls using a particular dial peer.

vad (voice-port configuration)

Enables VAD for the calls using a particular voice port on the Cisco MC3810 multiservice concentrator.

compand-type

To specify the companding standard used to convert between analog and digital signals in PCM systems on the Cisco MC3810, use the compand-type command in voice-port configuration mode. To disable the compand type, use the no form of this command.

compand-type {u-law | a-law}

no compand-type {u-law | a-law}

Syntax Description

u-law

Specifies the North American u-Law ITU-T PCM encoding standard.

a-law

Specifies the European a-Law ITU-T PCM encoding standard.

Defaults

u-Law (T1 digital)

a-Law (E1 digital)

Command Modes

Voice-port configuration

Command History
Release Modification

11.3 MA

This command was first introduced.

Usage Guidelines

This command applies only to the Cisco MC3810.


Note On the Cisco 3600 series, the u-Law and a-Law settings are configured using the codec dial-peer configuration command.

Examples

The following example configures a-law encoding on voice port 1/1 on the Cisco MC3810:

voice-port 1/1
 compand-type a-law

Related Commands
Command Description

codec (voice-port configuration)

Configures voice compression on the Cisco MC3810 voice port.

condition

To manipulate the signalling format bit pattern for all voice signalling types on the Cisco MC3810, use the condition command in voice-port configuration mode. Use the no form of this command to turn off conditioning on the voice-port.

condition {tx-a-bit | tx-b-bit | tx-c-bit | tx-d-bit} {rx-a-bit | rx-b-bit | rx-c-bit | rx-d-bit}
{on | off | invert}

no condition {tx-a-bit | tx-b-bit | tx-c-bit | tx-d-bit} {rx-a-bit | rx-b-bit | rx-c-bit | rx-d-bit}
{on | off | invert}

Syntax Description

tx-a-bit

Sends A bit.

tx-b-bit

Sends B bit.

tx-c-bit

Sends C bit.

tx-d-bit

Sends D bit.

rx-a-bit

Receives A bit.

rx-b-bit

Receives B bit.

rx-c-bit

Receives C bit.

rx-d-bit

Receives D bit.

on

Forces the bit state to be a 1.

off

Forces the bit state to be a 0.

invert

Inverts the state of the bits.

Defaults

No condition (for all send or receive A, B, C, and D bits)

Command Modes

Voice-port configuration

Command History
Release Modification

11.3 MA

This command was introduced.

Usage Guidelines

This command applies to the Cisco MC3810 only.

Use the condition command to manipulate the bit patterns sent or received by the Cisco MC3810 to match expected patterns on a connected device. Be careful not to destroy the information content of the bit pattern. For example, forcing the A-bit on or off will prevent FXO interfaces from being able to generate both an on-hook and off-hook state.

Examples

The following example manipulates the signalling format bit-pattern on voice port 1/1 on the Cisco MC3810:

voice-port 1/1
 condition tx-a-bit invert
 condition rx-a-bit invert

Related Commands
Command Description

define

Defines the send and receive bits for E&M and E&M MEL CAS voice signalling on the Cisco MC3810 multiservice concentrator.

ignore

Specifies the E&M or E&M MEL CAS voice port on the Cisco MC3810 multiservice concentrator to ignore specific receive bits.

connect

To define connections between T1 or E1 controller ports for drop-and-insert (also called TDM cross-connect), use the connect command in global configuration mode. Use the no form of this command to restore default values.

connect id {t1 | e1} slot/port-1 tdm-group-no-1 {t1 | e1} slot/port-2 tdm-group-no-2

no connect id {t1 | e1} slot/port-1 tdm-group-no-1 {t1 | e1} slot/port-2 tdm-group-no-2

Syntax Description

id

A name for this connection.

t1

Specifies a T1 port.

e1

Specifies an E1 port.

slot/port-1

The location of the first T1 or E1 controller to be connected. Valid values for slot and port are 0 and 1.

tdm-group-no-1

The number identifier of the time-division multiplexing (TDM) group associated with the first T1 or E1 controller port and created by using the tdm-group command. Valid values are from 0 to 23 for T1 and from 0 to 30 for E1.

slot/port-2

The location of the second T1 or E1 controller port to be connected.

Valid values for slot are from 0 to 5 depending on the platform.

Valid values for port are 0 to 3 depending on the platform and the presence of a network module.

tdm-group-no-2

The number identifier of the time-division multiplexing (TDM) group associated with the second T1 or E1 controller and created by using the tdm-group command. Valid values are from 0 to 23 for T1 and from 0 to 30 for E1.

Defaults

There is no drop-and-insert connection between the ports.

Command Modes

Global configuration

Command History
Release Modification

12.0(5)XK and 12.0(7)T

The command was introduced.

Usage Guidelines

The connect command creates a named connect between two TDM groups associated with drop-and-insert ports on T1 or E1 interfaces where the user has already defined the groups by using the tdm-group command.

Examples

The following example shows how two T1 TDM groups are set up and then connected:

Router(config)# controller T1 1/0
Router(config-controller)tdm-group 2 timeslots 13-24 type e&m
Router(config-controller)# controller T1 1/1
Router(config-controller)tdm-group 3 timeslots 13-24 type e&m
Router(config-controller)exit
Router(config)connect tdm1 T1 1/0 2 T1 1/1 3

Related Commands
Command Description

show connect

Displays configuration information about drop-and-insert connections that have been configured on a router.

tdm-group

Configures a list of timeslots for creating clear channel groups (pass-through) for TDM cross-connect.

connect (global)

This command, created for the Cisco MC3810-IGX Interworking feature in Cisco IOS Release 12.0(2)T, is not supported in this release.

connect voice

This command, created for the Cisco MC3810-IGX Interworking feature in Cisco IOS Release 12.0(2)T, is not supported in this release.

connection

To specify a connection mode for a voice port, use the connection command in voice-port configuration mode. Use the no form of this command to disable the selected connection mode.

connection {plar | tie-line | plar-opx} string | {trunk | string [answer-mode]}

no connection {plar | tie-line | plar-opx} string | {trunk | string [answer-mode]}

Syntax Description

plar

Specifies a private line auto ring down (PLAR) connection. PLAR is handled by associating a peer directly with an interface; when an interface goes off-hook, the peer is used to set up the second call leg and conference them together without the caller having to dial any digits.

tie-line

(This keyword is specific to the Cisco MC3810.) Specifies a tie-line connection to a private branch exchange (PBX).

plar-opx

(This keyword is specific to the Cisco MC3810) Specifies a PLAR Off-Premises eXtension connection. Using this option, the local voice-port provides a local response before the remote voice-port receives an answer. On FXO interfaces, the voice-port will not answer until the remote side answers.

string

Specifies the destination telephone number. Valid entries are any series of digits that specify the E.164 telephone number.

trunk

Specifies a straight tie-line connection to a private branch exchange (PBX).

string

Specifies the destination telephone number. Valid entries are any series of digits that specify the E.164 telephone number.

answer-mode

(Optional; used only with the trunk keyword.) Specifies that the router should not attempt to initiate a trunk connection, but should wait for an incoming call before establishing the trunk.

Defaults

No connection mode is specified.

Command Modes

Voice-port configuration

Command History
Release Modification

11.3(1)T

This command was introduced.

11.3(1)MA1

This command was first supported on the Cisco MC3810, and the tie-line keyword was made available on the Cisco MC3810.

11.3(1)MA5

The plar-opx keyword was first made available on the Cisco MC3810 as the plar-opx-ringrelay keyword. The keyword was shortened in a subsequent release.

12.0(3)XG

The trunk keyword was made available on the Cisco MC3810. The trunk answer-mode option was added.

Usage Guidelines

Use the connection command to specify a connection mode for a specific interface. For example, use the connection plar command to specify a PLAR interface. The string you configure for this command is used as the called number for all calls coming in over this connection. The destination peer is determined by called number.

Use the connection trunk command to specify a straight tie-line connection (in other words, a virtual trunk connection) to a PBX. Voice over IP simulates a trunk connection by creating virtual trunk tie lines between PBXs connected to Cisco devices on each side of a VoIP connection. (See Figure 2.) In this example, two PBXs are connected using a virtual trunk. PBX-A is connected to Router A via an E&M voice port; PBX-B is connected to Router B via an E&M voice port. The Cisco routers spoof the connected PBXs into believing that a permanent trunk tie line exists between them.


Figure 2: Virtual Trunk Connection


To configure virtual trunk connections in Voice over IP, the following restrictions apply:


Note Because virtual trunk connections do not support number expansion, the destination patterns on each side of the trunk connection must match exactly.

If you desire one of the devices in a static trunk connection to act as slave and receive calls only, use the answer-mode option with the connection trunk command when configuring that device.


Note When using the connection trunk command, you must perform a shutdown/no shutdown command sequence on the voice port.

VoIP establishes the trunk connection immediately after it is configured. Both ports on either end of the connection are dedicated until you disable trunking for that connection. If for some reason the link between the two switching systems goes down, the virtual trunk re-establishes itself after the link comes back up.

The connection tie-line command is used on the Cisco MC3810 when a dial plan requires that additional digits are added in front of any digits dialed by the PBX, and that the combined set of digits are used to route the call via the dial-peers and into the network. The operation is similar to the connection plar command operation, but in this case the tie-line port also waits to collect digits from the PBX. The tie-line digits are also automatically stripped by a terminating port.

If the connection command is not configured, the standard session application outputs a dial tone when the interface goes off-hook until enough digits are collected to match a dial-peer and complete the call.

Examples

The following example selects PLAR as the connection mode on the Cisco 3600 series, with a destination telephone number of 555-9262:

voice-port 1/0/0
 connection plar 5559262
 

The following example selects tie-line as the connection mode on the Cisco MC3810, with a destination telephone number of 555-9262:

voice-port 1/1
 connection tie-line 5559262
 

The following example configures the routers on both sides of a Voice over IP connection (as illustrated in Figure 2) to support trunk connections:

Router A

configure terminal
voice-port 1/0/0
 connection trunk +15105554000
dial-peer voice 10 pots
 destination-pattern +13085551001
 port 1/0/0
dial-peer voice 100 voip
 session-target ipv4:172.20.10.10
 destination-pattern +15105554000
 

Router B

configure terminal
voice-port 1/0/0
 connection trunk +13085551000
dial-peer voice 20 pots
 destination-pattern +15105554001
 port 1/0/0
dial-peer voice 200 voip
 session-target ipv4:172.19.10.10
 destination-pattern +13085551000

Related Commands
Command Description

session protocol

Establishes a session protocol for calls between the local and remote routers through the packet network in Voice over IP.

voice-port

Enters voice-port configuration mode.

connection-timeout

To configure the time that a connection is maintained after completing a communication exchange, use the connection-timeout command in settlement configuration mode. Use the no form of this command to reset to the default value of this command.

connection-timeout num

no connection-timeout num

Syntax Description

num

Time (in seconds) that a connection is maintained after the communication exchange is completed. Values can range from zero (0) to 86400 seconds, zero (0) means forever.

Defaults

The default connection timeout is 3600 seconds (1 hour).

Command Modes

Settlement configuration

Command History
Release Modification

12.0(4)XH1

This command was introduced.

Usage Guidelines

When you configure the connection timeout command, the router maintains the connection for this period in anticipation of future communication exchanges to the same server.

Examples

The following example configures the connection timeout to be 3600 seconds:

settlement 0
    connection timeout 3600

Related Commands
Command Description

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.

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.

copy flash vfc

To copy a new version of VCWare from the Cisco AS5300 motherboard to VFC Flash memory, use the copy flash vfc command in privileged EXEC mode.

copy flash vfc slot-number

Syntax Description

slot-number

Indicates the slot on the Cisco AS5300 where the VFC is installed. Valid entries are from 0 to 2.

Defaults

No default behavior or values.

Command Modes

Privileged EXEC

Command History
Release Modification

11.3 NA

This command was introduced.

Usage Guidelines

Use the copy flash vfc command to use the standard copy user interface to copy a new version of VCWare from the Cisco AS5300 motherboard to VFC Flash memory. The VFC is a plug-in feature card for the Cisco AS5300 and has its own Flash memory storage for embedded firmware. For more information about VFCs, refer to Installing Voice over IP Feature Cards in Cisco AS5300 Universal Access Servers.

Once the VCWare file has been copied, use the unbundle vfc command to uncompress and install VCWare.

Examples

The following example copies a new version of VCWare from the Cisco AS5300 motherboard to VFC Flash memory:

copy flash vfc 0

Related Commands
Command Description

copy tftp vfc

Copies a new version of VCWare from a TFTP server to VFC Flash memory.

unbundle vfc

Unbundles the current running image of VCWare or DSPWare into separate files.

copy tftp vfc

To copy a new version of VCWare from a TFTP server to VFC Flash memory, use the copy tftp vfc command in privileged EXEC mode.

copy tftp vfc slot-number

Syntax Description

slot-number

Indicates the slot on the Cisco AS5300 where the VFC is installed. Valid entries are from 0 to 2.

Defaults

No default behavior or values.

Command Modes

Privileged EXEC

Command History
Release Modification

11.3 NA

This command was introduced.

Usage Guidelines

Use the copy tftp vfc command to copy a new version of VCWare from a TFTP server to VFC Flash memory. The VFC is a plug-in feature card for the Cisco AS5300 and has its own Flash storage for embedded firmware. For more information about VFCs, refer to Installing Voice Over IP Feature Cards in Cisco AS5300 Universal Access Servers.

Once the VCWare file has been copied, use the unbundle vfc command to uncompress and install VCWare.

Examples

The following example copies a file from the TFTP server to VFC Flash memory:

copy tftp vfc 0

Related Commands
Command Description

copy flash vfc

Copies a new version of VCWare from the Cisco AS5300 motherboard to VFC Flash memory.

unbundle vfc

Unbundles the current running image of VCWare or DSPWare into separate files.

cptone

To specify a regional analog voice interface-related tone, ring, and cadence setting, use the cptone command in voice-port configuration mode. Use the no form of this command to disable the selected tone.

cptone locale

no cptone locale

ISDN PRI

cptone {australia | brazil | china | finland | france | germany | japan | northamerica | sweden | unitedkingdom}

no cptone

E1 R2 signalling

cptone {australia | brazil | china | finland | france | germany | japan | northamerica | sweden | unitedkingdom}

no cptone

Syntax Description

locale

Keyword specifying an analog voice interface-related default tone, ring, and cadence setting for a specified country.

Valid entries for the Cisco MC3810 prior to release 12.0(4)T are: argentina, australia, austria, belgium, brazil, canada, china, colombia, czechrepublic, denmark, finland, france, germany, greatbritain, greece, hongkong, hungary, iceland, india, indonesia, ireland, israel, italy, japan, korea, luxembourg, malaysia, mexico, netherlands, newzealand, norway, peru, philippines, poland, portugal, russia, singapore, slovakia, slovenia, southafrica, spain, sweden, switzerland, taiwan, thailand, turkey, unitedstates, and venezuela.

The Cisco 2600 series, 3600 series and the Cisco MC3810 comply with the ISO 3166 country name standards, which use a two-letter code to represent a country. Valid entries are listed in Table 11.

Table 11 lists valid entries for the locale argument.


Table 11: cptone locale Argument Command Entries
cptone Command Entry Country

ar

Argentina

au

Australia

at

Austria

be

Belgium

br

Brazil

ca

Canada

cn

China

co

Colombia

cz

Czech Republic

dk

Denmark

fi

Finland

fr

France

de

Germany

gb

Great Britain

gr

Greece

hk

Hong Kong

hu

Hungary

is

Iceland

in

India

id

Indonesia

ie

Ireland

il

Israel

it

Italy

jp

Japan

kr

Korea Republic

lu

Luxembourg

my

Malaysia

mx

Mexico

nl

Netherlands

nz

New Zealand

no

Norway

pe

Peru

ph

Philippines

pl

Poland

pt

Portugal

ru

Russian Federation

sg

Singapore

sk

Slovakia

si

Slovenia

za

South Africa

es

Spain

se

Sweden

ch

Switzerland

tw

Taiwan

th

Thailand

tr

Turkey

gb

Great Britain

us

United States

ve

Venezuela

australia

Specifies an analog voice interface-related default tone, ring, and cadence setting for Australia.

brazil

Specifies an analog voice interface-related default tone, ring, and cadence setting for Brazil.

china

Specifies an analog voice interface-related default tone, ring, and cadence setting for China.

finland

Specifies an analog voice interface-related default tone, ring, and cadence setting for Finland.

france

Specifies an analog voice interface-related default tone, ring, and cadence setting for France.

germany

Specifies an analog voice interface-related default tone, ring, and cadence setting for Germany.

japan

Specifies an analog voice interface-related default tone, ring, and cadence setting for Japan.

northamerica

Specifies an analog voice interface-related default tone, ring, and cadence setting for North America.

sweden

Specifies an analog voice interface-related default tone, ring, and cadence setting for Sweden.

unitedkingdom

Specifies an analog voice interface-related default tone, ring, and cadence setting for the United Kingdom.

ISDN PRI.


E1 R2 signalling:

locale

Keyword specifying an analog voice interface-related default tone, ring, and cadence settings for a specified country.

Valid entries are listed in Table 11.



Defaults

northamerica for the Cisco MC3810 for versions prior to Release 12.0(4)T; and for ISDN PRI. us for the Cisco MC3810 for 12.0(4)T and higher and for E1 R2 signalling.

Command Modes

Voice-port configuration

Command History
Release Modification

11.3(1)T

This command was introduced.

11.3(1)MA

The full keyword names for the countries were first supported on the Cisco MC3810.

12.0(4)T

Support was added for the ISO 3166 two-letter country codes on the Cisco MC3810.

Usage Guidelines

Use the cptone command to specify a regional analog voice interface-related default tone, ring, and cadence setting for a specified voice port. This command only affects the tones generated at the local interface. It does not affect any information passed to the remote end of a connection, or any tones generated at the remote end of a connection.

This command only affects the tones generated at the local interface. It does not affect any information passed to the remote end of a connection, or any tones generated at the remote end of a connection.

If your device is configured to support E1 R2 signalling, the E1 R2 signalling type (whether ITU, ITU variant, or local variant as defined by the cas-custom command) needs to match the appropriate PCM encoding type as defined by the cptone command. For countries for which a cptone value has not yet been defined, you can try the following:

Examples

The following example configures United States as the call progress tone locale on the Cisco 3600 series, beginning from global configuration mode:

voice-port 1/0/0
 cptone us
 

The following example configures Singapore as the call progress tone locale on the Cisco MC3810, beginning from global configuration mode:

voice-port 1/1
 cptone sg
 

The following example configures Japan as the call progress tone locale:

voice-port 0:D
 cptone japan
 

The following example configures Brazil as the call progress tone locale on the Cisco AS5300:

voice-port 1:0
 cptone BR
 description Brasil Tone

Related Commands
Command Description

voice-port

Opens voice-port configuration mode.

cross-connect

To cross-connect two groups of digital signal level 0s (DS0s) from two controllers on the Cisco MC3810, or to cross-connect the Universal I/O (UIO) serial port for pass-through traffic to a trunk controller, use the cross-connect command in global configuration command. Use the no form of this command to remove the cross-connect function for the given controller.

Pass-through between two controllers:

cross-connect id controller-1 tdm-group-no-1 controller-2 tdm-group-no-2

no cross-connect id controller-1 tdm-group-no-1 controller-2 tdm-group-no-2

Pass-through traffic from a UIO serial port to a trunk controller:

cross-connect id interface-serial controller tdm-group-no

no cross-connect id interface-serial controller tdm-group-no


Note The UIO serial port is either serial port 0 or 1.

Syntax Description

For pass-through between two controllers:

id

Unique ID assigned to this cross-connection. The valid range is from 0 to 31.

controller-1

Type of the first controller (T1 0, T1 1, or E1)

tdm-group-no-1

TDM group number assigned to the first controller.

controller-2

Type of the second controller (T1, E1 0, or E1 1).

tdm-group-no-2

TDM group number assigned to the second controller.

For pass-through traffic from a UIO serial port to a trunk controller:

id

Unique ID assigned to this cross connection.

interface-serial

Number of the serial port, either 0 or 1.

controller

Type of the controller. Enter one of the following: T1 0, T1 1, E1 0, or  E1 1.

tdm-group-no

TDM group number assigned to the controller.

Defaults

No default behavior or values.

Command Modes

Global configuration

Command History
Release Modification

11.3 MA

This command was introduced.

Usage Guidelines

This command applies to Voice over Frame Relay, Voice over ATM, and Voice over HDLC on the Cisco MC3810.

Examples

The following example configures a pass-through cross-connect from serial port 0 to controller T1 1 on TDM group 20:

cross-connect 10 serial0 T1 1 20

Related Commands
Command Description

supervisory disconnect

Configures a list of timeslots for creating clear channel groups (pass-through) for TDM cross-connect.

customer-id

To identify a carrier or internet service provider with a settlement provider, use the customer-id command in settlement configuration mode. Use the no form of this command to reset to the default value of this command.

customer-id num

no customer-id num

Syntax Description

num

Customer ID number as provided by the settlement server.

Defaults

The default customer ID is 0.

Command Modes

Settlement configuration

Command History
Release Modification

12.0(4)XH1

This command was introduced.

Examples

The following example identifies a carrier or service provider with the ID number of 1000:

settlement 0
    customer id 1000

Related Commands
Command Description

connection-timeout

Configures the time that a connection is maintained after completing a communication exchange.

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.

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 configuration mode and specifies the attributes specific to a settlement provider.

type

Configures an SAA-RTR operation type.

url

Configures the ISP address.

default-file vfc

To specify an additional (or different) file from the ones in the default file list and stored in VFC Flash memory, use the default-file vfc command in global configuration mode. To delete the file from the default file list, use the no form of this command.

default-file filename vfc slot

no default-file filename vfc slot

Syntax Description

filename

Indicates the file to be retrieved from VFC Flash memory and used (as the default file) to boot up the system.

slot

Indicates the slot on the Cisco AS5300 where the VFC is installed. Valid entries are from 0 to 2.

Defaults

No default behavior or values.

Command Modes

Global configuration

Command History
Release Modification

11.3 NA

This command was introduced.

Usage Guidelines

When VCWare is unbundled, it automatically adds DSPWare to Flash memory, creates both the capability and default file lists, and populates these lists with the default files for that version of VCWare. The default file list includes the files that will be used to boot up the system.

Use the default-file vfc command to add a specified file to the default file list, replacing the existing default for that extension type.

Examples

The following example specifies that the bas-vfc-1.0.14.0.bin file, which is stored in VFC Flash memory, be added to the default file list:

config term
 default-file bas-vfc-1.0.14.0.bin vfc 0

Related Commands
Command Description

cap-list vfc

Adds a voice codec overlay file to the capability file list.

delete vfc

Deletes a file from VFC Flash memory.

define

To define the transmit and receive bits for E&M and E&M MEL CAS voice signalling on the Cisco MC3810, use the define command in voice-port configuration mode. Use the no form of this command to restore the default value.

define {Tx-bits | Rx-bits} {seize | idle} {0000 | 0001 | 0010 | 0011 | 0100 | 0101 | 0110 | 0111 | 1000 | 1001 | 1010 | 1011 | 1100 | 1101 | 1110 | 1111}

no define {Tx-bits | Rx-bits} {seize | idle} {0000 | 0001 | 0010 | 0011 | 0100 | 0101 | 0110 | 0111 | 1000 | 1001 | 1010 | 1011 | 1100 | 1101 | 1110 | 1111}

Syntax Description

Tx-bits

Send signalling bits.

Rx-bits

Receive signalling bits.

seize

Define the pattern that represents the seized state.

idle

Define the pattern that represents the idle state.

0000...1111

Define the appropriate bit pattern.

Defaults

The default is to use the preset signalling patterns as defined in ANSI and CEPT standards, as follows:

For E&M:

Tx-bits idle 0000 (0001 if on E1 trunk)
Tx-bits seize 1111
Rx-bits idle 0000
Rx-bits seize 1111

For E&M MEL CAS:

Tx-bits idle 1101
Tx-bits seize 0101
Rx-bits idle 1101
Rx-bits seize 0101

Command Modes

Voice-port configuration

Command History
Release Modification

11.3 MA

This command was introduced.

Usage Guidelines

This command applies to digital voice ports on the Cisco MC3810 only.

Use the define command to match the E&M bit patterns with the attached telephony device. Be careful not to define invalid configurations, such as all 0000 on E1, or identical seize and idle states. Use this command with the ignore command.

Examples

To configure a voice-port sending traffic in North American E&M signalling format to convert the signalling to Mercury Exchange Limited (MEL) CAS format, enter the following commands:

voice-port 1/1
 define rx-bits idle 1101
 define rx-bits idle 0101
 define tx-bits seize 1101
 define tx-bits seize 0101

Related Commands
Command Description

condition

Manipulates the signalling format bit-pattern for all voice signalling types on the Cisco MC3810 multiservice concentrator.

ignore

Specifies the E&M or E&M MEL CAS voice port on the Cisco MC3810 multiservice concentrator to ignore specific receive bits.

delete vfc

To delete a file from VFC Flash memory, use the delete vfc command in privileged EXEC mode.

delete filename vfc slot

Syntax Description

filename

Specifies the file in VFC Flash memory to be deleted.

slot

Specifies the slot on the Cisco AS5300 where the specified VFC resides. Valid entries are from 0 to 2.

Command Modes

Privileged EXEC

Command History
Release Modification

11.3 NA

This command was introduced.

Usage Guidelines

Use the delete vfc command to delete a specific file from VFC Flash memory, and to remove the file from the default list or capability list if the specified file is included on those lists.


Note Deleting a file from VFC Flash memory does not free the VFC Flash memory space the file occupied. To free VFC Flash memory space, use the erase vfc command.

Examples

The following example deletes the bas-vfc-1.0.14.0.bin file, which is stored in VFC Flash memory of the VFC located in slot 0:

delete bas-vfc-1.0.14.0.bin vfc 0

Related Commands
Command Description

default-file vfc

Specifies an additional (or different) file from the ones in the default file list and stored in VFC Flash memory.

show vfc directory

Displays the list of all files residing on this VFC.

erase vfc

Erases the Flash memory of a specified VFC.

description

To include a description of what this voice port is connected to, use the description command in voice-port configuration mode. Use the no form of this command to disable this feature.

description string

no description string

Syntax Description

string

Character string from 1 to 255 characters.

Defaults

Enabled with a null string.

Command Modes

Voice-port configuration

Command History
Release Modification

11.3(1)T

This command was introduced.

Usage Guidelines

This command applies to both the Cisco MC3810 and the Cisco 3600 series.

Use the description command to include descriptive text about this voice-port connection. This information is displayed when you issue a show command and does not affect the operation of the interface in any way.

Examples

The following example identifies voice port 1/0/0 on the Cisco 3600 series as being connected to the Purchasing department:

voice-port 1/0/0
 description purchasing_dept
 

The following example identifies voice port 1/1 on the Cisco MC3810 as being connected to the Marketing department:

voice-port 1/1
 description marketing_dept

description (DSP)

To include a specific description about the digital signal processor (DSP) interface, use the description command in DSPfarm interface configuration mode. Use the no form of this command to disable this feature.

description string

no description string

Syntax Description

string

Character string from 1 to 80 characters.

Defaults

Enabled with a null string.

Command Modes

DSPfarm interface configuration

Command History
Release Modification

11.3(1)T

This command was introduced.

Usage Guidelines

Use the description command to include descriptive text about this DSP interface connection. This information is displayed when you issue a show command and does not affect the operation of the interface in any way.

Examples

The following example identifies DSPfarm interface 1/0 on the Cisco 7200 series router as being connected to the marketing department:

dspint dspfarm 1/0
 description marketing_dept

destination-pattern

To specify either the prefix or the full E.164 telephone number (depending on your dial plan) to be used for a dial peer, use the destination-pattern command in dial-peer configuration mode. Use the no form of this command to disable the configured prefix or telephone number.

destination-pattern [+]string[T]

no destination-pattern [+]string[T]

Syntax Description

+

(Optional) Character indicating an E.164 standard number. The plus sign (+) is not supported on the Cisco MC3810.

string

Series of digits that specify the E.164 or private dialing plan telephone number. Valid entries are the digits 0 through 9, the letters A through D, and the following special characters:

  • The asterisk (*) and pound sign (#) that appear on standard touch-tone dial pads. On the Cisco 3600 only, these characters cannot be used as leading characters in a string (for example, *650).

  • Comma (,), which inserts a pause between digits.

  • Period (.), which matches any entered digit (this character is used as a wildcard). On the Cisco 3600, the period cannot be used as a leading character in a string (for example, .650).

T

(Optional) Control character indicating that the destination-pattern value is a variable length dial-string.

Defaults

Enabled with a null string

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

Use the destination-pattern command to define the E.164 telephone number for a dial peer.

This pattern is used to match dialed digits to a dial peer. The dial peer is then used to complete the call. When a router receives voice data, it compares the called number (the full E.164 telephone number) in the packet header with the number configured as the destination pattern for the voice-telephony peer. The router then strips out the left-justified numbers corresponding to the destination pattern. If you have configured a prefix, the prefix is appended to the front of the remaining numbers, creating a dial string, which the router then dials. If all numbers in the destination pattern are stripped-out, the user receives a dial tone.

There are certain areas in the world (for example, in certain European countries) where valid telephone numbers can vary in length. Use the optional control character t to indicate that a particular destination-pattern value is a variable-length dial string. In this case, the system does not match the dialed numbers until the interdigit timeout value has expired.


Note The Cisco IOS software does not check the validity of the E.164 telephone number; it accepts any series of digits as a valid number.

Examples

The following example configures the E.164 telephone number, 555-7922, for a dial peer:

dial-peer voice 10 pots
 destination-pattern +5557922

Related Commands
Command Description

answer-address

Specifies the full E.164 telephone number to be used to identify the dial peer of an incoming call.

prefix

Specifies the prefix of the dialed digits for this dial peer.

timeouts interdigit

Configures the interdigit timeout value for a specified voice port.

destination-pattern (ISDN)

To specify the ISDN directory number for the telephone interface, use the destination-pattern command in interface configuration mode. Use the no form of this command to disable the specified ISDN directory number.

destination-pattern isdn

no destination-pattern

Syntax Description

isdn

Local ISDN directory number assigned by your telephone service provider.

Defaults

A default ISDN directory number is not defined for this interface.

Command Modes

Interface configuration

Command History
Release Modification

12.0(3)T

This command was introduced.

Usage Guidelines

This command is applicable to the Cisco 800 series routers.

You must 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.

Do not specify an area code with the local ISDN directory number.

Examples

The following example specifies 555-1111 as the local ISDN directory number:

destination-pattern 5551111

Related Commands
Command Description

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.

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.

device-id

To specify a gateway associated with a settlement provider, use the device-id command in settlement configuration mode. Use the no form of this command to reset to the default value of this command.

device-id num

no device-id num

Syntax Description

num

Device ID number as provided by the settlement server.

Defaults

The default device ID is 0.

Command Modes

Settlement configuration

Command History
Release Modification

12.0(4)XH1

This command was introduced.

Examples

The following example specifies gateway with device ID# 1000 associated with the settlement provider:

settlement 0
    device-id 1000

Related Commands
Command Description

connection-timeout

Configures the time that a connection is maintained after completing a communication exchange.

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.

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 configuration mode and specifies the attributes specific to a settlement provider.

type

Configures an SAA-RTR operation type.

url

Configures the ISP address.

dial-control-mib

To specify attributes for the call history table, use the dial-control-mib command in global configuration mode.

dial-control-mib {max-size number | retain-timer number}

Syntax Description

max-size number

Specifies the maximum size of the call history table. Valid entries are from 0 to 500 table entries. A value of 0 prevents any history from being retained.

retain-timer number

Specifies the length of time, in minutes, for entries in the call history table. Valid entries are from 0 to 2147483647 minutes. A value of 0 prevents any history from being retained.

Defaults

The default call history table length is 50 table entries. The default retain timer is 15 minutes.

Command Modes

Global configuration

Command History
Release Modification

11.3(1)T

This command was introduced on the Cisco 3600 Series routers.

12.0(1)XA and 12.0(2)T

This command was first applied to the CDR feature on the Cisco MC3810.

Examples

The following example configures the call history table to hold 400 entries, with each entry remaining in the table for 10 minutes:

configure terminal
 dial-control-mib max-size 400
 dial-control-mib retain-timer 10

dial-peer terminator

To designate a special character to be used as a terminator for variable length dialed numbers, use the dial-peer terminator command in global configuration mode. Use the no form of this command to disable the designated terminating character.

dial-peer terminator character

no dial-peer terminator character

Syntax Description

character

Designates the terminating character for a variable-length dialed number. Valid numbers and characters are #, *, 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, a, b, c, and d.

Defaults

No default behavior or values.

Command Modes

Global configuration

Command History
Release Modification

12.0

This command was introduced.

Usage Guidelines

There are certain areas in the world (for example, in certain European countries) where valid telephone numbers can vary in length. When a dialed-number string has been identified as a variable length dialed-number, the system waits until the configured value for the timeouts interdigits command has expired before placing the call. To avoid waiting until the interdigit timeout value has expired, you can designate a special character as a terminator---meaning that when you dial that character, the system no longer waits for any additional digits and places the call. Use the dial-peer terminator global configuration command to designate a particular character as a terminator.

Examples

The following example configures # as the special terminating character for variable-length dialed-numbers:

configure terminal
 dial-peer terminator #

Related Commands
Command Description

answer-address

Specifies the full E.164 telephone number to be used to identify the dial peer of an incoming call.

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.

timeouts interdigit

Configures the interdigit timeout value for a specified voice port.

dial-peer video

To define a video ATM dial peer for a local or remote video codec, specify video-related encapsulation, and enter dial-peer configuration mode, enter the dial-peer video command in global configuration mode. The video dial peer is persistent and remains until you use the no form of the command to remove it.

dial-peer video tag {videocodec | videoatm}

no dial-peer video tag {videocodec | videoatm}

Syntax Description

tag

Digits defining a particular dial peer. Defines the dial peer and assigns the protocol type to the peer. Valid entries are from 1 to 10000. The tag must be unique on the router.

videocodec

This keyword specifies a local video codec connected to the router.

videoatm

This keyword specifies a remote video codec on the ATM network.

Defaults

No video dial peer is configured.

Command Modes

Global configuration

Command History
Release Modification

12.0(5)XK and 12.0(7)T

This command was introduced for ATM interface configuration on the Cisco MC3810.

Usage Guidelines

The tag value that you assign must be unique to the device.

Video dial peers are persistent and remain until explicitly removed using the no form of the command.

Examples

On a Cisco MC3810, the following example shows the setup of a local video dial peer designated as 10:

dial-peer video 10 videocodec

Related Commands
Command Description

show dial-peer video

Displays dial-peer configuration.

dial-peer voice

To enter dial-peer configuration mode (and specify the method of voice-related encapsulation), use the dial-peer voice command in global configuration mode. Use the no form of this command to disable a defined dial peer.

dial-peer voice number {pots | vofr | voip}

no dial-peer voice number {pots | vofr | voip}

Cisco AS5300 access servers

dial-peer voice number {pots | vofr |voip | mmoip}

no dial-peer voice number {pots | vofr |voip | mmoip}

Cisco 7200 series routers

dial-peer voice number {vofr}

no dial-peer voice number {vofr}

Cisco MC3810

dial-peer voice number {pots | voatm | vofr | vohdlc}

no dial-peer voice number {pots | voatm | vofr | vohdlc}

Syntax Description

number

Digit(s) that define a particular dial peer. Valid entries are 1 to 2147483647.

mmoip

Indicates that this is a Multimedia Mail peer using IP encapsulation on the IP backbone.

pots

Indicates that this is a POTS peer using Voice over IP encapsulation on the IP backbone.

voatm

Specifies that this is a Voice over ATM dial peer using the real-time AAL5 voice encapsulation on the ATM backbone network.

vofr

Specifies that this is a Voice over Frame Relay dial peer using FRF.11 encapsulation on the Frame Relay backbone network.

vohdlc

Specifies that this is a Voice over HDLC dial peer using Cisco serial encapsulation (HDLC) for voice.

voip

Indicates that this is a VoIP peer using voice encapsulation on the POTS network.

Defaults

No default behavior or values.

Command Modes

Global configuration

Command History
Release Modification

11.3(1)T

This command was introduced.

11.3(1)MA

This command was first supported on the Cisco MC3810, with support for the pots, vofr, voatm, and vohdlc keywords.

12.0(3)T

This command was first supported on the AS5300, with support for the pots and voip keywords.

12.0(3)XG and 12.0(4)(T)

The vofr keyword was added for support for the Cisco 2600 series and Cisco 3600 series platforms.

12.0(4)T

Added vofr keyword support for the Cisco 7200 series platform.

12.0(4)XJ

Added mmoip keyword support for the Cisco AS5300 platform.

Usage Guidelines

Use the dial-peer voice global configuration command to switch to dial-peer configuration mode from global configuration mode and to define a particular dial peer. Use the exit command to exit dial-peer configuration mode and return to global configuration mode.

After you have created a dial peer, that dial peer remains defined and active until you disable that particular dial peer. To disable a dial peer, use the no form of this command.

In Store and Forward Fax on the Cisco AS5300, the POTS dial peer defines the inbound faxing line characteristics from the sending fax device to the receiving Cisco AS5300 and the outbound line characteristics from the sending Cisco AS5300 to the receiving fax device. The MMoIP dial peer defines the inbound faxing line characteristics from the Cisco AS5300 to the receiving SMTP mail server. This command applies to both on-ramp and off-ramp Store and Forward Fax functions.

Examples

The following example shows how to access dial-peer configuration mode and configure a POTS peer identified as dial peer 100, starting from global configuration mode:

configure terminal
 dial-peer voice 100 pots
 

The following example accesses dial-peer configuration mode and configures a POTS peer identified as dial peer 10 and an MMoIP dial peer identified as dial peer 20:

configure terminal
 dial-peer voice 10 pots
 dial-peer voice 20 mmoip
 
 

The following example disables the MMoIP peer identified as dial peer 20:

configure terminal
 no dial-peer voice 20 

Related Commands
Command Description

codec (dial-peer)

Specifies the voice coder rate of speech for a Voice over Frame Relay dial peer.

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.

sequence-numbers

Enables the generation of sequence numbers in each frame generated by the DSP for Voice over Frame Relay applications.

session protocol

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.

voice-port

Opens voice-port configuration mode.

dial-type

To specify the type of out-dialing for voice port interfaces, use the dial-type command in voice-port configuration mode. Use the no form of this command to disable the selected type of dialing.

dial-type {dtmf | pulse}

no dial-type {dtmf | pulse}

Syntax Description

dtmf

Specifies a touch-tone dialer.

pulse

Specifies a pulse dialer.

Defaults

dtmf

Command Modes

Voice-port configuration

Command History
Release Modification

11.3(1)T

This command was introduced.

Usage Guidelines

This command applies to both the Cisco MC3810 and the Cisco 3600 series.

Use the dial-type command to specify an out-dialing type for an FXO or E&M voice port interface; this command is not applicable to FXS voice ports because they do not generate out-dialing. Voice ports can always detect dtmf and pulse signals. This command does not affect voice port dialing detection.

The dial-type command affects out-dialing as configured for the dial peer.

Examples

The following example configures a voice port on the Cisco 3600 series to support a touch-tone dialer:

voice-port 1/0/0
 dial-type dtmf
 

The following example configures a voice port on the Cisco MC3810 to support a rotary (pulse tone) dialer:

voice-port 1/1
 dial-type pulse

direct-inward-dial

To enable the direct inward dial (DID) call treatment for the incoming called number, use the direct-inward-dial command in dial-peer configuration mode. Use the no form of this command to disable DID.

direct-inward-dial

no direct-inward-dial

Syntax Description

This command has no arguments or keywords.

Defaults

Disabled

Command Modes

Dial-peer configuration

Command History
Release Modification

11.3(1)NA

This command was introduced.

12.0(4)T

This command was modified for Store and Forward Fax.

Usage Guidelines

Use the direct-inward-dial command to enable the DID call treatment for the incoming called numbers. When this feature is enabled, the incoming call is treated as if the digits are received from the DID trunk. The called number is used to select the outgoing dial peer. No dial tone will be presented to the caller.

Use the no form of this command to disable DID. When disabled, the called number is used to select the outgoing dial peer. The caller will be prompted for a called number via dial tone.

This command is only applicable to POTS dial peers. This command applies to on-ramp Store and Forward Fax functions.

Examples

The following example enables DID call treatment for incoming called numbers:

dial peer voice 10 pots
 direct-inward-dial

dsn

To specify that a delivery status notice be delivered to the sender, use the dsn command in dial-peer configuration mode. Use the no form of this command to cancel a specific delay status notice option.

dsn {delay | failure | success}

no dsn {delay | failure | success}

Syntax Description

delay

Indicates that when the mail is sent, the next-hop mailer is requested to send an indication to the FROM address if the mail message is delayed. The definition of delay is made by each mailer and is not controllable by the sender (the AS5300). Each mailer in the path to the recipient that supports the DSN extension receives the same request.

failure

Indicates that when the mail is sent, the next-hop mailer is requested to send a message to the FROM address if the mail message failed to be delivered. Each mailer in the path to the recipient that supports the DSN extension receives the same request.

success

Indicates that when the mail is sent, the next-hop mailer is requested to send a message to the FROM address if the mail message is successfully delivered to the recipient. Each mailer in the path to the recipient that supports the DSN extension receives the same request.


Note In the absence of any other DSN settings ("no dsn," or a mailer in the path that does not support the DSN extension) a failure to deliver will always cause a nondelivery message to be generated. This nondelivery message is colloquially termed a "bounce."

Defaults

The default is success and failure.

Command Modes

Dial-peer configuration

Command History
Release Modification

12.0(4)T

This command was introduced.

Usage Guidelines

This command is applicable to MMoIP dial peers.

Delivery status notifications (DSNs) are messages or responses that are automatically generated and sent to the sender or originator of an e-mail message by the SMTP server, notifying the sender of the status of the e-mail message. Specifications for DSN are described in RFC 1891, RFC 1892, RFC 1893, and RFC 1894.

The on-ramp DSN request is included as part of the fax-mail message sent by the on-ramp gateway when the matching MMoIP dial peer has been configured. The on-ramp DSN response is generated by the SMTP server when the fax-mail message is accepted. The DSN is sent back to the user defined in using the mta send mail-from command. The off-ramp DSN is requested by the e-mail client. The DSN response is generated by the SMTP server when it receives a request as part of the fax-mail message.


Note DSNs can only be generated if the mail client on the SMTP server is capable of responding to a DSN request.

Because the SMTP server generates the DSNs, you need to configure both the mail from: and rcpt to: commands for the DSN feature to be operational, for example:

mail from: <user@mail-server.company.com>
rcpt to: <fax=555-1212@company.com> NOTIFY=SUCCESS,FAILURE,DELAY

There are three different states that can be reported back to the sender:

Because these delivery states are not mutually exclusive, you can configure Store and Forward Fax to generate these messages for all or any combination of these events.

DSN messages notify the sender of the status of a particular e-mail message containing a fax TIFF image. Use the dsn command to specify which notification messages will be sent to the user.

The dsn command allows you to select more than one notification option by reissuing the command, specifying a different notification option each time. To discontinue a specific notification option, use the no form of the command for that specific keyword.


Note If the keyword failure is not included when configuring DSN, the sender will receive absolutely no notification of message delivery failure. As a failure is usually significant, care should be taken to always include failure as part of the dsn command configuration.

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

Examples

The following example specifies that a DSN message be returned to the sender when the e-mail message containing the fax has been successfully delivered to the recipient or if the message containing the fax has failed, for whatever reason, to be delivered:

dial-peer voice 10 mmoip
 dsn success
 dsn failure
 

The following example specifies that a DSN message be returned to the sender either when the e-mail message containing the fax has been successfully delivered to the recipient or when the message has been delayed:

dial-peer voice 10 mmoip
 dsn success
 dsn delayed

Related Commands
Command Description

mta send mail-from

Specifies the mail-from address (also called the RFC 821 envelope-from or the Return-Path address).

ds0-group

To define T1/E1 channels for compressed voice calls and the channel-associated signalling (CAS) method by which the router connects to the PBX or PSTN, use the ds0-group command in controller configuration mode. The no form of the command removes the group and signalling setting.

ds0-group ds0-group-no timeslots timeslot-list type {e&m-immediate | e&m-delay | e&m-wink | fxs-ground-start | fxs-loop-start | fxo-ground-start | fxo-loop-start}

no ds0-group ds0-group-no timeslots timeslot-list type {e&m-immediate | e&m-delay | e&m-wink | fxs-ground-start | fxs-loop-start | fxo-ground-start | fxo-loop-start}

Syntax Description

ds0-group-no

A value from 0 to 23 that identifies the DS0 group.

timeslots timeslot-list

Timeslot timeslot-list is a single time slot number, a single range of numbers, or multiple ranges of numbers separated by commas. For T1/E1, allowable values are from 1 to 24. Examples are:

  • 2

  • 1-15, 17-24

  • 1-23

  • 2, 4, 6-12

type

The signalling method selection for the type keyword depends on the connection that you are making. The E&M interface allows connection for PBX trunk lines (tie lines) and telephone equipment. The FXS interface allows connection of basic telephone equipment and PBX. The FXO interface is for connecting the central office (CO) to a standard PBX interface where permitted by local regulations; it is often used for OPXs.

The options are as follows:

  • e&m-immediate specifies no specific off-hook and on-hook signalling.

  • e&m-delay specifies that the originating endpoint sends an off-hook signal and then and waits for an off-hook signal followed by an on-hook signal from the destination.

  • e&m-wink specifies that the originating endpoint sends an off-hook signal and waits for a wink signal from the destination.

  • fxs-ground-start specifies Foreign Exchange Station ground-start signalling support.

  • fxs-loop-start specifies Foreign Exchange Station loop-start signalling support.

  • fxo-ground-start specifies Foreign Exchange Office ground-start signalling support.

  • fxo-loop-start specifies Foreign Exchange Office loop-start signalling support.

Defaults

No DS0 group is defined.

Command Modes

Controller configuration

Command History
Release Modification

11.2

This command was introduced for the Cisco AS5300 as the cas-group command.

12.0(1)T

The cas-group command was introduced for the Cisco 3600 series.

12.0(5)XE and 12.0(7)T

The command was renamed ds0-group on the Cisco AS5300 and on the Cisco 2600 and 3600 series (Digital T1 Packet Voice Trunk Network Modules are required).

Usage Guidelines

The ds0-group command automatically creates a logical voice port that is numbered as follows on Cisco 2600 and 3600 series routers: slot/port:ds0-group-no. Although only one voice port is created for each group, applicable calls are routed to any channel in the group.

Examples

The following example configures ranges of T1 controller time slots for FXS ground-start and FXO loop-start signalling:

controller T1 1/0
 cablelength long 0db
 ds0-group 1 timeslots 4-5 type e&m-immediate-start

Related Commands
Command Description

codec

Specifies the voice coder rate of speech for a dial peer.

codec complexity

Specifies call density and codec complexity based on the codec standard you are using.

dspfarm

To enable the digital signal processor (DSP) interface, use the dspfarm command in global configuration mode.

dspfarm slot/port

Syntax Description

slot

Slot number of the interface.

port

Port number of the interface.

Defaults

No default behavior or values.

Command Modes

Global configuration

Command History
Release Modification

12.0(5)XE

This command was introduced.

Examples

The following example creates a DSPfarm interface with a slot number of 1 and a port number of 0:

dspint dspfarm 1/0

dtmf-relay

To specify how an H.323 gateway relays dual tone multifrequency (DTMF) tones between telephony interfaces and an IP network, use the dtmf-relay command in dial-peer configuration mode. Use the no form of this command to remove all signalling options and send the DTMF tones as part of the audio stream.

dtmf-relay [cisco-rtp] [h245-alphanumeric] [h245-signal]

no dtmf-relay [cisco-rtp] [h245-alphanumeric] [h245-signal]

Syntax Description

cisco-rtp

(Optional) Forwards DTMF tones by using RTP protocol with a Cisco proprietary payload type.

h245-alphanumeric

(Optional) Forwards DTMF tones by using the H.245 "alphanumeric" User Input Indication method. Supports tones 0-9, *, #, and A-D.

h245-signal

(Optional) Forwards DTMF tones by using the H.245 "signal" User Input Indication method. Supports tones 0-9, *, #, and A-D.

Defaults

No default behavior or values.

Command Modes

Dial-peer configuration

Command History
Release Modification

12.0(1)T

This command was introduced.

12.0(2)XH

This command was modified to include the h245-signal keyword.

12.0(5)T

This command was modified for H.323 V2.

Usage Guidelines

DTMF is the tone generated when you press a digit on a touch-tone phone. This tone is compressed at one end of a call; when the tone is decompressed at the other end, it can become distorted, depending on the codec used. The DTMF relay feature transports DTMF tones generated after call establishment out of band using a standard H.323 out-of-band method and a proprietary RTP-based mechanism.

The gateway only sends DTMF tones in the format you specify if the remote device supports it. If the remote device supports multiple formats, the gateway chooses the format based on the following priority:

    1. cisco-rtp (highest priority)

    2. h245-signal

    3. h245-alphanumeric

    4. None---DTMF sent in-band

The principal advantage of the dtmf-relay command is that it sends DTMF tones with greater fidelity than is possible in-band for most low-bandwidth codecs, such as G.729 and G.723. Without the use of DTMF relay, calls established with low-bandwidth codecs may have trouble accessing automated DTMF-based systems, such as voice-mail, menu-based ACD systems, and automated banking systems.


Note The cisco-rtp option of the dtmf-relay command is a proprietary Cisco implementation and only operates between two Cisco AS5800 universal access servers running Cisco IOS Release 12.0(2)XH, or between Cisco AS5800 universal access servers or Cisco 2600 or 3600 modular access routers running Cisco IOS Release 12.0(2)XH or later releases. Otherwise, the DTMF relay feature does not function, and the gateway sends DTMF tones in-band.

Examples

The following example configures DTMF relay with the cisco-rtp option when sending DTMF tones to dial-peer 103:

configure terminal
 dial-peer voice 103 voip
  dtmf-relay cisco-rtp 
  end
 

The next example configures the dtmf-relay command for cisco-rtp or h245-signal when sending to dial-peer 103:

configure terminal
 dial-peer voice 103 voip
  dtmf-relay cisco-rtp h245-signal
  end
 

The next example configures the gateway to send DTMF in-band (the default) when sending DTMF tones to dial-peer 103:

configure terminal
 dial-peer voice 103 voip
  no dtmf-relay
  end

Related Commands
Command Description

codec

Specifies the voice coder rate of speech for a dial peer.

dtmf-relay (Voice over Frame Relay)

To enable the generation of FRF.11 Annex A frames for a dial peer, use the dtmf-relay command in dial-peer configuration mode. Use the no form of this command to disable the generation of FRF.11 Annex A frames and return to the default handling of dial digits.

dtmf-relay

no dtmf-relay

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

This command applies to all Voice over Frame Relay, Voice over ATM, and Voice over HDLC applications on the Cisco MC3810, and to Voice over Frame Relay applications on the Cisco 2600 series and 3600 series routers.

Cisco recommends that this command be used with low bit-rate codecs.

When dtmf-relay (Voice over Frame Relay) is enabled, the digital signal processor (DSP) generates Annex A frames instead of passing a DTMF tone through the network as a voice sample. For information about the payload format of FRF.11 Annex A frames, see Annex A---Dialed Digit Transfer Syntax, in Voice over Frame Relay Implementation Agreement---FRF.11.

Examples

The following example shows how to enable FRF.11 Annex A frames on a Cisco 2600 series or 3600 series router or on an MC3810 concentrator for VoFR dial peer 200, starting from global configuration mode:

dial-peer voice 200 vofr
 dtmf-relay

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.

connection

Specifies a connection mode for a voice port.

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.

preference

Indicates the preferred order of a dial peer within a rotary hunt group.

session protocol

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.


hometocprevnextglossaryfeedbacksearchhelp
Posted: Tue Jun 20 11:25:54 PDT 2000
Copyright 1989 - 2000©Cisco Systems Inc.