Displaying Caller Statistics

Feature Summary

The show caller command combines the output of the existing show commands. This command displays connection status in summary or in detail.

Benefits

Using the show caller command provides the following benefits:

Displays statistics or debug information for connections using a single command.
Replaces the need to know and use the various show commands
Provides network management across all Cisco platforms.

Platforms

This feature is supported on all Cisco routers and access servers.

Prerequisites

Your access server or router must be running Cisco IOS Release 11.3(5)AA or higher.

Supported MIBs and RFCs

None.

Configuration Tasks

The following tasks are provided:

Enter the show caller command
Enter the show caller full command

Table 1: Configuring show caller Command
Step Command Purpose

1
5300> enable Password: <password> 5300#
Enter the privileged enable mode. (This mode is also called EXEC mode.)

Enter the password.

You have entered enable mode when the prompt changes to 5300#.

2
5300# show caller (interface name [full]) | (username name [detailed]) | (line range [full]) | (ip)]
5300#
Use this command to display a summary of caller information based on the interface, a user's name, a line, or an IP address.

The summary output is 1 line per interface.

**Table 1: Configuring show caller Command**
Step	Command	Purpose
1	5300> enable Password: <password> 5300#	Enter the privileged enable mode. (This mode is also called EXEC mode.) Enter the password. You have entered enable mode when the prompt changes to `5300#`.
2	5300# show caller (interface name [full]) \| (username name [detailed]) \| (line range [full]) \| (ip)] 5300#	`Use this command to display a summary of caller information based on the interface, a user's name, a line, or an IP address.` The summary output is 1 line per interface.

Table 2: Configuring show caller full Command
Step Command Purpose

1
5300> enable Password: <password> 5300#
Enter enable mode.

Enter the password.

You have entered enable mode when the prompt changes to 5300#.

2
5300# show caller full
(interface name [full]) | (username name [detailed]) | (line range [full]) | (ip)]
5300#

Use this command to display complete information based on the interface, a user's name, a line, or an IP address.

**Table 2: Configuring show caller full Command**
Step	Command	Purpose
1	5300> enable Password: <password> 5300#	Enter enable mode. Enter the password. You have entered enable mode when the prompt changes to `5300#`.
2	5300# show caller full (interface name [full]) \| (username name [detailed]) \| (line range [full]) \| (ip)] 5300#	`Use this command to display complete information based on the interface, a user's name, a line, or an IP address.`

Configuration Examples

The following configuration examples include one example for ISDN connections and another for async connections.

Summary Commands

The following example shows how to display a summary of caller information using the show caller summary command:

5300# show caller
  Line      User                  Service       Active   
  con 0     -                     TTY           00:08:21
  BR0:1     hatteras              PPP           00:00:14
  Vi1       hatteras              PPP   Bundle  00:00:13

Detailed Commands

The following example shows how to display a complete set of caller information using the show caller detail command:

5300# show caller full
 
  User: unknown, line con 0, service TTY, active 1d04h
  TTY: Line 0, idle 1d05h
  Status: Ready, Active
  Modem State: Ready
  Timeouts: Idle EXEC  Idle Session  Modem Answer   Session   Dispatch
                never         never             -     never   not set
 
  User: uut-a, line tty 1, service Async, active -
  TTY: Line 1, running PPP on As1, idle 00:00:53
  Location: mod 2329928
  Line: Baud rate (TX/RX) is 38400/38400, no parity, 1 stopbits, 8 databits
  Status: Ready, Active, No Exit Banner, Async Interface Active
  Capabilities: EXEC Suppressed, Hardware Flowcontrol In, 
                Hardware Flowcontrol Out, Modem Callout, Modem RI is CD
                Line usable as async interface
  Modem State: Ready
  Timeouts: Idle EXEC  Idle Session  Modem Answer   Session   Dispatch
                never         never             -     never   not set
 
  User: uut-a, line As1, service PPP, active 00:00:46
  PPP: LCP Open, CHAP (local <--> local), IPCP, CDPCP
  Dialer: Connected to 2329927, outbound
          Idle timer 2147483 secs, idle 52 secs
          Type is IN-BAND ASYNC, group Dialer0
          Cause: ip (s=2.2.2.2, d=2.2.2.1)
  IP: Local 2.2.2.2/8, remote 2.2.2.1
  Counts: 101 packets input, 4970 bytes, 0 no buffer
          3 input errors, 3 CRC, 0 frame, 0 overrun
          93 packets output, 1917 bytes, 0 underruns
          0 output errors, 0 collisions, 2 interface resets

Command Reference

This section describes, in detail, the show caller command. All other commands used with this feature are documented in the Cisco IOS Release 11.3 command references.

show caller

show caller

To get a summary or full display of caller information for an interface, a username, a line, or an IP address, enter the show caller command global configuration command.

show caller (interface name [full]) | (username name [detailed]) | (line range [full]) | (ip)]

Syntax Description


interface name	(Optional) Displays a summary of caller information for the interface name you provide.
username name	(Optional) Displays a summary of caller information for the username you provide.
line range	(Optional) Displays a summary of caller information for the range of lines you define.
ip	(Optional) Displays a summary of caller information for the IP address you provide.
full	(Optional) This option provides expanded information.
detailed	(Optional) This options provides expanded information.

Command Mode

EXEC

Usage Guidelines

This command first appeared in Cisco IOS Release 11.3(5)AA.

Example

The following example shows sample show caller output:

5300# show caller
  Line      User                  Service       Active   
  con 0     -                     TTY           00:08:21
  BR0:1     hatteras              PPP           00:00:14
  Vi1       hatteras              PPP   Bundle  00:00:13
 
5300# show caller full
 
  User: unknown, line con 0, service TTY, active 00:08:25
  TTY: Line 0, idle 00:09:44
  Status: Ready, Active
  Modem State: Ready
  Timeouts: Idle EXEC  Idle Session  Modem Answer   Session   Dispatch
                never         never             -     never   not set
 
  User: hatteras, line BR0:1, service PPP, active 00:00:18
  PPP: LCP Open, multilink Open, CHAP (local <--> local)
  Dialer: Connected 00:00:25 to 60222, outbound
          Type is ISDN, group Dialer0
          Cause: ip (s=1.0.0.3, d=1.0.0.1)
  IP: Local 1.0.0.3/8
  Counts: 9 packets input, 189 bytes, 0 no buffer
          0 input errors, 0 CRC, 0 frame, 0 overrun
          8 packets output, 169 bytes, 0 underruns 
          0 output errors, 0 collisions, 5 interface resets
 
  User: hatteras, line Vi1, service PPP Bundle, active 00:00:18
  PPP: LCP Open, multilink Open, IPCP
  Dialer: Connected 00:00:25 to 60222, inbound
          Idle timer 120 secs, idle 19 secs
          Type is IN-BAND SYNC, group Dialer0
  IP: Local 1.0.0.3/8, remote 10.1.1.1
  Bundle: First link of hatteras, 1 link, last input 00:00:19
  Counts: 3 packets input, 36 bytes, 0 no buffer
          0 input errors, 0 CRC, 0 frame, 0 overrun
          3 packets output, 36 bytes, 0 underruns
          0 output errors, 0 collisions, 0 interface resets

Related Commands

show user
show line
show dialer
show async status
show init
show ip pool
show modem

Table of Contents