|
|
This section documents EXEC commands that are unique to Cisco MC3810 series concentrators. All other supported EXEC commands are documented in the Cisco IOS Release 12.0 command references.
The following commands are associated with the EXEC mode:
To clear voice port calls in progress on the Cisco MC3810, use the clear voice port privileged EXEC command.
clear voice port [slot/port]
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. |
Privileged EXEC
| Release | Modification |
|---|---|
11.3 MA | This command was first introduced. |
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.
The following example clears all calls on voice port 1/2 on the Cisco MC3810:
clear voice port 1/2
| Command | Description |
Displays configuration information about a specific voice port. |
To display Call Detail Record (CDR) events in the call history table, use the show call history voice records privileged EXEC command.
show call history voice recordPrivileged EXEC.
| Release | Modification |
|---|---|
12.0(2) T | This command was first introduced. |
The show call history voice record command shows only the call detail record (CDR) events currently stored in the call history table buffer. The complete CDR history is stored in the Cisco Network Management System (NMS) database.
The following example displays a sample of voice call history records showing a local call between two telephones attached to the same Cisco MC3810:
show call history voice record ConnectionId=[0x2C7AEFDC 0x59830001 0x0 0xB0AAA3] Media=TELE, TxDuration= 1418 ms CallingNumber=2001 SetupTime=1157801 x 10ms ConnectTime=1158046 x 10ms DisconectTime=1158188 x 10ms DisconnectText=local onhook ConnectionId=[0x2C7AEFDC 0x59830001 0x0 0xB0AAA3] Media=TELE, TxDuration= 1422 ms CalledNumber=2002 SetupTime=1157802 x 10ms ConnectTime=1158046 x 10ms DisconectTime=1158188 x 10ms DisconnectText=remote onhook
Table 2-1 explains the fields in the sample output.
| Field | Description |
|---|---|
ConnectionID | Global call identifier for this voice call |
Media | Call over the type of media. If the call is over the (telephone) access side, the entry will be TELE. If the call is over the voice network side, the entry will be either ATM, FR (for Frame Relay), or HDLC. |
LowerIFName | Physical Lower interface information. Only displays if the Media is either ATM, FR, or HDLC. |
TxDuration | The length of the call. Only displays if the Media is TELE. |
CalledNumber | The called number. |
CallingNumber | The calling number. |
SetupTime | Time the call setup started. |
ConnectTime | Time the call is connected. |
DisconnectTime | Time the call is disconnected. |
DisconnectText | Descriptive text explaining the reason for disconnect. |
| Command | Description |
dial-control-mib | Specifies attributes for the call history table. |
number | (Optional) A specific dial peer. This option displays configuration information for a single dial peer identified by the argument number. Valid entries are any integers that identify a specific dial peer, from 1 to 32767. |
summary | (Optional) Displays a summary of all voice dial peers. |
Privileged EXEC
| Release | Modification |
|---|---|
11.3(1) T | This command was first introduced. |
Use the show dial-peer voice privileged EXEC command to display the configuration for all VoIP and POTS dial peers configured for the router. To show configuration information for only one specific dial peer, use the argument number to identify the dial peer.
The following is sample output from the show dial-peer voice command for a POTS dial peer on the Cisco 3600:
router# show dial-peer voice 1
VoiceEncapPeer1
tag = 1, dest-pat = \Q+14085291000',
answer-address = \Q',
group = 0, Admin state is up, Operation state is down
Permission is Both,
type = pots, prefix = \Q',
session-target = \Q', voice port =
Connect Time = 0, Charged Units = 0
Successful Calls = 0, Failed Calls = 0
Accepted Calls = 0, Refused Calls = 0
Last Disconnect Cause is ""
Last Disconnect Text is ""
Last Setup Time = 0
The following is sample output from the show dial-peer voice command for a VoFR dial peer on the Cisco MC3810:
router#show dial-peer voice 21VoiceOverFRPeer21tag = 21, destination-pattern = \Q10', preference = 0,Admin state is up, Operation state is up *********************type = vofr, session-target = \QSerial1 150'
The following is sample output from the show dial-peer voice command for a VoHDLC dial peer on the Cisco MC3810:
router#show dial-peer voice 10VoiceOverHDLCPeer10tag = 10, destination-pattern = \Q7', preference = 0,Admin state is up, Operation state is up *********************type = vohdlc, session-target = \QSerial0'
Table 2-2 explains the fields contained in these examples.
| Field | Description |
|---|---|
Accepted Calls | Number of calls from this peer accepted since system startup. |
acc-qos | Lowest acceptable quality of service configured for calls for this peer. |
Admin state | Administrative state of this peer. |
Charged Units | Total number of charging units applying to this peer since system startup. |
codec | Default voice coder rate of speech for this peer. |
Connect Time | Accumulated connect time to the peer since system startup for both incoming and outgoing calls. |
dest-pat | Destination pattern (telephone number) for this peer. |
Expect factor | User-requested Expectation Factor of voice quality for calls via this peer. |
fax-rate | Fax transmission rate configured for this peer. |
Failed Calls | Number of failed call attempts to this peer since system startup. |
group | Group number associated with this peer. |
ICPIF | Configured Calculated Planning Impairment Factor (ICPIF) value for calls sent by a dial peer. |
incall-number | Full E.164 telephone number to be used to identify the dial peer. |
Last Disconnect Cause | Encoded network cause associated with the last call. This value will be updated whenever a call is started or cleared and depends on the interface type and session protocol being used on this interface. |
Last Disconnect Text | ASCII text describing the reason for the last call termination. |
Last Setup Time | Value of the System Up Time when the last call to this peer was started. |
Operation state | Operational state of this peer. |
Permission | Configured permission level for this peer. |
Poor QOV Trap | Whether Poor Quality of Voice trap messages have been enabled or disabled. |
Refused Calls | Number of calls from this peer refused since system startup. |
req-qos | Configured requested quality of service for calls for this dial peer. |
session-target | Session target of this peer. |
sess-proto | Session protocol to be used for Internet calls between local and remote router via the IP backbone. |
Successful Calls | Number of completed calls to this peer. |
tag | Unique dial peer ID number. |
VAD | Whether or not voice activation detection (VAD) is enabled for this dial peer. |
| Command | Description |
Specifies attributes for the call history table. | |
Displays Call Detail Record (CDR) events in the call history table. | |
show num-exp | Display all of the number expansions configured for this router. |
Displays configuration information about a specific voice port. |
dial string | Particular destination pattern (telephone number). |
Privileged EXEC
| Release | Modification |
|---|---|
11.3(1) T | This command was first introduced. |
The show dialplan number command is used to test if the dial-plan configuration is valid and working as expected.
The following example displays the dial peer associated with the destination pattern of 54567:
router# show dialplan number 51234
Macro Exp.: 14085551234
VoiceOverIpPeer1004
tag = 1004, destination-pattern = \Q+1408555....',
answer-address = \Q',
group = 1004, Admin state is up, Operation state is up
type = voip, session-target = \Qipv4:1.13.24.0',
ip precedence: 0 UDP checksum = disabled
session-protocol = cisco, req-qos = best-effort,
acc-qos = best-effort,
fax-rate = voice, codec = g729r8,
Expect factor = 10, Icpif = 30,
VAD = enabled, Poor QOV Trap = disabled
Connect Time = 0, Charged Units = 0
Successful Calls = 0, Failed Calls = 0
Accepted Calls = 0, Refused Calls = 0
Last Disconnect Cause is ""
Last Disconnect Text is ""
Last Setup Time = 0
Matched: +14085551234 Digits: 7
Target: ipv4:172.13.24.0
Table 2-3 explains the fields contained in this example.
| Field | Description |
|---|---|
Macro Exp. | Expected destination pattern for this dial peer. |
VoiceOverIpPeer | Identifies the dial peer associated with the destination pattern entered. |
tag | Unique dial peer identifying number |
destination-pattern | Destination pattern (telephone number) configured for this dial peer |
answer-address | Answer address configured for this dial peer. |
Admin state | Describes the administrative state of this dial peer. |
Operation state | Describes the operational state of the dial peer. |
type | Type of dial peer (POTS or VoIP). |
session-target | Displays the configures session target (IP address or host name) for this dial peer. |
ip precedence | Displays the numeric value for the IP Precedence configured for this dial peer. |
UDP checksum | Indicates the status of the UDP checksum feature. |
session-protocol | Session protocol to be used for Internet calls between local and remote router via the IP backbone. |
req-qos | Configured requested quality of service for calls for this dial peer. |
acc-qos | Configures acceptable quality of service for calls for this dial peer. |
fax-rate | Configured facsimile transmission speed for with this dial peer. |
codec | CODEC type configured for this dial peer. |
Expect factor | Configured value at which the system will generate an SMTP message alerting that the voice quality has dropped. |
Icpif | Configured Calculated Planning Impairment Factor (ICPIF) value for calls sent by a dial peer. |
VAD | Whether or not voice activation detection (VAD) is enabled for this dial peer. |
Poor QOV Trap | Whether Poor Quality of Voice trap messages have been enabled or disabled. |
Connect Time | Unit of measure indicating the call connection time associated with this dial peer. |
Charged Units | Number of call units charged to this dial peer. |
Successful Calls | Number of completed calls to this peer since system startup. |
Failed Calls | Number of uncompleted (failed) calls to this peer since system startup. |
Accepted Calls | Number of calls from this peer accepted since system startup. |
Refused Calls | Number of calls from this peer refused since system startup. |
Last Disconnect Cause | Encoded network cause associated with the last call. This value will be updated whenever a call is started or cleared and depends on the interface type and session protocol being used on this interface. |
Last Disconnect Text | ASCII text describing the reason for the last call termination. |
Last Setup Time | Value of the System Up Time when the last call to this peer was started. |
Matched | Destination pattern matched for this dial peer. |
Target | Matched session target (IP address or host name) for this dial peer. |
| Command | Description |
show dialplan incall number | Pairs different voice ports and telephone numbers together for troubleshooting. |
This command has no arguments or keywords.
Privileged EXEC
| Release | Modification |
|---|---|
11.3 MA | This command was first introduced. |
This command applies to Voice over Frame Relay, Voice over ATM, and Voice over HDLC on the Cisco MC3810.
The Cisco MC3810 has a background task that verifies every 120 seconds whether a valid clocking configuration exists. If this task detects an error, you will be reminded every 120 seconds until the error is corrected. A clocking configuration error may be generated for various reasons. Using the show network-clocks command, you can display the clocking configuration status.
The following is sample output from the show network-clocks command on the Cisco MC3810:
router# show network-clocks Priority 1 clock source(inactive config) : T1 0 Priority 1 clock source(active config) : T1 0 Clock switch delay: 10 Clock restore delay: 10 T1 0 is clocking system bus for 9319 seconds. Run Priority Queue: controller0
In this display, inactive configuration is the new configuration that has been established. Active configuration is the run-time configuration. Should an error be made in the new configuration, the inactive and active configurations will be different. In the above example, the clock priority configuration is valid, and the system is being clocked as indicated.
The following is another sample output from the show network-clocks command:
router# show network-clocks Priority 1 clock source(inactive config) : T1 0 Priority 2 clock source(inactive config) : T1 1 Priority 1 clock source(active config) : T1 0 Clock switch delay: 10 Clock restore delay: 10 T1 0 is clocking system bus for 9319 seconds. Run Priority Queue: controller0
In this display, the new clocking configuration has an error for controller T1 1. This is indicated by checking differences between the last valid configuration (active) and the new proposed configuration (inactive). The error may result from hardware (the system controller board or MFT) unable to support this mode, or controller T1 1 is currently configured as "clock source internal."
Since the active and inactive configurations are different, the system will periodically display the warning message about the faulty configuration.
| Command | Description |
network-clock-select | Sets the selection priority for one or more clock sources for the Cisco .MC3810. |
To display information about the voice busyout state, use the show voice busyout privileged EXEC command.
show voice busyoutThis command has no arguments or keywords.
Privileged EXEC
| Release | Modification |
|---|---|
12.0(3) T | This command was first introduced. |
This command is only supported on the Cisco MC3810.
The following example displays the busyout information:
show voice busyout If following network interfaces are down, voice port will be put into busyout state ATM0 Serial0 The following voice ports are in busyout state 1/1 is forced into busyout state 1/2 is in busyout state caused by network interfaces 1/3 is in busyout state caused by ATM0 1/4 is in busyout state caused by network interfaces 1/5 is in busyout state caused by Serial0
| Command | Description |
busyout forced | Forces a voice port into busyout state. |
busyout-monitor | Places a voice port into busyout monitor state. |
busyout-seize | Specifies the busyout seize procedure for a voice port. |
voice-port busyout | Places all voice ports associated with a serial or ATM interface into a busyout state |
summary | (Optional) Show a summary of the call status instead of the full detailed report. |
Privileged EXEC
| Release | Modification |
|---|---|
11.3 MA | This command was first introduced. |
This command applies to Voice over Frame Relay, Voice over ATM, and Voice over HDLC on the Cisco MC3810.
This command provides the status at these levels of the call handling module:
The following is a sample display from the show voice call summary command for analog voice ports on the Cisco MC3810:
router# show voice call summary 1/1 (orig): eecm = ST_DIGIT_COLLECT, LFXS= call_progress, CPD= failure_cont 1/2 ( ): eecm = IDLE, LFXS= idle, CPD= idle 1/3 ( ): eecm = IDLE, LFXS= idle, CPD= idle 1/4 ( ): eecm = IDLE, LFXO= idle, CPD= idle 1/5 ( ): eecm = IDLE, LEM= idle, CPD= idle 1/6 ( ): eecm = IDLE, LEM= idle, CPD= idle
Table 2-4 explains the fields in the sample output.
| Field | Description |
|---|---|
(orig) | Indicates the call is originating on the voice port. |
eecm | Status of the End-to-End Call Manager. |
LFXS | Status of the FXS line. |
CPD | Status of the Call Processing Data. |
LFXO | Status of the FXO line. |
LEM | Status of the E&M line. |
| Command | Description |
Displays the configuration for all VoIP and POTS dial peers configured on the router. | |
Shows the current status of all DSP voice channels. | |
Displays configuration information about a specific voice port. |
This command has no arguments or keywords.
Privileged EXEC
| Release | Modification |
|---|---|
11.3 MA | This command was first introduced. |
This command applies to Voice over Frame Relay, Voice over ATM, and Voice over HDLC on the Cisco MC3810.
The following is sample output from the show voice dsp command for the Cisco MC3810:
router# show voice dsp DSP# 0, channel# 0 G729A BUSY DSP# 0, channel# 1 G729A BUSY DSP# 1, channel# 2 FAX IDLE DSP# 1, channel# 3 FAX IDLE DSP# 2, channel# 4 NONE BAD DSP# 2, channel# 5 NONE BAD DSP# 3, channel# 6 NONE BAD DSP# 3, channel# 7 NONE BAD DSP# 4, channel# 8 NONE BAD DSP# 4, channel# 9 NONE BAD DSP# 5, channel# 10 NONE BAD DSP# 5, channel# 11 NONE BAD
Table 1 explains the fields in the sample output.
| Field | Description |
|---|---|
DSP | Number of the DSP |
Channel | Number of the channel and its status. |
| Command | Description |
Displays the configuration for all VoIP and POTS dial peers configured on the router. | |
show voice call [summary] | Shows a summary of the call status for all voice ports on the Cisco MC3810 |
Displays configuration information about a specific voice port. |
slot/port | (Optional) Displays information for only the voice port you specify with the slot/port designation. slot specifies the slot number of the voice module in the Cisco MC3810. port specifies the voice port number in the slot specified above. |
summary | (Optional) Displays a summary of all voice ports. |
Privileged EXEC
| Release | Modification |
|---|---|
11.3(1) T | This command was first introduced. |
Use the show voice port privileged EXEC command to display configuration and voice-interface-card-specific information about a specific port.
The following is sample output from the show voice port command for an FXS voice port on the Cisco MC3810:
router# show voice port 1/2
Voice port 1/2 Slot is 1, Port is 2
Type of VoicePort is FXS
Operation State is UP
Administrative State is UP
No Interface Down Failure
Description is not set
Noise Regeneration is enabled
Non Linear Processing is enabled
In Gain is Set to 0 dB
Out Attenuation is Set to 0 dB
Echo Cancellation is enabled
Echo Cancel Coverage is set to 8 ms
Connection Mode is normal
Connection Number is not set
Initial Time Out is set to 10 s
Interdigit Time Out is set to 10 s
Coder Type is g729ar8
Companding Type is u-law
Voice Activity Detection is disabled
Ringing Time Out is 180 s
Wait Release Time Out is 30 s
Nominal Playout Delay is 80 milliseconds
Maximum Playout Delay is 160 milliseconds
Analog Info Follows:
Region Tone is set for northamerica
Currently processing Voice
Maintenance Mode Set to None (not in mtc mode)
Number of signaling protocol errors are 0
Impedance is set to 600r Ohm
Analog interface A-D gain offset = -3 dB
Analog interface D-A gain offset = -3 dB
Voice card specific Info Follows:
Signal Type is loopStart
Ring Frequency is 20 Hz
Hook Status is On Hook
Ring Active Status is inactive
Ring Ground Status is inactive
Tip Ground Status is active
Digit Duration Timing is set to 100 ms
InterDigit Duration Timing is set to 100 ms
Ring Cadence are [20 40] * 100 msec
InterDigit Pulse Duration Timing is set to 500 ms
The following is sample output from the show voice port summary command for all voice ports on a Cisco MC3810 with an analog voice module (AVM):
router# show voice port summary
IN OUT ECHO
PORT SIG-TYPE ADMIN OPER IN-STATUS OUT-STATUS CODEC VAD GAIN ATTN CANCEL
1/1 fxs-ls up up on-hook idle 729a n 0 0 y
1/2 fxs-ls up up on-hook idle 729a n 0 0 y
1/3 e&m-wnk up up idle idle 729a n 0 0 y
1/4 e&m-wnk up up idle idle 729a n 0 0 y
1/5 fxo-ls up up idle on-hook 729a n 0 0 y
1/6 fxo-ls up up idle on-hook 729a n 0 0 y
Table 2-5 explains the fields in the sample output.
| Field | Description |
|---|---|
Administrative State | Administrative state of the voice port. |
Alias | User-supplied alias for this voice port. |
Analog interface A-D gain offset | Offset of the gain for analog-to-digital conversion. |
Analog interface D-A gain offset | Offset of the gain for digital-to-analog conversion. |
Clear Wait Duration Timing | Time of inactive seizure signal to declare call cleared. |
Coder Type | Voice compression mode used. |
Companding Type | Companding standard used to convert between analog and digital signals in PCM systems. |
Connection Mode | Connection mode of the interface. |
Connection Number | Full E.164 telephone number used to establish a connection with the trunk or PLAR mode. |
Currently Processing | Type of call currently being processed: none, voice, or fax. |
Delay Duration Timing | Maximum delay signal duration for delay dial signaling. |
Delay Start Timing | Timing of generation of delayed start signal from detection of incoming seizure. |
Description | Description of the voice port. |
Dial Type | Out-dialing type of the voice port. |
Digit Duration Timing | DTMF Digit duration in milliseconds. |
E&M Type | Type of E&M interface. |
Echo Cancel Coverage | Echo Cancel Coverage for this port. |
Echo Cancellation | Whether or not echo cancellation is enabled for this port. |
Hook Flash Duration Timing | Maximum length of hook flash signal. |
Hook Status | Hook status of the FXO/FXS interface. |
Impedance | Configured terminating impedance for the E&M interface. |
In Gain | Amount of gain inserted at the receiver side of the interface. |
In Seizure | Incoming seizure state of the E&M interface. |
Initial Time Out | Amount of time the system waits for an initial input digit from the caller. |
InterDigit Duration Timing | DTMF interdigit duration in milliseconds. |
InterDigit Pulse Duration Timing | Pulse dialing interdigit timing in milliseconds. |
Interdigit Time Out | Amount of time the system waits for a subsequent input digit from the caller. |
Maintenance Mode | Maintenance mode of the voice port. |
Maximum Playout Delay | The amount of time before the Cisco MC3810 DSP starts to discard voice packets from the DSP buffer. |
Music On Hold Threshold | Configured Music-On-Hold Threshold value for this interface. |
Noise Regeneration | Whether or not background noise should be played to fill silent gaps if VAD is activated. |
Nominal Playout Delay | The amount of time the Cisco MC3810 DSP waits before starting to play out the voice packets from the DSP buffer. |
Non-Linear Processing | Whether or not non-linear processing is enabled for this port. |
Number of signaling protocol errors | Number of signaling protocol errors. |
Operations State | Operation state of the port. |
Operation Type | Operation of the E&M signal: two-wire or four-wire. |
Out Attenuation | Amount of attenuation inserted at the transmit side of the interface. |
Out Seizure | Outgoing seizure state of the E&M interface. |
Port | Port number for this interface associated with the voice interface card. |
Pulse Rate Timing | Pulse dialing rate in pulses per second (pps). |
Region Tone | Configured regional tone for this interface. |
Ring Active Status | Ring active indication. |
Ring Cadence | Configured ring cadence for this interface. |
Ring Frequency | Configured ring frequency for this interface. |
Ring Ground Status | Ring ground indication. |
Ringing Time Out | Ringing time out duration. |
Signal Type | Type of signaling for a voice port: loop-start, ground-start, wink-start, immediate, and delay-dial. |
Slot | Slot used in the voice interface card for this port. |
Sub-unit | Subunit used in the voice interface card for this port. |
Tip Ground Status | Tip ground indication. |
Type of VoicePort | Type of voice port: FXO, FXS, and E&M. |
The Interface Down Failure Cause | Text string describing why the interface is down, |
Voice Activity Detection | Whether Voice Activity Detection is enabled or disabled. |
Wait Release Time Out | The time that a voice port stays in the call-failure state while the Cisco MC3810 sends a busy tone, reorder tone, or an out-of-service tone to the port. |
Wink Duration Timing | Maximum wink duration for wink start signaling. |
Wink Wait Duration Timing | Maximum wink wait duration for wink start signaling. |
| Command | Description |
show call active voice | Displays the contents of the active call table, which shows all of the calls currently connected through the router. |
show call history voice | Displays the call history table. |
Displays the configuration for all VoIP and POTS dial peers configured on the router. | |
show num-exp | Displays all of the number expansions configured for this router. |
show voice port | Displays configuration information about voice ports in this router. |
![]()
![]()
![]()
![]()
![]()
![]()
![]()
Posted: Mon May 3 15:09:47 PDT 1999
Copyright 1989-1999©Cisco Systems Inc.