-
Cisco IOS Multiservice Applications Command Reference, Release 12.1
-
About the Cisco IOS Software Documentation
-
Using Cisco IOS Software
-
Multiservice Application Commands: A through Ca
-
Multiservice Applications Commands: Cb through D
-
Multiservice Applications Commands: E through P
-
Multiservice Applications Commands: R through Sh
-
Multiservice Applications Commands: Si through Z
-
Table Of Contents
Multiservice Applications Commands:
Cb through Dces cell-loss-integration-period
dtmf-relay (Voice over Frame Relay)
Multiservice Applications Commands:
Cb through D
This book documents commands used to configure Voice over ATM, Voice over Frame Relay, Voice over HDLC, Voice over IP, video, head-end universal broadband features, and subscriber-end universal broadband features. Commands in this book are listed alphabetically. For information on how to configure Voice over ATM, Voice over Frame Relay, Voice over HDLC, Voice over IP, video, head-end universal broadband features, and subscriber-end universal broadband features, refer to the
Cisco IOS Multiservice Applications Configuration Guide.cbr
To configure the constant bit rate (CBR) for the ATM circuit emulation service (CES) for an ATM permanent virtual circuit (PVC) on the Cisco MC3810, use the cbr command in ATM virtual circuit configuration mode. To restore the default, use the no form of this command.
cbr rate
no cbr rate
Syntax Description
rate
Constant bit bate (also known as the average cell rate) for ATM CES. The valid range for this command is from 56 to 10,000 kbps.
Defaults
0
Command Modes
ATM virtual circuit configuration
Command History
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 20cbr 56Related Commands
ccs connect
To configure a CCS connection on an interface configured to support CCS frame forwarding, use the ccs connect command in controller interface configuration mode. To disable the CCS connection on the interface, use the no form of this command.
ccs connect {serial | atm} number [dlci dlci | pvc vci | pvc vcd | pvc vpi/vci | pvc string]
no ccs connect {serial | atm} number [dlci dlci | pvc vci | pvc vcd | pvc vpi/vci | pvc string]
Syntax Description
Defaults
No CCS connection is made.
Command Modes
Controller interface configuration
Command History
Examples
The following example shows how to configure a CCS frame-forwarding connection on DLCI 100:
ccs connect serial 1 dlci 100The following example shows how to configure a CCS frame-forwarding connection over an ATM PVC:
ccs connect atm0 pvc 100Related Commands
mode ccs
Configures the T1/E1 controller to support CCS cross-connect or CCS frame-forwarding.
ces cell-loss-integration-period
To set the circuit emulation service (CES) cell-loss integration period, use the ces cell-loss-integration-period command in interface configuration mode.To delete the cell-loss integration period, use the no form of this command.
ces cell-loss-integration-period period
no ces cell-loss-integration-period period
Syntax Description
period
Time in milliseconds for the cell loss integration period. Possible values are from 1 to MAXINT.
Defaults
2500
Command Modes
Interface configuration
Command History
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 0ces cell-loss-integration-period 1056Related Commands
ces clockmode synchronous
To configure the ATM circuit emulation service (CES) synchronous clock mode, use the ces clockmode synchronous command in interface configuration mode. To restore the default value, use the no form of this command.
ces clockmode synchronous
no ces clockmode synchronous
Syntax Description
This command has no arguments or keywords.
Defaults
Enabled
Command Modes
Interface configuration
Command History
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 0ces clockmode synchronousRelated Commands
encapsulation atm-ces
Enables CES ATM encapsulation on the Cisco MC3810 multiservice concentrator.
ces connect
To map the circuit emulation service (CES) service to an ATM PVC on the Cisco MC3810, use the ces connect command in interface configuration mode. To delete the CES map to the ATM PVC, use the no form of this command.
ces connect atm-interface pvc [name | [vpi/]vci]
no ces connect atm-interface pvc [name | [vpi/]vci]
Syntax Description
Defaults
No ATM interface is defined.
Command Modes
Interface configuration
Command History
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 20Related Commands
ces initial-delay
To configure the size of the receive buffer of a circuit emulation service (CES) circuit, use the ces initial-delay command in interface configuration mode. To remove the initial-delay value, use the no form of this command.
ces initial-delay bytes
no ces initial-delay bytes
Syntax Description
Defaults
4000 bytes
Command Modes
Interface configuration
Command History
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 8000Related Commands
ces max-buf-size
To configure the transmit buffer of a circuit emulation service (CES) circuit, use the ces max-buf-size command in interface configuration mode. To delete the CES transmit buffer size, use the no form of this command.
ces max-buf-size size
no ces max-buf-size size
Syntax Description
Defaults
256
Command Modes
Interface configuration
Command History
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 1520Related Commands
ces partial-fill
To configure the number of user octets per cell for the ATM circuit emulation service (CES), use the ces partial-fill command in interface configuration mode. To delete the CES partial-fill value, use the no form of this command.
ces partial-fill octet
no ces partial-fill octet
Syntax Description
Defaults
47
Command Modes
Interface configuration
Command History
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 0ces partial-fill 20Related Commands
ces service
To configure the ATM circuit emulation service (CES) type, use the ces service command in interface configuration mode. To stop the ATM CES service type, use the no form of this command.
ces service structured
no ces service structured
Syntax Description
structured
Specifies that the ATM CES type is structured. Structured is the only option supported in this release.
Defaults
Structured
Command Modes
Interface configuration
Command History
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 0ces service structuredRelated Commands
clear cable flap-list
To reset the flap-list table for a specific cable modem or for all cable modems connected to the Cisco uBR7200 series, use the clear cable flap-list command in privileged EXEC mode.
clear cable flap-list [mac-addr | all]
Syntax Description
mac-addr
(Optional) MAC address. Specify the 48-bit hardware address of an individual cable modem.
all
(Optional) Remove all cable modems from the flap-list table.
Defaults
No default behavior or values.
Command Modes
Privileged EXEC
Command History
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 allRelated Commands
clear cable modem counters
To reset the cable modem flapping counters to zero, use the clear cable modem counters command in privileged EXEC mode.
clear cable modem {mac-addr | ip-addr | all} counters
Syntax Description
Defaults
No default behavior or values.
Command Modes
Privileged EXEC
Command History
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 countersRelated Commands
Removes a cable modem from the Station Maintenance List and resets the cable modem.
clear cable modem reset
To remove a cable modem from the Station Maintenance List and reset it, use the clear cable modem reset command in privileged EXEC mode.
clear cable modem {mac-addr | ip-addr | all} reset
Syntax Description
Defaults
No default behavior or values.
Command Modes
Privileged EXEC
Command History
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 resetRelated Commands
clear csm-statistics modem
To clear the CSM statistics for a modem or group of modems, use the clear csm-statistics modem command in privileged EXEC mode.
clear csm-statistics modem [slot/port | modem-group-number]
Syntax Description
slot/port
(Optional) Identifies the location (and thereby the identity) of a specific modem.
modem-group-number
(Optional) Designates a defined modem group.
Command Modes
Privileged EXEC
Command History
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 terminalclear csm-statistics modem 2Related Commands
clear csm-statistics voice
Clears the CSM statistics for a particular or all DSP channels.
clear csm-statistics voice
To clear the CSM statistics for a particular or all digital signal processor (DSP) channels, use the clear csm-statistics voice command in privileged EXEC mode.
clear csm-statistics voice [slot/dspm/dsp/dsp-channel]
Syntax Description
Command Modes
Privileged EXEC
Command History
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 terminalclear csm-statistics voiceRelated Commands
clear csm-statistics modem
Clears the CSM statistics for a modem or group of modems.
clear h323 gatekeeper call
To force a disconnect on a specific call or all calls active on a particular Multimedia Conference Manager (MCM) gateway, use the clear h323 gatekeeper call command in privileged EXEC mode.
clear h323 gatekeeper call {all | local-callID local-callID}
Syntax Description
Defaults
No default behavior or values.
Command Modes
Privileged EXEC
Command History
Usage Guidelines
If you want to force a particular call to be disconnected (as opposed to all active calls on the MCM gateway), use the CallID number to identify that specific call. You can find the local CallID number for a specific call by using the show gatekeeper calls command; the ID number is displayed in the LocalCallID column. Figure 1 shows output from the show gatekeeper calls command.
Figure 1 show gatekeeper calls Command Output
router# show gatekeeper callsTotal number of active calls =1Gatekeeper Call Info====================LocalCallID Age (secs) BW12-3339 94 768 (Kbps)Endpt(s): Alias E.164Addr CallSignalAddr Port RASSignalAddr Portsrc EP: epA 10.0.0.11 1720 10.0.0.11 1700dst EP: epB2zoneB.comsrc PX: pxA 10.0.0.1 1720 10.0.0.11 24999dst PX: pxB 172.21.139.90 1720 172.21.139.90 24999Examples
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.
enableclear h323 gatekeeper call local-callID 12-3339The following example forces all active calls on the MCM gateway to be disconnected:
enableclear h323 gatekeeper call allRelated Commands
show gatekeeper calls
Shows the status of each ongoing call that a gatekeeper is aware of.
clear voice port
To clear voice port calls in progress on the Cisco MC3810, use the clear voice port command in privileged EXEC mode.
clear voice port [slot/port]
Syntax Description
slot/port
(Optional) The voice port slot number and port number. If you do not specify a voice port, all calls on all voice ports are cleared.
Command Modes
Privileged EXEC
Command History
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/2clock rate line
To configure the line clock rate for serial ports 0 or 1 in DTE mode on the Cisco MC3810, use the clock rate line command in interface configuration mode. To cancel the clock rate line value, use the no form of this command.
clock rate line rate
no clock rate line rate
Syntax Description
Defaults
No clock rate is set.
Command Modes
Interface configuration
Command History
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 1clock rate line 2048Related Commands
clock rate network-clock
To configure the network clock speed for serial ports 0 or 1 in DCE mode on the Cisco MC3810, use the clock rate network-clock command in interface configuration mode. To cancel the network clock speed value, use the no form of this command.
clock rate network-clock rate
no clock rate network-clock rate
Syntax Description
Defaults
No clock rate is set.
Command Modes
Interface configuration
Command History
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 1clock rate network-clock 2048Related Commands
codec (Cisco 7200 series)
To specify call density and codec complexity based on a particular codec standard, use the codec command in DSP interface dsp farm mode. To reset the card type to the default, use the no form of the command.
codec {high | low | medium}
no codec {high | low | medium}
Syntax Description
high
Specifies high complexity: Two channels of any mix of codec.
low
Specifies low complexity: Eight channels of g711.
medium
Specifies medium complexity: Four channels of g711/g726/g729a/fax.
Defaults
Medium
Command Modes
DSP interface dsp farm
Command History
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-30Related Commands
command-type
Specifies the companding standard used to convert between analog and digital signals in PCM systems.
codec (dial-peer)
To specify the voice coder rate of speech for a dial peer, use the codec command in dial-peer configuration mode. To reset the default value, use the no form of this command.
Cisco 2600 and 3600 series routers, Cisco AS5300 access servers, and AS5800 access servers
codec {g711alaw | g711ulaw | g723ar53 | g723ar63 | g723r53 | g723r63 | g726r16 | g726r24 |
g726r32 | g728 | g729br8 | g729r8} [bytes | bytes payload_size] [pre-ietf]no codec {g711alaw | g711ulaw | g723ar53 | g723ar63 | g723r53 | g723r63 | g726r16 | g726r24 |
g726r32 | g728 | g729br8 | g729r8} [bytes | bytes payload_size] [pre-ietf]Cisco MC3810
codec {g711alaw | g711ulaw | g726r32 | g729ar8 | g729r8} [bytes | bytes payload_size]
no codec {g711alaw | g711ulaw | g726r32 | g729ar8 | g729r8} [bytes | bytes payload_size]
Syntax Description
Cisco 2600 and 3600 series routers, Cisco AS5300 access servers, and AS5800 access servers
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
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 vofrcodec g711alaw bytes 120The 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 voipcodec g711alawRelated Commands
codec (voice-port)
To configure voice compression on the Cisco MC3810 voice port, use the codec command in voice-port configuration mode. To restore the default value, use the no form of this command.
codec {g729r8 | g729ar8 | g726r32 | g711alaw | g711ulaw}
no codec {g729r8 | g729ar8 | g726r32 | g711alaw | g711ulaw}
Syntax Description
Defaults
The default is g729ar8 compression mode.
Command Modes
Voice-port configuration
Command History
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
Examples
The following example configures voice port 1/1 on the Cisco MC3810 to support g729r8 compression:
voice-port 1/1codec g729r8Related Commands
Specifies the companding standard used to convert between analog and digital signals in PCM systems on the Cisco MC3810 multiservice concentrator.
codec complexity
To specify call density and codec complexity based on the codec standard you are using, use the codec complexity command in voice-card configuration mode. To reset the voice card to the default, use the no form of the command.
codec complexity {high | medium}
no codec complexity {high | medium}
Syntax Description
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.
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 1codec complexity highRelated 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.
codec preference
To specify a list of preferred codecs to use on a dial peer, use the codec preference command in class configuration mode. To restore the default, use the no form of this command.
codec preference value codec_type bytes size
no codec preference value codec_type bytes size
Syntax Description
Defaults
No default behavior or values.
Command Modes
Class configuration
Command History
Examples
The following example illustrates a list of 12 codecs in order of preference:
voice class codec 99codec preference 1 g711alawcodec preference 2 g711ulaw bytes 80codec preference 3 g723ar53codec preference 4 g723ar63 bytes 144codec preference 5 g723r53codec preference 6 g723r63 bytes 120codec preference 7 g726r16codec preference 8 g726r24codec preference 9 g726r32 bytes 80codec preference 10 g728codec preference 11 g729br8codec preference 12 g729r8 bytes 50Related Commands
comfort-noise
To generate background noise to fill silent gaps during calls if voice activity detection (VAD) is activated, use the comfort-noise command in voice-port configuration mode. To provide silence when the remote party is not speaking and VAD is enabled at the remote end of the connection, use the no form of this command.
comfort-noise
no comfort-noise
Syntax Description
This command has no arguments or keywords.
Defaults
Enabled
Command Modes
Voice-port configuration
Command History
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
Examples
The following example enables background noise on the Cisco 3600 series:
voice-port 1/0/0comfort-noiseRelated Commands
compand-type
To specify the companding standard used to convert between analog and digital signals in PCM systems on the Cisco MC3810, use the compand-type command in voice-port configuration mode. To disable the compand type, use the no form of this command.
compand-type {u-law | a-law}
no compand-type {u-law | a-law}
Syntax Description
u-law
Specifies the North American u-Law ITU-T PCM encoding standard.
a-law
Specifies the European a-Law ITU-T PCM encoding standard.
Defaults
u-Law (T1 digital)
a-Law (E1 digital)
Command Modes
Voice-port configuration
Command History
Usage Guidelines
This command applies only to the Cisco MC3810.
Note
Examples
The following example configures a-law encoding on voice port 1/1 on the Cisco MC3810:
voice-port 1/1compand-type a-lawRelated Commands
codec (voice-port configuration)
Configures voice compression on the Cisco MC3810 voice port.
condition
To manipulate the signalling format bit pattern for all voice signalling types on the Cisco MC3810, use the condition command in voice-port configuration mode. Use the no form of this command to turn off conditioning on the voice-port.
condition {tx-a-bit | tx-b-bit | tx-c-bit | tx-d-bit} {rx-a-bit | rx-b-bit | rx-c-bit | rx-d-bit}
{on | off | invert}no condition {tx-a-bit | tx-b-bit | tx-c-bit | tx-d-bit} {rx-a-bit | rx-b-bit | rx-c-bit | rx-d-bit}
{on | off | invert}Syntax Description
Defaults
No condition (for all send or receive A, B, C, and D bits)
Command Modes
Voice-port configuration
Command History
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/1condition tx-a-bit invertcondition rx-a-bit invertRelated Commands
connect
To define connections between T1 or E1 controller ports for drop-and-insert (also called TDM cross-connect), use the connect command in global configuration mode. Use the no form of this command to restore default values.
connect id {t1 | e1} slot/port-1 tdm-group-no-1 {t1 | e1} slot/port-2 tdm-group-no-2
no connect id {t1 | e1} slot/port-1 tdm-group-no-1 {t1 | e1} slot/port-2 tdm-group-no-2
Syntax Description
Defaults
There is no drop-and-insert connection between the ports.
Command Modes
Global configuration
Command History
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/0Router(config-controller)tdm-group 2 timeslots 13-24 type e&mRouter(config-controller)# controller T1 1/1Router(config-controller)tdm-group 3 timeslots 13-24 type e&mRouter(config-controller)exitRouter(config)connect tdm1 T1 1/0 2 T1 1/1 3Related Commands
connect (global)
This command, created for the Cisco MC3810-IGX Interworking feature in Cisco IOS Release 12.0(2)T, is not supported in this release.
connect voice
This command, created for the Cisco MC3810-IGX Interworking feature in Cisco IOS Release 12.0(2)T, is not supported in this release.
connection
To specify a connection mode for a voice port, use the connection command in voice-port configuration mode. Use the no form of this command to disable the selected connection mode.
connection {plar | tie-line | plar-opx} string | {trunk | string [answer-mode]}
no connection {plar | tie-line | plar-opx} string | {trunk | string [answer-mode]}
Syntax Description
Defaults
No connection mode is specified.
Command Modes
Voice-port configuration
Command History
Usage Guidelines
Use the connection command to specify a connection mode for a specific interface. For example, use the connection plar command to specify a PLAR interface. The string you configure for this command is used as the called number for all calls coming in over this connection. The destination peer is determined by called number.
Use the connection trunk command to specify a straight tie-line connection (in other words, a virtual trunk connection) to a PBX. Voice over IP simulates a trunk connection by creating virtual trunk tie lines between PBXs connected to Cisco devices on each side of a VoIP connection. (See Figure 2.) In this example, two PBXs are connected using a virtual trunk. PBX-A is connected to Router A via an E&M voice port; PBX-B is connected to Router B via an E&M voice port. The Cisco routers spoof the connected PBXs into believing that a permanent trunk tie line exists between them.
Figure 2 Virtual Trunk Connection
To configure virtual trunk connections in Voice over IP, the following restrictions apply:
•
–
–
–
•
•
•
Note
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
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/0connection plar 5559262The following example selects tie-line as the connection mode on the Cisco MC3810, with a destination telephone number of 555-9262:
voice-port 1/1connection tie-line 5559262The 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 terminalvoice-port 1/0/0connection trunk +15105554000dial-peer voice 10 potsdestination-pattern +13085551001port 1/0/0dial-peer voice 100 voipsession-target ipv4:172.20.10.10destination-pattern +15105554000Router B
configure terminalvoice-port 1/0/0connection trunk +13085551000dial-peer voice 20 potsdestination-pattern +15105554001port 1/0/0dial-peer voice 200 voipsession-target ipv4:172.19.10.10destination-pattern +13085551000Related Commands
connection-timeout
To configure the time that a connection is maintained after completing a communication exchange, use the connection-timeout command in settlement configuration mode. Use the no form of this command to reset to the default value of this command.
connection-timeout num
no connection-timeout num
Syntax Description
num
Time (in seconds) that a connection is maintained after the communication exchange is completed. Values can range from zero (0) to 86400 seconds, zero (0) means forever.
Defaults
The default connection timeout is 3600 seconds (1 hour).
Command Modes
Settlement configuration
Command History
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 3600Related Commands
copy flash vfc
To copy a new version of VCWare from the Cisco AS5300 motherboard to VFC Flash memory, use the copy flash vfc command in privileged EXEC mode.
copy flash vfc slot-number
Syntax Description
slot-number
Indicates the slot on the Cisco AS5300 where the VFC is installed. Valid entries are from 0 to 2.
Defaults
No default behavior or values.
Command Modes
Privileged EXEC
Command History
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 0Related 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.
copy tftp vfc
To copy a new version of VCWare from a TFTP server to VFC Flash memory, use the copy tftp vfc command in privileged EXEC mode.
copy tftp vfc slot-number
Syntax Description
slot-number
Indicates the slot on the Cisco AS5300 where the VFC is installed. Valid entries are from 0 to 2.
Defaults
No default behavior or values.
Command Modes
Privileged EXEC
Command History
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 0Related Commands
cptone
To specify a regional analog voice interface-related tone, ring, and cadence setting, use the cptone command in voice-port configuration mode. Use the no form of this command to disable the selected tone.
cptone locale
no cptone locale
ISDN PRI
cptone {australia | brazil | china | finland | france | germany | japan | northamerica | sweden | unitedkingdom}
no cptone
E1 R2 signalling
cptone {australia | brazil | china | finland | france | germany | japan | northamerica | sweden | unitedkingdom}
no cptone
Syntax Description
locale
Keyword specifying an analog voice interface-related default tone, ring, and cadence setting for a specified country.
Valid entries for the Cisco MC3810 prior to release 12.0(4)T are: argentina, australia, austria, belgium, brazil, canada, china, colombia, czechrepublic, denmark, finland, france, germany, greatbritain, greece, hongkong, hungary, iceland, india, indonesia, ireland, israel, italy, japan, korea, luxembourg, malaysia, mexico, netherlands, newzealand, norway, peru, philippines, poland, portugal, russia, singapore, slovakia, slovenia, southafrica, spain, sweden, switzerland, taiwan, thailand, turkey, unitedstates, and venezuela.
The Cisco 2600 series, 3600 series and the Cisco MC3810 comply with the ISO 3166 country name standards, which use a two-letter code to represent a country. Valid entries are listed in Table 11.
Table 11 lists valid entries for the locale argument.
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
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/0cptone usThe following example configures Singapore as the call progress tone locale on the Cisco MC3810, beginning from global configuration mode:
voice-port 1/1cptone sgThe following example configures Japan as the call progress tone locale:
voice-port 0:Dcptone japanThe following example configures Brazil as the call progress tone locale on the Cisco AS5300:
voice-port 1:0cptone BRdescription Brasil ToneRelated Commands
cross-connect
To cross-connect two groups of digital signal level 0s (DS0s) from two controllers on the Cisco MC3810, or to cross-connect the Universal I/O (UIO) serial port for pass-through traffic to a trunk controller, use the cross-connect command in global configuration command. Use the no form of this command to remove the cross-connect function for the given controller.
Pass-through between two controllers:
cross-connect id controller-1 tdm-group-no-1 controller-2 tdm-group-no-2
no cross-connect id controller-1 tdm-group-no-1 controller-2 tdm-group-no-2
Pass-through traffic from a UIO serial port to a trunk controller:
cross-connect id interface-serial controller tdm-group-no
no cross-connect id interface-serial controller tdm-group-no
Note
Syntax Description
For pass-through between two controllers:
For pass-through traffic from a UIO serial port to a trunk controller:
Defaults
No default behavior or values.
Command Modes
Global configuration
Command History
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 20Related Commands
supervisory disconnect
Configures a list of timeslots for creating clear channel groups (pass-through) for TDM cross-connect.
customer-id
To identify a carrier or internet service provider with a settlement provider, use the customer-id command in settlement configuration mode. Use the no form of this command to reset to the default value of this command.
customer-id num
no customer-id num
Syntax Description
Defaults
The default customer ID is 0.
Command Modes
Settlement configuration
Command History
Examples
The following example identifies a carrier or service provider with the ID number of 1000:
settlement 0customer id 1000Related Commands
default-file vfc
To specify an additional (or different) file from the ones in the default file list and stored in VFC Flash memory, use the default-file vfc command in global configuration mode. To delete the file from the default file list, use the no form of this command.
default-file filename vfc slot
no default-file filename vfc slot
Syntax Description
Defaults
No default behavior or values.
Command Modes
Global configuration
Command History
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 termdefault-file bas-vfc-1.0.14.0.bin vfc 0Related Commands
cap-list vfc
Adds a voice codec overlay file to the capability file list.
delete vfc
Deletes a file from VFC Flash memory.
define
To define the transmit and receive bits for E&M and E&M MEL CAS voice signalling on the Cisco MC3810, use the define command in voice-port configuration mode. Use the no form of this command to restore the default value.
define {Tx-bits | Rx-bits} {seize | idle} {0000 | 0001 | 0010 | 0011 | 0100 | 0101 | 0110 | 0111 | 1000 | 1001 | 1010 | 1011 | 1100 | 1101 | 1110 | 1111}
no define {Tx-bits | Rx-bits} {seize | idle} {0000 | 0001 | 0010 | 0011 | 0100 | 0101 | 0110 | 0111 | 1000 | 1001 | 1010 | 1011 | 1100 | 1101 | 1110 | 1111}
Syntax Description
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 1111For E&M MEL CAS:
Tx-bits idle 1101
Tx-bits seize 0101
Rx-bits idle 1101
Rx-bits seize 0101Command Modes
Voice-port configuration
Command History
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/1define rx-bits idle 1101define rx-bits idle 0101define tx-bits seize 1101define tx-bits seize 0101Related Commands
delete vfc
To delete a file from VFC Flash memory, use the delete vfc command in privileged EXEC mode.
delete filename vfc slot
Syntax Description
filename
Specifies the file in VFC Flash memory to be deleted.
slot
Specifies the slot on the Cisco AS5300 where the specified VFC resides. Valid entries are from 0 to 2.
Command Modes
Privileged EXEC
Command History
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
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 0Related Commands
description
To include a description of what this voice port is connected to, use the description command in voice-port configuration mode. Use the no form of this command to disable this feature.
description string
no description string
Syntax Description
Defaults
Enabled with a null string.
Command Modes
Voice-port configuration
Command History
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/0description purchasing_deptThe following example identifies voice port 1/1 on the Cisco MC3810 as being connected to the Marketing department:
voice-port 1/1description marketing_deptdescription (DSP)
To include a specific description about the digital signal processor (DSP) interface, use the description command in DSPfarm interface configuration mode. Use the no form of this command to disable this feature.
description string
no description string
Syntax Description
Defaults
Enabled with a null string.
Command Modes
DSPfarm interface configuration
Command History
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/0description marketing_deptdestination-pattern
To specify either the prefix or the full E.164 telephone number (depending on your dial plan) to be used for a dial peer, use the destination-pattern command in dial-peer configuration mode. Use the no form of this command to disable the configured prefix or telephone number.
destination-pattern [+]string[T]
no destination-pattern [+]string[T]
Syntax Description
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.
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
Examples
The following example configures the E.164 telephone number, 555-7922, for a dial peer:
dial-peer voice 10 potsdestination-pattern +5557922Related Commands
destination-pattern (ISDN)
To specify the ISDN directory number for the telephone interface, use the destination-pattern command in interface configuration mode. Use the no form of this command to disable the specified ISDN directory number.
destination-pattern isdn
no destination-pattern
Syntax Description
Defaults
A default ISDN directory number is not defined for this interface.
Command Modes
Interface configuration
Command History
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 5551111Related Commands
device-id
To specify a gateway associated with a settlement provider, use the device-id command in settlement configuration mode. Use the no form of this command to reset to the default value of this command.
device-id num
no device-id num
Syntax Description
Defaults
The default device ID is 0.
Command Modes
Settlement configuration
Command History
Examples
The following example specifies gateway with device ID# 1000 associated with the settlement provider:
settlement 0device-id 1000Related Commands
dial-control-mib
To specify attributes for the call history table, use the dial-control-mib command in global configuration mode.
dial-control-mib {max-size number | retain-timer number}
Syntax Description
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.
Examples
The following example configures the call history table to hold 400 entries, with each entry remaining in the table for 10 minutes:
configure terminaldial-control-mib max-size 400dial-control-mib retain-timer 10dial-peer terminator
To designate a special character to be used as a terminator for variable length dialed numbers, use the dial-peer terminator command in global configuration mode. Use the no form of this command to disable the designated terminating character.
dial-peer terminator character
no dial-peer terminator character
Syntax Description
character
Designates the terminating character for a variable-length dialed number. Valid numbers and characters are #, *, 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, a, b, c, and d.
Defaults
No default behavior or values.
Command Modes
Global configuration
Command History
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 terminaldial-peer terminator #Related Commands
dial-peer video
To define a video ATM dial peer for a local or remote video codec, specify video-related encapsulation, and enter dial-peer configuration mode, enter the dial-peer video command in global configuration mode. The video dial peer is persistent and remains until you use the no form of the command to remove it.
dial-peer video tag {videocodec | videoatm}
no dial-peer video tag {videocodec | videoatm}
Syntax Description
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.
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 videocodecRelated Commands
dial-peer voice
To enter dial-peer configuration mode (and specify the method of voice-related encapsulation), use the dial-peer voice command in global configuration mode. Use the no form of this command to disable a defined dial peer.
dial-peer voice number {pots | vofr | voip}
no dial-peer voice number {pots | vofr | voip}
Cisco AS5300 access servers
dial-peer voice number {pots | vofr |voip | mmoip}
no dial-peer voice number {pots | vofr |voip | mmoip}
Cisco 7200 series routers
dial-peer voice number {vofr}
no dial-peer voice number {vofr}
Cisco MC3810
dial-peer voice number {pots | voatm | vofr | vohdlc}
no dial-peer voice number {pots | voatm | vofr | vohdlc}
Syntax Description
Defaults
No default behavior or values.
Command Modes
Global configuration
Command History
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 terminaldial-peer voice 100 potsThe 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 terminaldial-peer voice 10 potsdial-peer voice 20 mmoipThe following example disables the MMoIP peer identified as dial peer 20:
configure terminalno dial-peer voice 20Related Commands
dial-type
To specify the type of out-dialing for voice port interfaces, use the dial-type command in voice-port configuration mode. Use the no form of this command to disable the selected type of dialing.
dial-type {dtmf | pulse}
no dial-type {dtmf | pulse}
Syntax Description
Defaults
dtmf
Command Modes
Voice-port configuration
Command History
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/0dial-type dtmfThe following example configures a voice port on the Cisco MC3810 to support a rotary (pulse tone) dialer:
voice-port 1/1dial-type pulsedirect-inward-dial
To enable the direct inward dial (DID) call treatment for the incoming called number, use the direct-inward-dial command in dial-peer configuration mode. Use the no form of this command to disable DID.
direct-inward-dial
no direct-inward-dial
Syntax Description
This command has no arguments or keywords.
Defaults
Disabled
Command Modes
Dial-peer configuration
Command History
11.3(1)NA
This command was introduced.
12.0(4)T
This command was modified for Store and Forward Fax.
Usage Guidelines
Use the direct-inward-dial command to enable the DID call treatment for the incoming called numbers. When this feature is enabled, the incoming call is treated as if the digits are received from the DID trunk. The called number is used to select the outgoing dial peer. No dial tone will be presented to the caller.
Use the no form of this command to disable DID. When disabled, the called number is used to select the outgoing dial peer. The caller will be prompted for a called number via dial tone.
This command is only applicable to POTS dial peers. This command applies to on-ramp Store and Forward Fax functions.
Examples
The following example enables DID call treatment for incoming called numbers:
dial peer voice 10 potsdirect-inward-dialdsn
To specify that a delivery status notice be delivered to the sender, use the dsn command in dial-peer configuration mode. Use the no form of this command to cancel a specific delay status notice option.
dsn {delay | failure | success}
no dsn {delay | failure | success}
Syntax Description
Note
Defaults
The default is success and failure.
Command Modes
Dial-peer configuration
Command History
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
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,DELAYThere 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
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 mmoipdsn successdsn failureThe 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 mmoipdsn successdsn delayedRelated Commands
mta send mail-from
Specifies the mail-from address (also called the RFC 821 envelope-from or the Return-Path address).
ds0-group
To define T1/E1 channels for compressed voice calls and the channel-associated signalling (CAS) method by which the router connects to the PBX or PSTN, use the ds0-group command in controller configuration mode. The no form of the command removes the group and signalling setting.
ds0-group ds0-group-no timeslots timeslot-list type {e&m-immediate | e&m-delay | e&m-wink | fxs-ground-start | fxs-loop-start | fxo-ground-start | fxo-loop-start}
no ds0-group ds0-group-no timeslots timeslot-list type {e&m-immediate | e&m-delay | e&m-wink | fxs-ground-start | fxs-loop-start | fxo-ground-start | fxo-loop-start}
Syntax Description
Defaults
No DS0 group is defined.
Command Modes
Controller configuration
Command History
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.
Note
Examples
The following example configures ranges of T1 controller time slots for FXS ground-start and FXO loop-start signalling:
controller T1 1/0cablelength long 0dbds0-group 1 timeslots 4-5 type e&m-immediate-startRelated 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.
dspfarm
To enable the digital signal processor (DSP) interface, use the dspfarm command in global configuration mode.
dspfarm slot/port
Syntax Description
Defaults
No default behavior or values.
Command Modes
Global configuration
Command History
Examples
The following example creates a DSPfarm interface with a slot number of 1 and a port number of 0:
dspint dspfarm 1/0dtmf-relay
To specify how an H.323 gateway relays dual tone multifrequency (DTMF) tones between telephony interfaces and an IP network, use the dtmf-relay command in dial-peer configuration mode. Use the no form of this command to remove all signalling options and send the DTMF tones as part of the audio stream.
dtmf-relay [cisco-rtp] [h245-alphanumeric] [h245-signal]
no dtmf-relay [cisco-rtp] [h245-alphanumeric] [h245-signal]
Syntax Description
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.
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.
2.
3.
4.
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
Examples
The following example configures DTMF relay with the cisco-rtp option when sending DTMF tones to dial-peer 103:
configure terminaldial-peer voice 103 voipdtmf-relay cisco-rtpendThe next example configures the dtmf-relay command for cisco-rtp or h245-signal when sending to dial-peer 103:
configure terminaldial-peer voice 103 voipdtmf-relay cisco-rtp h245-signalendThe next example configures the gateway to send DTMF in-band (the default) when sending DTMF tones to dial-peer 103:
configure terminaldial-peer voice 103 voipno dtmf-relayendRelated Commands
dtmf-relay (Voice over Frame Relay)
To enable the generation of FRF.11 Annex A frames for a dial peer, use the dtmf-relay command in dial-peer configuration mode. Use the no form of this command to disable the generation of FRF.11 Annex A frames and return to the default handling of dial digits.
dtmf-relay
no dtmf-relay
Syntax Description
This command has no arguments or keywords.
Defaults
Disabled
Command Modes
Dial-peer configuration
Command History
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 vofrdtmf-relayRelated Commands
