cc/td/doc/product/access/multicon/3810soft
hometocprevnextglossaryfeedbacksearchhelp
PDF

Table of Contents

EXEC Commands

EXEC Commands

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:

clear voice port

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

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 Mode

Privileged EXEC

Command History

Release Modification

11.3 MA

This command was first introduced.

Usage Guidelines

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

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

Examples

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

clear voice port 1/2

Related Commands

Command Description

show voice port

Displays configuration information about a specific voice port.

show call history voice record

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 record

Command Mode

Privileged EXEC.

Command History

Release Modification

12.0(2) T

This command was first introduced.

Usage Guidelines

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.

Examples

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

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.


Table 2-1: Field Descriptions for show call history voice record Command
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.

Related Commands

Command Description

dial-control-mib

Specifies attributes for the call history table.

show dial-peer voice

To display configuration information for dial peers, use the show dial-peer voice privileged EXEC command.

show dial-peer voice [number] [summary]

Syntax Description

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.

Command Mode

Privileged EXEC

Command History

Release Modification

11.3(1) T

This command was first introduced.

Usage Guidelines

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.

Sample Displays

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 21
VoiceOverFRPeer21
tag = 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 10
VoiceOverHDLCPeer10
tag = 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.


Table 2-2: Show Dial Peer Voice Field Descriptions
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.

Related Commands

Command Description

show voice call

Specifies attributes for the call history table.

show call history voice record

Displays Call Detail Record (CDR) events in the call history table.

show num-exp

Display all of the number expansions configured for this router.

show voice port

Displays configuration information about a specific voice port.

show dialplan number

To show which dial peer is reached when a particular telephone number is dialed, use the show dialplan number privileged EXEC command.

show dialplan number dial string

Syntax Description

dial string

Particular destination pattern (telephone number).

Command Mode

Privileged EXEC

Command History

Release Modification

11.3(1) T

This command was first introduced.

Usage Guidelines

The show dialplan number command is used to test if the dial-plan configuration is valid and working as expected.

Sample Display

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.


Table 2-3: Show DialPlan Number Field Descriptions
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.

Related Commands

Command Description

show dialplan incall number

Pairs different voice ports and telephone numbers together for troubleshooting.

show network-clocks

To display the current configured and active network clock sources, use the show network-clocks privileged EXEC command.

show network-clocks

Syntax Description

This command has no arguments or keywords.

Command Mode

Privileged EXEC

Command History

Release Modification

11.3 MA

This command was first introduced.

Usage Guidelines

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.

Sample Displays

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.

Related Commands

Command Description

network-clock-select

Sets the selection priority for one or more clock sources for the Cisco .MC3810.

show voice busyout

To display information about the voice busyout state, use the show voice busyout privileged EXEC command.

show voice busyout

Syntax Description

This command has no arguments or keywords.

Command Mode

Privileged EXEC

Command History

Release Modification

12.0(3) T

This command was first introduced.

Usage Guidelines

This command is only supported on the Cisco MC3810.

Examples

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

Related Commands

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

show voice call

To show the call status for all voice ports on the Cisco MC3810, use the show voice call privileged EXEC command.

show voice call [summary]

Syntax Description

summary

(Optional) Show a summary of the call status instead of the full detailed report.

Command Mode

Privileged EXEC

Command History

Release Modification

11.3 MA

This command was first introduced.

Usage Guidelines

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:

Sample Display

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.


Table 2-4: Show Voice Call Field Descriptions
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.

Related Commands

Command Description

show dial-peer voice

Displays the configuration for all VoIP and POTS dial peers configured on the router.

show voice dsp

Shows the current status of all DSP voice channels.

show voice port

Displays configuration information about a specific voice port.

show voice dsp

To show the current status of all digital signal processor (DSP) voice channels, use the show voice dsp privileged EXEC command.

show voice dsp

Syntax Description

This command has no arguments or keywords.

Command Mode

Privileged EXEC

Command History

Release Modification

11.3 MA

This command was first introduced.

Usage Guidelines

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

Sample Display

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.


Table 1: Show Voice DSP Field Descriptions
Field Description

DSP

Number of the DSP

Channel

Number of the channel and its status.

Related Commands

Command Description

show dial-peer voice

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

show voice port

Displays configuration information about a specific voice port.

show voice port

To display configuration information about voice ports, use the show voice port privileged EXEC command.

show voice port [slot/port] [summary]

Syntax Description

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.

Command Mode

Privileged EXEC

Command History

Release Modification

11.3(1) T

This command was first introduced.

Usage Guidelines

Use the show voice port privileged EXEC command to display configuration and voice-interface-card-specific information about a specific port.

Sample Display

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.


Table 2-5: Show Voice Port Field Descriptions
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.

Related Commands

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.

show dial-peer voice

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.


hometocprevnextglossaryfeedbacksearchhelp
Posted: Mon May 3 15:09:47 PDT 1999
Copyright 1989-1999©Cisco Systems Inc.