show call history fax
To display the call history table for fax transmissions, use the show call history fax command in user EXEC or privileged EXEC mode.
show call history fax [brief [id identifier] | compact [duration {less | more} time] | id identifier | last number ]
Syntax Description
|
brief |
(Optional) Displays a truncated version of the call history table. |
|
id identifier |
(Optional) Displays only the call with the specified identifier. Range is a hex value from 1 to FFFF. |
|
compact |
(Optional) Displays a compact version. |
|
duration time |
(Optional) Displays history information for calls that are longer or shorter than a specified time value. The arguments and keywords are as follows:
|
|
last number |
(Optional) Displays the last calls connected, where the number of calls that appear is defined by the number argument. Range is from 1 to 100 . |
Command Modes
User EXEC (>)
Privileged EXEC (#)
Command History
|
Release |
Modification |
|---|---|
|
11.3(1)T |
This command was introduced on the Cisco 3600 series. |
|
12.0(3)XG |
This command was implemented for Voice over Frame Relay (VoFR) on the Cisco 2600 series and Cisco 3600 series. |
|
12.0(4)XJ |
This command was modified for store-and-forward fax. |
|
12.0(4)T |
This command was modified. The brief keyword was added, and the command was implemented on the Cisco 7200 series. |
|
12.0(7)XK |
This command was modified. The brief keyword was implemented on the Cisco MC3810. |
|
12.1(2)T |
This command was integrated into Cisco IOS Release 12.1(2)T. |
|
12.1(5)XM |
This command was implemented on the Cisco AS5800. |
|
12.1(5)XM2 |
This command was implemented on the Cisco AS5350 and Cisco AS5400. |
|
12.2(2)XA |
This command was modified. The output of this command was modified to indicate whether the call in question has been established using Annex E. |
|
12.2(4)T |
This command was integrated into Cisco IOS Release 12.2(4)T. |
|
12.2(2)XB1 |
This command was implemented on the Cisco AS5850. |
|
12.2(8)T |
This command was integrated into Cisco IOS Release 12.2(8)T. Support for the Cisco AS5350, Cisco AS5400, Cisco AS5800, and Cisco AS5850 was not included in this release. |
|
12.2(11)T |
This command was implemented on the Cisco AS5350, Cisco AS5400, Cisco AS5800, and Cisco AS5850. |
|
12.3(1) |
This command was modified. The following fields were added: FaxRelayMaxJitterBufDepth, FaxRelayJitterBufOverFlow, FaxRelayHSmodulation, and FaxRelayNumberOfPages. |
|
12.3(14)T |
This command was modified. T.38 fax relay call statistics were made available to Call Detail Records (CDRs) through vendor-specific attributes (VSAs) and added to the call log. |
|
12.4(15)T |
This command was modified. The Port and BearerChannel display fields were added to the TELE call leg record of the command output. |
|
12.4(16) |
This command was modified. The Port and BearerChannel display fields were added to the TELE call leg record of the command output. |
|
12.4(22)T |
This command was modified. Command output was updated to show IPv6 information. |
Usage Guidelines
This command displays a call-history table that contains a list of fax calls connected through the router in descending time order. The maximum number of calls contained in the table can be set to a number from 0 to 500 using the dial-control-mib command in global configuration mode. The default maximum number of table entries is 50. Each call record is aged out of the table after a configurable number of minutes has elapsed, also specified by the dial-control-mib command. The default timer value is 15 minutes.
You can display subsets of the call history table by using specific keywords. To display the last calls connected through this router, use the keyword last , and define the number of calls to be displayed with the number argument.
To display a truncated version of the call history table, use the brief keyword.
This command applies to both on-ramp and off-ramp store-and-forward fax functions.
Examples
The following is sample output from the show call history fax command:
Router# show call history fax
Telephony call-legs: 1
SIP call-legs: 0
H323 call-legs: 0
MGCP call-legs: 0
Total call-legs: 1
GENERIC:
SetupTime=590180 ms
Index=2
PeerAddress=4085452930
PeerSubAddress=
PeerId=81
PeerIfIndex=221
LogicalIfIndex=145
DisconnectCause=10
DisconnectText=normal call clearing (16)
ConnectTime=59389
DisconnectTime=68204
CallDuration=00:01:28
CallOrigin=2
ReleaseSource=1
ChargedUnits=0
InfoType=fax
TransmitPackets=295
TransmitBytes=5292
ReceivePackets=2967
ReceiveBytes=82110
TELE:
ConnectionId=[0xD9ACDFF1 0x9F5D11D7 0x8002CF18 0xB9C3632]
IncomingConnectionId=[0xD9ACDFF1 0x9F5D11D7 0x8002CF18 0xB9C3632]
CallID=2
Port=3/0/0 (2)
BearerChannel=3/0/0.1
TxDuration=28960 ms
VoiceTxDuration=0 ms
FaxTxDuration=28960 ms
FaxRate=voice bps
FaxRelayMaxJitterBufDepth = 0 ms
FaxRelayJitterBufOverFlow = 0
FaxRelayHSmodulation = 0
FaxRelayNumberOfPages = 0
NoiseLevel=-120
ACOMLevel=127
SessionTarget=
ImgPages=0
CallerName=
CallerIDBlocked=False
OriginalCallingNumber=4085550130
OriginalCallingOctet=0x0
OriginalCalledNumber=52930
OriginalCalledOctet=0xE9
OriginalRedirectCalledNumber=
OriginalRedirectCalledOctet=0xFF
TranslatedCallingNumber=4085550130
TranslatedCallingOctet=0x0
TranslatedCalledNumber=52930
TranslatedCalledOctet=0xE9
TranslatedRedirectCalledNumber=
TranslatedRedirectCalledOctet=0xFF
GwReceivedCalledNumber=52930
GwReceivedCalledOctet3=0xE9
GwReceivedCallingNumber=4085550130
GwReceivedCallingOctet3=0x0
GwReceivedCallingOctet3a=0x80
The table below provides an alphabetical listing of the fields displayed in the output of the show call history fax command and a description of each field.
|
Field |
Description |
|---|---|
|
ACOM Level |
Current ACOM level for this call. ACOM is the combined loss achieved by the echo canceler, which is the sum of the Echo Return Loss, Echo Return Loss Enhancement, and nonlinear processing loss for the call. |
|
BearerChannel |
Identification of the bearer channel carrying the call. |
|
Buffer Drain Events |
Total number of jitter buffer drain events. |
|
Buffer Fill Events |
Total number of jitter buffer fill events. |
|
CallDuration |
Length of the call, in hours, minutes, and seconds, hh:mm:ss. |
|
CallerName |
Voice port station name string. |
|
CallOrigin |
Call origin: answer or originate. |
|
CallState |
Current state of the call. |
|
ChargedUnits |
Total number of charging units that apply to this peer since system startup. The unit of measure for this field is hundredths of second. |
|
CodecBytes |
Payload size, in bytes, for the codec used. |
|
CoderTypeRate |
Negotiated coder rate. This value specifies the send rate of voice or fax compression to its associated call leg for this call. |
|
ConnectionId |
Global call identifier for this gateway call. |
|
ConnectTime |
Time, in milliseconds (ms), at which the call was connected. |
|
Consecutive-packets-lost Events |
Total number of consecutive (two or more) packet-loss events. |
|
Corrected packet-loss Events |
Total number of packet-loss events that were corrected using the RFC 2198 method. |
|
Dial-Peer |
Tag of the dial peer sending this call. |
|
DisconnectCause |
Cause code for the reason this call was disconnected. |
|
DisconnectText |
Descriptive text explaining the reason for the disconnect. |
|
DisconnectTime |
Time, in ms, when this call was disconnected. |
|
EchoCancellerMaxReflector=64 |
The location of the largest reflector, in ms. The reflector size does not exceed the configured echo path capacity. For example, if 32 ms is configured, the reflector does not report beyond 32 ms. |
|
ERLLevel |
Current Echo Return Loss (ERL) level for this call. |
|
FaxTxDuration |
Duration of fax transmission from this peer to the voice gateway for this call. You can derive the Fax Utilization Rate by dividing the FaxTxDuration value by the TxDuration value. |
|
FaxRelayJitterBufOverFlow |
Count of number of network jitter buffer overflows (number of packets). These packets are equivalent to lost packets. |
|
FaxRelayMaxJitterBufDepth |
Maximum depth of jitter buffer (in ms). |
|
FaxRelayHSmodulation |
Most recent high-speed modulation used. |
|
FaxRelayNumberOfPages |
Number of pages transmitted. |
|
GapFillWithInterpolation |
Duration of a voice signal played out with a signal synthesized from parameters, or samples of data preceding and following in time because voice data was lost or not received in time from the voice gateway for this call. |
|
GapFillWithRedundancy |
Duration of a voice signal played out with a signal synthesized from available redundancy parameters because voice data was lost or not received in time from the voice gateway for this call. |
|
GapFillWithPrediction |
Duration of the voice signal played out with signal synthesized from parameters, or samples of data preceding in time, because voice data was lost or not received in time from the voice gateway for this call. Examples of such pullout are frame-eraser and frame-concealment strategies in G.729 and G.723.1 compression algorithms. |
|
GapFillWithSilence |
Duration of a voice signal replaced with silence because voice data was lost or not received in time for this call. |
|
GENERIC |
Generic or common parameters, that is, parameters that are common for VoIP and telephony call legs. |
|
GwReceivedCalledNumber, GwReceivedCalledOctet3, GwReceivedCallingNumber, GwReceivedCallingOctet3, GwReceivedCallingOctet3a |
Call information received at the gateway. |
|
H323 call-legs |
Total H.323 call legs for which call records are available. |
|
HiWaterPlayoutDelay |
High-water-mark Voice Playout FIFO Delay during this call. |
|
ImgPages |
The fax pages that have been processed. |
|
Incoming ConnectionId |
The incoming_GUID. It can be different with ConnectionId (GUID) when there is a long_pound or blast_call feature involved. In those cases, incoming_GUID is unique for all the subcalls that have been generated, and GUID is different for each subcall. |
|
Index |
Dial peer identification number. |
|
InfoActivity |
Active information transfer activity state for this call. |
|
InfoType |
Information type for this call; for example, voice or fax. |
|
InSignalLevel |
Active input signal level from the telephony interface used by this call. |
|
Last Buffer Drain/Fill Event |
Elapsed time since the last jitter buffer drain or fill event, in seconds. |
|
Local UUID |
Unique identifier generated from the originating user agent. |
|
LogicalIfIndex |
Index number of the logical interface for this call. |
|
LoWaterPlayoutDelay |
Low-water-mark Voice Playout FIFO Delay during this call. |
|
LowerIFName |
Physical lower interface information. Appears only if the medium is ATM, Frame Relay (FR), or High-Level Data Link Control (HDLC). |
|
Media |
Medium over which the call is carried. If the call is carried over the (telephone) access side, the entry is TELE. If the call is carried over the voice network side, the entry is either ATM, FR, or HDLC. |
|
Modem passthrough signaling method in use |
Indicates that this is a modem pass-through call and that named signaling events (NSEs)--a Cisco-proprietary version of named telephone events in RFC 2833--are used for signaling codec upspeed. The upspeed method is the method used to dynamically change the codec type and speed to meet network conditions. This means that you might move to a faster codec when you have both voice and data calls and then slow down when there is only voice traffic. |
|
NoiseLevel |
Active noise level for this call. |
|
OnTimeRvPlayout |
Duration of voice playout from data received on time for this call. Derive the Total Voice Playout Duration for Active Voice by adding the OnTimeRvPlayout value to the GapFill values. |
|
OriginalCallingNumber, OriginalCalling Octet, OriginalCalledNumber, OriginalCalledOctet, OriginalRedirectCalledNumber, OriginalRedirectCalledOctet |
Original call information regarding calling, called, and redirect numbers, as well as octet-3s. Octet-3s are information elements (IEs) of Q.931 that include type of number, numbering plan indicator, presentation indicator, and redirect reason information. |
|
OutSignalLevel |
Active output signal level to the telephony interface used by this call. |
|
PeerAddress |
Destination pattern or number associated with this peer. |
|
PeerId |
ID value of the peer table entry to which this call was made. |
|
PeerIfIndex |
Voice port index number for this peer. For ISDN media, this would be the index number of the B channel used for this call. |
|
PeerSubAddress |
Subaddress when this call is connected. |
|
Percent Packet Loss |
Total percent packet loss. |
|
Port |
Identification of the voice port carrying the call. |
|
ReceiveBytes |
Number of bytes received by the peer during this call. |
|
ReceiveDelay |
Average Playout FIFO Delay plus the Decoder Delay during this voice call. |
|
ReceivePackets |
Number of packets received by this peer during this call. |
|
ReleaseSource |
Number value of the release source. |
|
RemoteIPAddress |
Remote system IP address for the VoIP call. |
|
RemoteUDPPort |
Remote system User Datagram Protocol (UDP) listener port to which voice packets are sent. |
|
Remote UUID |
Unique identifier generated from the terminating user agent. |
|
RoundTripDelay |
Voice packet round-trip delay between the local and remote systems on the IP backbone for this call. |
|
SelectedQoS |
Selected Resource Reservation Protocol (RSVP) quality of service (QoS) for this call. |
|
SessionProtocol |
Session protocol used for an Internet call between the local and remote routers through the IP backbone. |
|
SessionTarget |
Session target of the peer used for this call. |
|
SetupTime |
Value of the system UpTime, in ms, when the call associated with this entry was started. |
|
SignalingType |
Signaling type for this call; for example, channel-associated signaling (CAS) or common-channel signaling (CCS). |
|
SIP call-legs |
Total SIP call legs for which call records are available. |
|
Telephony call-legs |
Total telephony call legs for which call records are available. |
|
Time between Buffer Drain/Fills |
Minimum and maximum durations between jitter buffer drain or fill events, in seconds. |
|
TranslatedCallingNumber, TranslatedCallingOctet, TranslatedCalledNumber, TranslatedCalledOctet, TranslatedRedirectCalled Number, TranslatedRedirectCalledOctet |
Translated call information. |
|
TransmitBytes |
Number of bytes sent by this peer during this call. |
|
TransmitPackets |
Number of packets sent by this peer during this call. |
|
TxDuration |
The length of the call. Appears only if the medium is TELE. |
|
VAD |
Whether voice activation detection (VAD) was enabled for this call. |
|
VoiceTxDuration |
Duration of voice transmission from this peer to the voice gateway for this call. Derive the Voice Utilization Rate by dividing the VoiceTxDuration value by the TxDuration value. |
The following is sample output from the show call history fax brief command:
Router# show call history fax brief
<ID>: <start>hs.<index> +<connect> +<disc> pid:<peer_id> <direction> <addr>
tx:<packets>/<bytes> rx:<packets>/<bytes> <disc-cause>(<text>)
IP <ip>:<udp> rtt:<time>ms pl:<play>/<gap>ms lost:<lost>/<early>/<late>
delay:<last>/<min>/<max>ms <codec>
Telephony <int>: tx:<tot>/<voice>/<fax>ms <codec> noise:<lvl>dBm acom:<lvl>dBm
2 : 5996450hs.25 +-1 +3802 pid:100 Answer 408
tx:0/0 rx:0/0 1F (T30 T1 EOM timeout)
Telephony : tx:38020/38020/0ms g729r8 noise:0dBm acom:0dBm
2 : 5996752hs.26 +-1 +3500 pid:110 Originate uut1@linux2.allegro.com
tx:0/0 rx:0/0 3F (The e-mail was not sent correctly. Remote SMTP server said: 354 )
IP 14.0.0.1 AcceptedMime:0 DiscardedMime:0
3 : 6447851hs.27 +1111 +3616 pid:310 Originate 576341.
tx:11/14419 rx:0/0 10 (Normal connection)
Telephony : tx:36160/11110/25050ms g729r8 noise:115dBm acom:-14dBm
3 : 6447780hs.28 +1182 +4516 pid:0 Answer
tx:0/0 rx:0/0 10 (normal call clearing.)
IP 0.0.0.0 AcceptedMime:0 DiscardedMime:0
4 : 6464816hs.29 +1050 +3555 pid:310 Originate 576341.
tx:11/14413 rx:0/0 10 (Normal connection)
Telephony : tx:35550/10500/25050ms g729r8 noise:115dBm acom:-14dBm
4 : 6464748hs.30 +1118 +4517 pid:0 Answer
tx:0/0 rx:0/0 10 (normal call clearing.)
IP 0.0.0.0 AcceptedMime:0 DiscardedMime:0
5 : 6507900hs.31 +1158 +2392 pid:100 Answer 4085763413
tx:0/0 rx:3/3224 10 (Normal connection)
Telephony : tx:23920/11580/12340ms g729r8 noise:0dBm acom:0dBm
5 : 6508152hs.32 +1727 +2140 pid:110 Originate uut1@linux2.allegro.com
tx:0/2754 rx:0/0 3F (service or option not available, unspecified)
IP 14.0.0.4 AcceptedMime:0 DiscardedMime:0
6 : 6517176hs.33 +1079 +3571 pid:310 Originate 576341.
tx:11/14447 rx:0/0 10 (Normal connection)
Telephony : tx:35710/10790/24920ms g729r8 noise:115dBm acom:-14dBm
6 : 6517106hs.34 +1149 +4517 pid:0 Answer
tx:0/0 rx:0/0 10 (normal call clearing.)
IP 0.0.0.0 AcceptedMime:0 DiscardedMime:0
7 : 6567382hs.35 +1054 +3550 pid:310 Originate 576341.
tx:11/14411 rx:0/0 10 (Normal connection)
Telephony : tx:35500/10540/24960ms g729r8 noise:115dBm acom:-14dBm
7 : 6567308hs.36 +1128 +4517 pid:0 Answer
tx:0/0 rx:0/0 10 (normal call clearing.)
IP 0.0.0.0 AcceptedMime:0 DiscardedMime:0
The following example shows output for the show call history fax command with the T.38 Fax Relay statistics:
Router# show call history fax
Telephony call-legs: 1
SIP call-legs: 0
H323 call-legs: 0
MGCP call-legs: 0
Total call-legs: 1
GENERIC:
SetupTime=9872460 ms
Index=8
PeerAddress=41023
PeerSubAddress=
PeerId=1
PeerIfIndex=242
LogicalIfIndex=180
DisconnectCause=10
DisconnectText=normal call clearing (16)
ConnectTime=9875610 ms
DisconnectTime=9936000 ms
CallDuration=00:01:00 sec
CallOrigin=2
ReleaseSource=1
ChargedUnits=0
InfoType=fax
TransmitPackets=268
TransmitBytes=4477
ReceivePackets=1650
ReceiveBytes=66882
TELE:
ConnectionId=[0xD6635DD5 0x9FA411D8 0x8005000A 0xF4107CA0]
IncomingConnectionId=[0xD6635DD5 0x9FA411D8 0x8005000A 0xF4107CA0]
CallID=7
Port=3/0/0:0 (7)
BearerChannel=3/0/0.8
TxDuration=6170 ms
VoiceTxDuration=0 ms
FaxTxDuration=0 ms
FaxRate=disable bps
FaxRelayMaxJitterBufDepth=560 ms
FaxRelayJitterBufOverFlow=0
FaxRelayMostRecentHSmodulation=V.17/short/14400
FaxRelayNumberOfPages=1
FaxRelayInitHSmodulation=V.17/long/14400
FaxRelayDirection=Transmit
FaxRelayPktLossConceal=0
FaxRelayEcmStatus=ENABLED
FaxRelayEncapProtocol=T.38 (UDPTL)
FaxRelayNsfCountryCode=Japan
FaxRelayNsfManufCode=0031B8EE80C48511DD0D0000DDDD0000DDDD000000000000000022ED00B0A400
FaxRelayFaxSuccess=Success
NoiseLevel=0
ACOMLevel=0
SessionTarget=
ImgPages=0
CallerName=Analog 41023
CallerIDBlocked=False
OriginalCallingNumber=
OriginalCallingOctet=0x80
OriginalCalledNumber=41021
OriginalCalledOctet=0xA1
OriginalRedirectCalledNumber=
OriginalRedirectCalledOctet=0xFF
TranslatedCallingNumber=41023
TranslatedCallingOctet=0x80
TranslatedCalledNumber=41021
TranslatedCalledOctet=0xA1
TranslatedRedirectCalledNumber=
TranslatedRedirectCalledOctet=0xFF
GwReceivedCalledNumber=41021
GwReceivedCalledOctet3=0xA1
The table below describes the fields not shown in the table above.
|
Field |
Description |
|---|---|
|
FaxRelayDirection |
Direction of fax relay. |
|
FaxRelayEcmStatus |
Fax relay error correction mode status. |
|
FaxRelayEncapProtocol |
Fax relay encapsulation protocol. |
|
FaxRelayFaxSuccess |
Fax relay success. |
|
FaxRelayInitHSmodulation |
Fax relay initial high speed modulation. |
|
FaxRelayMostRecentHSmodulation |
Fax relay most recent high speed modulation. |
|
FaxRelayNsfCountryCode |
Fax relay Nonstandard Facilities (NSF) country code. |
|
FaxRelayNsfManufCode |
Fax relay NSF manufacturers code. |
|
FaxRelayPktLossConceal |
Fax relay packet loss conceal. |
Feedback