Table Of Contents

System Management Commands

cd

help

log

ping

reboot

reset packets

set baudrate

set callduration

set calltime

set compression

set date

set default

set echo

set ipx trace

set loopback

set screenlength

set serialport

set systemname

set time

set tpad parity

show

show callduration

show calltime

show configuration

show connection

show demand

show memstat

show packets

show tpad

show users

swl

test

upload

version

System Management Commands

---

This chapter describes the commands for system interfaces, system booting, and terminal sessions. The system interface commands display the router configuration in various forms using the show commands. The system booting commands are used to reboot the router, download software, and reset configuration value to their defaults. The terminal session commands manage communications between an ASCII terminal or a PC running terminal emulation software and the router. (The Cisco 700 Series Installation Guide provides instructions for connecting a terminal to the router.)

cd

To create a profile, enter an existing profile, or return to system mode, use the cd command (also known as the change user command).

CD [username]

Syntax Description

username

Profile name.

Command Mode

System or profile mode

Usage Guidelines

This command creates a profile if the user name does not exist or moves to the specified profile if the user name does exist. From within a profile, this command returns from the profile to system mode.

The user name displays in the prompt, following the router name.

The user name can be abbreviated to the fewest number of characters that make the name unique. The minimum is two characters. The maximum is 64 characters. User names are not case-sensitive. If no user name is specified, you return to system mode.

For authentication purposes, the user name is the string the remote device uses as a username when authenticating itself through Point-to-Point Protocol (PPP).

Example

The following example moves from system mode (where the router name is Host) to a profile named 2503:

Host> cd 2503

Host:2503>

help

To display a list of commands and the syntax for each command, use the help command.

HElp [cmd [modifier]]

Syntax Description

cmd	All commands for the specified group are listed. The most useful are set commands, reset commands, show commands, log commands, test commands, and unset commands.
modifier	All modifiers for the specified command are listed. The most useful are ip (Internet Protocol), ipx (Internetwork Packet Exchange), and snmp (Simple Network Management Protocol).

Default

None

Command Mode

System or profile mode

Usage Guidelines

Use this command to display online help information about commands. You can enter a question mark (?) in place of the word "help." Used without parameters, the command displays all the commands.

Example

The following example displays help for the call command:

Host> help call

CAll [ C# | L# | # | C#/L# | C#/# | #/# ]  [ P# | CH# | P#/CH# ] 
[<number>]

where

 C#            indicates a Connection number

 # or L#       indicates a Link number

 C#/L# or #/#  indicates Link of a Connection

 P#            indicates Port

 CH#           indicates Channel

 P#/CH#        indicates Channel of a Port

<Q> and <enter> to Quit or <enter> for MORE

log

To implement the logging functions, use the log command.

LOg NOne | CAlls | MEssage | ERrors | IPx [TIme] [VErbose]

LOg [LAN | connection] PAckets | TRaffic [CHannel = channel] [VErbose [INbound | OUtbound]]

NOne	Disable all logging.
CAlls	Log call statistics. Each major call event is logged, and a message displays every time a channel is assigned a connection.
MEssage	Display a message when a channel is assigned a connection.
ERrors	Log error messages that otherwise are not displayed, including buffer allocation errors, mail delivery errors, and chip-level errors.
IPx	Display messages when Service Advertisement Protocol (SAP) entries get changed, interface characteristics are set or changed, or when erroneous Routing Information Protocol (RIP) information is received.
TIme	Display time and date of each logged event or message.
VErbose	Log all layers of the ISDN call control stack and traffic by printing the entire packet.
LAN	Enable logging for the LAN connection. Used with packets or traffic.
PAckets	Display statistics on packet routing once per second. Number of packets filtered, forwarded, received, and the packet queue lengths are displayed.
TRaffic	Display a one-character indicator of each packet sent on the connection or the whole packet when verbose is specified.
CHannel	Provide the channel number (logs traffic on a channel before the channel is assigned to a connection). This is primarily used to diagnose Point-to-Point Protocol (PPP) negotiation problems.
INbound OUtbound	In conjunction with verbose, restrict the packet content display to either incoming or outgoing packets.

Syntax Description

Default

Log calls

Command Mode

System or profile mode

Usage Guidelines

The log command displays all enabled logged entries. More than one keyword can be entered at a time.

Examples

The following example shows output from the log calls command:

Host> log calls time

cb760> ca 1 6545

04/04/1996 00:24:08  L05  0         6545  Outgoing Call Initiated

cb760> cb760> 01/01/1995 00:24:10  L04  0        Line Deactivated

cb760> 01/01/1995 00:24:10  L27  0               Disconnected

cb760> 

The following example shows output from the log messages command:

Host> log messages

> Host> 04/04/1996 04:19:26  L05  0 814159031604  Outgoing Call 
Initiated

Host>  0500 --> 0400 0001

 01 00 02 80 13 1d 18 02 00 03 2c

 0c 38 31 34 31 35 39 30 33 31

 36 30 35 6c 09 00 00 37 37 34

 32 38 36 35 04 02 88 90

Host> 04/04/1996 04:19:26  L05  0 814159031605  Outgoing Call Initiated

Host  0400 --> 0300 01 8012 0340 b548

 08 01 00 80 04 02 88 90 18 01 83

 2c 0c 38 31 34 31 35 39 30 33

 31 36 30 34 6c 09 00 80 37 37

 34 32 38 36 35

Host>  0400 --> 0300 02 8013 0340 b548

 08 01 00 80 04 02 88 90 18 01 83

 2c 0c 38 31 34 31 35 39 30 33

 31 36 30 35 6c 09 00 80 37 37

 34 32 38 36 35

Host>  0300 --> 0400 02 8013 0341 b3f6

 02 01 14 98 18 01 89

The following example shows output from the log messages verbose command:

Host> log messages verbose

Host>  0300 --> 020a 02 8015 0240 b3f6

 08 01 16 0f

Host>  0400 --> 0500 0004

 04 00 02 80 15 04 18 02 01 01

Host>  020a --> 0200 02 0000 0140 b3f6

 00 93 fa 2e

 08 01 16 0f

Host>  0200 --> 020a 00 0000 0141 b3f6

 02 81 0c e0

 08 01 95 07

Host> 04/04/19956 04:22:48  L08  2 814159031605  Call Connected

Host>  020a --> 0300 01 0000 0241 b3f6

 02 81 0c e0

 08 01 95 07

Host>  020a --> 0200 01 0000 0140 b0c6

 02 81 01 0e 

The following example shows output from the log errors command:

2865_66>  log errors

2865_66>  Log Errors: 11003 IPX RIP Not Sent To Virtual Conn 3

2865_66>  Log Errors: 11003 IPX RIP Not Sent To Virtual Conn 3

2865_66>  Log Errors: 11003 IPX RIP Not Sent To Virtual Conn 3

2865_66>  Log Errors: 11003 IPX RIP Not Sent To Virtual Conn 3

2865_66>  Log Errors: 11003 IPX RIP Not Sent To Virtual Conn 3

2865_66>

ping

To determine whether a system can be reached on any connected interface, use the ping command.

PIng ipaddress

Syntax Description

ipaddress

IP address of the target system.

Default

None

Command Mode

System or profile mode

Usage Guidelines

The router generates a ping packet that includes the source address of the profile from which it was sent. If the destination can be reached, the round-trip delay is determined and reported. If the destination cannot be reached, a "no response" message is generated.

The ping command automatically tries three times to reach the destination.

Example

The following example illustrates a successful ping:

Host> ping 172.16.2.1

start sending : round trip time is 40 msec.

start sending : round trip time is 40 msec.

start sending : round trip time is 40 msec.

The following example illustrates an unsuccessful ping:

Host> ping 172.16.2.1

start sending : no response

start sending : no response

start sending : no response

reboot

To boot the router manually, use the reboot command.

REBoot

Default

None

Command Mode

System or profile mode

Example

The following example shows a manual reboot:

Host> reboot

Boot version 2.1(1) 08/13/97 17:33

Copyright (c) 1993-1997.  All rights reserved.

POST ............ OK (1.5MB).

Validating FLASH ... OK.

Booting up ............................

01/01/1995 00:00:00  Connection 1 Opened

tomd> 01/01/1995 00:00:00  L01  0       Started Operation

tomd> 01/01/1995 00:00:01  Connection 2 Opened

Related Commands

set baudrate
set default

reset packets

To set accumulated packet counts to zero for one connection, use the reset packets command.

REset [connection | LAN] PACkets [ALl]

Syntax Description

connection	Reset accumulated packet counts to zero on the specified connection. If neither a connection number nor LAN is specified, packet counts for the connection associated with the current profile are reset.
LAN	Reset accumulated packet counts to zero on the LAN connection.
ALl	Reset all accumulated packets.

Default

None

Command Mode

Profile mode

Example

The following example resets the packet counts for profile 2503:

Host:2503> reset packets

Related Command

show packets

set baudrate

To configure the baud rate for the console port, use the set baudrate command.

SEt BAudrate 300 | 1200 | 2400 | 4800 | 9600 | 19200 | 38400

Syntax Description

300	Configure the console port for 300 baud.
1200	Configure the console port for 1200 baud.
2400	Configure the console port for 2400 baud.
4800	Configure the console port for 4800 baud.
9600	Configure the console port for 9600 baud.
19200	Configure the console port for 19200 baud.
38400	Configure the console port for 38400 baud.

Default

9600 baud

Command Mode

System mode

Example

The following example configures the console port for 2400 baud:

Host> set baudrate 2400

Related Command

reboot

set callduration

To place a limit on the length of time a data call is up, use the set callduration command.

SEt CALLDuration minutes

Syntax Description

minutes

Maximum duration of a call in minutes. Enter any value between 1 and 1430. A value of 0 turns off any configured limit on data call duration.

Default

None

Command Mode

System or profile mode

Usage Guidelines

The set callduration command is allowed only after system-level password authentication is complete.

This command does not affect voice calls.

Example

The following example sets the duration of a data call to 10 minutes:

Host> set callduration 10

Related Commands

set calltime
set password
show callduration

set calltime

To set the time of day when calls can be made or accepted, use the set calltime command.

SEt CALLTime [VOice | DAta] INcoming | OUTgoing [starttime | endtime]
SEt CALLTime [VOice | DAta] INcoming | OUTgoing OFf]

Syntax Description

VOice	Time-of-day parameters affect voice calls only.
DAta	Time-of-day parameters affect data calls only.
INcoming	Time-of-day parameters affect incoming calls only.
OUTgoing	Time-of-day parameters affect outgoing calls only.
starttime	Starting time of day when calls are allowed. The router uses a 24-hour clock, and the parameter is entered HH:MM format, where HH is a number from 0 to 23, and MM is a two-digit number from 00 to 59.
endtime	Ending time of day when calls are no longer allowed. Enter the parameter in HH:MM format, where HH is a number from 0 to 23, and MM is a two-digit number from 00 to 59.
OFf	Turn off any configured time-of-day limits on calls.

Default

None

Command Mode

System mode

Usage Guidelines

The system time on the router must be set correctly for this feature to be accurate and effective. System-level password authentication is required before the set calltime command is allowed. The router does not have an auxiliary power supply, such as a battery, to maintain the router clock. If you power-cycle the router, reenter the system date and time.

Example

The following example allows incoming voice calls from 8:00 am to 4:00 pm:

Host> set calltime voice incoming 08:00 16:00

Related Commands

set callduration
set date
set password
set sntp server
set time
show callduration
show calltime

set compression

To enable or disable data compression, use the set compression command.

SEt COmpression STac | OFf

Syntax Description

STac	Enable data compression.
OFf	Disable data compression.

Default

STac (enabled)

Command Mode

Profile mode

Usage Guidelines

Turn compression off if you are using High Level Data Link Control (HDLC) protocol.

Example

The following example disables compression for the profile 2503 connection:

Host:2503> set compression off

set date

To set the current date, use the set date command.

SEt DAte MM/DD/YYYY

Syntax Description

MM	A two-digit number from 01 to 12.
DD	A two-digit number from 01 to 31.
YYYY	A four-digit number from 1994 to 2020.

Default

The default date is 01/01/1995.

Command Mode

System mode

Usage Guidelines

You must reset the date every time the router is booted. The date appears during logging.

Example

The following example configures the date in the router for August 13, 1999:

Host> set date 08/13/1999

Related Command

set time

set default

To set all variable parameters to their default values, use the set default command.

SEt DEfault

Default

None

Command Mode

System or profile mode

Usage Guidelines

The set default command resets all parameters to their default values, deletes the user-defined profiles, sets the Auto_Config flag to FALSE, and reboots the router. Setting the Auto_Config flag to FALSE triggers the auto-configuration procedure in the power-up operation.

The auto-configuration feature allows the router to obtain the configuration file from a remote server by using Bootstrap Protocol(BOOTP). Upon power-up, the router examines the Auto_Config flag stored in nonvolatile RAM (NVRAM). If the Auto_Config flag is FALSE, the router initiates a BOOTP to request an IP address from the server when a connection is established. (If the flag is TRUE, the BOOTP request is not initiated.)

When the router and BOOTP and TFTP servers at the central site are set up, use ping to generate traffic and trigger the ISDN call. When the call is connected, the Cisco 700 series router sends a BOOTP request. If the server finds a matching MAC address from BOOTPTAB, the server returns a client profile that includes an IP address and configuration filename. The router initiates a TFTP client request, requesting the server download the configuration file. (The U.S. image requires SPID and switch configuration information before the ISDN connection can be established.)

After successfully loading the configuration file, the router sets the Auto_Config flag to TRUE in NVRAM. In a subsequent power-up operation, if the Auto_Config flag is TRUE, the router does not initiate BOOTP to request a configuration file from the server.

This should be done on the LAN side (Ethernet interface) only. If this operation fails, the Auto_Config flag remains FALSE. If this is done on the WAN side and there is a WAN/PPP connection established, this process is triggered repeatedly on the WAN link.

Example

The following example configures the router to default values:

Host> set default

Related Command

reboot

set echo

To enable and disable terminal echo of keyboard entries, use the set echo command.

SEt ECho ON | OFf

Syntax Description

ON	Enable terminal echo.
OFf	Disable terminal echo.

Default

On

Command Mode

System mode

Example

The following example disables terminal echo for the router:

Host> set echo off

set ipx trace

To convert IPX packets to hexadecimal values for troubleshooting purposes, use the set ipx trace command.

SEt IPX TRace length | OFf | ON

Syntax Description

length	Packet length (from 1 to 65535).
ON	Enable IPX packet conversion to hexadecimal numbers.
OFf	Disable IPX packet conversion to hexadecimal numbers.

Default

Off

Command Mode

Profile mode

Examples

The following example enables IPX trace and sets packet length to 4096:

Host> set ipx trace 4096 on

The following example disables IPX trace:

Host> set ipx trace off

set loopback

To create a loop from the Cisco 700 series router toward the remote router on the ISDN line, use the set loopback command.

SEt [connection] LOOpback ON | OFf

Syntax Description

connection	A connection number on which to create a loop. If no connection number is specified, a loop is created on the connection associated with the current profile. If the router cannot determine the connection number from the profile, the router displays an error message.
ON	Enable a loop.
OFf	Disable a loop.

Default

Disabled

Command Mode

System or profile mode

Usage Guidelines

This command is used with the test command for troubleshooting purposes. In system mode, this command must be used with the connection-number argument. The router displays an error message if a connection number is not specified. In profile mode, the command uses the connection number for the profile. Use the show connection command to display which profiles have a loopback.

Example

The following example creates a loopback on connection 1:

Host> set 1 loopback on

Related Commands

show connection
test

set screenlength

To set the maximum number of lines to display on the terminal, use the set screenlength command.

SEt SCreenlength lines

Syntax Description

lines

Maximum screen length to display on your terminal. The length can be from 2 to 128 lines.

Default

20 lines

Command Mode

System mode

Example

The following example configures the terminal to display 30 lines:

Host> set screenlength 30

Related Commands

set baudrate
set serialport

set serialport

To toggle the serial port to function as a configuration port or a TPAD (Controller PAD) port, use the set serialport command.

SEt SErialport TPad | COnfig

Syntax Description

TPAD	Set the serial port as a TPAD port.
COnfig	Set the serial port as a configuration port.

Default

COnfig

Command Mode

System mode

Usage Guidelines

When you enable the serial port as a TPAD, communications from a configuration terminal to the serial port are not possible. You can enter configuration commands by using Telnet. (Refer to the Cisco 700 Series Installation Guide for information on connecting a terminal to the router.)

To switch from TPAD mode to configuration mode, do one of the following:

•From the terminal connected to the serial port, enter ^A three times, followed by a Return to restore the prompt.

•From a Telnet session, enter the set serial config command.

Attention (AT) commands are entered at the prompt on the TPAD terminal.

There are two mode of operation in the TPAD implementation that respond to the enhanced point-of-sale system (EPOS), Verbose and Terse. In Verbose mode, the response is in strings, such as "CONNECT," "NO CARRIER," "BUSY" and so forth. In Terse mode the response is in numbers, such as 1 (CONNECT), 3 (DISCONNECT), 7 (BUSY), and so forth.

When the router is in TPAD mode, these responses are echoed to a terminal attached to the router serial port. Prior to software Release 4.3(1), the mode of operation was always verbose with echo on. In software Release 4.3(1), a series of TPAD commands were implemented to support RIVA functionality.

Multiple commands can be entered on a single line.

Table 2-1 AT Commands

Command	Description
ATV0	Response strings display in Terse mode (as numbers).
ATV1	Response strings display in Verbose mode (as strings). Default.
ATE0	Disable echoing commands.
ATE1	Enable echoing commands (default).
ATP	Pulse dial prefix.
ATDT	Tone dial prefix.
AT&F	Force factory defaults.
ATS7	Set carrier wait time.

The current state of the serial port can be displayed by using the show configuration command.

Example

The following example sets the serial port as a TPAD port:

Host> set serialport tpad 

Related Commands

set tpad parity
show configuration
show tpad

set systemname

To configure the router name as the system prompt and for Point-to-Point Protocol (PPP) authentication, use the set systemname command.

SEt SYstemname [systemname]

Syntax Description

systemname

Name used as the system prompt.

Default

No system name

Command Mode

System mode

Usage Guidelines

The system name is case sensitive and can be from 1 to 64 characters. If no system name is entered, the system name is blanked.

The system name identifies the router when making PPP connections to an Internet service provider (ISP) if there is no PPP client name in the profile defined with the set ppp clientname command. If a PPP client name is defined in the profile, the router uses the PPP client name for PPP authentication; the router retains the system name as part of the prompt. To delete the system name, enter the systemname command without an argument.

Example

The following example sets the system name to Host:

> set systemname Host

Host>

Related Command

set ppp clientname

set time

To set the current time, use the set time command.

SEt TIme HH:MM:SS

Syntax Description

HH	A two-digit number from 00 to 23.
MM	A two-digit number from 00 to 59.
SS	A two-digit number from 00 to 59.

Default

None

Command Mode

System mode

Usage Guidelines

The time must be reset whenever the router is rebooted.

Example

The following example configures the current time in the router:

Host> set time 08:48:20

Related Command

set calltime

set tpad parity

To select the communications parameters for TPAD, use the set tpad parity command.

SEt TPad PArity EVen | ODd | None

Syntax Description

EVen	7 data bits, 1 stop bit, and even parity.
ODd	7 data bits, 1 stop bit, and odd parity.
None	8 data bits, 1 stop bit, and no parity.

Default

None (8 data bits, 1 stop bit, and no parity)

Command Mode

System mode

Usage Guidelines

You can change parity of TPAD communications in software Release 4.1(2) and higher. (In software Release 4.1(1), serial port communication is limited to 8 data bits, 1 stop bit, and no parity.)

The TPAD protocol requires the following X.25 fixed parameters:

•LAPB (Link Access Procedure, Balanced)

•T1 Timer - 1 second

•N2 Retry Count - 2

•DTE only

•K frame count - 7

•Module 8 only

The X.25 protocol requires the following fixed parameters:

•Packet Size - 128 bytes

•VC - 1024 to 1279

•Window Size - 2

•Facility - No

•DTE only

•Reverse Charging - No

X.28 and other X.25 Packet Assembly Disassemblies (PADs) are not supported because there is no provision for protocol sensing.

The call direction is dial-out only. Incoming calls and two-way calls are not supported.

Cisco 700 series router software Release 4.2(1) supports Network User Information (NUI) and Network User Address (NUA), as described in British Telecom CardWay 0800 Phase 3 Access Platform specification.

Example

The following example sets the TPAD to even parity, 7 data bits, and 1 stop bit:

Host> set tpad parity even 

Related Commands

set serialport
show tpad

show

To display the configuration and the status of both ISDN B channels, use the show command.

SHow

Command Mode

System or profile mode

Usage Guidelines

In profile mode, the show command displays only the profile-based configuration parameters. Parameters that have been changed are indicated by an asterisk (*). Values without an asterisk are inherited from the profile template.

In system mode, the show command displays the profile template.

Example

The following example shows output from the show command in system mode:

Host> show

System Parameters

    Environment

      Screen Length          20

      Echo Mode              ON

      CountryGroup           1

    Bridging Parameters

      LAN Forward Mode       ANY

      WAN Forward Mode       ONLY

      Address Age Time       OFF

    Call Startup Parameters

      Multidestination       OFF

    Line Parameters

      Switch Type            5ESS

      Auto SPID and Switch Detection   OFF

    Call Parameters          Link 1             Link 2

      Retry Delay              30                 30

Profile Parameters

    Bridging Parameters

Bridging               ON

      Routed Protocols

      Learn Mode             ON

      Passthru               OFF

    Call Startup Parameters

    Line Parameters

      Line Speed             AUTO

      Numbering Plan         NORMAL

    Call Parameters          Link 1             Link 2

      Auto                     ON                 ON

      Called Number

      Backup Number

      Ringback Number

    CLICallback              OFF

Status    01/01/1995 00:01:00

Line Status

  Line DeActivated

  Terminal Identifier Unassigned

Port Status Interface Connection Link

  Ch:  1      Waiting for Call

  Ch:  2      Waiting for Call

Related Command

show configuration

show callduration

To show the current setting for call duration, use the show callduration command.

SHow CALLDuration

Default

None

Command Mode

System or profile mode

Example

The following example shows the time limit of a call:

Host> show callduration

Host> Call Duration Limit      10 min.

Related Commands

set callduration
show calltime

show calltime

To show the current of time-of-day limits on calls, use the show calltime command.

SHow CALLTime

Default

None

Command Mode

Profile mode

Example

The following example displays the call-time limits:

Host:2503> show calltime

 ***   Call Time Limits   ***

  DATA Calls            Starttime   Endtime

    Incoming               00:00       14:59

    Outgoing               00:00       23:59

  VOICE Calls           Starttime    Endtime

    Incoming               00:00       04:59

    Outgoing               00:00       20:59

Related Commands

set callduration
set calltime
show callduration

show configuration

To display a subset of the current configuration parameters, use the show configuration command.

SHow COnfig [ALl]

Syntax Description

ALl	Displays system configurations and profile configurations in both system mode and profile mode.

Command Mode

System or profile mode

Usage Guidelines

In profile mode, the show configuration command without an argument displays only profile-based configurations. Parameters that have been changed are indicated by an asterisk (*). Values without an asterisk are inherited from the profile template. To display the profile template, type the show command in system mode.

Example

The following example shows output from the show configuration command in profile mode:

Host> show config

System Parameters

    Environment

      Screen Length          20

      Echo Mode              ON

      CountryGroup           1

    Bridging Parameters

      LAN Forward Mode       ANY

      WAN Forward Mode       ONLY

      Address Age Time       OFF

    Call Startup Parameters

      Multidestination       OFF

    Line Parameters

	      Switch Type            5ESS

      Svc Profile ID 1       123123123

      Directory Number(s)    01123412345

      Auto SPID and Switch Detection   OFF

Call Parameters          Link 1             Link 2

      Retry Delay              30                 30

Profile Parameters

    Bridging Parameters

      Bridging               ON

      Routed Protocols       IP

      Learn Mode             ON

      Passthru               OFF

    Call Startup Parameters

    Line Parameters

      Line Speed             AUTO

      Numbering Plan         NORMAL

    Call Parameters        Link 1             Link 2            Link D

      Auto                 ON                 ON                OFF

      Permanent Mode       ON                 OFF               OFF

      Called Number

      Backup Number 

Related Command

show demand

show connection

To display all current connections, use the show connection command.

SHow CONNection

Command Mode

System mode

Example

The following example shows output from the show connection command:

Host> show connection

Connections    12/04/1996 17:49:38

    Start Date & Time   #  Name               #     Ethernet

  1 12/04/1996 00:00:00 #                     # 00 00 00 00 00 00

  2 12/04/1996 00:00:00 # Top                 #

            Link: 1 Channel: 1 telephone: 9018

            Link: 2 Channel: 2 telephone: 9018 

Table 2-2 describes the fields shown in the display.

Table 2-2 Show Connection Field Descriptions  

Field	Description
Connections	Connection number assigned by the router.
Start Date	Connection start date.
Start Time	Connection start time.
Name	System ID of the remote device.
Ethernet	Ethernet address of the remote device.

show demand

To display demand and timeout configurations, use the show demand command.

SHow DEmand

Command Mode

System or profile mode

Usage Guidelines

In profile mode, the show demand command displays only profile-based configurations. Parameters that have been changed are indicated by an asterisk (*). Values without an asterisk are inherited from the profile template. To display the profile template, enter the show command in system mode.

Example

The following example displays the profile template:

Host> show demand

Demand Calling Parameters        Link 1        Link 2

  Connection Type               Auto ON        Auto ON

  Threshold                        0 kbs         48 kbs

  Duration                         1 sec          1 sec

  Source                             LAN           BOTH

Timeout (call tear 
down) Parameters

  Threshold                        0 kbs         48 kbs

  Duration                           OFF            OFF

  Source                             LAN           BOTH

Related Commands

demand
set timeout
show
timeout

show memstat

To display the memory configuration, use the show memstat command.

SHow MEmstat

Command Mode

System mode

Usage Guidelines

The RAM size displays in hexadecimal. For example, a Cisco 700 series router with 1 MB displays 0x100000, and a router with 1.5 MB displays 0x180000.

lists the RAM size hexadecimal values reported by the show memstat command and the corresponding RAM size in megabytes.

Table 2-3 Device RAM Sizes

RAM Size (hex)	Memory
0x100000	1 MB
0x180000	1.5 MB
0x200000	2 MB

Example

The following example shows output from the show memstat command:

Host> show memstat

ID  0: Size:    10 Avail:    8 Max:    8 Used:    1 Addr: 0x000DDBA8

ID  1: Size:    30 Avail:   69 Max:   80 Used:   16 Addr: 0x000DDDE2

ID  2: Size:    18 Avail:   35 Max:   35 Used:    0 Addr: 0x000DE5A8

ID  3: Size:     4 Avail:   36 Max:   36 Used:    0 Addr: 0x000DE850

ID  4: Size:     8 Avail:  220 Max:  220 Used:    1 Addr: 0x000DE908

ID  5: Size:    32 Avail:  223 Max:  400 Used:  180 Addr: 0x000E0650

ID  6: Size:   268 Avail:   20 Max:   20 Used:    1 Addr: 0x000E2238

ID  7: Size:    20 Avail:   80 Max:   80 Used:    2 Addr: 0x000E3764

ID  8: Size:    14 Avail:  124 Max:  200 Used:   76 Addr: 0x000E41E0

ID  9: Size:    54 Avail:   38 Max:   50 Used:   17 Addr: 0x000E629A

ID 10: Size:     8 Avail:    1 Max:    2 Used:    1 Addr: 0x000EEC40

ID 11: Size:    54 Avail:    6 Max:    6 Used:    0 Addr: 0x000EEC70

ID 12: Size:   462 Avail:    4 Max:    4 Used:    0 Addr: 0x000EF588

ID 13: Size:   134 Avail:    2 Max:    2 Used:    0 Addr: 0x000F00C0

ID 14: Size:    68 Avail:    5 Max:    5 Used:    1 Addr: 0x000F0BB8

ID 15: Size:    96 Avail:    5 Max:    6 Used:    2 Addr: 0x000F0DA0

ID 16: Size:   112 Avail:    2 Max:    2 Used:    0 Addr: 0x000F0FA8

NVStore Used: 1203, Remaining 6989 (Deleted 77 + Unused 6912), Total 819
2

RamStore Used: 0, Remaining 10000, Total 10000

RAM Size = 0x180000

Available memory=517088, Allocs=119, Frees=0

MbufAllocs=0x5, MbufFrees=0x5, MbufFail=0x0

IbufAllocs=0x0, IbufFrees=0x0, IbufFails=0x0

MlenMax=0xe0, MlenAvail=0xe0, MlenLow=0xdf, MlenAllocs=0x5, MlenFails=0x
0

ZeroMax=0x0, ZeroAvail=0x0, ZeroLow=0x7fff, ZeroAllocs=0x0, ZeroFails=0x
0

show packets

To display packet count statistics, use the show packets command.

SHow [connection | LAn] PAckets

Syntax Description

connection	Display packet statistics for the connection number. If no connection number is entered, the router displays statistics for the current profile.
LAn	Display packet statistics for the LAN connection.

Command Mode

System or profile mode

Examples

The following example shows the statistics for connection 14:

host> show 14 packets

Packet Statistics for Connection 14

Filtered: 11013246 Forwarded: 8400 Received: 5993

Dropped: 263 Lost: 0 Corrupted: 0 Misordered: 1

Compression Ratio: 1.73:1

Ethernet Type: 0806 Count: 3375

Ethernet Type: 0800 Count: 979

Ethernet Type: 80f3 Count: 1068

Ethernet Type: 809b Count: 48718 

The following example shows statistics for the LAN connection:

Host> show lan packets

Packet Statistics for LAN

Filtered: 11001795 Forwarded: 12411637 Received: 25496880

Dropped: 0 Lost: 6911 Corrupted: 46 Misordered: 0

Ethernet Type: 0806 Count: 3375

Ethernet Type: 0800 Count: 979

Ethernet Type: 80f3 Count: 1068

Ethernet Type: 809b Count: 48718 

describes the fields.

Table 2-4 Show Packets Field Descriptions  

Field	Description
Filtered	Packets received by the bridge engine and not forwarded.
Forwarded	Packets forwarded to specified connection.
Received	Packets received from the specified connection.
Dropped	Packets received from the connection and dropped because the queue of packets to be forwarded was too long.
Lost	Packets received from the connection but not successfully transmitted (often because of a faulty Ethernet connection).
Corrupted	Packets received from the connection with a bad checksum (CRC) that were discarded as corrupted.
Misordered	Packet received out of sequence when using ordered or fragmented protocol.
Compression	Packets compressed.
Ethernet Type	Broadcast packet types received.
Count	Number of packets of this type received.

show tpad

To display the TPAD parity, use the show tpad command.

SHow TPad

Default

None

Command Mode

System or profile level

Example

The following example displays the TPAD parity setting:

Host> show tpad

TPAD Serial Port Parity     :NONE

TPAD Echo Response          :ON

TPAD Response Mode          :Verbose Mode

TPAD Carrier Wait Time  :10 seconds

Related Commands

set serialport
set tpad parity

show users

To display all profiles and their status, use the show users command.

SHow USers

Command Mode

System mode

Example

The following example shows output from the show users command:

Host> show users

User                   State      Connection

--------------------------------------------

LAN                    Active     LAN

Internal               Active     INTERNAL

Standard               Active     1

tomd                   Inactive

describes the fields shown in the display.

Table 2-5 Show Users Field Descriptions  

Field	Description
Profile Name	Name of profile.
State	Active or inactive.
Connection	Name or number of the connection assigned to the profile.

swl

To download new router software or configuration files across a TCP/IP network using Trivial File Transfer Protocol (TFTP) or through the configuration port using a serial cable link, use the swl command.

SWL [TFTP] [CONFIG] [ipaddress filename]

Syntax Description

TFTP	Load the software across a TCP/IP network by using TFTP or use the router as a TFTP server, depending on the status of the ipaddress and filename parameters. When the parameters are not included, the router is a TFTP (proxy) server.
CONFIG	Load a configuration file across a TCP/IP network by using TFTP.
ipaddress	TFTP server IP address used when the router acts as a TFTP client. When the ipaddress is included, the filename must also be included.
filename	Name of the software image file when the router acts as a TFTP client during download. The filename should include the directory path if the file is not in the server default directory. When the filename is included, the ipaddress must also be included.

Default

None

Command Mode

System mode

Usage Guidelines

The swl command assumes that communications occur through the configuration port. (See Cisco 700 Series Installation Guide for information on connecting a terminal to the router.)

The swl tftp command assumes that communications occur through a TFTP server.

The swl tftp command loads the software across a TCP/IP network by using TFTP when the ipaddress and filename are included. The command sets the router as a TFTP proxy server when an ipaddress and filename are not included. The software or configuration file must be stored on a client server. (TFTP server mode times out in 1 minute.)

On the TFTP client, you must use binary file transfer mode to transfer the software file. If the transfer is successful, the router reboots using the downloaded software and the downloaded configuration (if a configuration file was also downloaded). If the transfer was not successful, the router displays an error message or fails to boot, and the software must be reloaded.

The TFTP client and TFTP server implementation is based on RFC 1350. TFTP timeout interval and transfer size options are not implemented.

Examples

The following example loads the operating system software in the router through a serial connection from the terminal to the configuration port. (You can use an ASCII terminal or a personal computer running terminal emulation software.)

To load software with the swl command, follow these steps:

---

Step 1 Connect your terminal to the configuration port on the router.

Step 2 Set the baud rate for the terminal to 9600 and the protocol to 8N1.

Step 3 Turn on power to the router. The router boots, and when the boot process is complete, the router displays a prompt.

Step 4 Enter the swl command:

Host> swl

You are prompted to verify that you are downloading the software image.

Step 5 Enter y to continue:

Are you sure? y

You are prompted for the baud rate.

BOOT version 2.0(1) 04-16-96 12:03:06

Copyright (c) 1993-1996. All rights reserved.

Ready to upload new firmware into flash. Select baud rate:

	1 -    300 baud

    	2 -   1200 baud

    	3 -   2400 baud

    	4 -   4800 baud

    	5 -   9600 baud

    	6 -  19200 baud

    	7 -  38400 baud

    	8 -  57600 baud

    	9 - 115200 baud

Step 6 At the prompt, enter one of the baud rates listed (do not press the Return key), and make sure that the load rate you choose is supported by your terminal emulation software. Table 2-6 shows the approximate software load times.

Table 2-6 Approximate Software Load Time 

Load Rate (Baud)	Approximate Time (Minutes)
2400	48
9600	12
19200	6
38400	3
57600	2
115200	1

Step 7 Change the baud rate of the terminal to the appropriate download rate.

Step 8 Set the protocol to ASCII on the terminal.

Step 9 Download the file containing the new software to the router by following the prompts on your terminal. (The LINE LED blinks throughout the loading process.)

You are prompted to change the terminal baud rate to 9600.

Change settings to 8n1/9600 baud and press a key

Step 10 Change the baud rate of the terminal emulation software to the appropriate baud rate and press any key.

When the download is successful, the LINE LED turns off, and the RDY LED turns on. If the download was not successful, use Table 2-7, which shows symptoms and possible solutions.

Table 2-7 Software Download Command Troubleshooting  

Symptom	Probable Cause and Solution
Download takes significantly longer than the approximate time listed in Table 2-6.	The terminal emulation program interline and intercharacter delays are not set to zero. If the load was successful, no further action is necessary. If the load was terminated prematurely, reset the interline and intercharacter delays to zero, and reload the software.
The terminal displays unrecognizable text after the download is completed.	The terminal has not been reset to 9600 baud. Reset the terminal any time after loading the new software. After changing the terminal baud rate, press Return to gain access to the standard prompt (>).
Two or more LEDs are blinking.	Incorrect configuration of the PC COM port or a defective console cable. Press Esc on the keyboard, and try to load the software again.

TFTP File Transfer Example

The following example shows the transfer of an image by using TFTP. The router is the server and the workstation is the client. (Before beginning this procedure, configure your workstation to operate as a TFTP client. In server mode, the workstation only accepts put requests for the file.

---

Step 1 Check the file directory to confirm that the new software and, optionally, the new configuration file are installed on the TFTP server.

Step 2 Ping the TFTP server from the router to confirm that the router can be reached from the client machine:

Host> ping clientipaddress

---

Caution   

When the swl tftp command is entered, the existing software is erased. If a catastrophic event such as a power failure occurs before the file transfer is complete, the router must be initialized through the configuration port.

---

Step 3 Enter the swl tftp command to load the software image on the router:

Host> swl tftp 171.69.91.33 foxus.fl

Are you sure? y

Host>

SWL TFTP: Starting transfer ...

SWL TFTP: Transfer successful.

Image received successfully.

Burning flash, standby (15 seconds max.) ...

The software is downloaded. You can follow the same procedure using the swl tftp config command to download a configuration:

Host> swl tftp config 171.69.91.33 efoxcfg.txt

Are you sure? y

Host>

SWL TFTP: Starting transfer ...

SWL TFTP: Transfer successful.

SWL TFTP: Erasing old configuration.

Host>  Connection 1 Closed

Host>  Connection 2 Closed

Host>  Connection 3 Closed

Host>  Connection 4 Closed

Host>

SWL TFTP: Setting new configuration.

Configuration Load Example

The following example loads a configuration. (The example uses Terminal for Windows, a commonly used terminal emulation program. You can use other terminal emulation software.) Although this is not part of the swl command, the following example is provided for your convenience:

---

Step 1 From the terminal emulation program, go to the Setting menu, and select Text Transfer. The Text Transfer dialog box appears.

Step 2 Set flow control to Line at a Time, and set Delay Between Lines to 0.5 to 1 second.

Step 3 Click OK.

Step 4 From the Transfer menu, select Send Text File.

Step 5 Select the file to be loaded.

Step 6 Click OK. The parameters are transferred to your router.

Step 7 If errors occur during the transfer, enter the set default command, increase the delay between lines, and repeat the procedure for loading the configuration beginning with Step 1.

Related Command

show security

test

To generate test packets, use the test command.

TEst [connection] [WAn | ALl] [STop | REsult | ETher] RAte pps [MInpkts bytes MAxpkts bytes]

Syntax Description

connection	Number of the connections where test packets are generated.
WAn	Generate test packets on the (WAN) ISDN line. Packets should be sent to a WAN switch that has a loopback enabled. Compare number of sent packets to number of received packets.
ALl	Generate test packets on both the ISDN line and on the LAN.
STop	Stop all test packets from being generated.
REsult	Display results of last completed test.
ETher	Generate test packets on the LAN and compare the number of sent packets to the number of received packets.
RAte	Rate in packets per second (pps) at which test packets are generated. The rate can be between 1 and 100; the default value is 10.
MInpkts	Minimum size (in bytes) of test packets. The size can be between 60 and 1514; the default value is 60. Packets are generated in incrementally larger sizes, starting with the minimum size and ending with the maximum size. After the maximum length is reached, the next packet is the minimum size.
MAxpkts	Maximum size in bytes of test packets. The size can be between 60 and 1514; the default value is 1514.

Default

None

Command Mode

System mode

Example

The following example enables a test on the ISDN line and the LAN with a minimum packet size of 255 bytes and a maximum packet size of 1024 bytes:

Host> test all min 255 max 1024

upload

To send a set of ASCII strings containing the current configuration to the terminal or TFTP client, use the upload command.

UPload [TFTP ipaddress filename]

Syntax Description

TFTP	Upload the configuration across a TCP/IP network by using TFTP. The output goes to the console port if this parameter is not included.
ipaddress	TFTP server IP address.
filename	Name of the file where the router configuration is to be stored on the TFTP server. The filename field should include the directory path if the file is not in the default directory of the server.

Default

None

Command Mode

Profile mode

Usage Guidelines

The upload command (without any parameters) sends the current configuration to the console port. The upload tftp command uploads the configuration through a TFTP client.

You can use the captured file to reconfigure the router after loading new software or to configure multiple routers with the same parameters.

Set the ASCII download for 1 second so that each line is correctly processed.

Password and secret information are encrypted for security reasons. If you are reloading a configuration into a router for reconfiguration, all password and secret information is loaded.

Example

The following example uses TFTP to send the router configuration to IP address 10.1.1.1, filename 700ted.cfg:

Host> upload tftp 10.1.1.1 700ted.cfg

Related Commands

set default
set echo
swl

version

To display the software release level and date, use the version command.

VErsion

Default

None

Command Mode

System or profile mode

Example

The following example shows output from the version command:

Host> version

Software Version c760-in.r.US 4.2(1) - Aug 13 1998 08:34:02

Cisco 761

ISDN Stack Revision US 2.10 (5ESS/DMS/NI-1)

Copyright (c) 1993-1997 by Cisco Systems, Inc.  All rights reserved.

Software is used subject to software license agreement contained

with this product. By using this product you agree to accept the

terms of the software license.

Hardware Configuration:

   DRAM:  1.5MB

   Flash: 0.5MB

   POTS:  Type 2 (Rev. Unknown)

   NT1:   Not Installed

   ROM:   2.1(1) ALPHA-7

lists the specific types of basic telephone service (POTS) used in each country.

Table 2-8 POTS Types and Countries  

Board Types	Countries
Type 0	Mexico, United States
Type 1	Canada, Japan, Korea, Netherlands, Singapore, Taiwan
Type 2	Austria, Belgium, Denmark, Finland, France, Germany, Greece, Hong Kong, Ireland, Italy, Luxembourg, Norway, Portugal, Spain, Switzerland, United Kingdom