|
|
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.
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
12.0 This command was introduced.
Release
Modification
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
ces cell-loss-integration-period Sets the CES cell-loss integration period on the Cisco MC3810 multiservice concentrator. Configures the ATM CES synchronous clock mode on the Cisco MC3810 multiservice concentrator. Maps the CES service to an ATM PVC on the Cisco MC3810 multiservice concentrator. Configures the size of the receive buffer of a CES circuit on the Cisco MC3810 multiservice concentrator. Configures the send buffer of a CES circuit on the Cisco MC3810 multiservice concentrator. Configures the send buffer of a CES circuit on the Cisco MC3810 multiservice concentrator. Configures the number of user octets per cell for the ATM CES on the Cisco MC3810 multiservice concentrator. Configures the ATM CES type on the Cisco MC3810 multiservice concentrator. encapsulation atm-ces Enables CES ATM encapsulation on the Cisco MC3810 multiservice concentrator.
Command
Description
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]
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
12.0(2)T This command was introduced.
Release
Modification
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
mode ccs Configures the T1/E1 controller to support CCS cross-connect or CCS frame-forwarding.
Command
Description
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
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
11.3 MA This command was introduced.
Release
Modification
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
cbr Configures the CBR for the ATM CES for an ATM PVC on the Cisco MC3810 multiservice concentrator. Configures the ATM CES synchronous clock mode on the Cisco MC3810 multiservice concentrator. Maps the CES service to an ATM PVC on the Cisco MC3810 multiservice concentrator. Configures the size of the receive buffer of a CES circuit on the Cisco MC3810 multiservice concentrator. Configures the send buffer of a CES circuit on the Cisco MC3810 multiservice concentrator. Configures the number of user octets per cell for the ATM CES on the Cisco MC3810 multiservice concentrator. Configures the ATM CES type on the Cisco MC3810 multiservice concentrator. encapsulation atm-ces Enables CES ATM encapsulation on the Cisco MC3810 multiservice concentrator.
Command
Description
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 synchronousSyntax Description
This command has no arguments or keywords.
Defaults
Enabled
Command Modes
Interface configuration
Command History
11.3 MA This command was introduced.
Release
Modification
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
encapsulation atm-ces Enables CES ATM encapsulation on the Cisco MC3810 multiservice concentrator.
Command
Description
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]
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
11.3 MA This command was introduced.
Release
Modification
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
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. Configures the ATM CES synchronous clock mode on the Cisco MC3810 multiservice concentrator. Configures the size of the receive buffer of a CES circuit on the Cisco MC3810 multiservice concentrator. Configures the send buffer of a CES circuit on the Cisco MC3810 multiservice concentrator. Configures the number of user octets per cell for the ATM CES on the Cisco MC3810 multiservice concentrator. Configures the ATM CES type on the Cisco MC3810 multiservice concentrator. encapsulation atm-ces Enables CES ATM encapsulation on the Cisco MC3810 multiservice concentrator.
Command
Description
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
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
11.3 MA This command was introduced.
Release
Modification
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
ces cell-loss-integration-period Sets the CES cell-loss integration period on the Cisco MC3810 multiservice concentrator. Configures the ATM CES synchronous clock mode on the Cisco MC3810 multiservice concentrator. Maps the CES service to an ATM PVC on the Cisco MC3810 multiservice concentrator. Configures the send buffer of a CES circuit on the Cisco MC3810 multiservice concentrator. Configures the number of user octets per cell for the ATM CES on the Cisco MC3810 multiservice concentrator. Configures the ATM CES type on the Cisco MC3810 multiservice concentrator.
Command
Description
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
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
11.3 MA This command was introduced.
Release
Modification
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
ces cell-loss-integration-period Sets the CES cell-loss integration period on the Cisco MC3810 multiservice concentrator. Configures the ATM CES synchronous clock mode on the Cisco MC3810 multiservice concentrator. Maps the CES service to an ATM PVC on the Cisco MC3810 multiservice concentrator. Configures the size of the receive buffer of a CES circuit on the Cisco MC3810 multiservice concentrator. Configures the number of user octets per cell for the ATM CES on the Cisco MC3810 multiservice concentrator. Configures the ATM CES type on the Cisco MC3810 multiservice concentrator.
Command
Description
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
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
11.3 MA This command was introduced.
Release
Modification
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
ces cell-loss-integration-period Sets the CES cell-loss integration period on the Cisco MC3810 multiservice concentrator. Configures the ATM CES synchronous clock mode on the Cisco MC3810 multiservice concentrator. Maps the CES service to an ATM PVC on the Cisco MC3810 multiservice concentrator. Configures the size of the receive buffer of a CES circuit on the Cisco MC3810 multiservice concentrator. Configures the send buffer of a CES circuit on the Cisco MC3810 multiservice concentrator. Configures the ATM CES type on the Cisco MC3810 multiservice concentrator.
Command
Description
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
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
11.3 MA This command was introduced.
Release
Modification
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
ces cell-loss-integration-period Sets the CES cell-loss integration period on the Cisco MC3810 multiservice concentrator. Configures the ATM CES synchronous clock mode on the Cisco MC3810 multiservice concentrator. Maps the CES service to an ATM PVC on the Cisco MC3810 multiservice concentrator. Configures the size of the receive buffer of a CES circuit on the Cisco MC3810 multiservice concentrator. Configures the send buffer of a CES circuit on the Cisco MC3810 multiservice concentrator. Configures the number of user octets per cell for the ATM CES on the Cisco MC3810 multiservice concentrator.
Command
Description
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
11.3 NA This command was introduced.
Release
Modification
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
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.
Command
Description
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
11.3 NA This command was introduced.
Release
Modification
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
Removes a cable modem from the Station Maintenance List and resets the cable modem.
Command
Description
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
11.3 NA This command was introduced.
Release
Modification
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
Resets the flapping counters of a cable modem to zero.
Command
Description
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
11.3 NA This command was introduced.
Release
Modification
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
clear csm-statistics voice Clears the CSM statistics for a particular or all DSP channels.
Command
Description
Syntax Description
slot/dspm/dsp/dsp-channel (Optional) Identifies the location of a particular DSP channel.
Command Modes
Privileged EXEC
Command History
11.3 NA This command was introduced.
Release
Modification
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
clear csm-statistics modem Clears the CSM statistics for a modem or group of modems.
Command
Description
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
12.0(5)T This command was introduced.
Release
Modification
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.
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
show gatekeeper calls Shows the status of each ongoing call that a gatekeeper is aware of.
Command
Description
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
11.3 MA This command was introduced.
Release
Modification
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
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
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
11.3 MA This command was introduced.
Release
Modification
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
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.
Command
Description
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
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
11.3 MA This command was introduced.
Release
Modification
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
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.
Command
Description
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
12.0(5)XE and 12.0(7)T This command was introduced.
Release
Modification
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-type Specifies the companding standard used to convert between analog and digital signals in PCM systems.
Command
Description
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
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.
Release
Modification
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
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.
Command
Description
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}
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
11.3 MA This command was introduced.
Release
Modification
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
Specifies the companding standard used to convert between analog and digital signals in PCM systems on the Cisco MC3810 multiservice concentrator.
Command
Description
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}
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
12.0(5)XK and 12.0(7)T The command was introduced for the Cisco 2600 and 3600 series.
Release
Modification
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
ds0-group Defines T1/E1 channels for compressed voice calls and the CAS method by which the router connects to the PBX or PSTN.
Command
Description
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
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
12.0(2)XH This command was introduced.
Release
Modification
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
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.
Command
Description
Syntax Description
This command has no arguments or keywords.
Defaults
Enabled
Command Modes
Voice-port configuration
Command History
11.3(1)T This command was introduced.
Release
Modification
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
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.
Command
Description
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
11.3 MA This command was first introduced.
Release
Modification
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
codec (voice-port configuration) Configures voice compression on the Cisco MC3810 voice port.
Command
Description
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
11.3 MA This command was introduced.
Release
Modification
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
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.
Command
Description
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
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
12.0(5)XK and 12.0(7)T The command was introduced.
Release
Modification
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
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.
Command
Description
This command, created for the Cisco MC3810-IGX Interworking feature in Cisco IOS Release 12.0(2)T, is not supported in this release.
This command, created for the Cisco MC3810-IGX Interworking feature in Cisco IOS Release 12.0(2)T, is not supported in this release.
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
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.
Release
Modification
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.

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
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.
Command
Description
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
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
12.0(4)XH1 This command was introduced.
Release
Modification
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 0connection timeout 3600
Related Commands
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.
Command
Description
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
11.3 NA This command was introduced.
Release
Modification
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
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.
Command
Description
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
11.3 NA This command was introduced.
Release
Modification
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
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.
Command
Description
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.
| 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
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.
Release
Modification
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
voice-port Opens voice-port configuration mode.
Command
Description
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
11.3 MA This command was introduced.
Release
Modification
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
supervisory disconnect Configures a list of timeslots for creating clear channel groups (pass-through) for TDM cross-connect.
Command
Description
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
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
12.0(4)XH1 This command was introduced.
Release
Modification
Examples
The following example identifies a carrier or service provider with the ID number of 1000:
settlement 0customer id 1000
Related Commands
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.
Command
Description
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
11.3 NA This command was introduced.
Release
Modification
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
cap-list vfc Adds a voice codec overlay file to the capability file list. delete vfc Deletes a file from VFC Flash memory.
Command
Description
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
11.3 MA This command was introduced.
Release
Modification
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
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.
Command
Description
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
11.3 NA This command was introduced.
Release
Modification
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
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.
Command
Description
Syntax Description
string Character string from 1 to 255 characters.
Defaults
Enabled with a null string.
Command Modes
Voice-port configuration
Command History
11.3(1)T This command was introduced.
Release
Modification
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
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
Syntax Description
string Character string from 1 to 80 characters.
Defaults
Enabled with a null string.
Command Modes
DSPfarm interface configuration
Command History
11.3(1)T This command was introduced.
Release
Modification
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
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: 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
11.3(1)T This command was introduced. 12.0(4)XJ This command was modified for Store and Forward Fax.
Release
Modification
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
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.
Command
Description
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
12.0(3)T This command was introduced.
Release
Modification
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
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.
Command
Description
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
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
12.0(4)XH1 This command was introduced.
Release
Modification
Examples
The following example specifies gateway with device ID# 1000 associated with the settlement provider:
settlement 0device-id 1000
Related Commands
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.
Command
Description
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
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.
Release
Modification
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
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
12.0 This command was introduced.
Release
Modification
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
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.
Command
Description
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}
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
12.0(5)XK and 12.0(7)T This command was introduced for ATM interface configuration on the Cisco MC3810.
Release
Modification
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
show dial-peer video Displays dial-peer configuration.
Command
Description
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
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.
Release
Modification
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
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.
Command
Description
Syntax Description
dtmf Specifies a touch-tone dialer. pulse Specifies a pulse dialer.
Defaults
dtmf
Command Modes
Voice-port configuration
Command History
11.3(1)T This command was introduced.
Release
Modification
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
Syntax Description
This command has no arguments or keywords.
Defaults
Disabled
Command Modes
Dial-peer configuration
Command History
11.3(1)NA This command was introduced. 12.0(4)T This command was modified for Store and Forward Fax.
Release
Modification
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
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}
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
12.0(4)T This command was introduced.
Release
Modification
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
mta send mail-from Specifies the mail-from address (also called the RFC 821 envelope-from or the Return-Path address).
Command
Description
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}
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: 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:
Defaults
No DS0 group is defined.
Command Modes
Controller configuration
Command History
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).
Release
Modification
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
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.
Command
Description
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
12.0(5)XE This command was introduced.
Release
Modification
Examples
The following example creates a DSPfarm interface with a slot number of 1 and a port number of 0:
dspint dspfarm 1/0
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]
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
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.
Release
Modification
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
codec Specifies the voice coder rate of speech for a dial peer.
Command
Description
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-relaySyntax Description
This command has no arguments or keywords.
Defaults
Disabled
Command Modes
Dial-peer configuration
Command History
12.0(4)T This command was introduced.
Release
Modification
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
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.
Command
Description
![]()
![]()
![]()
![]()
![]()
![]()
![]()
Posted: Tue Jun 20 11:25:54 PDT 2000
Copyright 1989 - 2000©Cisco Systems Inc.