[Top][Contents][Prev][Next][Last]Search


MAX TNT Command Reference


This chapter provides complete information about the MAX TNT commands. The information is designed for quick reference, and does not include tutorials. All commands are listed alphabetically. For an overall alphabetic listing, see the general table of contents.

You can display a usage summary for any command by entering a question mark and the name of the command:

admin> ? command-name
For an alphabetic list of commands, just enter a question mark:

admin> ?

Note: If the list of commands displayed as output does not include all of the commands described in this chapter, you might need to authenticate a User profile that has more extensive permissions. For details, see Auth.

?

Description: Displays a list of all available commands, or help text about a specific command. A list of all available commands also shows the permission level required for the use of each command.

Permission level: User

Usage: ? [-a]|[command-name

Option

Description

-a
List all commands. (Without this option, the list includes only commands authorized by the current User profile.)

command-name
Display information about the specified command.

]

Example: To display a list of commands authorized for your current login:

admin> ?
? ( user )
auth ( user )
callroute ( diagnostic )
clear ( user )
clock-source ( diagnostic )
clr-history ( system )
connection ( system )
date ( update )
debug ( diagnostic )
delete ( update )
device ( diagnostic )
dir ( system )
dircode ( system )
ether-display ( diagnostic )
fatal-history ( system )
format ( code )
fsck ( code )
get ( system )
hdlc ( system )
help ( user )
if-admin ( diagnostic )
igmp ( system )
[More? <ret>=next entry, <sp>=next page, <^C>=abort]
To display help text about a command:

admin> ? dir
dir list all profile types
dir profile-type list all profiles of the specified type
dir profile-type profile-index list the specified profile instance
Dependencies: The current security level is set by the current User profile and determines which commands are displayed in response to the ? command. If the current User profile does not have sufficient privileges to execute a command, that command is not displayed unless you include the -a option. By default, commands with the User security level are always displayed. For details, see Auth.

See Also: Help, Auth

ARPtable

Description: Displays or modifies the MAX TNT Address Resolution Protocol (ARP) table. Each entry in the ARP table associates a known IP address with a physical address. For remote IP addresses, the MAX TNT can use the ARP table to respond with its own MAC address to ARP requests.

Permission level: System

Usage: arptable [-a IP_address MAC_address]|[-d IP_address]|[-f]

Option

Description

-a IP_address 
MAC_address
Add an ARP table entry for the device with the specified IP address and MAC address.

-d IP_address
Delete the ARP table entry for the device at the specified IP address.

-f
Clear the ARP table.

Example: To display the ARP table:

admin> arptable
IP Address MAC Address Type IF Retries/Pkts/RefCnt Time Stamp
10.103.0.2      00:C0:7B:7A:AC:54    DYN   0        0/0/552          22760
10.103.0.220 00:C0:7B:71:83:02 DYN 0 0/0/2791 22760
10.103.0.1 08:00:20:7B:24:27 DYN 0 0/0/4296 22811
10.103.0.8 00:00:0C:05:B3:A2 DYN 0 0/0/6493 23058
10.103.0.7 00:00:0C:76:58:4E DYN 0 0/0/6572 23233
10.103.0.49 00:C0:80:89:19:95 DYN 0 0/0/397 23208
The ARP table displays the following information:

Column

Description

IP Address
The address contained in ARP requests.

MAC Address
The MAC address of the host.

Type
How the address was learned, that is, dynamically (DYN) or by specification of a static route (STAT).

IF
The interface on which the MAX TNT received the ARP request.

Retries
The number of retries needed to refresh the entry after it timed out.

Pkts
The number of packets sent out to refresh the entry after it timed out.

RefCnt
The number of times the MAX TNT consulted the entry.

Time Stamp
The number of seconds since the system has come up. The MAX TNT updates this column every time an ARP entry is refreshed.

To add an ARP table entry for a device with the physical address 00A024A61535 at IP address 10.9.8.20:

admin> arptable -a 10.9.8.20 00A024A61535
See Also: NSlookup

Auth

Description: Authenticates your current login by applying a specified User profile. Use this command to increase or decrease the permissions of the current login. For information about permission levels in User profiles, see the description of the User profile.

Permission level: User

Usage: auth user-name

Option

Description

user-name
Authenticate the specified User profile.

Example: To login as Joe:

admin> auth joe
Password:
If you supply the proper password for the User profile you've specified, the MAX TNT enables the privileges in that profile and then displays the system prompt again. Note that the User profile may specify its own system prompt, which is a useful way to flag certain permission levels. For example:

admin> auth admin
Password:
If you supply the wrong password at the prompt, you'll see the following message:

Login incorrect
User:
Enter the user name again to display the Password prompt.

See Also: Whoami

BRIchannels

Description: Displays the status of all the BRI channels on the MAX TNT.

Permission level: System

Usage: brichannels -a|-d|-c|-i

Option

Description

-a
Display all available BRI channels.

-d
Display disabled BRI channels.

-c
Display all possible BRI channels.

-i
Display in-use BRI channels.

Example: To display all BRI channels, specify the -a option:

admin> brichannels -a
The BRIchannels command displays the following information:

Column

Description

dvOp
The current operational state of the channel (also specified by the Device-State setting):

  • Down indicates that the channel is in a nonoperational state.

  • Up indicates that the channel is in normal operations mode.

dvUpSt
The status of a channel in normal operations mode:

  • Idle indicates that no call is on the line.

  • Reserved indicates that the channel is reserved for an incoming call.

  • Assigned indicates that the channel is handling a call.

dvRq
The required state of the channel as specified by the Reqd-State setting:

  • Down indicates that the channel is required to be in a nonoperational state.

  • Up indicates that the channel is required to be in normal operations mode.

SAdm
The desired administrative state of the channel (also specified by the Desired-State setting):

  • Down specifies that the channel should terminate all operations and enter the down state.

  • Up specifies that the channel should come up in normal operations mode.

The actual state of the channel can differ from the desired state, as when a device is powering up, or you change the desired state on a running slot. Changing the desired state does not force a channel to the new state. It indicates that the MAX TNT should change the channel state in a graceful manner.

BRIdisplay

Description: Displays D-channel traffic for an IDSL card. You must first execute the Open command to open a session with the card.

Permission level: Diagnostic

Usage: bridisplay count [channel]

Syntax element

Description

count
The number of bytes to display.

channel
A number from 0 to 31, specifying one of 32 D channels on the IDSL card. If you specify a channel number, only traffic on that D channel is displayed. If you do not specify a channel number, all traffic on all D channels is displayed.

Example: The following commands open a session with an IDSL card in slot 7, and display up to 12 bytes of the traffic in every D channel on the card:

admin> open 1 7
idsl-1/7> bridisplay 12
To turn off the display, set count to zero:

idsl-1/7> bridisplay 0

CADSLlines

Description: Displays all ADSL-Cap lines, including disabled, busy, and unused channels.

Permission level: System

Usage: cadslLines -a|-d|-f|-u

Option

Description

-a
Display all channels.

-d
Display all disabled channels.

-f
Display all free channels.

-u
Display all in-use channels.

Example: To display all ADSL-Cap channels:

admin> cadsllines -a
All CAP ADSL lines:
(OperState UpStatus ReqState AdminState)
  Line {  1 14  1 }     (Down        Idle        UP          UP    )
Line { 1 14 2 } (Down Idle UP UP )
Line { 1 14 3 } (Down Idle UP UP )
Line { 1 14 4 } (Down Idle UP UP )
Line { 1 14 5 } (Down Idle UP UP )
Line { 1 14 6 } (Down Idle UP UP )
The output contains the following fields:

Field

Description

OperState
The current operational state of the channel (also specified by the Device-State setting):

  • Down indicates that the channel is nonoperational.

  • Up indicates that the channel is in normal operations mode.

UpStatus
The status of a channel in normal operations mode:

  • Idle indicates that no call is on the channel.

  • Active indicates that the channel is handling a call.

ReqState
The required state of the channel as specified by the Reqd-State setting:

  • Down indicates that the channel is required to be nonoperational.

  • Up indicates that the channel must be in normal operations mode.

AdminState
The desired administrative state of the channel (also specified by the Desired-State setting):

  • Down specifies that the channel should terminate all operations and enter the down state.

  • Up specifies that the channel should come up in normal operations mode.

The actual state of the channel can differ from the desired state, as when a device is powering up, or you change the desired state on a running slot. Changing the desired state does not force a channel to the new state. It indicates that the MAX TNT should change the channel state in a graceful manner.

Callroute

Description: Displays the call-routing database (the total set of all Call-Route profiles). For information about how call routing works and about how to create Call-Route profiles, see the description of the Call-Route profile, and refer to the MAX TNT Hardware Installation Guide.

Permission level: Diagnostic

Usage: callroute -ah|-an|-ad|-d|-t|-?

Option

Description

-ah
List available host-side call routing entries.

-an
List available network-side call routing entries.

-ad
List available host-side and network-side call routing entries.

-d
List call routing tables by device.

-t
Toggle module debug level.

-?
Display a usage summary.

Example: In the following display, the output shows host-side call routing entries directed to a modem card. All the entries are defaults, except for one Call-Route profile that specifies an inbound phone number.

admin> callroute -ah
device      # source     type               tg sa phone
1:12:02/0 0 0:00:00/0 any-call-type 0 0 4812
1:12:01/0 0 0:00:00/0 voice-call-type 0 0
1:12:03/0 0 0:00:00/0 voice-call-type 0 0
...
1:12:47/0 0 0:00:00/0 voice-call-type 0 0
1:12:48/0 0 0:00:00/0 voice-call-type 0 0
A zero or null field always means any. The call-routing database displays the following information:

Column

Description

Device
Interface address to which the MAX TNT routes the incoming or outgoing call. Host-side addresses show incoming-call routes, while network-side addresses show outgoing-call routes.

When the MAX TNT has an incoming route for a call, it answers the call, and the host-side address points to the device (such as a modem or HDLC processor) that terminates the WAN circuit. When the MAX TNT places an outgoing call, the network-side address points to the line on which the call goes out.

#
Entry number in the call-routing database.

Source
The network-side address at which the incoming call connects to the MAX TNT, or the host-side interface address at which the outgoing call originates.

Type
Call-route type, which can be any-call-type, voice-call-type (voice bearer capability), digital-call-type (data bearer service), or trunk-call-type.

TG
Trunk-group number.

SA
Subaddress number.

Phone
Add-on number.

See Also: Modem, HDLC, Show, T1channels

Clear

Description: Clears the terminal session screen and places the system prompt at the top row of the VT100 window.

Permission level: User

Usage: clear [-r]

Option

Description

-r
Reset the terminal session's VT100 attributes.

Example: To clear the screen:

admin> clear

Clock-Source

Description: Displays the current clock-source settings for the system. If a line is specified as the master clock-source, it provides the source of timing information for synchronous connections throughout the multishelf system. The clock allows the sending device and the receiving device to determine where one block of data ends and the next begins. If multiple lines specify that they are eligible to be the clock-source, you can assign clock-source priority among multiple lines. In the output of the Clock-Source command, the value 1 signifies the highest priority. For information about setting clock-source priority, see the MAX TNT Hardware Installation Guide.

The Clock-Source command applies to units with T1, E1, T3, or FrameLine cards. It lists only currently eligible local clock sources. Sources with layer 2 up, which are preferred, are marked with an asterisk. In addition, a message is logged whenever the system clock source changes. You can execute this command on the shelf controller or on an individual T1, E1, T3, or FrameLine card. You must first execute the Open command to open a session with the card.

Permission level: Diagnostic

Usage: clock-source

Example: The Clock-Source command on the shelf controller shows the master clock's slot card line number:

admin>  clock-source
Master line: 1
Source List:
Source: line 1 Available* priority: 2
Source: line 3 Available priority: 2
On the slot cards, the Clock-Source command uses one-base indexes for the card's lines. For example, to open a session with a T1 card and display its clock-source settings:

admin> open 1 1
t1-1/15> clock-source
Master line: 1
Source List:
Source: line 1 Available* priority: 2
Source: line 3 Available priority: 2
Following are examples of log messages generated for clock-source transitions:

LOG notice, Shelf 1, Controller, Time: 19:44:39--
Master clock source changed to slot-1/8 line 1
LOG notice, Shelf 1, Controller, Time: 10:34:56--
Master clock source changed to local oscillator
See Also: Line, Open, T1channels

Clr-History

Description: Clears the fatal-error history log.

Permission level: System

Usage: clr-history

Example: To display the fatal-error history log, enter the Fatal-History command:

admin> fatal-history
OPERATOR RESET:  Index:  99  Revision: 1.0F Controller (tntsr)
Date: 09/20/1997. Time: 16:56:01
Reset from unknown, user profile super.
OPERATOR RESET: Index: 99 Revision: 1.0F Controller (tntsr)
Date: 09/24/1997. Time: 11:56:10
Reset from unknown, user profile super.
To clear the log:

admin> clr-history
The log is now empty:

admin> fatal-history
admin> 
See Also: Fatal-History

Connection

Description: Specifies that the upper-left portion of the status window should display connection status information. If the status window is not already displayed, this command opens it with the connection status information displayed.

Permission level: System

Usage: connection

Example: An administrator opens a window with connection status information displayed:

admin> connection

For each active connection, the displays includes a line that shows the user or station name, type of connection, T1 shelf/line/channel on which the call was placed or received, and the bandwidth or baud rate. You can press the Down-Arrow key to scroll through the list of active connections.

To display a prompt below the status window, press the Escape key. To close the status window, enter the Status command:

admin> status
See Also: Line, List, Log, Status, View

Date

Description: Displays or sets the MAX TNT system date and time. The date and time are stored in the Timedate profile.

Permission level: Update

Usage: date [yymmddhhmm]

Option

Description

yy
A two-character representation of the current year

mm
A two-character representation of the current month

dd
A two-character representation of the current day

hh
A two-character representation of the hour

mm
A two-character representation of the minute

Example: To set the MAX TNT system date and time to noon, December 31, 1997:

admin> date 9712311200

Debug

Description: Enables or disables diagnostic output.

Permission level: Diagnostic

Usage: debug on | off

Syntax element

Description

on
Enables diagnostic output.

off
Disables diagnostic output.

Example: To enable diagnostic output:

admin> debug on
Diagnostic output enabled
admin> FRMAIN: Setting timer DCE
FRMAIN: time 88121200, mkstatus type 1, seq (026,025)

Delete

Description: Permanently deletes a profile from local storage. Any flash space that was used by the profile becomes available to the system.

Permission level: Update

Usage: delete [-f] profile-type [profile-index]

Syntax element

Description

-f
Delete without prompting for confirmation.

profile-type
A type of profile, as listed by the Dir command.

profile-index
The index of the specified profile type. Not all profile types require an index.

Example: To delete the Connection profile previously created for Tom Lynch:

admin> delete conn tlynch
Delete profile CONNECTION /tlynch? [y/n] y
CONNECTION /tlynch deleted
admin>
See Also: Get, New, Read

Device

Description: Initiates a state change in a specified device. The device is specified by its interface address. This command is typically used to administratively up or down a device. For a list of devices supported by the MAX TNT, see the description of the Device-Address parameter.

Permission level: Diagnostic

Usage: device -d|-t|-u|-? interface_address

Option

Description

-d
Bring the specified device down.

-t
Toggle debug output level.

-u
Bring the specified device up.

-?
Display a usage summary.

interface_address
The interface address of the device, specified as shelf, slot, item number, and logical item number.

Example: To administratively down modem #24 in slot #3 on shelf #1:

admin> device -d {{1 3 24} 0}
See Also: Show, Slot

Dir

Description: Lists profiles. With no options, the Dir command lists all profile types supported by the MAX TNT. It can also be used to list all profiles of a certain type, or to list file-system information about a specific profile.

Permission level: System

Usage: dir [profile-type [profile-index]]

Option

Description

profile-type
List all the profiles of the specified type.

profile-index
Display information about the specified profile.

Example: To list all profile types, enter the Dir command with no options:

admin> dir
ADMIN-STATE SNMP Administrative State
ADSL-CAP Cap adsl line parameters
ADSL-CAP-STAT Cap Adsl line status
ADSL-CAP-STATISTICS Cap adsl Interface Statistics
ADSL-CAP-STATUS Cap adsl Interface Status
ANSWER-DEFAULTS Answer profile
ATALK-GLOBAL Global Appletalk parameters
ATALK-INTERFACE Appletalk interfaces
ATMP ATMP profile
BASE System version and enabled features
CALL-INFO Active call information
CALL-LOGGING Call logging
CALL-ROUTE Call routing attributes
CONNECTION Connection (WAN) profiles
DEVICE-STATE Device Operational State
ETHER-INFO Ethernet Interfaces Information
ETHERNET Ethernet Interfaces Configuration
EXTERNAL-AUTH External authentication info
FILTER Filter Profile
FIREWALL Firewall Profile
FRAME-RELAY Frame-Relay link configuration
IDSL BRI line parameters
IDSL-STAT BRI line status
IP-GLOBAL Global TCP/IP parameters
IP-INTERFACE IP interfaces
IP-ROUTE Static IP routes
IPX-GLOBAL Global IPX parameters
IPX-INTERFACE IPX interfaces
IPX-ROUTE Static IPX routes
IPX-SAP-FILTER IPX Sap Filters
LAN-MODEM LAN Modem Disable State
LOG System event logging configuration
SDSL Sdsl line parameters
SDSL-STAT Sdsl line status
SDSL-STATISTICS Sdsl Interface Statistics
SDSL-STATUS Sdsl Interface Status
SERIAL Serial interfaces
SLOT-INFO Slot Info profile
SLOT-STATE Slot Operational State
SLOT-TYPE Slot Type profile
SNMP SNMP configuration
SWAN Swan line parameters
SWAN-STAT Swan line status
SYSTEM System-wide basic parameters
T1 DS1 line parameters
T1-STAT DS1 line status
T3 DS3 line parameters
T3-STAT DS3 line status
TERMINAL-SERVER Terminal server parameters
TIMEDATE Current system date and time
TRAP SNMP trap destinations
USER Administrative user accounts
To list all Connection profiles, as well as all RADIUS profiles for nailed-up connections, specify conn as the profile type. For example:

admin> dir conn
169 08/31/1997 22:21:07 dallas
195 09/12/1997 10:14:08 chicago
189 11/14/1997 09:34:44 nyc1
177 11/14/1997 11:38:09 nyc2
187 10/22/1997 15:34:53 la
201 10/14/1997 14:29:32 sacto
This form of the command is useful for displaying valid profile indexes. The index is in the rightmost field. The listing includes the following information:

To list information about a specific profile, include its index on the command line:

admin> dir conn dallas
169 08/31/1997 22:21:07 dallas
See Also: List, Get

Dircode

Description: Displays the contents of the PCMCIA flash-card code directory. The flash cards contain code for the slot cards, run-time shelf controller, and profiles. The system configuration is stored in the onboard NVRAM.

Permission level: System

Usage: dircode

Example: To display the contents of the flash-card code directory:

admin> dircode
Flash card code directory:
Card 1, directory size 16
slot-card-8t1 reg good 146634 Dec 26 10:15 v1.2
slot-card-8e1 reg good 259484 Jan 16 21:58 v1.2
slot-card-48modem reg good 386566 Dec 26 10:15 v1.2
slot-card-192hdlc reg good 457360 Jan 5 12:21 v1.2
The information displayed by this command includes the card number (1 or 2) and the size of the code directory. For each expansion module installed in the system, it also shows the following information:

See Also: Format, Fsck, Load

DNStab

Description: Displays the local DNS host table, which supplies host IP addresses when DNS fails to successfully resolve a hostname. This table is not a DNS cache, but a fallback option, listing up to eight host addresses for important or frequently used connections.

Permission level: System

Usage: dnstab -s [entry-number]

Option

Description

-s
Display the local DNS table.

entry-number
Display an entry from the local DNS table. You can specify an integer from 1 to 8.

Example: To display the local DNS table:

admin> dnstab -s
Local DNS Table:enabled, AutoUpdate: enabled.
Local DNS Table
 Name                      IP Address       # Reads Time of last read
__________________________ _________________ ________ _______________
1: "barney" 200.65.212.12 * 2 Feb 10 10:40:44 97
2: "rafael" 200.65.212.23 3 Feb 10 9:30:00 97
3: "donatello" 200.65.212.67 1 Feb 11 11:41:33 97
4: "wheelers" 200.65.212.9 1 Feb 12 8:35:22 97
5: "tiktok" 200.65.212.148 4 Feb 12 7:01:01 97
6: "" ------- - ---
7: "wilma" 200.65.212.8 10 Feb 15 10:02:58 97
8: "" ------- - ---
The output contains the following fields:

Field

Description

Local DNS Table
Specifies whether Enabled=Yes in the DNS-Local-Table subprofile of the IP-Global profile.

AutoUpdate
Specifies whether Auto-Update=Yes in the DNS-Local-Table subprofile of the IP-Global profile.

Name
Hostname.

IP address
IP address. An asterisk (*) indicates that the entry has been automatically updated by a DNS query.

# Reads
Number of accesses since the entry was created.

Time of last 
read
Time and date the entry was last accessed. If SNTP is not in use, the field contains hyphens.

DS3link

Description: Enables you to carry out a diagnostic session with the DS3 card. You must first execute the Open command to open a session with the card.

Permission level: Diagnostic

Usage: ds3link -a|-c|-d|-l|-i|-s|-t|-?

Option

Description

-a 
Display current DS3 line alarms.

-c 
Display and clear line error statistics.

-d 1-7 
Display current DS2 line state.

-l on|off 
Perform an external loopback test.

-i on|off
Perform an internal loopback test.

-s 
Display line error statistics without clearing.

-t 
Toggle debug output.

-? 
Display summary.

Opening a session with a DS3 card

Before you can use the DS3link command, you must open a session with the card on which you wish to perform diagnostics. For example, to open a session with the card in slot 15 on shelf 1:

admin> open 1 15
t3-1/15>

Displaying alarms on the DS3 line

To display alarms on the line, specify the -a option. For example:

t3-1/15> ds3link -a
Loss of Signal: false
Out of Frame: false
Alarm Indication Signal: false
Idle Signal: false
Yellow Signal: false
In Red Alarm: false
C-bit parity framing: false
An alarm condition of true has the following significance:

Alarm

Description (if the condition is true)

Loss of Signal 
The DS3 line is not functioning. A sequence of 175 consecutive zeroes was detected.

Out of Frame 
The DS3 line cannot receive or transmit data because the MAX TNT has lost the frame alignment on the received signal.

Alarm Indication 
Signal (AIS) 
A device on the line has sent the AIS signal, rather than regular data, in order to take the line out of service.

Idle Signal 
The remote device has no data to send.

Yellow Signal
Also called Remote Alarm Indicator, (RAI). A device on the DS3 line is detecting framing-error conditions in the signal it receives.

In Red Alarm 
An out-of-frame condition has lasted for more than 2.23 msec.

C-bit parity 
The remote end is using C-bit parity.

DIsplaying and clearing line error statistics

To display and clear line error statistics, specify the -c option. For example:

t3-1/15> ds3link -c
Line Code Violations: 2136611
Framing Errors: 67279
Excessive Zeros: 2098353
P-bit Parity Errors: 217318
C-bit Parity Errors: 0
Far End Block Errors: 0
DS2 1 Framing Errors: 8415
DS2 2 Framing Errors: 8415
DS2 3 Framing Errors: 8415
DS2 4 Framing Errors: 8415
DS2 5 Framing Errors: 8415
DS2 6 Framing Errors: 8415
DS2 7 Framing Errors: 8415
Statistics cleared.
Following are descriptions of the fields in the output:

Field

Description

Line Code Violations 
(LCV) 
The MAX TNT detected either a Bipolar Violation or Excessive Zeros, indicating that one of the low-level rules for encoding data was violated in the received signal.

Framing Errors (FERR) 
The number of errors in the bits used to frame the DS3 signal.

P-bit Parity Errors 
(PERR) 
The number of times that the P-bit parity check failed.

C-bit Parity Errors 
(CPERR) 
The number of times that the C-bit parity check failed.

Far End Block Errors 
(FEBE) 
The number of times the remote end has sent an FEBE signal, indicating it has received DS3 frames with either Framing Errors (FERR) or P-bit Parity Errors (CPERR).

DS2 # Framing Errors 
(FERR)
The number of errors in the bits used to frame the DS2 signal.

Displaying the line state of a DS2

To display the line state of a DS2, specify the -d 1-7 option. For example, to display the state of the third DS2:

t3-1/15> ds3link -d 3
State of DS2 3:
Out of Frame: false
Alarm Indication Signal: false
Yellow Signal: false
In Red Alarm: false
Reserved Bit: false
An alarm condition of true has the following significance:

Alarm

Description (if condition is true)

Out of Frame 
The third DS2 stream in the DS3 line cannot receive or transmit data because the TNT has lost the frame alignment on the received signal.

Alarm Indication Signal
(AIS) 
The unit is receiving an AIS on this DS2 stream of the DS3 line. A device on the line has sent the AIS signal, rather than regular data, in order to take the line out of service.

Yellow Signal
Also called Remote Alarm Indicator (RAI). A device on the DS2 stream is detecting framing-error conditions in the signal it receives.

In Red Alarm 
An out-of-frame condition has lasted for more than 9.9 msec.

Reserved Bit
The state of the reserved bit does not have any significance in diagnosing the state of the DS2 stream.

Performing an external loopback test

To perform an external loopback test, specify the -l on option:

t3-1/15> ds3link -l on
DS3 remote loopback activated
When the DS3 remote loopback is activated, the unit returns the signal it receives on the DS3 line. After the test, enter the DS3link command with the -l off option:

t3-1/15> ds3link -l off
DS3 remote loopback deactivated

Performing an internal loopback test

The -i option connects the DS3 receive path to the DS3 transmit path at the D3MX. The transmitted DS3 signal is still sent to the network as well. The following example shows how to activate and then deactivate a DS3 internal loopback:

t3-1/15> ds3link -i on 
DS3 internal loopback activated
t3-1/15> ds3link -i off
DS3 internal loopback deactivated

E1sig

Description: Displays the state of all E1 channels. You must first execute the Open command to open a session with the E1 card.

Permission level: Diagnostic

Usage: e1sig

Example: To diagnose the state of all E1 channels:

admin> open 1 10
e1-1/10>
e1-1/10> e1sig
DSL: 0, Channel: 1, state: 1
DSL: 0, Channel: 2, state: 1
DSL: 0, Channel: 3, state: 1
DSL: 0, Channel: 4, state: 1
DSL: 0, Channel: 5, state: 1
DSL: 0, Channel: 6, state: 1
DSL: 0, Channel: 7, state: 1
DSL: 0, Channel: 8, state: 1
DSL: 0, Channel: 9, state: 1
DSL: 0, Channel: 10, state: 1
DSL: 0, Channel: 11, state: 1
DSL: 0, Channel: 12, state: 1
DSL: 0, Channel: 13, state: 1
DSL: 0, Channel: 14, state: 1
DSL: 0, Channel: 15, state: 1
DSL: 0, Channel: 17, state: 1
DSL: 0, Channel: 18, state: 1
DSL: 0, Channel: 19, state: 1
DSL: 0, Channel: 20, state: 1
DSL: 0, Channel: 21, state: 1
DSL: 0, Channel: 22, state: 1
DSL: 0, Channel: 23, state: 1
DSL: 0, Channel: 24, state: 1
DSL: 0, Channel: 25, state: 1
DSL: 0, Channel: 26, state: 1
DSL: 0, Channel: 27, state: 1
DSL: 0, Channel: 28, state: 1
DSL: 0, Channel: 29, state: 1
DSL: 0, Channel: 30, state: 1
DSL: 0, Channel: 31, state: 1

E1-Stats

Description: Reports DS1-level line errors on an E1 card. You must first execute the Open command to open a session with the card.

Permission level: Diagnostic

Usage: e1-stats [-c] line

Syntax element

Description

-c
Display statistics for the line, and reset the statistics to 0 (zero).

line
Line on the card.

Example: To open a session with a card in shelf 1, slot 13:

admin> open 1 13
e1-1/13>
To display and reset the statistics on line 2:

e1-1/13> e1-stats -c 2 
DS1 Line 2:
CRC Errors: 0
Frame Slips: 9872
Framing Bit Errors: 0
Out of Frame Events 0
Far End Block Errors: 0
Line Code Violations: 0
Statistics cleared.
The significance of each number in the output is as follows:

Field

Description

CRC errors 
Data corruption in the signal.

Frame slips 
The MAX TNT received E1 data at a greater or less frequency than that of the internal line clock. In the process of realigning itself to the transmitter, the MAX TNT can skip or repeat a frame.

Framing bit 
errors 
The MAX TNT detected a framing bit that was incorrect. E1 framing requires that certain bit positions (known as framing bits) have a fixed value in the signal. The framing bits enable the MAX TNT to determine where frames begin and end.

Out of Frame 
Events 
The MAX TNT no longer detects a framing pattern in the receiving signal, or it detects a pattern at a different relative offset than expected.

Far end block 
errors 
How frequently the remote end reported errors in E1 frames transmitted by the MAX TNT.

Line Code 
Violations
The MAX TNT detected either a Bipolar Violation or Excessive Zeros, indicating that one of the low-level E1 rules for encoding data was violated in the received signal.

Statistics 
cleared
The statistics have been reset to 0 (zero), because the command included the -c option.

Ether-Display

Description: Displays the contents of Ethernet packets.

Permission level: Diagnostic

Usage: ether-display port# n

Syntax element

Description

port#
The Ethernet port on which the packets are received or transmitted. If you specify 0 (zero) for the port number, the MAX TNT displays all ports on the shelf.

n
The number of octets to display in each Ethernet packet.

Example: To display Ethernet packet contents for port 0 in 12-octet sizes:

admin> ether-display 0 12
ETHER XMIT: 12 of 60 octets
10799E40: 08 00 20 75 80 6b 00 c0 7b 5e ad 3c .. u.k.. {^.<
ETHER RECV: 12 of 60 octets
1077D980: 00 c0 7b 5e ad 3c 00 80 c7 2f 27 ca ..{^.<.. ./'.
ETHER XMIT: 12 of 509 octets
1079A480: 00 80 c7 2f 27 ca 00 c0 7b 5e ad 3c .../'... {^.<
ETHER XMIT: 12 of 330 octets
1079AAC0: 08 00 20 75 80 6b 00 c0 7b 5e ad 3c .. u.k.. {^.<
ETHER RECV: 12 of 60 octets
1077DFD0: 00 c0 7b 5e ad 3c 08 00 20 75 80 6b ..{^.<.. u.k
ETHER XMIT: 12 of 451 octets
1079B100: 08 00 20 75 80 6b 00 c0 7b 5e ad 3c .. u.k.. {^.<
ETHER XMIT: 12 of 723 octets
1079B740: 00 20 af f8 0f 1d 00 c0 7b 5e ad 3c . ...... {^.<
ETHER XMIT: 12 of 84 octets
1078F580: 08 00 20 75 80 6b 00 c0 7b 5e ad 3c .. u.k.. {^.<
ETHER RECV: 12 of 60 octets
1077E620: 00 c0 7b 5e ad 3c 00 20 af f8 0f 1d ..{^.<. ....
ETHER XMIT: 12 of 238 octets
1078FBC0: 00 20 af f8 0f 1d 00 c0 7b 5e ad 3c . ...... {^.<
ETHER XMIT: 12 of 373 octets
10790200: 00 20 af f8 0f 1d 00 c0 7b 5e ad 3c . ...... {^.<
ETHER RECV: 12 of 60 octets
1077EC70: 00 c0 7b 5e ad 3c 00 20 af f8 0f 1d ..{^.<. ....
ETHER XMIT: 12 of 267 octets
10790840: 00 20 af f8 0f 1d 00 c0 7b 5e ad 3c . ...... {^.<
To stop displaying the Ethernet statistics, enter:

admin> ether-display 0 0

Fatal-History

Description: Displays the MAX TNT fatal-error log. Every time a fatal error occurs on the MAX TNT, it is logged to the fatal-error history log. Available flash space limits the number of entries in the log. You can clear the log with the Clr-History command.

Permission level: System

Usage: fatal-history

Example: To display the fatal-history log:

admin> fatal-history
OPERATOR RESET: Index: 99 Revision: 1.3Ap6 Shelf 1 (tntsr)
Date: 09/20/1997. Time: 16:56:01
Reset from unknown, user profile super.
OPERATOR RESET: Index: 99 Revision: 1.3Ap6 Shelf 9 (tntsr)
Date: 09/24/1997. Time: 11:56:10
Reset from unknown, user profile super.
See Also: Clr-History

FE-Loop

Description: Performs a line loopback at the transceiver of a T1 or E1 card. You must first execute the Open command to open a session with the card.

Permission level: Diagnostic

Usage: fe-loop line in|out on|off

Syntax element

Description

line
DS1 line.

in
Perform local loopback.

out
Perform remote loopback.

on
Enable loopback.

off
Disable loopback.

Example: To loop the CSU towards the network for the first DS1 in slot 1:

admin> open 1 1
t1-1/1>
t1-1/1> fe-loop 1 in on
The receive side of the T1 is not bridged to the MAX TNT. To turn the loopback off:

t1-1/1> fe-loop 1 in off
To send a remote loopback request to the remote CSU:

t1-1/1> fe-loop 1 out on
To turn the remote loopback off:

t1-1/1> fe-loop 1 out off
See Also: DS3link

Format

Description: Formats a PCMCIA flash card, preparing it for use in the MAX TNT. You must format the card before you can use the Load command to load code.

Permission level: Code

Usage: format [-f] device

Syntax element

Description

-f 
Force format without asking for verification.

device
The name of the flash card to be formatted. The following are valid names:

· [flash-card-]1

· [flash-card-]2

Note that device names may be abbreviated as 1 and 2.

Example: After inserting a PCMCIA flash card in the second (rightmost) slot on the shelf controller, you would format it as follows:

admin> format flash-card-2
format will erase existing card 2 data; confirm: [y/n] y
See Also: Dircode, Fsck, Load

Fsck

Description: Audits inconsistent file conditions (which can include file contents) on a PCMCIA flash card. For each file found, the command displays the type-name, type-number, decimal and hex byte counts, date written to flash, and whether blocks that were in use were allocated to a file. Any detected errors are reported. No errors are fixed.

Permission level: Code

Usage: fsck [-b -c -v] device

Syntax element

Significance

-b 
Try to ignore bad magic. Each flash card file system contains two directory blocks: an in-use block and an empty block used when deleting information. Both directory blocks contain a magic identifier, which indicates that they are indeed directory blocks. A candidate directory block is one that is missing the magic identifier but contains information that can be interpreted as directory-block information. If Fsck finds no valid directory block but does find a candidate directory block, this option causes it to ignore the bad magic and go ahead and use the candidate directory block anyway. This option allow the file system to be used normally until the next reboot, assuming that the Fsck command found no other errors.

-c
Do not check file contents. By default, Fsck checks the file contents for validity, which involves opening and reading every file, checking the file header, verifying the data length and CRC value, and performing other functions. This option causes Fsck to check only the file-system format.

-v
Display verbose messages, including the number of blocks used, a block list, and (unless the -c option is specified) various information about the files found. See the example below.

device
The name of the flash card to be checked. The following are valid names:

· [flash-card-]1

· [flash-card-]2

Note that device names may be abbreviated as 1 and 2.

Example: To run a file-system check of the card named flash-card-1:

admin> fsck 1
ffs check in progress for card 1...
Dir 1 not in use
Dir 2 has magic, size 16, sequence 0x8
Using dir entry: 2, total data blocks: 0x40, directory size: 16
8t1-card:(0x04)
reg good 153759 (0x02589f) Jan 13 19:38
192hdlc-card:(0x07)
reg good 276920 (0x0439b8) Jan 13 19:38
48modem-card:(0x06)
reg good 398850 (0x061602) Jan 13 19:39
flash card 1 fsck: good.
The next example shows verbose messages for only one file. The actual output would show these messages for each file found.

admin> fsck -v 1
ffs check in progress for card 1...
Dir 1 not in use
Dir 2 has magic, size 16, sequence 0x8
Using dir entry: 2, total data blocks: 0x40, directory size: 16
8t1-card:(0x04)
reg good 153759 (0x02589f) Jan 13 19:38
Total Blocks: 0x02, First Block list:
x02 x04
checking in-use list...
checking in-use count...
checking file contents...
Image Info:
hdrVers(2) imageVers(1.2) totParts(1) execAddr(0x80000000)
Part Info:
totFrags(0x0259) loadAddr(0x80000000) fragSize(0x0100)
data(Compressed) partLen(0x25867) partCrc(0x60c905e1)
...
checking free list...
checking that allocated blocks are in a file...
error: block 0x02 allocated but not in a file
error: block 0x03 allocated but not in a file
error: block 0x04 allocated but not in a file
ensuring all blocks are accounted for...
flash card 1 fsck: good.
See Also: Dircode, Format, Load

FWALLdblog

Description: Displays firewall messages.

Permission level: Diagnostic

Usage: FWALLdblog

The Secure Access Manager default specifies that a firewall generate a message for every packet it blocks. Firewall messages are sent to the logging mechanism, such as Syslog or the console, configured in the Log profile. Messages generated by firewalls have the following format:

date time router-name ASCEND: interface message
Following the date and time the message was logged is the name of the router from which the message was sent. The name of the interface (for example, ie0) is also shown. The message itself can contain one or more of the following fields:

protocol local direction remote length frag log tag
Each field has the following significance:

Field

Description

protocol
For non-IP protocols, shows the 4-digit hexadecimal Ether Type or the network protocol name. For IP protocols, shows either the IP protocol number (up to 3 decimal digits) or one of the following names:

  • ip-in-ip

  • tcp

  • icmp (which might also include the ICMP Code and Type as: [code]/[type]/icmp)

  • udp

  • esp

  • ah

For a list of IP protocols, see the description of the Protocol parameter.

local
For non-IP packets, shows the packet's source or destination Ethernet MAC address (depending on whether the packet is inbound or outbound). On a WAN connection, the two MAC addresses are all zeros.

For IP packets, indicates the packet's source or destination IP address. In the case of TCP or UDP, also includes the TCP or UDP port number as ([IP_address];[port]).

direction
An arrow shows the direction in which the packet was traveling (<- for inbound or -> for outbound).

remote
For non-IP packets, specifies the packet's source or destination Ethernet MAC address (depending on whether the packet is inbound or outbound). For IP packets, specifies the packet's source or destination IP address. In the case of TCP or UDP, also includes the TCP or UDP port number as ([IP_address];[port]).

length
Specifies the length of the packet in octets (8-bit bytes).

frag
Indicates packet fragmentation. This field is present if the packet has a nonzero IP offset or the IP More-Fragments bit is set in the IP header.

log
Reports packet status or header flags. Packet status messages include:

  • corrupt-The packet is internally inconsistent.

  • unreach-The packet was generated by an unreach rule in the firewall.

  • !pass-The packet was blocked by the data firewall.

Packet header flags are TCP flag bits, including syn, fin, and rst. The syn flag should only be displayed for the initial packet, which has the syn flag set and the ack flag not set.

tag 
Contains user-defined tags in the template used by the Secure Access Manager.

See Also: FWALLversion

FWALLversion

Description: Displays the firewall versions supported by the current system software.

Permission level: Diagnostic

Usage: FWALLversion

Example: To display the supported firewall versions:

admin> FWALLversion
1 2
The output shows all firewall versions supported in the current code. The version numbers are separated by spaces. The Secure Access Manager uses this information to verify that firewalls you uploaded are supported.

See Also: FWALLdblog

Get

Description: Displays the contents of a profile or subprofile, but does not make it writable. Only the working profile can be modified. For information about reading a profile into the edit buffer to make it the working profile, see Read.

The Get command recognizes the period character (.) as a shorthand for the working profile (the profile in the edit buffer).

Permission level: System

Usage: get profile-type [profile-index] [[sub-profile] [param-name [param-index]]

Syntax element

Description

profile-type 
The type of profile to be displayed, which might require an index as well. A period represents the working profile (the profile in the edit buffer).

profile-index
The profile index (the name or address that distinguishes a profile from others of the same type). To see profile indexes, use the Dir command.

sub-profile
A subprofile within the specified profile.

param-name
A parameter within the specified profile. If the parameter is in a subprofile, you must specify the subprofile name first.

param-index
Complex parameters have an index. For example, the Interface-Address parameter contains both the physical-address and logical-item indexes.

Example: To display the contents of a Connection profile called Dallas:

admin> get connection dallas
station*=dallas
active=yes
encapsulation-protocol=mpp
called-number-type=national
dial-number=85283
clid=""
ip-options={ yes yes 1.1.1.1/8 0.0.0.0/0 7 100 255 no no 0 0.0.0.0 rou+
session-options={ "" "" no 120 no-idle 120 "" }
telco-options={ ans-and-orig no off 1 no no 64k-clear 0 "" "" no no }
ppp-options={ ****** ****** stac 1524 no 600 600 }
mp-options={ 1 1 2 }
mpp-options={ "" quadratic transmit 1 1 15 5 10 70 }
tcp-clear-options={ "" 0 }
answer-options={ }
usrRad-options={ global 0.0.0.0 1646 "" 1 acct-base-10 }
calledNumber=""
To display the OSPF subprofile:

admin> get connection dallas ip ospf
active=no
area=0.0.0.0
area-type=normal
hello-interval=30
dead-interval=120
priority=5
authen-type=simple
auth-key=ascend0
cost=10
down-cost=1000
ase-type=type-1
ase-tag=c0:00:00:00
transit-delay=1
retransmit-interval=5
Several additional examples follow. The first shows how to use the param-name argument for the IP address of an Ethernet interface:

admin> get ip-int {{1 c 1}0} ip-address
ip-address=10.65.12.224/24
The next example shows how to use a parameter index on the Get command line:

admin> get ip-int {{1 c 1}0} interface-address physical-address
shelf=shelf-1
slot=controller
item-number=1
The Get command, followed by a period, displays the contents of the current location in the working profile:

admin> get .
active=no
area=0.0.0.0
area-type=normal
hello-interval=30
dead-interval=120
priority=5
authen-type=simple
auth-key=ascend0
cost=10
down-cost=1000
ase-type=type-1
ase-tag=c0:00:00:00
transit-delay=1
retransmit-interval=5
As when you use the List command, you can modify "Get ." with ".." to display a higher context than the current location in the working profile:

admin> get . ..
ip-routing-enabled=yes
vj-header-prediction=yes
assign-address=no
remote-address=10.9.5.6/24
if-remote-address=0.0.0.0
local-address=0.0.0.0/0
routing-metric=7
down-metric=7
preference=100
down-preference=255
private-route=no
multicast-allowed=no
address-pool=0
auth-pool-address=0.0.0.0
ip-direct=0.0.0.0
rip=routing-off
ospf-options={ no 0.0.0.0 normal 10 30 120 5 simple ****** 10 1000 t+
multicast-rate-limit=100
client-dns-primary-addr=0.0.0.0
client-dns-secondary-addr=0.0.0.0
client-dns-addr-assign=yes
client-default-gateway=0.0.0.0/0
To display a deeper context than the current location in the working profile, specify one or more subprofiles after the period:

admin> get . ip ospf
active=no
area=0.0.0.0
area-type=normal
hello-interval=30
dead-interval=120
priority=5
authen-type=simple
auth-key=ascend0
cost=10
down-cost=1000
ase-type=type-1
ase-tag=c0:00:00:00
transit-delay=1
retransmit-interval=5
See Also: Read, Write, List

HDLC

Description: Displays information about the channels handled by the HDLC controller card. The HDLC controller card handles all channels except those using Serial Line Internet Protocol (SLIP), Compressed Serial Line Internet Protocol (CSLIP), or asynchronous PPP. A multichannel connection uses multiple HDLC channels.

Permission level: System

Usage: hdlc -a|-d|-f|-i|-p

Option

Description

-a
Display all available HDLC channels.

-d
Display disabled HDLC channels.

-f
Display failed/nonexistent HDLC channels.

-i
Display in-use HDLC channels.

-p
Display all possible HDLC channels.

Example: To display information about all available HDLC channels, specify the -a option:

admin> hdlc -a
HDLC channels available for use:
(dvOp dvUpSt dvRq sAdm)
HDLC { { 1 5 1 } 1 } (Up Idle UP UP )
HDLC { { 1 5 1 } 2 } (Up Idle UP UP )
HDLC { { 1 5 1 } 3 } (Up Idle UP UP )
HDLC { { 1 5 1 } 4 } (Up Idle UP UP )
HDLC { { 1 5 1 } 5 } (Up Idle UP UP )
HDLC { { 1 5 1 } 6 } (Up Idle UP UP )
HDLC { { 1 5 1 } 7 } (Up Idle UP UP )
HDLC { { 1 5 1 } 8 } (Up Idle UP UP )
HDLC { { 1 5 1 } 9 } (Up Idle UP UP )
HDLC { { 1 5 1 } 10 } (Up Idle UP UP )
HDLC { { 1 5 1 } 11 } (Up Idle UP UP )
HDLC { { 1 5 1 } 12 } (Up Idle UP UP )
HDLC { { 1 5 1 } 13 } (Up Idle UP UP )
HDLC { { 1 5 1 } 14 } (Up Idle UP UP )
HDLC { { 1 5 1 } 15 } (Up Idle UP UP )
HDLC { { 1 5 1 } 16 } (Up Idle UP UP )
HDLC { { 1 5 1 } 17 } (Up Idle UP UP )
HDLC { { 1 5 1 } 18 } (Up Idle UP UP )
HDLC { { 1 5 1 } 19 } (Up Idle UP UP )
HDLC { { 1 5 1 } 20 } (Up Idle UP UP )
HDLC { { 1 5 1 } 21 } (Up Idle UP UP )
[More? <ret>=next entry, <sp>=next page, <^C>=abort]
The data displayed includes the physical address and channel number, and the following status information about each channel:

Column

Description

dvOp
The current operational state of the channel (also specified by the Device-State setting):

  • Down indicates that the channel is in a nonoperational state.

  • Up indicates that the channel is in normal operations mode.

dvUpSt
The status of the channel in normal operations mode:

  • Idle indicates that no call is on the line.

  • Active indicates that the channel is handling a call.

dvRq
The required state of the channel as specified by Reqd-State:

  • Down indicates that the channel is required to be in a nonoperational state.

  • Up indicates that the channel is required to be in normal operations mode.

SAdm
The desired administrative state of the channel (also specified by the Desired-State setting):

  • Down specifies that the channel should terminate all operations and enter the down state.

  • Up specifies that the channel should come up in normal operations mode.

The actual state of the channel can differ from the desired state, as when a device is powering up, or you change the desired state on a running slot. Changing the desired state does not force a channel to the new state. It indicates that the MAX TNT should change the channel state in a graceful manner.

See Also: Modem, Show, Slot

Help

Description: Displays a list of all available commands or help text about a specific command. The question-mark (?) is a shortcut version of this command.

Permission level: User

Usage: help [-a]|[command-name]

Option

Description

-a
List all commands. (Without this option, the list includes only commands authorized by the current User profile.)

command-name
Display information about the specified command.

Example: To display a list of commands authorized for your current login:

admin> help
? ( user )
arp ( system )
auth ( user )
callroute ( diagnostic )
clear ( user )
clock-source ( diagnostic )
clr-history ( system )
connection ( system )
date ( update )
delete ( update )
device ( diagnostic )
dir ( system )
dircode ( system )
ether-display ( diagnostic )
fatal-history ( system )
format ( code )
get ( system )
hdlc ( system )
help ( user )
if-admin ( diagnostic )
line ( system )
[More? <ret>=next entry, <sp>=next page, <^C>=abort]
To display help text about the Dir command, for example:

admin> help dir
dir list all profile types
dir profile-type list all profiles of the specified type
dir profile-type profile-index list the specified profile instance
Dependencies: The current security level is set by the current User profile and determines which commands are displayed in response to this command. If the current User profile does not have sufficient privileges to execute a command, the command is not displayed unless you specify the -a option. Commands with the User security level are always displayed. For detailed information, see Auth.

See Also: ?, Auth

IDSLcmd

Description: Enables you to perform loopback and error tests on an IDSL card. You must first execute the Open command to open a session with the card.

Permission level: Diagnostic

Usage: idslcmd -1|-2|-a|-f|-z|-c|-u|-r|-n|-? [channel]

Option

Description

-1
Perform a loopback on the first B channel.

-2
Perform a loopback on the second B channel.

-a
Perform an analog loopback on the B channels.

-f
Perform block-error fetching.

-z
Clear block-error counters.

-c
Generate artificial CRC errors by inverting the CRC value.

-u
Cancel the -c option.

-r
Request that the remote TA invert the CRC value.

-n
Cancel the -n option.

-?
Display the command summary.

channel
The channel to test. You can specify a channel from 0 to 31. If you do not specify a channel, IDSLcmd tests all channels.

Performing an EOC loopback over the B channels

The first two options, -1 and -2, initiate an Embedded Operations Channel (EOC) loopback on the specified B channel. EOC refers to the out-of-band mechanism available in the BRI-U interface to implement maintenance functions. Instead of using the D or B channels, the mechanism uses the maintenance bits of U-interface superframe, so it is nonintrusive. Maintenance functions include test loopbacks, statistics gathering (in the form of block error counters), and requests to generate errors (to verify that the counters work).

When you use the -1 or -2 option, IDSLcmd accepts additional arguments in the following syntax:

idsl-1/7> idslcmd -channel [EOC_address] [count] [buffersize] 

Syntax element

Description

channel
The number 1 represents the first B channel. The number 2 represents the second B channel.

EOC_address
A number from 0 to 7. The default is zero, which addresses the remote TA (NT). The number 7 broadcasts the EOC loopback to all the nodes. The numbers 1 to 6 address the nodes between the IDSL card and the remote TA, with 1 being closest to the IDSL card.

count
The number of buffers to send in the loopback. The default is 10.

buffersize
The size of the buffer to send. The default is 128 bytes.

For example, to request that the remote TA or BRI-U device (specified by the EOC address) go into Loopback mode over the B1 channel and send 64 frames of 32 bytes each:

idsl-1/7> idslcmd -1 0 64 32
A message appears, reporting the number of frames received from the TA.

Performing an analog loopback over the B channels

With the -a option, IDSLcmd requests an analog loopback for testing data paths between components of the card itself. The -a option requires that you specify a channel number, and accepts additional arguments in the following syntax:

idsl-1/7> idslcmd -a channel [count] [buffersize] 

Syntax element

Description

channel
The number 1 represents the first B channel. The number 2 represents the second B channel.

count
The number of buffers to send in the loopback. The default is 10.

buffersize
The size of the buffer to send. The default is 128 bytes.

For example, to put the U-interface echo canceller (IEC-2091) in analog loopback mode and send 64 frames of 32 bytes each over channel B1:

idsl-1/7> idslcmd -a 1 64 32
A message appears, reporting the number of frames received. This test is adequate to verify the path between the HDLC controllers and the IEC-2091 echo canceller.

Block error fetching and error clearing

The remote U-interface/echo canceller provides internal counters for remote and local block errors. This mechanism facilitates comfortable surveillance of the transmission quality at the U-interface. A block error is detected when the calculated checksum of the received data does not correspond to the control checksum transmitted in the next superframe. One block error indicates that one U-superframe has not been transmitted correctly. You cannot determine the number of bit errors by examining the block-error counters.

All error reports are from the point of view of the remote TA, because the mechanism fetches error counters from the remote TA. A near-end block error (NEBE) indicates that the error has been detected in the receive direction. A far-end block error (FEBE) identifies errors in the transmit direction.

With the -f option, IDSLcmd fetches block-error counters for the specified channel. For example:

idsl-1/7> idslcmd -f 1
Block error counters are cumulative. They stop accumulating when they reach their upper limit of 65534. To clear the block-error counters for a channel, use the -z option:

idsl-1/7> idslcmd -z 1

Performing CRC error tests

To test the NEBE and FEBE counters, you can simulate transmission errors by artificially corrupting CRCs. With the -c option, IDSLcmd inverts the CRC values to purposely generate CRC errors. The remote FEBE should then increment for every corrupt frame it receives. For example, to invert the CRC value on channel 2 by one:

idsl-1/7> idslcmd -c 2
To cancel the command and return the CRC values to normal, use the -u option:

idsl-1/7> idslcmd -u 2
Conversely, you can use the -r option to request that the remote TA invert the CRC values. For example:

idsl-1/7> idslcmd -r 1
The remote NEBE should increment by one for every corrupt frame sent. To cancel the command and return the CRC values to normal, use the -n option:

idsl-1/7> idslcmd -n 1

If-Admin

Description: Displays information about or administratively changes the state of an SNMP interface. Each device in the system has a unique SNMP interface number assigned to the device when a card is installed. Interface numbers are stored in NVRAM, which is not affected by system resets, so a physical device keeps the same interface number across system resets or power failures.

Permission level: Diagnostic

Usage: if-admin -a|-d interface|-l|-u interface|-r interface|-?

Option

Description

-a
List available SNMP interface numbers.

-d interface
Administratively down a specified SNMP interface

-l
List SNMP interface/device address mappings.

-u interface
Administratively bring up a specified SNMP interface.

-r interface
Reset an SNMP interface.

-?
Display a usage summary.

Example: To display a list of available SNMP interface numbers, specify the -a option:

admin> if-admin -a
Available SNMP interface numbers
118 - infinity
To display a list of all SNMP interface numbers assigned by the system, specify the -l option:

admin> if-admin -l
SNMP-IF DEVICE ADDRESS
101 - { 1 11 32 }
1 - { 1 17 1 }
102 - { 1 11 33 }
2 - { 1 3 1 }
103 - { 1 11 34 }
3 - { 1 3 2 }
104 - { 1 11 35 }
4 - { 1 3 3 }
105 - { 1 11 36 }
5 - { 1 3 4 }
106 - { 1 11 37 }
6 - { 1 3 5 }
107 - { 1 11 38 }
7 - { 1 3 6 }
108 - { 1 11 39 }
8 - { 1 3 7 }
109 - { 1 11 40 }
9 - { 1 3 8 }
110 - { 1 11 41 }
10 - { 1 15 1 }
111 - { 1 11 42 }
[More <ret>=next entry, <sp>=next page, <^C>=abort]
To bring up SNMP interface number 111:

admin> if-admin -u 111
interface 111 state change forced

IGMP

Description: Displays multicast information about Internet Group Membership Protocol (IGMP) groups and clients. The IGMP command applies only if the MAX TNT forwards multicast packets to members of multicast groups. It lists the members of groups to which the MAX TNT forwards multicast packets, and displays information about the groups.

Permission level: System

Usage: igmp group|client|debug|hbdebug

Keyword

Description

group
Display active multicast group addresses and interfaces.

client
Display multicast clients.

debug
Display IGMP debug information, such as statistics about queries to clients and replies from clients.

hbdebug
Display heartbeat messages.

Example: To display active multicast group addresses and interfaces for each group, specify the group argument:

admin> igmp group
IGMP Group address Routing Table Up Time: 0:0:22:17
Hash Group Address Members Expire time Counts
N/A Default route * (Mbone) ...... 2224862
10 224.0.2.250
2 0:3:24 3211 :: 0 S5
1 0:3:21 145 :: 0 S5
0(Mbone) ...... 31901 :: 0 S5
The output contains the following fields:

Field

Description

Hash
Index to a hash table (displayed for debugging purposes only). N/A indicates that the Default route is not an entry in the hash table.

Group address
IP multicast address used for the group. An asterisk indicates the IP multicast address being monitored, meaning that members join this address by local application. The Default route is the MBONE interface (the interface on which the multicast router resides). If the MAX TNT finds that there is no member in a group, it forwards multicast traffic for the group to the MBONE interface.

Members 
ID of each member of each multicast group. The zero ID represents members on the same Ethernet interface as the MAX TNT. All other IDs go to members of each group as they inform the MAX TNT that they have joined the group. If a client is a member of more than one group to which the MAX TNT forwards multicast packets, it has more than one multicast ID. The interface labeled Mbone is the interface on which the multicast router resides.

Expire time
When this membership expires. The MAX TNT sends out IGMP queries every 60 seconds, so the expiration time is usually renewed. If the expiration time is reached, the MAX TNT removes the entry from the table. If the field contains periods, this membership never expires. A string of periods means that the default route never times out.

Counts 
Number of packets forwarded to the client, the number of packets dropped due to lack of resources, and the state of the membership. The state is displayed for debugging purposes.

To display a list of multicast clients, use the client argument:

admin> igmp client
IGMP Clients
Client Version RecvCount CLU ALU
0(Mbone) 1 0 0 0
2 1 39 68 67
1 1 33310 65 65
The output contains the following fields:

Field

Description

Client
Interface ID on which the client resides. The value 0 (zero) represents the Ethernet. Other numbers are WAN interfaces, numbered according to when they became active. The interface labeled Mbone is the interface on which the multicast router resides.

Version
Version of IGMP being used.

RecvCount
Number of IGMP messages received on that interface.

CLU
ALU
CLU is Current Line Utilization, and ALU is Average Line Utilization. Both indicate the percentage of bandwidth utilized across this interface. If bandwidth utilization is high, some IGMP packet types are not forwarded.

Dependencies: This command is not applicable if IP multicast forwarding is not enabled.

IPcache

Description: Displays information about IP route caches. A route cache enables a slot card to route IP packets to another slot, reducing the route-processing overhead on the shelf controller. The shelf controller is still responsible for managing routing protocols and the route caches themselves, but each slot card is able to check a small IP cache and route packets to a destination slot. When a slot card receives an IP packet for which it has no cache entry, it forwards that packet to the shelf controller. The shelf controller routes it to the proper slot and writes a cache entry. The cache entry is downloaded to the route cache of all slot cards via the control bus.

Permission level: System

Usage: ipcache cache|debug|disable|enable

Option

Description

cache
Display the cache.

debug
Turn on debugging.

disable
Disable the route cache. (Available only on slot cards.)

enable
Enable the route cache. (Available only on slot cards.)

Example: To display the cache, which is currently empty:

admin> ipcache cache

Cache Limit 0 Cache Count 0 Cache over limit 0

Hash Address Gateway Ifname

Mem Usage: Allocated 1k bytes
Free block count 35

IP-Pools

Description: Displays the status of the IP address pools configured in the IP-Global profile.

Permission level: System

Usage: ip-pools

Example: admin> ip-pools
Pool# Base Count InUse
1 10.154.3.50 50 0
3 10.154.3.150 50 1

Number of remaining allocated addresses:     99
The sample output shows two configured pools, with the base address, address count, and number of addresses in use for each pool.

IProute

Description: Enables you to manually add or delete IP routes. Changes to the routing table do not persist across system resets.

Permission level: System

Usage: iproute add|delete

Syntax element

Description

add
Add an IP route to the routing table.

delete
Delete an IP route from the routing table.

Adding a static IP route to the routing table

To add a static IP route to the MAX TNT unit's routing table, use the IProute Add command.

iproute add dest_IPaddr[/subnet_mask] gateway_IPaddr[/subnet_mask] 
[pref] [metric] 

Syntax element

Description

dest_IPaddr/subnet_mask
Destination network address and subnet mask (in bits). The default is 0.0.0.0/0.

gateway_IPaddr/subnet_mask
IP address of the router that can forward packets to the destination network, and subnet mask (in bits). The default is 0.0.0.0.

pref
Route preference. The default is 100.

metric
Virtual hop count of the route. You can enter a value between 1 and 15. The default is 1.

For example, consider the following command:

admin> iproute add 10.1.2.0/24 10.0.0.3/24 1
It adds a route to the 10.1.2.0 network, through the IP router located at 10.0.0.3/24. The metric to the route is 1 (one hop away).

If you try to add a route to a destination that is already in the routing table, the MAX TNT does not replace the existing route unless it has a higher metric than the route you attempt to add. If you get the message Warning: a better route appears to exist, the MAX TNT has rejected your attempt to add a route. Note that RIP and OSPF updates can change the metric for the route.


Note: Any routes you add with the IProute Add command are lost when you reset the MAX TNT.

Deleting a static IP route from the routing table

To remove a static IP route from the MAX TNT unit's routing table, enter the IProute Delete command.

iproute delete dest_IPaddr/subnet_mask [gateway_IPaddr[/subnet_mask]]
For example, the following command removes the route to the 10.1.2.0 network:

admin> iproute delete 10.1.2.0/24 10.0.0.3/24

Note: RIP and OSPF updates can add back any route you remove with IProute Delete. Also, the MAX TNT restores all routes listed in the IP-Route profile after a system reset.

Line

Description: Specifies that the upper-right or lower-right portion of the status window (or both) should display T1, E1, or DS3 line and channel status information. If the status window is not already displayed, this command opens it with the connection status information displayed.

Permission level: System

Usage: line all|enabled top|bottom

Option

Description

all
Display status information about all T1 lines.

enabled
Display status information only about enabled T1 lines.

top
Display line status in the upper portion of the status window.

bottom
Display line status in the lower portion of the status window (the default).

Example: To display line status information in the upper part of the status window:

admin> line top

Line status information includes the following identifiers and codes:

Following are the link-status codes:

Code

Description

LA (T1 lines)
TE (E1 lines)
Link Active. The line is active and physically connected.

RA
Red Alarm. The line is not connected, or it is improperly configured, experiencing a very high error rate, or supplying inadequate synchronization.

YA
Yellow Alarm. The MAX TNT is receiving a Yellow Alarm pattern, which indicates that the other end of the line cannot recognize the signals the MAX TNT is transmitting.

DF
D-channel Fail. The D channel for a PRI line is not currently communicating.

1S
All Ones. The PRI network is sending a keepalive (all ones) signal to the MAX TNT to indicate that the line is currently inoperative.

DS
Disabled. The line might be physically connected, but the T1 or E1 profile specifies that it is inactive.

Following are the channel-status codes:

Code

Description

.
The channel is not available because the line is disabled, has no physical link, or does not exist, or because the channel configuration specifies that it is unused.

* 
The channel is connected in a current call.

- 
The channel is currently idle (but in service).

b
The channel is a backup NFAS D channel (T1 PRI only).

c
The channel is currently not available because it is in the process of clearing the most recent call, or because it is in the process of sending echo cancellation tones to receive a call (inband signaling on T1 only).

d
The MAX TNT is dialing from this channel for an outgoing call.

r
The channel is ringing for an incoming call.

m
The channel is in maintenance/backup mode (ISDN only).

n
The channel is nailed.

o
The channel is out of service (ISDN only).

s
The channel is an active D channel (ISDN only).

Following are the channel-type codes:

Code

Description

T
T1 inband signaling

I
T1 PRI signaling

P
NFAS Primary

S
NFAS Secondary

N
All other NFAS types

To display a prompt below the status window, press the Escape key. To scroll through the list of lines, press the Up-Arrow or Down-Arrow key, or to page up or down through the lines, press the Page Up or Page Dn key.

To close the status window:

admin> status
See Also: Connection, Log, Status, T1channels, View

List

Description: Lists the contents of the current or specified context in the working profile. Listing a subprofile changes the current context to that subprofile. Specifying two periods (..) as the command argument changes the current context back to one level higher in the working profile ("closing" the subprofile).


Note: The List command works only on the working profile.

Permission level: System

Usage: list [..] [param-name [param-index] [sub-profile]]

Option

Description

.. (two periods)
Close the current subprofile and return to the previous higher context.

param-name
A parameter in the current context. If the parameter is in a subprofile, you must specify the subprofile name first.

param-index
Complex parameters have an index. For example, the Interface-Address parameter contains both the physical-address and logical-item indexes.

sub-profile
List the contents of a subprofile that is visible in the current context, and make that subprofile the current context.

Example: To make a Connection profile named Dallas the working profile:

admin> read connection dallas
To list its contents:

admin> list
station*=dallas
active=yes
encapsulation-protocol=mpp
called-number-type=national
dial-number=85283
clid=""
ip-options={ yes yes 1.1.1.1/8 0.0.0.0/0 7 100 255 no no 0 0.0.0.0 rou+
session-options={ "" "" no 120 no-idle 120 "" }
telco-options={ ans-and-orig no off 1 no no 64k-clear 0 "" "" no no }
ppp-options={ ****** ****** stac 1524 no 600 600 }
mp-options={ 1 1 2 }
mpp-options={ "" quadratic transmit 1 1 15 5 10 70 }
tcp-clear-options={ "" 0 }
answer-options={ }
usrRad-options={ global 0.0.0.0 1646 "" 1 acct-base-10 }
calledNumber=""
To list the PPP-Options subprofile:

admin> list ppp
send-password=******
recv-password=******
enabled=yes
link-compression=stac
mru=1524
lqm=no
disconnect-on-auth-timeout=yes
lqm-minimum-period=600
lqm-maximum-period=600
To return to the top-level context of the profile:

admin> list ..
To use the List command to display the Answer-Options subprofile:

admin> list .. answer
profile-required=no
ans-default=no
profile-source=no
clid-auth-mode=ignore
Dependencies: The List command works only on the working profile. To make an existing profile the working profile, use the Read command. When you create a new profile, it becomes the working profile automatically.

See Also: Dir, Get, Read, New, Set, Write

Load

Description: Uploads a code image to flash or runs a remote configuration script. The code image or script may be located on the disk of the PC you are using for the terminal session with the MAX TNT or on a network host that supports TFTP.

Permission level: Update

Usage: load [-v] load-type [-subtype] source [device]

Syntax element

Description

-v
Display verbose output for configuration loads.

load-type
The load type:

  • config- configuration file

  • sr- shelf-router runtime load (resides in onboard flash)

  • boot-sr- shelf-router boot load

  • t1-8- code for an 8-port T1 card

  • e1-8- code for an 8-port E1 card

  • hdlc- code for an HDLC card

  • modem- code for a modem card

load-type 
(continued)
  • swan- code for a serial WAN card

  • enet- code for an Ethernet card

  • ana-modem-code for an analog modem card

  • tar-a tar file containing all slot card code images

  • idsl-code for an IDSL card

  • sdsl-code for an SDSL card

  • T3-code for a T3 card

  • mdm56k-code for a Series56 Digital Modem card

  • unchan-t1-code for an unchannelized T1 line

  • hssi-code for a High-Speed Serial Interface (HSSI)

The Load command supports type checking to verify that the load type specified on the command line matches the image header.

-subtype
The subtype of the image:

  • -normal (for regular image, the default)

  • -debug (for debugging image)

  • -diagnostic (for diagnostic image)

The Load command supports subtype alignment, which enables you to change the subtype of the image. For example, if you load an image whose header specifies that it is a normal image, but you specify the
-debug subtype, the image saved in flash has a subtype of Debug instead of Normal.

source
The location from which the file will be loaded:

  • network host filename-After typing the word
    network, you can specify a hostname or IP address and the path to the file on a TFTP host.

  • console-The PC connected to the MAX TNT via the serial port.

device
The name of the flash card to load. The valid device names are:

  • [flash-card-]1 (default)

  • [flash-card-]2

Note that device names may be abbreviated as 1 and 2.

Example: To load a configuration file named maxtnt.cfg from a network host 10.8.7.2 to flash-card-1:

admin> load config network 10.8.7.2 /maxtnt.cfg
To load a software update for a T1 card from the PC you are using to flash-card-2:

admin> load t1-8 console 2 tntt1.ffs

Note: The first time you use a tar file to load MAX TNT system software, Ascend recommends that you bring down the expansion slots before upgrading their slot card code images. After you have loaded a tar file once, you do not need to down the slots for your next upgrade.

Assuming that you have access to the unit through the shelf-controller Ethernet or serial port, you can load a tar file by following the steps below. Note that the MAX TNT will not be operational from step 2 through step 4 of this procedure.

  1. Load the shelf controller software. For example, to load tntsr.bin from a network host named host1:

  2. If this is the first time you are upgrading with a tar file, reset the unit to execute the new shelf controller software, and manually down all installed slot cards by using the Slot command. (If this is not the first time you have loaded a tar file, you can skip this step and go to step 3.)

    For example:

  3. Load the tar file. For example, to load the tntrel.tar file from a network host named host1:

  4. Manually bring up all slot cards, or reset the system.


Note: As an alternative, you can extract the contents of a tar archive and load slot card images individually. Windows users might find the WinZip utility useful (available at www.winzip.com). For example, to load just the update for a T1 card:

admin> load t1-8 net host1 tntt1.ffs
If the system terminates the process of loading a tar file, one of the following messages might appear:

load aborted: not a tar image
load aborted: a tar image, inconsistent with the specified load-type.
load aborted: invalid/unknown image header.
load aborted: mismatched image for the specified load-type.
load aborted: invalid image, unsupported by load tar command.
The Load command supports type checking to verify that the load type specified on the command line matches the image header. The above messages indicate that the type checking process discovered inconsistencies between the load type and the image header. Check your command line. If necessary, download the tar file again.

The following warning message does not terminate the Load, but indicates that you are not loading the most recent software version:

load: warning: old image header version detected, load continued...
See Also: Dircode, Format, Fsck, Save

Loadslave

Description: Enables you to update slave-shelf code from the master-shelf interface.

Permission level: Update

Usage: loadslave shelf [image1|image2]

Syntax element

Description

shelf
The shelf number of a slave shelf.

image1, image2
The two load images maintained in the master shelf controller's NVRAM. The MAX TNT uses one of the images to update the specified shelf. The image1 option specifies the low boot image of the Master. The image2 option specifies the high boot image of the Master. The default is image2.

When you load a binary to the master shelf controller via TFTP or a serial connection, the compressed image is stored in the high-address section of NVRAM, referred to as image2 in Figure 1-1. When you then reset the system to execute the new shelf-controller software, the system first verifies that the compressed image is good and copies it into the low-address section of memory. The copy is referred to as image1. The system then decompresses image1, loads it into memory, and boots from image1.

Figure 1-1. Loading new shelf-controller software

The slave shelf always stores the code image in the high-address section of its NVRAM (image2). However, you can specify in the Loadslave command whether you want it to load the binary from image1 or image2 in the master shelf. After you reset the master shelf, both images are identical.

Log

Description: Specifies that the upper-right or lower-right portion of the status window (or both) should display a message from the MAX TNT log buffer that contains the most recent system events. If the status window is not already displayed, this command opens it with the connection status information displayed.

The Log profile controls whether logs are sent to a Syslog host, as well as how many logs are stored in the MAX TNT buffer. The number of events stored in the log is set by the Save-Number parameter. For more information about the Log profile, see the description of the Log profile.

Permission level: System

Usage: log top|bottom

Option

Description

top
Display the log in the upper-right portion of the status window.

bottom
Display the log in the lower-right portion of the status window.

Example: To display the event log in the lower portion of the status window:

admin> log bottom

The first line of the event-log window shows the log entry number (M: 00 through M: N, where N is set in the Save-Number parameter of the Log profile), the level of message, and the device on which the event occurred. The last line shows the date and time when the event occurred.

The message levels are as follows:

Level

Description

emergency
A failure or major error has occurred, and normal operation is doubtful.

alert
A failure or major error has occurred, but normal operation can probably continue.

critical
An interface has gone down, or there has been a security error.

error
Something that should not occur has occurred.

warning
Something out of the ordinary, such as a login failure due to an invalid user name or password, has happened in otherwise normal operations.

notice
Something of interest, such as a link going up or down, has happened during normal operation.

info
A change in state or status was noticed. Such messages are not of general interest.

debug
The message is of interest only if you are debugging a unit configuration.

The text of the most recent message is displayed in the middle of the window. You can press the Up-Arrow key to see previous messages, and return to more recent messages by pressing the Down-Arrow key.

Following are some sample informational messages:

Informational message

Description

48 out of 48 modems 
passed POST
All of the modems on a card passed the power-on self test.

Incoming call
A call has been received but not yet routed.

Outgoing call
The MAX TNT has dialed a call.

Added Bandwidth
The MAX TNT has added bandwidth to an active call.

Ethernet up
The Ethernet interface has been initialized and is running.

LAN session up
A PPP session has been established.

LAN session down
A PPP session has been terminated.

Assigned to port
The MAX TNT has determined the assignment of an incoming call to a digital modem or HDLC channel.

Call Terminated
An active call was disconnected normally, although not necessarily by operator command.

Removed Bandwidth
The MAX TNT has removed bandwidth from an active call.

RADIUS config error
The MAX TNT has detected an error in the configuration of a RADIUS user profile.

Requested Service 
Not Authorized
This message appears in the terminal server interface if the user requests a service not authorized by the RADIUS server.

Following are some sample warning messages:

Warning message

Description

Busy
The phone number was busy when the call was dialed.

No connection
The remote end did not answer when the call was dialed.

Network problem
The call setup was faulty because of problems in the WAN or in the Line profile configuration. The D channel might be getting an error message from the switch, or the telco might be experiencing a problem.

Call disconnected
The call has ended unexpectedly.

Far end hung up
The remote end terminated the call normally.

Incoming glare
The MAX TNT could not place a call because it saw an incoming glare signal from the switch. Glare occurs when you attempt to place an outgoing call and answer an incoming call simultaneously. If you receive this error message, you have probably selected incorrect Line profile parameters. Check the Robbed-Bit-Mode setting.

LAN security error
A PPP session has failed authentication, another session by the same name already exists, or remote authentication timed out.

Call Refused
An incoming call could not be connected.

Press the Escape key to display a prompt below the status window. Then, to close the status window, enter the Status command:

admin> status
See Also: Connection, Line, Status, View

Modem

Description: Displays information about digital modems in the MAX TNT. Each modem card provides 48 modems.

Permission level: System

Usage: modem -a|-d|-f|-g|-i|-m|-s

Option

Description

-a
Display all available modems.

-d
Display disabled modems.

-f
Display failed or nonexistent modems.

-g
Display available good modems.

-i
Display in-use modems.

-m
Display all possible modems.

-s
Display suspect modems.

Example: To display all the good modems that are available for use, use the -g option:

admin> modem -g
Non-suspect modems available for use:
(dvOp dvUpSt dvRq sAdm mDis)
Modem { 1 11 1 } (Up Idle UP UP ENABLE )
Modem { 1 11 2 } (Up Idle UP UP ENABLE )
Modem { 1 11 3 } (Up Idle UP UP ENABLE )
Modem { 1 11 4 } (Up Idle UP UP ENABLE )
Modem { 1 11 5 } (Up Idle UP UP ENABLE )
Modem { 1 11 6 } (Up Idle UP UP ENABLE )
Modem { 1 11 7 } (Up Idle UP UP ENABLE )
Modem { 1 11 8 } (Up Idle UP UP ENABLE )
Modem { 1 11 9 } (Up Idle UP UP ENABLE )
Modem { 1 11 10 } (Up Idle UP UP ENABLE )
Modem { 1 11 11 } (Up Idle UP UP ENABLE )
Modem { 1 11 12 } (Up Idle UP UP ENABLE )
Modem { 1 11 13 } (Up Idle UP UP ENABLE )
Modem { 1 11 14 } (Up Idle UP UP ENABLE )
Modem { 1 11 15 } (Up Idle UP UP ENABLE )
Modem { 1 11 16 } (Up Idle UP UP ENABLE )
[More? <ret>=next entry, <sp>=next page, <^C>=abort]
The information displayed includes the physical address of the modem and the following status information:

Column

Description

dvOp
The current operational state of the modem (also specified by the Device-State setting):

  • Down indicates that the modem is in a nonoperational state.

  • Up indicates that the modem is in normal operations mode.

dvUpSt
The status of the modem in normal operations mode:

  • Idle indicates that the modem is not handling a call.

  • Active indicates that the modem is handling a call.

dvRq
The required state of the modem as specified by the Reqd-State setting:

  • Down indicates that the modem is required to be in a nonoperational state.

  • Up indicates that the modem is required to be in normal operations mode.

SAdm
The desired administrative state of the modem (also specified by the Desired-State setting):

  • Down specifies that the modem should terminate all operations and enter the down state.

  • Up specifies that the modem should come up in normal operations mode.

The actual state of the modem can differ from the desired state, as when a device is powering up, or you change the desired state on a running slot. Changing the desired state does not force a modem to the new state. It indicates that the MAX TNT should change the modem state in a graceful manner.

mDis
Modem disable mode (as indicated by the LAN-Modem profile):

  • Enable specifies that the modem is operational.

  • Disable specifies that the modem has been disabled.

See Also: Open, Show, Slot

Netstat

Description: Displays the MAX TNT IP interface and routing tables, protocol statistics, and active sockets.

Permission level: System

Usage: netstat [udp][tcp][-i][-r[host]][?][-n][-s

Option

Description

no arguments

Display UDP and TCP statistics.

udp
Display only UDP information.

tcp
Display only TCP information.

-i
Display the IP interface table.

-r host
Display the IP routing table. You can specify a hostname after the -r option to display the routing table entry for that host.

-?
Display a usage summary.

-n
Display numeric addresses rather than symbolic names.

-s identifiers
Display protocol statistics. If no identifiers follow the -s option, all protocol statistics are printed. If you specify one or more identifiers, they determine the type of protocol statistics to display. The valid identifiers are udp, tcp, icmp, ip, igmp, and mcast.

identifiers]

For TCP, Netstat reports the following services:

Service

TCP port number

Telnet

23

TACACS+

49

Finger

79

For UDP, Netstat reports the following services:

Service

UDP port number

Route

520

Echo

7

NTP

123

SNMP

161

SNMPTrap

162

If the port being used is not found among these named services, it is printed as a number.

Displaying UDP and TCP statistics

To display information about UDP sockets, include the udp option with the Netstat command:

admin> netstat -n udp
or

admin> netstat udp
The command output shows the queue depth of various UDP ports, as well as the total packets received and total packets dropped on each port. The total packets received count includes the total packets dropped. For the following sample output, the SNMP queue depth was set to 32:

admin> netstat -n udp
udp:
-Socket- Local Port InQLen InQMax InQDrops Total Rx
1/c 0 1023 0 1 0 0
1/c 1 route 0 0 0 25
1/c 2 echo 0 32 0 0
1/c 3 ntp 0 32 0 1
1/c 4 1022 0 128 0 0
1/c 5 snmp 0 128 0 0
1/1 0 1 0 256 0 0
1/1 1 1018 0 128 0 0
1/3 0 3 0 256 0 0
1/3 1 1021 0 128 0 0
1/5 0 5 0 256 0 0
1/5 1 1020 0 128 0 0
1/8 0 8 0 256 0 0
1/8 1 1019 0 128 0 0
The display contains the following information:

Column

Description

Socket
The shelf, slot, and socket corresponding to a local UDP port.

Local Port
The port on which the MAX TNT is listening for UDP packets.

InQLen
The number of packets in the input queue for the socket. The packets are waiting to be processed.

InQMax
The maximum number of packets that can reside in the input queue for the socket. A value of 0 (zero) means no limit. The MAX TNT drops excess packets.

InQDrops
The number of packets dropped from the input queue because the value of InQMax was reached.

Total Rx
The total number of packets received on the socket, including dropped packets.

To display information about TCP sockets and current TCP sessions, include the tcp option with the Netstat command. For example:

admin> netstat tcp
tcp:
-Socket- Local Remote State
1/c 0 host1.eng.abc.finger *.* LISTEN
1/c 1 host1.eng.abc.telnet *.* LISTEN
1/c 2 host1.eng.abc.finger ridgeback.eng.abc..38040 TIME-WAIT
1/c 3 host1.eng.abc.finger ridgeback.eng.abc..38041 ESTABLISHED
1/c 4 host1.eng.abc.finger ridgeback.eng.abc..38042 ESTABLISHED
1/c 5 host1.eng.abc.finger ridgeback.eng.abc..38043 ESTABLISHED
1/c 6 host1.eng.abc.finger ridgeback.eng.abc..38044 ESTABLISHED
The display contains the following information:

Column

Description

Socket
The shelf, slot, and socket corresponding to a local TCP port. The socket number corresponds to a TCP session or the local TCP port on which the MAX TNT is listening.

Local
The local IP address and port for a TCP session. For example, in the value 10.2.3.114.23, 10.2.3.114 specifies the IP address and 23 specifies the port for a TCP session. If the address portion contains only an asterisk (*), the MAX TNT is listening for the start of a TCP session.

Remote
The remote IP address and port for a TCP session. For example, in the value 15.5.248.121.44581, 15.5.248.121 specifies the IP address and 44581 specifies the port for a TCP session. If the specification contains only asterisks (*.*), the MAX TNT is listening for the start of a TCP session.

State
The state of the session. The possible state values are:

  • CLOSED-The socket is not in use.

  • LISTEN-The socket is listening for incoming connections. Note that no session is associated with the LISTEN state, because this state precedes the establishment of a TCP session.

  • SYN_SENT-The socket is trying to establish a connection.

  • SYN_RECEIVED-The connection is being synchronized.

  • ESTABLISHED-The connection is established.

  • CLOSE_WAIT-The remote side has shut down the connection, and the MAX TNT is waiting for the socket to close.

  • FIN_WAIT_1-The socket is closed, and the MAX TNT is shutting down the connection.

  • CLOSING-The socket is closed. The MAX TNT is waiting for acknowledgment that the remote end has shut down.

  • LAST_ACK-The remote end has shut down and closed the socket, and it is waiting for an acknowledgment from the MAX TNT.

  • FIN_WAIT_2-The socket is closed, and the MAX TNT is waiting for the remote end to shut down the connection.

  • TIME_WAIT-The socket is closed, and the MAX TNT is waiting for a remote-shutdown retransmission.

To display both UDP and TCP statistics, specify the -n option. For example:

admin> netstat -n
udp:
-Socket- Local Port InQLen InQMax InQDrops Total Rx
1/c 0 1023 0 1 0 0
1/c 1 route 0 0 0 25
1/c 2 echo 0 32 0 0
1/c 3 ntp 0 32 0 1
1/c 4 1022 0 128 0 0
1/c 5 snmp 0 128 0 0
1/1 0 1 0 256 0 0
1/1 1 1018 0 128 0 0
1/3 0 3 0 256 0 0
1/3 1 1021 0 128 0 0
1/5 0 5 0 256 0 0
1/5 1 1020 0 128 0 0
1/8 0 8 0 256 0 0
1/8 1 1019 0 128 0 0
tcp:
Socket Local Remote State
1/c 0 *.23 *.* LISTEN
1/c 1 10.2.3.114.23 15.5.248.121.44581 ESTABLISHED

Displaying the interface table

The MAX TNT interface table shows the address of each interface. To display the MAX TNT interface table, specify the -in option:

admin> netstat -in
The entries in the interface table associated with the MAX TNT Ethernet interfaces use the following naming convention:

ie[shelf]-[slot]-[item]
For example, the following output shows a four-port Ethernet card in slot 13:

Name     MTU  Net/Dest          Address        Ipkts  Ierr Opkts  Oerr
ie0 1500 12.65.212.0/24 12.65.212.227 107219 0 54351 0
lo0 1500 127.0.0.1/32 127.0.0.1 4867 0 4867 0
rj0 1500 127.0.0.2/32 127.0.0.2 0 0 0 0
bh0 1500 127.0.0.3/32 127.0.0.3 0 0 0 0
wan4 1500 10.122.99.1 - 0 0 0 0
ie1-12-1 1500 11.168.6.0/24 11.168.6.227 430276 651 0 0
ie1-12-2 1500 10.122.72.0/24 10.122.72.1 0 0 0 3144
ie1-12-3 1500 10.122.73.0/24 10.122.73.1 0 0 3142 0
ie1-12-4 1500 10.122.74.0/24 10.122.74.1 0 0 3141 0
The columns in the interface table contain the following information:

Column

Description

Name
The name of the interface:

  • ie0 or ie[shelf]-[slot]-[item] is an Ethernet interface.

  • lo0 is the loopback interface.

  • rj0 is the reject interface, used in network summarization.

  • bh0 is the blackhole interface, used in network summarization.

  • wanN is a WAN connection, entered as it becomes active.

  • wanabe indicates an inactive RADIUS dialout profile.

MTU
(Maximum Transmission Unit) The maximum packet size allowed on the interface.

Net/Dest
The network or the target host this interface can reach.

Address
The address of this interface.

Ipkts
The number of packets received.

Ierr
The number of packets that contain errors.

Opkts
The number of packets transmitted.

Oerr
The number of transmitted packets that contain errors.

Displaying the routing table

To display the routing table, specify the -rn option. For example:

admin> netstat -rn
Destination         Gateway        IF        Flg    Pref  Metric Use       
Age
0.0.0.0/0         206.65.212.1   ie0      SG     100   1    4891      
48630
10.0.0.0/24 11.168.6.249 ie1-12-1 RGT 100 3 0 9236
10.0.100.0/24 11.168.6.86 ie1-12-1 RGT 100 2 0 48601
10.0.200.0/24 11.168.6.86 ie1-12-1 RGT 100 2 0 48601
10.122.72.0/24 - ie1-12-2 C 0 0 3141 48630
10.122.72.1/32 - lo0 CP 0 0 0 48630
10.122.73.0/24 - ie1-12-3 C 0 0 3140 48630
10.122.73.1/32 - lo0 CP 0 0 0 48630
10.122.74.1/32 - lo0 CP 0 0 0 48630
10.122.99.0/24 10.122.99.1 wan4 SG 100 7 0 48630
10.122.99.1/32 10.122.99.1 wan4 S 100 7 1 48630
127.0.0.1/32 - local CP 0 0 0 48672
127.0.0.2/32 - rj0 CP 0 0 0 48672
127.0.0.3/32 - bh0 CP 0 0 0 48672
11.0.2.0/24 11.168.6.249 ie1-12-1 RGT 100 2 0 48626
11.168.6.0/24 - ie1-12-1 C 0 0 14589 48630
11.168.6.0/24 11.168.6.116 ie1-12-1 *RGTM 100 8 0 48606
11.168.6.0/24 11.168.6.142 ie1-12-1 *RGTM 100 8 0 48610
11.168.6.0/24 11.168.6.96 ie1-12-1 *RGTM 100 8 0 48624
11.168.6.102/32 11.168.6.86 ie1-12-1 RGT 100 8 0 48601
11.168.6.115/32 11.168.6.116 ie1-12-1 RGT 100 8 0 48606
224.0.0.0/4 mcast CP 0 0 0 59593
255.255.255.255/32- ie0 CP 0 0 0 48630
The columns in the routing table contain the following information:

Column

Description

Destination
The route's target address. To send a packet to this address, the MAX TNT uses this route. If the target address appears more than once in the routing table, the MAX TNT uses the most specific route (having the largest subnet mask) that matches that address.

Gateway
The next hop router that can forward packets to the given destination. Direct routes (without a gateway) show a hyphen in this column.

IF
The name of the interface through which to send packets over this route:

  • ie0 or ie[shelf]-[slot]-[item] is an Ethernet interface.

  • lo0 is the loopback interface.

  • rj0 is the reject interface, used in network summarization.

  • bh0 is the blackhole interface, used in network summarization.

  • wanN is a WAN connection, entered as it becomes active.

  • wanabe indicates an inactive RADIUS dialout profile.

  • local indicates a single route targeted at the local machine.

  • mcast indicates a route to a virtual device. The route encapsulates the multicast forwarder for the entire class D address space.

Flg
One or more of the following flags:

  • C-a directly connected route, such as Ethernet

  • I-an ICMP redirect dynamic route

  • N-placed in the table via SNMP MIB II

  • O-A route learned from OSPF

  • R-a route learned from RIP

  • r-a transient RADIUS-like route

  • S -a static route

  • ?-a route of unknown origin, which indicates an error

  • G-an indirect route via a gateway

  • P-a private route

  • T-a temporary route

  • M-a multipath route

  • *-a backup static route for a transient RADIUS-like route

Pref
The preference value. See the description of the Preference parameter for information about defaults for route preferences.

Metric
A RIP-style metric for the route, with a range of 0-16. Routes learned from OSPF show a RIP metric of 10. OSPF cost-infinity routes show a RIP metric of 16.

Use
A count of the number of times the route was referenced since it was created. (Many of these references are internal, so this is not a count of the number of packets sent over this route.)

Age
The age of the route in seconds.

Displaying protocol statistics

You can include identifiers in the command line to display IP, UDP, TCP, ICMP, IGMP, and multicast protocol statistics. The system displays TCP statistics collected from slot cards as well as the shelf controller. All other types of statistics are collected for the shelf controller only.

The following example contains the tcp identifier:

admin> netstat -s tcp 
tcp:
17 active opens
160 passive opens
0 connect attempts failed
9 connections were reset
4294967215 connections currently established
75620 segments received
82645 segments transmitted
313 segments retransmitted
1 active closes
1 passive closes
0 disconnects while awaiting transmission
See Also: NSlookup, Ping, Rlogin, Traceroute

New

Description: Creates an instance of the specified profile type and makes the new profile the working profile. You can also use the command to assign the profile its index value. To write a new profile, you must uniquely identify it by setting its index field. In a profile listing, a parameter name followed by an asterisk identifies the index field.

In most cases, the profile's parameters are assigned default values. However, depending on the profile type, the index chosen might affect the factory default values set in the profile. (For details, see page 1-63.)

Permission level: System

Usage: new profile-type [profile-index]

Syntax element

Description

profile-type
The type of profile you want to create.

profile-index
The index value of the profile.

If you create a new indexed profile without using the profile-index argument, a default index (usually null or zero) is used. For example:

Profile type

Default index

User

""

Serial

{ any-shelf any-slot 0 }

Ethernet

{ any-shelf any-slot 0 }

IP-Interface

{ { any-shelf any-slot 0 } 0 }


Note: If you specify the profile-index on the command line, it is validated before use. For example:

admin> new t1 {12 2 3}
error: bad index: unknown value "12"
admin> new system foo
error: profile has no index
If you specify a valid index, it is applied to the new profile, which is read into the edit buffer. For example:

admin> new t1 {1 2 3} 
T1/{ shelf-1 slot-2 3 } read
admin> list
physical-address*={ shelf-1 slot-2 3 }
line-interface={ no d4 ami eligible middle-priority inband +
Example: To create a new Connection profile called Tim:

admin> new conn tim
CONNECTION/tim read
admin> list
station*=tim
active=no
encapsulation-protocol=mpp
called-number-type=national
dial-number=""
clid=""
ip-options={ yes yes 0.0.0.0/0 0.0.0.0/0 7 100 255 no no 0 0.0.0.0 rou+
session-options={ "" "" no 120 no-idle 120 "" }
telco-options={ ans-and-orig no off 1 no no 56k-restricted 0 "" "" no +
ppp-options={ "" "" stac 1524 no 600 600 }
mp-options={ 1 1 2 }
mpp-options={ "" quadratic transmit 1 1 15 5 10 70 }
tcp-clear-options={ "" 0 }
answer-options={ }
usrRad-options={ global 0.0.0.0 1646 "" 1 acct-base-10 }
calledNumber=""
admin> write
CONNECTION/tim written
Dependencies: The index you choose might affect the factory default values set in the profile. For example, if you specify the profile-index default for a User profile, the factory default permission settings are as follows:

admin> new user default
USER/default read
admin> list
name*=default
password=""
active-enabled=yes
allow-termserv=no
allow-system=no
allow-diagnostic=no
allow-update=no
allow-password=no
allow-code=no
allow-debug=no
idle-logout=0
prompt=*
default-status=no
top-status=general-info
bottom-status=log-window
left-status=connection-list
use-scroll-regions=no
log-display-level=none
If you specify the profile-index admin instead, the factory-default permissions are set as follows:

admin> new user admin
USER/admin read
admin> list
name*=admin
password=Ascend
active-enabled=yes
allow-termserv=yes
allow-system=yes
allow-diagnostic=yes
allow-update=yes
allow-password=no
allow-code=yes
allow-debug=no
idle-logout=0
prompt=*
default-status=no
top-status=general-info
bottom-status=log-window
left-status=connection-list
use-scroll-regions=no
log-display-level=error
See Also: Delete, List, Read, Set, Write

NSlookup

Description: Resolves the IP address of a specified hostname by performing a DNS lookup. The IP-Global profile must be configured with the address of at least one DNS server. For information about configuring DNS, see the MAX TNT Network Configuration Guide.

Permission level: Diagnostic

Usage: nslookup hostname

Syntax element

Description

hostname
The hostname for which you want to obtain an IP address.

Example: To look up a host's IP address in DNS:

admin> nslookup host-231
Resolving host host-231.
IP address for host host-231 is 10.65.12.231.
See Also: ARPtable, Netstat

NVRAM

Description: Provides functions for managing or clearing onboard nonvolatile random access memory (NVRAM). The onboard NVRAM stores the system configuration. Clearing NVRAM initializes the system. It comes up unconfigured, just as it was when you first installed it. You can then restore the configuration from a recent backup. For details, see the MAX TNT Administration Guide.

Permission level: Update

Usage: nvram -f|-t|-u|-c|-?

Option

Description

-f
Clear NVRAM without prompting for confirmation.

-t
Toggle module debug level.

-u
Display NVRAM usage statistics.

-c
Compact the NVRAM storage.

-?
Display a usage summary.

Example: To display memory usage information, specify the -u option:

admin> nvram -u
NVRAM seg[0]:start 14000098 size 258040 avail 191680 cmpct 0
You can enter the command without any arguments to clear NVRAM and reset the unit:

admin> nvram
Clear configuration and reboot? [y/n]
See Also: Load, Save, Reset

Open

Description: Each slot card has its own processor, memory, operating system, and set of debug commands. The Open command sets up a Telnet-like session across the control bus to one of the slot cards. Then you can execute commands on that slot card.

Permission level: Diagnostic

Usage: open 1..9 [1..16]

Syntax element

Description

1..9
The shelf number in a multishelf system.

1..16
The number of the expansion slot you want to diagnose.

Example: On the master shelf of a multishelf system, you might open a session with a slave shelf (for example, shelf 3) as follows:

admin> open 3
You can then execute commands on the slave shelf as usual, except that you cannot use the Open command from the slave shelf. If you do execute the Open command, the following error message appears:

Can't use open command on a slave shelf.
To open a session with a T1 card installed in shelf 1, slot 13:

admin> open 1 13
The prompt changes to show your location, and you can list the available commands:

t1-1/13> ?
?                              ( user )
auth ( user )
cbcardif ( debug )
checkd ( debug )
clear ( user )
clock-source ( diagnostic )
debug ( diagnostic )
debugd ( debug )
display ( debug )
dp-ram-display ( debug )
dpram-test ( debug )
dspBypassClients ( debug )
dspDial ( debug )
dspSetDddTimeslot ( debug )
fe-loop ( diagnostic )
fill ( debug )
frreset ( debug )
gdb ( debug )
help ( user )
lifDebug ( debug )
logdebug ( debug )
logtest ( debug )
mibcbagt ( debug )
mibcbreq ( debug )
mibmgr ( debug )
modify ( debug )
nailedState ( debug )
nlcb ( debug )
open ( diagnostic )
pools ( debug )
priDisplay ( diagnostic )
quiesce ( debug )
quit ( user )
revision ( debug )
slots ( debug )
stackLimit ( debug )
stackUsage ( debug )
tdm ( debug )
timedMsgTest ( debug )
tntuart ( debug )
tprofmgr ( debug )
tss ( debug )
update ( debug )
version ( system )
whoami ( user )
To return to the shelf controller:

t1-1/13> quit
See Also: Show, Slot

OSPF

Description: Displays information related to OSPF routing, including Link-State Advertisements (LSAs), border routers' routing tables, and the OSPF areas, interfaces, statistics, and routing table.

You use the OSPF and OSPF-Options profiles to configure OSPF routing. For information, see the description of the OSPF and OSPF-Options subprofile.

Permission level: Diagnostic

Usage: ospf options

where options may be one or more of the following:

Option

Description

?
Display help information.

areas
Display OSPF areas.

border-routers 
Display OSPF border-router information.

database 
Display OSPF link-state database.

errors 
Display OSPF errors.

general 
Display OSPF general information.

interfaces 
Display OSPF interfaces.

neighbor 
Display OSPF neighbors.

rtab 
Display OSPF routing table.

timer-queue 
Display OSPF timer queue.

stats 
Display OSPF stats.

Displaying information about OSPF areas

To display information about OSPF areas, include the areas option with the OSPF command:

admin> ospf areas
Area ID: 0.0.0.0
Auth Type: Simple Passwd Import ASE: On Spf Runs: 5
Local ABRs: 0 Local ASBRs: 2 Inter LSAs: 3 Inter Cksum sum: 0x22298
The output includes the following fields:

Field

Description

Area ID 
The area number in dotted-decimal format. You use the Area parameter to configure the area ID.

Auth Type
The type of authentication, simple or null. You use the Authen-Type parameter to configure the type of authentication in use.

Import ASE 
Specifies whether the router is an Area Border Router (ABR). This functionality is always On in the MAX TNT.

Spf Runs 
How many times the SPF calculation was run. The calculation is performed every time the router notes a topology change or receives an update from another router.

Local ABRs 
The number of Area Border Routers (ABRs) and the number of areas that the router knows about. The number 0 (zero) means that the router knows about the backbone area only.

Local ASBRs 
The number of Autonomous System Border Routers (ASBRs) the router knows about.

Inter LSAs 
The number of entries in the link-state database.

Inter Cksum sum 
The checksum that is used to note that a database has changed.

Displaying information about AS border routers

To display AS border-router information, include the border-routers option with the OSPF command:

admin> ospf border-routers

Field

Description

Dest 
IP address of an Area Border Router (ABR) that the MAX TNT knows about.

Area 
ID of the area handled by the ABR.

Cost
Cost of the route.

E 
Cost of the link. (The cost of a route is the sum of the cost of each intervening link, including the cost to the connected route.)

Path 
Type of link: EXT (exterior), INT (interior), or STUB (a default).

Nexthop 
The IP address of the router through which the MAX TNT can reach an ABR.

AdvRtr
The router that advertised the route to the ABR. Sometimes a router advertises routes for which it is not the gateway.

The output includes the following fields:

Displaying the link-state database

To display the router's link-state database, use the database option. For example:

admin> ospf database
                Stub Link States (Area 0.0.0.10)
Link ID Adv Router Age Len Seq# Metric
11.57.4.254 11.57.4.254 410 24 0x0 0
10.31.114.0 10.31.114.0 410 24 0x0 0
10.31.114.254 10.31.114.254 420 24 0x0 0
                Router Link States (Area 0.0.0.10)
Link ID Adv Router Age Len Seq# Metric
11.57.4.8 11.57.4.8 577 36 0x80000021 0
11.57.4.254 11.57.4.254 420 60 0x80000024 0
10.31.114.254 10.31.114.254 421 60 0x80000019 0

Network Link States (Area 0.0.0.10)
Link ID Adv Router Age Len Seq# Metric
11.57.4.8 11.57.4.8 421 32 0x8000000a 0

Summary Net Link States (Area 0.0.0.10)
Link ID Adv Router Age Len Seq# Metric
10.103.0.0 11.57.4.8 708 28 0x80000009 10
10.103.0.3 11.57.4.8 708 28 0x80000009 30
10.103.0.4 11.57.4.8 708 28 0x80000009 30
10.103.0.254 11.57.4.8 106 28 0x80000001 30
10.104.0.0 11.57.4.8 708 28 0x80000009 21
10.104.0.2 11.57.4.8 708 28 0x8000000c 20
10.105.0.0 11.57.4.8 243 28 0x80000003 11
10.106.0.0 11.57.4.8 254 28 0x80000001 11
10.108.0.0 11.57.4.8 256 28 0x80000001 11
10.113.0.0 11.57.4.8 710 28 0x80000003 11
10.114.0.0 11.57.4.8 710 28 0x80000009 22
10.115.0.0 11.57.4.8 236 28 0x80000001 12
10.123.0.0 11.57.4.8 710 28 0x80000009 10
10.233.0.0 11.57.4.8 287 28 0x80000001 11
10.234.0.0 11.57.4.8 287 28 0x80000001 11
10.236.0.0 11.57.4.8 287 28 0x80000001 11
101.108.0.0 11.57.4.8 256 28 0x80000001 11
10.11.57.0 11.57.4.8 108 28 0x80000001 21
10.11.57.254 11.57.4.8 118 28 0x80000001 20
201.108.0.0 11.57.4.8 256 28 0x80000001 11

Type-5 AS External Link States (Area 0.0.0.10)
Link ID Adv Router Age Len Seq# Metric
11.67.0.0 10.31.114.254 531 36 0x8000000b 1
199.199.10.0 11.57.4.254 5 36 0x80000014 1
The database is segmented by the type of link as defined in RFC 1583:

Link type

Description

Stub link states

Summary-LSAs that describe point-to-point routes to networks or AS boundary routers.

Router link states

Describe the collected states of the router's interfaces.

Network link states

Describe the set of routers attached to the network.

Type-5 AS-external link states

Describe static routes to destinations external to the Autonomous System. A default route for the Autonomous System can also be described by an AS-external-LSA.

For each type of link other than external, the database request shows the area number and the following additional information:

Field

Description

Link ID
Target address of the route.

Adv Rtr
Address of the advertising router.

Age 
Age of the route in seconds.

Len 
Length of the LSA.

Seq # 
Hexadecimal number that begins with 80000000 and increments by one for each LSA received.

Metric
Cost of the link, not of a route. The cost of a route is the sum of all intervening links, including the cost of the connected link.

Displaying detailed information about a route in the database

The database option includes suboptions for focusing on particular areas of the database. To display the suboptions, enter the OSPF command with the database ? arguments:

admin> ospf database ?
ospf database ?        Display help information
ospf database asb Display OSPF ASB summary link states
ospf database ase Display OSPF external link states
ospf database network Display OSPF network link states
ospf database router Display OSPF router link states
ospf database summary Display OSPF network summary link states
ospf database ase7 Display OSPF type-7 external link states
For example, you might focus on the network link states:

admin> ospf database network
                Network Link States (Area 0.0.0.0)
 LS Age: 1473
Options: No TOS-capability
Link State ID: 10.168.6.181
Advertising Router: 10.168.6.181
Sequence Number: 0x80000003
Checksum: 0x8e58
Length: 32
Network Mask: /24
Attached Router: 10.168.6.181
Attached Router: 10.168.6.148
The following example shows information about Type-7 ASE link states:

admin> ospf database ase7

Type-7 AS External Link States (Area 0.0.0.10)

LS Age: 539
Options: No TOS-capability
Link State ID: 11.67.0.0
Advertising Router: 10.31.114.254
Sequence Number: 0x8000000b
Checksum: 0x7f9f
Length: 36
Network Mask: /16
Metric Type (bit E): 1
TOS: 0
Metric: 1
Forwarding address: 10.31.114.254
External Route Tag: c0000000

LS Age: 13
Options: No TOS-capability
Link State ID: 199.199.10.0
Advertising Router: 11.57.4.254
Sequence Number: 0x80000014
Checksum: 0x99cd
Length: 36
Network Mask: /24
Metric Type (bit E): 1
TOS: 0
Metric: 1
Forwarding address: 11.57.4.254
External Route Tag: c0000000

Displaying information about packet errors

To display OSPF errors, include the errors option with the OSPF command. For example:

admin> ospf errors
ERRORS from:                       boot
0: IP: Bad OSPF pkt type 0: IP: Bad IP Dest
0: IP: Bad IP proto id 0: IP: Pkt src=my IP addr
0: OSPF: Bad OSPF version 0: OSPF: Bad OSPF checksum
0: OSPF: Bad intf area id 0: OSPF: Area mismatch
0: OSPF: Bad virt link info 0: OSPF: Auth type != area type
0: OSPF: Auth key != area key 0: OSPF: Packet is too small
0: OSPF: Packet size > IP length 0: OSPF: Transmit bad
1: OSPF: Received on down IF 0: Hello: IF mask mismatch
0: Hello: IF hello timer mismatch 0: Hello: IF dead timer mismatch
909: Hello: Extern option mismatch 0: Hello: Nbr Id/IP addr confusion
0: Hello: Unknown Virt nbr 0: Hello: Unknown NBMA nbr
0: DD: Unknown nbr 0: DD: Nbr state low
0: DD: Nbr's rtr=my rtrid 0: DD: Extern option mismatch
17: Ack: Unknown nbr 0: Ack: Nbr state low
0: Ls Req: Nbr state low 0: Ls Req: Unknown nbr
0: Ls Req: Empty request 0: LS Req: Bad pkt
0: LS Update: Nbr state low 21: Ls Update: Unknown nbr
0: Ls Update: Newer self-gen LSA 0: Ls Update: Bad LS chksum
5: Ls Update: less recent rx 0: Ls Update: Unknown type
The output lists all error messages related to OSPF, with each message preceded by the number of times it has been generated since the MAX TNT powered up. Immediately following the number is a field indicating one of the following packet types:

Displaying general information about OSPF routing

To display general information about OSPF, include the general option with the OSPF command:

admin> ospf general
Or, you can simply enter the OSPF command without any arguments. For example:

admin> ospf
Rtr ID: 10.168.6.148
Status: Enabled Version: 2 ABR: Off ASBR: On
LS ASE Count: 4 ASE Cksum sum: Ox241b3 Tos Support: TOS 0 Only
New LSA Originate Count: 17 Rx New LSA Count: 9
In either case, the output contains the following fields:

Field

Description

Rtr ID
Contains the IP address assigned to the MAX TNT Ethernet interface.

Status 
Shows whether OSPF is enabled or disabled.

Version 
Indicates the version of the OSPF protocols running.

ABR 
Indicates On or Off, depending on where the MAX TNT is situated on the network. If ABR is On, the MAX TNT performs additional calculations related to external routes.

ASBR 
Always On in the MAX TNT. Although the MAX TNT cannot function as an IGP gateway, it does import external routes (for example, when it establishes a WAN link with a caller that does not support OSPF). The ASBR calculations are always performed.

LS ASE Count 
Specifies the number of link-state database entries that are external.

ASE Cksum sum 
Specifies a checksum used to note that ASE routes in the database have changed.

TOS Support 
Shows the level of TOS support in the router.

New LSA Originate Count 
Shows the number of LSAs this router created.

Rx New LSA Count 
Shows the number of LSAs this router received from other OSPF routers.

Displaying OSPF interfaces

To display the OSPF interfaces, include the interfaces option with the OSPF command:

admin> ospf interfaces
Area IP Address Remote Addr Type State Cost Pri DR BDR
----------------------------------------------------------------------
0.0.0.0 10.2.6.4 10.2.6.4 Bcast BackupDR 1 5 10.2.6.8 10.2.6.4
The output contains the following fields:

Field

Description

Area 
Area ID. (0.0.0.0 is the backbone.)

IP Address
Ethernet interface IP address.

Type 
Broadcast (Ethernet) or point-to-point (WAN links).

State 
How far along the router is in the process of electing a DR or BDR. The state can be 1-way (indicating that the election process has begun), 2-way (indicating that the router has received notification), BackupDR, or DR.

Cost 
Metric assigned to the link. The default cost for Ethernet is 1.

Pri 
Designated router-election priority assigned to the MAX TNT.

DR 
Designated router.

BDR 
Backup designated router.

Displaying OSPF neighbors

To display adjacencies, include the neighbor option with the OSPF command. For example:

admin> ospf neighbor
Area Interface Router Id Nbr IP Addr State Mode Pri
0.0.0.0 10.168.6.148 10.168.6.181 10.168.6.181 Full Slave 5
The output contains the following fields:

Field

Description

Area 
Area ID.

Interface
Address assigned to the interface. In the MAX TNT, the IP address is always the address assigned to the Ethernet interface.

Router Id 
IP address of the router used to reach a neighbor, often the same address as that of the neighbor itself.

Nbr IP Addr 
IP address of the neighbor.

State 
State of the link-state database exchange. Full means that the databases are fully aligned between the MAX TNT and its neighbor.

Mode
Whether the neighbor is functioning in master or slave mode. The master sends Database Description packets (polls) which are acknowledged by Database Description packets (responses) sent by the slave.

Pri 
Designated router-election priority assigned to the MAX TNT.

Displaying the OSPF routing table

To display the OSPF routing table, include the rtab option with the OSPF command. For example:

admin> ospf rtab
Dest             Area    Cost E  Path Nexthop         AdvRtr        L
AS Border Routes:
10.168.6.181 0.0.0.0 1 RTR 10.168.6.181 10.168.6.181
10.168.6.148 0.0.0.0 0 RTR 0.0.0.0 10.168.6.148
Nets: Rtab Version 5
0.0.0.0/0 0.0.0.0 2 0 EXT 10.168.6.181 10.168.6.181 0
8.0.0.0/8 imported: 2
10.168.6.0/24 0.0.0.0 1 0 INT 10.168.6.148 10.168.6.181 1
10.168.6.152/32 imported: 2
The routing table is segmented by the type of route. Each segment contains the following fields:

Field

Description

Dest
Destination address of the area shown in the Area field.

Area
Area ID.

Cost
Cost of the route.

E
Cost of the link. (The cost of a route is the sum of the cost of each intervening link, including the cost to the connected link.)

Path
Type of link: EXT (exterior), INT (interior), RTR (Router), or STUB (a default).

Nexthop
Target address from this router.

AdvRtr
Advertising router. Sometimes a router will advertise routes for which it is not the gateway.

Displaying the timer queue

To display information about the timer queue, include the timer-queue option with the OSPF command. For example:

admin> ospf timer-queue
Current Timerq:
Type         Minutes Seconds Area         Intf
-----------------------------------------------------------
LOG alert, Shelf 1, Controller, Time: 10:38:05--
Protection violation: ind = 00010000 addrType = 00001000 at 00000000
102b355c 10322228 10322424 102220c4 1023830c
TQAck              0       1 No Area       0.0.0.0
TQRetrans 0 5 No Area 192.168.8.25
TQLsaLock 0 5 0.0.0.0 No Intf
TQHelloTimer 0 5 No Area 192.168.8.25
TQAse7LsdbAge 0 17 No Area No Intf
TQAseLsdbAge 0 41 No Area No Intf
TQIntLsdbAge 2 35 No Area No Intf
TQSumLsdbAge 3 12 No Area No Intf
TQIntLsa 5 54 No Area No Intf
TQAse7Lsa 12 48 No Area No Intf
TQAseLsa 12 48 No Area No Intf

Displaying packet statistics

To display information about packets sent and received by the OSPF protocol, include the stats option with the OSPF command. For example:

admin> ospf stats
IO stats from:                       boot
>> RECEIVED:
0: Monitor request
481: Hello
2: DB Description
0: Link-State Req
8: Link-State Update
8: Link-State Ack
>> SENT:
482: Hello
3: DB Description
2: Link-State Req
11: Link-State Update
8: Link-State Ack

Ping

Description: Sends ICMP echo_request packets to the specified host as a way to verify that the host is up and the transmission path to the host is open. The host returns ICMP echo_response packets, and the command generates statistics about the exchange.

Permission level: Diagnostic

Usage: ping [-q|-v][-c count][-i delay][-s packetsize] hostname

Syntax element

Description

-q
Quiet. Do not display informational messages. Just display the summary lines at the beginning and end of the command.

-v
Verbose. List every ICMP packet received, except echo_response packets.

-c count
Send only the specified number of packets.

-i delay
Wait the specified number of seconds before sending the next packet. The default delay period is one second.

-s packetsize
Send the specified number of data bytes. The default size is 64 bytes, not including the 8-byte ICMP header. The minimum is 16.

hostname
The station's IP address or DNS hostname.

Example: Pinging a host named Host-231 on a local network:

admin> ping host-231
PING host-231 (10.65.12.231): 56 data bytes
64 bytes from 10.65.12.231: icmp_seq=0 ttl=255 time=0 ms
64 bytes from 10.65.12.231: icmp_seq=1 ttl=255 time=0 ms
64 bytes from 10.65.12.231: icmp_seq=2 ttl=255 time=0 ms
64 bytes from 10.65.12.231: icmp_seq=3 ttl=255 time=0 ms
64 bytes from 10.65.12.231: icmp_seq=4 ttl=255 time=0 ms
^C
--- host-231 ping statistics ---
5 packets transmitted, 5 packets received, 0% packet loss
round-trip min/avg/max=0/0/0 ms
Press Ctrl-C to stop. To exchange only 3 packets, each of which contains only 16 bytes:

admin> ping -c 3 -s 16 host-231
PING host-231 (10.65.12.231): 8 data bytes
16 bytes from 10.65.12.231: icmp_seq=0 ttl=255 time=0 ms
16 bytes from 10.65.12.231: icmp_seq=1 ttl=255 time=0 ms
16 bytes from 10.65.12.231: icmp_seq=2 ttl=255 time=0 ms
--- host-231 ping statistics ---
3 packets transmitted, 3 packets received, 0% packet loss
round-trip min/avg/max=0/0/0 ms
To exchange 3 packets and suppress the output for each exchange:

admin> ping -c3 -q host-231
PING host-231 (10.65.12.231): 56 data bytes
--- host-231 ping statistics ---
3 packets transmitted, 3 packets received, 0% packet loss
round-trip min/avg/max=0/0/0 ms
See Also: Netstat Rlogin, Telnet, Terminal-Server, Traceroute

Power

Description: Checks the status of the MAX TNT redundant power supplies and displays the results.

Permission level: System

Usage: power

Example: To check the power supply:

admin> power
Power supply A present, OK
Power supply B not present

PRIdisplay

Description: For a T1, E1, or T3 card, displays general PRI messages, shows a timestamp relative to the time the card booted, and identifies PRI messages that have bad CRCs or are too long.

You can use PRIdisplay on a T1, E1, or T3 card only. You must first execute the Open command to open a session with the card.

Permission level: Diagnostic

Usage: pridisplay octets [line]

Syntax element

Description

octets
The maximum number of octets to display per message. If you specify 0 (zero), the MAX TNT does not display any data.

line
The line whose D channel you want to monitor.

Example: To open a session with a T3 card in shelf 1, slot 15, and then display the first 160 bytes of PRI messages:

admin> open 1 15
t3-1/15> pridisplay 160
Display the first 160 bytes of PRI messages
PRI-XMIT-24: 01:38:53: 3 of 3 octets
1010A850: 00 01 7f ...
PRI-RCV-24: 01:38:55: 3 of 3 octets
10112C10: 00 01 7f ...
PRI-RBAD-22: 01:38:53: 2 of 2 octets
1010A850: 00 01
In the following example, the first command displays the first 32 bytes of PRI messages for line 12 only. The second command enables display of the first 32 bytes of messages for any line on the card, and the third command turns off the message display:

t3-1/15> prid 32 12
Display the first 32 bytes of PRI messages for line 12
t3-1/15> prid 32 0 
Display the first 32 bytes of PRI messages
t3-1/15> prid 0 
PRI message display terminated
To close the session with the card and return to the shelf controller:

t3-1/15> quit
admin>

Quiesce

Description: Allows you to Busy Out or take Out Of Service (OOS) individual ISDN T1 PRI lines or channels connected to the MAX TNT. These actions are known as quiescing the line or channel to make it available for maintenance. Quiescing the line does not tear down calls that are currently active on the line. When an active call disconnects, that channel is taken OOS.

Quiescing a line is equivalent to setting the Maintenance-State parameter in the T1 profile to Yes. Unquiescing the line sets the parameter to No. When the parameter is set to Yes, individual channels on that line cannot be restored. See Chapter 2, MAX TNT Profile and Parameter Reference. This setting is preserved across power ups.

Whether the command takes a channel or line out of service or busies it out depends on the type of switch.

Type of switch

Description

AT&T switches running Custom generics

AT&T Custom generics support Service Messages that allow the MAX TNT to tell the switch to take channels on an ISDN PRI line OOS. The line-status window displays the condition as an o in an OOS channel. When all channels on the line are OOS, the switch can route incoming calls to other lines in a particular hunt group.

AT&T switches running NI-2 generics and Northern Telecom switches

Neither AT&T nor Northern Telecom switches running NI-2 software support Service Messages to take channels OOS. There is no sure way for the MAX TNT to tell the switch to take a channel OOS. Because channels cannot be taken OOS, incoming calls are presented to the MAX TNT even if the ISDN T1 PRI line is quiesced. The MAX TNT rejects the call with a cause code of 17, User Busy. The user originating the call receives a busy signal. This situation can pose a problem for ISPs who would like to have the switch automatically route incoming calls to another, nonquiesced trunk in the hunt group.


Note: Restoring a quiesced line or channel can take up to 3.5 minutes. Only 1 service message per channel is sent to the switch, at the rate of one per second.

Permission level: System

Usage: quiesce -d|-e|-r line|-q line|-t

Option

Description

-d
Quiesce a single DS0 channel (a B channel on any T1 PRI line).

-e
Restore a single DS0 channel that has been quiesced.

-r line
Restore the specified T1 PRI line that has been quiesced.

-q line
Quiesce the specified T1 PRI line.

-t 
Toggle debug display.

Example: To quiesce a T1 PRI line in port 4 of a card installed in shelf 1, slot 2:

admin> quiesce -q {1 2 4}
QUIESCE: line 1/2/4, enable=T, isPri=T
Dependencies: The specified T1 line must be enabled and configured for ISDN PRI.

See Also: Chapter 2, MAX TNT Profile and Parameter Reference

Quit

Description: Terminates the current Telnet session.

Permission level: User

Usage: quit

Example: To terminate the current Telnet session:

admin> quit
Connection closed by foreign host.
my-station%

Read

Description: Reads a copy of the specified profile into the edit buffer, making it the working profile. If the profile is one of a kind, such as the IP-Global profile, it has no index field. If an index field exists for a profile, it must be specified on the command line.

Only the working profile can be modified. The Set and List commands apply only to the working profile.


Note: The working profile remains in the edit buffer until you overwrite the buffer with another Read command or the New command. To save changes made in the buffer, you must use the Write command.

Permission level: System

Usage: read profile-type [profile-index]

Syntax element

Description

profile-type 
The type of profile to be read (or the profile itself if it does not require an index specification).

profile-index
The name or address that distinguishes a profile from others of the same type. To see profile indexes, enter the Dir command (dir profile-type).

Example: To find the right index for an IP-Interface profile, read that profile, and list its contents:

admin> dir ip-interface
66 12/20/1997 14:02:02 { { shelf-1 slot-12 1 } 0 }
66 12/27/1997 16:34:40 { { shelf-1 slot-12 2 } 0 }
66 12/27/1997 16:34:47 { { shelf-1 slot-12 3 } 0 }
66 12/27/1997 16:34:54 { { shelf-1 slot-12 4 } 0 }
66 12/28/1997 00:21:06 { { shelf-1 controller 1 } 0 }
admin> read ip-int {{1 c 1} 0}
IP-INTERFACE/{ { shelf-1 controller 1 } 0 } read
admin> list
interface-address*={ { shelf-1 controller 1 } 0 }
ip-address=10.6.212.227/24
rip-mode=routing-send-and-recv
ospf={ no 0.0.0.0 normal 10 10 40 5 simple ******* 1 16777215 type-1 +
multicast-allowed=no
multicast-rate-limit=100
rip2-use-multicast=yes
The profile remains in the edit buffer until another Read command or a New command overwrites the buffer. The Set command modifies the profile. The Write command saves changes without clearing the buffer.

admin> set multicast-allowed=yes
admin> write
IP-INTERFACE/{ { shelf-1 controller 1 } 0 } written
The working profile is represented by a period character. Even after you have used the Get command to display other profiles, or have executed other commands, you can still use the Get command to display the working profile:

admin> get .
interface-address*={ { shelf-1 controller 1 } 0 }
ip-address=10.6.212.227/24
rip-mode=routing-send-and-recv
ospf={ no 0.0.0.0 normal 10 10 40 5 simple ******* 1 16777215 type-1 +
multicast-allowed=yes
multicast-rate-limit=100
See Also: Get, List, New, Set, Write

Refresh

Description: Opens a connection to a RADIUS server and retrieves the latest configuration information. See the MAX TNT RADIUS Guide.

Permission level: System

Usage: refresh -a|-n|-p|-r|-t

Option

Description

-a
Refresh all types of configuration.

-n
Refresh nailed profiles configuration.

-p
Refresh address pools configuration.

-r
Refresh static routes configuration.

-t
Refresh terminal server configuration.

Example: RADIUS profiles can support up to 50 IP address pools. To refresh the address pool configuration on the MAX TNT:

admin> refresh -p
Refreshing remote config.

Reset

Description: Resets the MAX TNT. When you reset the unit, it restarts, and all active connections are terminated. All users are logged out and the default security level is reactivated. In addition, a system reset can cause a WAN line to temporarily be shut down due to momentary loss of signaling or framing information. After a reset, the MAX TNT runs POST (power-on self tests).

Permission level: Update

Usage: reset [-f]

Option

Description

-f
Force a reset without prompting for confirmation.

-a
Reset the master shelf and all slaves in a multishelf system. You can use the -a option only when logged into the master shelf. The -a option is not valid on slave shelves.

[
-a]

Example: To reset the unit:

admin> reset
See Also: NVRAM

Rlogin

Description: Opens a login session across the network with the specified host. The Rlogin command is supported only on the modem and HDLC cards. You must first execute the Open command to open a session with the card.

Permission level: Diagnostic

Usage: rlogin [-l user][-ec] hostname

Syntax element

Description

-l user
Log into the remote host using the specified user name.

-ec
Define an escape character other than the default tilde. You can use the escape character to log out of the session.

hostname
The name of a networked host.

Example: Logging in across a network to a host named Host-231:

admin> open 1 7
modem-1/7> rlogin host-231
Password:
Last login: Wed Dec 18 10:31:36 from marcel.marceau
SunOS Release 4.1.4 (HOST-231-BQE) #1: Wed Sep 4 08:56:59 PDT 1997
host-231%
You can log out of the remote host by typing the escape sequence (tilde-dot). For example:

host-231% ~.
Connection closed.
Or, you can log out explicitly:

host-231% logout
Connection closed.
If your user name is different on the MAX TNT and the remote host, you can specify a user name on the Rlogin command line. For example:

modem-1/7> rlogin -l marcel host-231
Password:
If you wish, you can change the default escape character from a tilde to any other character.

See Also: Netstat, Ping, Telnet, Terminal-Server

Save

Description: Saves configuration information to a file. The file may reside either on the hard disk of the PC you are using to issue commands to the MAX TNT or on a networked host. The file is saved in a format that can be loaded into the MAX TNT to restore a configuration. The Save command uses TFTP to transfer the configuration across the network. To save the MAX TNT configuration on a remote host, you must have the necessary permissions in the directory.

Permission level: Update

Usage: save [-a|-m] target [profile-type [profile-index]]

Syntax element

Description

-a
Explicitly save all fields, even those with default values. If you do not specify this option, the file stores only those fields whose values have been changed from the default.

-m
Use MIB tags instead of field and value names, and use profile-type numbers rather than profile-type text names.

target
The destination of the file to be saved. Valid specifications are:

· network host filename- A network hostname or IP address and the path to the file on that host.

· console- The PC you are using in a terminal session.

profile-type
The type of profile to be read, or the profile itself if it does not require an index specification.

profile-index
The name or address that distinguishes a profile from others of the same type. To see profile indexes, enter the Dir command (dir profile-type).

Example: Saving all Connection profiles to a file on a PC's hard disk (after starting the capture utility in the VT100 emulation software):

admin> save console connection
; saving profiles of type CONNECTION
; profile saved Thu Jan 2 13:02:54 1997
new CONNECTION dallas
set active=yes
set ip-options remote-address=10.122.99.1/24
write -f
;
; profile saved Thu Jan 2 13:02:54 1997
new CONNECTION chicago
set active=yes
set dial-number=999
set ip-options remote-address=10.168.6.57/24
set ip-options routing-metric=2
set ppp-options send-auth-mode=chap-ppp-auth
set ppp-options send-password=********
set ppp-options recv-password=********
set mp-options base-channel-count=6
set mp-options minimum-channels=6
set mp-options maximum-channels=20
write -f
;
To save the file, stop the capture in the VT100 emulation software. To save the entire configuration to hard disk, start the capture utility and specify the console option:

admin> save console
; saving all profiles
...
All configured profiles and parameters scroll to the capture buffer. When the entire configuration has been displayed, the following output appears:

;
;
; all profiles saved
To save the file, stop the capture. The following example shows how to save a specific profile to a file on a network host:

admin> save network host-231 /users/marcel/ipglobal ip-g
configuration being saved to 10.65.12.231
file /users/marcel/ipglobal...save
admin>
The following example shows how to specify a profile type by its internal number when saving:

admin> save -m console system
; saving profiles of type SYSTEM
; profile saved Sat Mar 29 13:29:42 1997
new 3
set 1=1
set 2=eng-lab-43
write -f

Note: If the first item following a New, Read, or Dir command is numeric, it is assumed to be a profile-type number.

See Also: Load, NVRAM

SDSLlines

Description: Displays SDSL channel information.

Permission level: System

Usage: sdsllines -a|-d|-f|-u

Option

Description

-a
Display all available channels.

-d
Display the disabled channels.

-f
Display all possible channels.

-u
Display in-use channels.

Example: To display all SDSL channels available, use the -a option:

admin> sdsllines -a
All SDSL lines:
(dvOp dvUpSt dvRq sAdm nailg)
Line { 1 3 1 } (Up Idle UP UP 00001)
Line { 1 3 2 } (Up Assigned UP UP 00002)
Line { 1 3 3 } (Up Assigned UP UP 00003)
Line { 1 3 4 } (Up Idle UP UP 00004)
Line { 1 3 5 } (Up Idle UP UP 00005)
Line { 1 3 6 } (Up Assigned UP UP 00006)
Line { 1 3 7 } (Up Idle UP UP 00007)
Line { 1 3 8 } (Up Assigned UP UP 00008)
Line { 1 3 9 } (Up Assigned UP UP 00009)
Line { 1 3 10 } (Up Assigned UP UP 00010)
Line { 1 3 11 } (Up Assigned UP UP 00011)
Line { 1 3 12 } (Up Assigned UP UP 00012)
Line { 1 3 13 } (Up Assigned UP UP 00013)
Line { 1 3 14 } (Up Assigned UP UP 00014)
Line { 1 3 15 } (Up Assigned UP UP 00015)
Line { 1 3 16 } (Up Idle UP UP 00016)

The data displayed includes the physical address and channel number, and the following status information about each channel:

Column

Description

dvOp
The current operational state of the channel (also specified by the Device-State setting):

  • Down indicates that the channel is in a nonoperational state.

  • Up indicates that the channel is in normal operations mode.

dvUpSt
The status of the channel in normal operations mode:

  • Idle indicates that no call is on the line.

  • Active indicates that the channel is handling a call.

dvRq
The required state of the channel as specified by the Reqd-State setting:

  • Down indicates that the channel is required to be nonoperational.

  • Up indicates that the channel is required to be in normal mode.

SAdm
The desired administrative state of the channel (also specified by the Desired-State setting):

  • Down specifies that the channel should terminate all operations and enter the down state.

  • Up specifies that the channel should come up in normal operations mode.

The actual state of the channel can differ from the desired state, as when a device is powering up, or you change the desired state on a running slot. Changing the desired state does not force a channel to the new state. It indicates that the MAX TNT should change the channel state in a graceful manner.

nailg
The nailed group to which the line is assigned.

Set

Description: Sets a parameter's value or displays help text for a parameter in the current or specified context of the working profile. To save the new setting, you must write the working profile.

Permission level: System

Usage: set param-name [param-index] [subprofile]=value|?

Syntax element

Description

param-name
The name of the parameter in the current or specified context of the working profile.

param-index
A parameter index, which might be required for some complex or array parameters. (See the Physical-Address example below.)

subprofile
A subprofile name within the working profile. By specifying its name on the command line, you can set a parameter in a subprofile without opening the subprofile.

value
A legal parameter value.

?
A question mark as an argument to the Set command displays help text about the specified parameter.

Example: Enter the following commands to display help about a T1 line's physical address:

admin> read t1 {1 2 1}
T1/{ shelf-1 slot-2 1 } read
admin> list
physical-address*={ shelf-1 slot-2 1 }
line-interface={ no d4 ami eligible middle-priority inband wink-start+
admin> set physical-address slot ?
slot: The number of the slot that the addressed physical device resides on. Enumerated field, values:
any-slot: Special value used to specify 'any' slot.
slot-1: Slot 1.
slot-2: Slot 2.
slot-3: Slot 3.
slot-4: Slot 4.
slot-5: Slot 5.
slot-6: Slot 6.
slot-7: Slot 7.
slot-8: Slot 8.
slot-9: Slot 9.
slot-10: Slot 10.
slot-11: Slot 11.
slot-12: Slot 12.
slot-13: Slot 13.
slot-14: Slot 14.
slot-15: Slot 15.
slot-16: Slot 16.
controller: The shelf-controller pseudo-slot.
The following example shows how to open the Line-Interface subprofile and set the phone number for channel 1:

admin> list line
enabled=no
frame-type=d4
encoding=ami
clock-source=eligible
clock-priority=middle-priority
signaling-mode=inband
robbed-bit-mode=wink-start
switch-type=att-pri
nfas-id=0
call-by-call=0
data-sense=normal
idle-mode=flag-idle
FDL=none
front-end-type=dsx
DSX-line-length=1-133
CSU-build-out=0-db
channel-config=[{ switched-channel 9 "" { any-shelf any-slot 0 } 0 } +
maintenance-state=no
admin> set channel 1 phone=5551212
admin> write
T1/{ shelf-1 slot-2 1 } written
See Also: List, New, Read, Write

Show

Description: Displays information about installed slot cards and their status, including slot 17 (the controller) on slave shelves.

Permission level: System

Usage: show shelf-number [slot-number [item-number]]

Syntax element

Description

shelf-number
The number of a MAX TNT shelf.

slot-number
The number of an expansion slot in the specified shelf (1-16).

item-number
The number of a specific item (device or channel) on the slot card.

Example: To display all installed expansion modules on shelf 1:

admin> show 1
{ shelf-1 slot-1 0 } UP 8t1-card
{ shelf-1 slot-11 0 } UP 48modem-56k-card
{ shelf-1 slot-12 } OCCUPIED
{ shelf-1 slot-14 0 } UP 48modem-card
{ shelf-1 slot-15 } OCCUPIED
The output includes the address of each slot in which an expansion slot card is installed, the status of the card, and the type of card installed. The status can be one of the following:

Status

Description

UP 
Normal operational mode.

DOWN 
Not in an operational mode.

POST 
The devices in the card are running power-on self tests.

LOAD
The card is loading code as part of coming up.

RESET 
The card is being reset.

NONE
The card has been swapped out, but its configuration remains in flash space.

OCCUPIED 
The card is using two slots.

The following example shows how to display information about the HDLC card in slot 3:

admin> show 1 3
{ shelf-1 slot-3 0 } RESET 192hdlc-card:
{ shelf-1 slot-3 1 } hdlc-1
{ shelf-1 slot-3 2 } hdlc-2
{ shelf-1 slot-3 3 } hdlc-3
{ shelf-1 slot-3 4 } hdlc-4
{ shelf-1 slot-3 5 } hdlc-5
{ shelf-1 slot-3 6 } hdlc-6
On the master shelf, the Show command output includes slave shelf controllers that are Up. For example:

admin> show 1
Shelf 1 ( master ):
{ shelf-1 slot-1 0 } UP 8t1-card
{ shelf-1 slot-4 0 } UP 128hdlc-card
{ shelf-3 slot-1 0 } UP 128hdlc-card
{ shelf-3 slot-2 0 } UP 4ether-card
{ shelf-3 slot-3 0 } UP 8t1-card
{ shelf-3 slot-4 0 } UP 48modem-56k-card
{ shelf-3 slot-5 } OCCUPIED
{ shelf-3 controller 0 } UP shelf-controller
Dependencies: You cannot change the state of a slave shelf controller by using the Slot -u or Slot -d commands. If you do attempt to bring the slave shelf up or down by using one of these commands, the following error message appears:

can't force slot 3/17 state change
See Also: Device, HDLC, Modem, Slot, T1channels

Slot

Description: Changes the administrative state of a slot card, forcing a state change (up or down). The down state allows temporary removal of a card without the loss of its configuration.

Permission level: Diagnostic

Usage: slot -u|-d|-r|-t|-b|? [shelf-number] slot-number]

Syntax element

Description

-u
Bring up the specified slot card.

-d
Bring down the specified slot card.

-r
Delete the profiles for a card that has been removed.

-t
Toggle module debug level.

-b
Force hardware reset. The modem card can be reset while a connection is up.

-w
Change or display watchdog failure limit.

-?
Display a usage summary.

shelf-number
The number of a MAX TNT shelf.

slot-number
The number of an expansion slot in the specified shelf (1-16).

Example: To bring up the expansion module in slot 5:

admin> slot -u 5
slot 1/5 state change forced
In the next example, a card has been removed, as indicated by a status of NONE in the output of the Show command:

admin> show 1 13
Shelf 1 ( standalone ):
{ shelf-1 slot-13 0 } NONE 8t1-card:
{ shelf-1 slot-13 1 } t1-line-1
{ shelf-1 slot-13 2 } t1-line-2
{ shelf-1 slot-13 3 } t1-line-3
{ shelf-1 slot-13 4 } t1-line-4
{ shelf-1 slot-13 5 } t1-line-5
{ shelf-1 slot-13 6 } t1-line-6
{ shelf-1 slot-13 7 } t1-line-7
{ shelf-1 slot-13 8 } t1-line-8
The NONE status indicates that the card was removed but that its profiles have been saved. The MAX TNT remembers that a card was in that slot and saves its profiles until a card of a different type is installed in the same slot, or until you delete the profile:

admin> slot -r 13
slot 1/13 removed
Either action deletes all the old profiles associated with the slot. When you insert a different type of card, the system creates appropriate new profiles.

See Also: Device, HDLC, Open, Modem, Show, T1channels

Status

Description: Displays the status windows. You can configure the content of the windows to show connection, line, or log-message information. For detailed information, see the MAX TNT Administration Guide.

Permission level: System

Usage: status [on|off]

Syntax element

Description

on
Display the status windows.

off
Hide the status windows.

Example: To display status windows:

admin> status
Or,

admin> status on

To hide the windows:

admin> status
Or,

admin> status off
See Also: Connection, Line, Log, View

SWANlines

Description: Displays all SWAN lines, including disabled, busy, and unused channels.

Permission level: System

Usage: swanlines -a|-d|-f|-u

Option

Description

-a
Display all channels.

-d
Display all disabled channels.

-f
Display all free channels.

-u
Display in-use channels.

Example: To display all SWAN channels:

admin> swanlines -a
All SWAN lines:
(OperState UpStatus ReqState AdminState)
Line { 1 14 1 } (Down Idle UP UP )
Line { 1 14 2 } (Down Idle UP UP )
Line { 1 14 3 } (Down Idle UP UP )
Line { 1 14 4 } (Down Idle UP UP )
Line { 1 14 5 } (Down Idle UP UP )
Line { 1 14 6 } (Down Idle UP UP )
The output contains the following fields:

Field

Description

OperState
The current operational state of the channel:

  • Down indicates that the channel is in a nonoperational state.

  • Up indicates that the channel is in normal operations mode.

UpStatus
The status of a channel in normal operations mode:

  • Idle indicates that no call is on the channel.

  • Active indicates that the channel is handling a call.

ReqState
The required state of the channel as specified by the Reqd-State setting:

  • Down indicates that the channel is required to be nonoperational.

  • Up indicates that the channel is required to be in normal operations mode.

AdminState

The desired administrative state of the channel:

  • Down specifies that the channel should terminate all operations and enter the down state.

  • Up specifies that the channel should come up in normal operations mode.

The actual state of the channel can differ from the desired state, as when a device is powering up, or you change the desired state on a running slot. Changing the desired state does not force a channel to the new state. It indicates that the MAX TNT should change the channel state gracefully.

T1channels

Description: Displays administrative information about T1 channels.

Permission level: System

Usage: t1channels -a|-c|-d|-i

Option

Description

-a
Display information about all available T1 channels.

-c
Display information about all possible T1 channels (all channels on all installed T1 cards).

-d
Display information about disabled T1 channels.

-i
Display information about all T1 channels that are currently in use.

The T1channels command displays the following information

Column

Description

dvOp
The current operational state of the channel (also specified by the Device-State setting):

  • Down indicates that the channel is in a nonoperational state.

  • Up indicates that the channel is in normal operations mode.

dvUpSt
The status of the channel in normal operations mode:

  • Idle indicates that no call is on the line.

  • Busy indicates that the channel is handling a call.

dvRq
The required state of the channel as specified by the Reqd-State setting:

  • Down indicates that the channel is required to be in a nonoperational state.

  • Up indicates that the channel is required to be in normal operations mode.

SAdm
The desired administrative state of the channel (also specified by the Desired-State setting):

  • Down specifies that the channel should terminate all operations and enter the down state.

  • Up specifies that the channel should come up in normal operations mode.

The actual state of the channel can differ from the desired state, as when a device is powering up, or you change the desired state on a running slot. Changing the desired state does not force a channel to the new state. It indicates that the MAX TNT should change the channel state in a graceful manner.

:

Example: Include the -a option with the T1channels command to display information about all available T1 channels:

admin> t1 -a
T1 channels available for use:
(dvOp dvUpSt dvRq sAdm)
Channel { { 1 13 1 } 1 } (UP Idle UP UP )
Channel { { 1 13 1 } 2 } (UP Idle UP UP )
Channel { { 1 13 1 } 3 } (UP Idle UP UP )
Channel { { 1 13 1 } 4 } (UP Idle UP UP )
Channel { { 1 13 1 } 5 } (UP Idle UP UP )
Channel { { 1 13 1 } 6 } (UP Idle UP UP )
Channel { { 1 13 1 } 7 } (UP Idle UP UP )
Channel { { 1 13 1 } 8 } (UP Idle UP UP )
Channel { { 1 13 1 } 9 } (UP Idle UP UP )
Channel { { 1 13 1 } 10 } (UP Idle UP UP )
Channel { { 1 13 1 } 11 } (UP Idle UP UP )
If you suspect that some channels might be disabled, you can use the -d option to list any disabled channels. For example:

admin> t1 -d
Disabled T1 channels:
(dvOp dvUpSt dvRq sAdm)
Channel { { 1 13 1 } 12 } (Down Idle UP UP )
Channel { { 1 13 1 } 13 } (Down Idle UP UP )
Channel { { 1 13 1 } 14 } (Down Idle UP UP )
The following example shows how to display all T1 channels known to the system:

admin> t1 -c
All T1 channels:
(dvOp dvUpSt dvRq sAdm)
Channel { { 1 13 1 } 1 } (UP Idle UP UP )
Channel { { 1 13 1 } 2 } (UP Idle UP UP )
Channel { { 1 13 1 } 3 } (UP Idle UP UP )
Channel { { 1 13 1 } 4 } (UP Idle UP UP )
Channel { { 1 13 1 } 5 } (UP Idle UP UP )
Channel { { 1 13 1 } 6 } (UP Idle UP UP )
Channel { { 1 13 1 } 7 } (UP Idle UP UP )
Channel { { 1 13 1 } 8 } (UP Idle UP UP )
Channel { { 1 13 1 } 9 } (UP Idle UP UP )
Channel { { 1 13 1 } 10 } (UP Idle UP UP )
Channel { { 1 13 1 } 11 } (UP Idle UP UP )
Channel { { 1 13 1 } 12 } (Down Idle UP UP )
Channel { { 1 13 1 } 13 } (Down Idle UP UP )
Channel { { 1 13 1 } 14 } (Down Idle UP UP )
[More? <ret>=next entry, <sp>=next page, <^C>=abort]
The -i option displays information about which T1 channels are in use. For example:

admin> t1 -i
T1 channels allocated/in-use:
(dvOp dvUpSt dvRq sAdm)
Channel { { 1 13 1 } 15 } (UP Busy UP UP )
Channel { { 1 13 1 } 16 } (UP Busy UP UP )
Channel { { 1 13 1 } 17 } (UP Busy UP UP )
Channel { { 1 13 1 } 18 } (UP Busy UP UP )
Channel { { 1 13 1 } 19 } (UP Busy UP UP )
Channel { { 1 13 1 } 20 } (UP Busy UP UP )
Channel { { 1 13 1 } 21 } (UP Busy UP UP )
See Also: Line, Show, Slot

T1-Stats

Description: Reports DS1-level line errors on a T1 or T3 card. You must first execute the Open command to open a session with the card.

Permission level: Diagnostic

Usage: t1-stats [-c] line

Syntax element

Description

-c
Reset statistics to 0 (zero) after displaying them.

line
Line on the card.

Example: To open a session with a card in shelf 1, slot 13:

admin> open 1 13
Then, to display DS1-level statistics for the first line on the card:

t1-1/13> t1-stats 1
Line 1:
CRC Errors: 0
Frame Slips: 8
Framing Bit Errors: 0
Out of Frame Events: 0
Line Code Violations: 0
Finally, to display statistics for line 2, and reset the statistics to zero:

t1-1/13> t1-stats -c 2
Line 2:
CRC Errors: 2
Frame Slips: 3
Framing Bit Errors: 0
Out of Frame Events: 0
Line Code Violations: 3
Statistics cleared.
The output contains the following fields:

Field

Event that increments the field's value

CRC errors 
Data corruption in the signal.

Frame slips 
The MAX TNT received T1 data at a greater or less frequency than that of the internal line clock. In the process of realigning itself to the transmitter, the MAX TNT can skip or repeat a frame.

Framing bit 
errors 
The MAX TNT detected a framing bit that was incorrect. T1 framing requires that certain bit positions (known as framing bits) have a fixed value in the signal. The framing bits enable the MAX TNT to determine where frames begin and end.

Out of Frame 
Events
The MAX TNT no longer detects a framing pattern in the receiving signal, or it detects a pattern at a different relative offset than expected.

Line Code 
Violations
The MAX TNT detected either a Bipolar Violation or Excessive Zeros, indicating that one of the low-level T1 rules for encoding data was violated in the received signal.

Statistics 
cleared
This field does not display a count. It simply indicates that the statistics have been reset to 0 (zero), because the command included the -c option.

Telnet

Description: Opens a Telnet session across the network to the specified host.

Permission level: Diagnostic

Usage: telnet [-a|-b|-t] [-l[e]|-r[e]] hostname [portnumber]

Syntax element

Description

-a
ASCII mode, or standard 7-bit mode. In 7-bit mode, bit 8 is set to 0 (zero); 7-bit Telnet is also known as NVT (Network Virtual Terminal) ASCII. This is the default if no other mode is specified.

-b
Binary mode. The MAX TNT attempts to negotiate the Telnet 8-bit binary option with the server at the remote end. You can run X-Modem and other 8-bit file transfer protocols in this mode.

-t
Transparent mode. You can send and receive binary files without having to be in Binary mode. You can run the same file transfer protocols available in Binary mode.

-l[e]
Local echo. As you type a line, it echoes on your terminal screen, but is not actually transmitted until you enter a carriage return.

-r[e]
Remote echo. Turn local echo off.

hostname
The IP address or DNS name of a networked host.

portnumber
A port number for Telnet sessions. The default port is 23.

Example: To open a Telnet session to Host-231:

admin> telnet host-231
Connecting to host-231 (10.65.12.231)...
Escape character is '^]'
Connected
You can also open a session after starting the Telnet program. To display the available commands:

admin> telnet

telnet> ?
? Displays this information.
help " " "
open Connect to a site.
quit Quit Telnet.
close Close current Telnet connection.
send Send Telnet command. Type 'send ?' for help.
set Set special char. Type 'set ?' for help.

Note: During an open Telnet connection, type Ctrl-] to display the telnet> prompt and the Telnet command-line interface. Any valid Telnet command returns you to the open session. Note that Ctrl-] does not function in binary mode Telnet. If you log into the MAX TNT by Telnet, you might want to change its escape sequence from Ctrl-] to a different setting.

See Also: Ping, Rlogin

Terminal-Server

Description: Starts terminal-server mode, which has its own command interface.

Permission level: Termserv

Usage: terminal-server

Example: To enter terminal-server mode and display the list of available commands:

admin> terminal-server

** Ascend TNT Terminal Server **

ascend% ?
? Display help information
help " " "
quit Closes terminal server session
hangup " " " "
local Go to local mode
remote remote <station>
set Set various items. Type 'set ?' for help
show Show various tables. Type 'show ?' for help
iproute Manage IP routes. Type 'iproute ?' for help
telnet telnet [-a|-b|-t] <host-name> [<port-number>]
tcp tcp <host-name> <port-number>
ping ping <host-name>
traceroute Trace route to host. Type 'traceroute -?' for help
rlogin rlogin [-l user -ec] <host-name>
To exit terminal server mode:

ascend% quit
admin>
See Also: Ping, Rlogin, Telnet

TNTMP

Description: Displays information about MP and MP+ bundles and their channels. You can execute the TNTMP command on the shelf controller or on an HDLC card. You must first execute the Open command to open a session with the card.

Permission level: Debug

Usage: tntmp -i

Example: To display information about MP and MP+ bundles and their channels:

admin> tntmp -i
mpBundleID=13 masterSlot=1/15 masterMpID=2 ifCount=2 rtIf=1/17:6
routeID slot ifNum localIfNum localMpID
32 1/15 1 1 2
33 9/ 2 193 1 2
This command works on HDLC cards as well. First, open a session with HDLC card, and then execute the TNTMP command. For example:

admin> open 1 15
hdlc-1/15> tntmp -i
mpBundleID=13 masterSlot=1/15 masterMpID=2 ifCount=2 rtIf=1/17:6
routeID slot ifNum localIfNum localMpID
32 1/15 1 1 2
33 9/ 2 193 1 2
In this example, the output shows a two-channel MP or MP+ bundle, with the first channel in slot 1/15 and the second (slave) channel in slot 9/2. The command displays the following information:

Field

Description

mpBundleID
The globally known bundle ID for the whole system. If the connection adds channels for additional bandwidth on demand, the call for those channels is compared to the current bundle and assigned the same bundle ID as the other channels of the call.

masterSlot
The channel that was established as the base channel of the connection. After the MAX TNT authenticates a call that is not part of an existing bundle, it establishes the base channel of the connection. That channel becomes the master of the multilink connection.

masterMpID 
The bundle ID at the master slot card. (The masterMpID is always the same as the localMpID for channels on the master slot card.)

ifCount
The number of channels in the bundle.

rtIf 
The shelf/slot:id for the Route Logical Interface.

routeID 
The globally known ID for each call.

slot
The shelf/slot numbers of the channels in the MP or MP+ bundle.

ifnum
Channel number on the master slot card.

localIfNum 
The channel number on the local slot card. For HDLC cards, the channels are numbered 1-192. In the output in the example, the master slot (1/15) shows channel number 1. The interface number for the slave slot (9/2) is also 1, meaning the first channel on that card. However, at the master slot card, the slave interface number is mapped to a pseudo-interface number greater than 192, so it is not confused with channels on the master slot.

localMpID
The bundle ID known locally to the slot card.

Traceroute

Description: Traces the route an IP packet follows by launching UDP probe packets with a low TTL (Time-To-Live) value and then listening for an ICMP time exceeded reply from a router. Probes start with a TTL of one and increase by one until either a probe packet reaches the destination host or the TTL reaches the maximum.

Three probes are sent at each TTL setting. The second line of command output shows the address of the router and round-trip time of each probe. If the probe answers come from different gateways, the address of each responding system is printed. If there is no response within a 3-second timeout interval, the command output is an asterisk.

The destination host isn't supposed to process the UDP probe packets, so the destination port is set to an unlikely value, such as 33434. When the packets reach the destination host, it sends back an ICMP port unreachable message.

Permission level: Diagnostic

Usage: traceroute [-n] [-v] [-m max_ttl] [-p port] [-q nqueries]
[-
w waittime] [-s src_IPaddr] hostname [datasize]

Syntax element

Description

-n
Print hop addresses numerically rather than symbolically and numerically (this eliminates a nameserver address-to-name lookup for each gateway found on the path).

-v
Verbose output. Include received ICMP packets other than Time Exceeded and ICMP Port Unreachable.

-m max_ttl
Set the maximum time-to-live (maximum number of hops) used in outgoing probe packets. The default is 30 hops.

-p port
Set the base UDP port number used in probes. Traceroute hopes that nothing is listening on any of the UDP ports from the source to the destination host (so that an ICMP Port Unreachable message will be returned to terminate the route tracing). If something is listening on a port in the default range, this option can be used to pick an unused port range. The default is 33434.

-q nqueries
Set the maximum number of queries for each hop. The default is 3.

-w waittime
Set the time to wait for a response to a query. The default is 3 seconds.

-s src_IPaddr
The IP address of the source host.

hostname
The IP address or DNS name of a networked host.

datasize
Set the size of the data field of the UDP probe datagram sent by Traceroute. The default is 0. This results in a datagram size of 38 bytes (a UDP packet carrying no data).

Example: To trace the route to Host-231:

admin> traceroute host-231
traceroute to host-231 (10.65.12.231), 30 hops max, 0 byte packets
1 host-231.abc.com (10.65.12.231) 0 ms 0 ms 0 ms
To perform the same trace, but with a maximum TTL of 60 hops:

admin> traceroute -m 60 host-231
traceroute to host-231 (10.65.12.231), 60 hops max, 0 byte packets
1 host-231.abc.com (10.65.12.231) 0 ms 0 ms 0 ms
The following annotations can appear after the time field:

Annotation

Description

!H 
Host reached.

!N 
Network unreachable.

!P 
Protocol unreachable.

!S 
Source route failed. This event should not occur, and might indicate that there is a problem with the associated device.

!F 
Fragmentation needed. This event should not occur, and might indicate that there is a problem with the associated device.

!h 
Communication with the host is prohibited by filtering.

!n 
Communication with the network is prohibited by filtering.

!c 
Communication is otherwise prohibited by filtering.

!? 
An ICMP subcode. This event should not occur.

!?? 
Reply received with inappropriate type. This event should not occur.

See Also: Ping, Netstat

Uptime

Description: Reports how long the system has been up and how long individual cards have been up.

Permission level: System

Usage: uptime [[-a]|[[shelf] slot ]]

Syntax element

Description

No arguments

Display the system uptime.

-a 
Display the uptime for all slot cards.

slot 
Display the uptime for the specified slot card on the master shelf.

shelf slot 
Display the uptime for the slot card specified by shelf and slot.

Example: At 1:26:39 p.m., the modem card in slot 2 has been up for five minutes and 53 seconds:

admin> uptime 1 2
13:26:39 { shelf-1 slot-2 } 48modem-card 0000 days 00:05:53
The following example shows the uptime for all slot cards in the Up state. (Cards that are not in the Up state are not reported.)

admin> uptime -a
13:26:54
{ shelf-1 slot-1 } 8t1-card 0 days 00:07:04
{ shelf-1 slot-2 } 48modem-card 0 days 00:06:00
{ shelf-1 slot-4 } 192hdlc-card 0 days 00:05:20
{ shelf-1 slot-5 } 4ether-card 0 days 00:06:38

Note: To enable network management stations to obtain uptime information, the following SNMP variable has been added to the Ascend Enterprise MIB:

slotLastChange   OBJECT-TYPE
SYNTAX TimeTicks
ACCESS read-only
STATUS mandatory
DESCRIPTION "The value of sysUpTime at the time the TNT slot card
entered its current state. For non-TNT systems 0 is
always reported."
::= { slotEntry 9 }
The slotLastChange variable reports the value of sysUpTime at the time the slot card entered its current state.

Userstat

Description: Displays user session status.

Permission level: System

Usage: userstat [-s|-l|-d|-k sessionid]

Syntax element

Description

-s
Show session information in an 80-character-wide format (the default).

-l
Show enhanced status information in a 140-character-wide format.

-d
Dump the output to the display, rather than show it one page at a time.

-k sessionid
Terminate a user session that uses PPP, SLIP, MP+, Telnet, Telnet binary, Raw TCP, or the terminal server. The -k option does not terminate Frame Relay or DTPT service types.

Example: To display user session status:

admin> userstat 
SessionID Line/Chan Slot:Item Tx/Rx Rate Svc Address Username
228687860 1.01.02/01 1:03:01/01 56K/56K PPP 10.100.0.1 barney
228687861 1.02.03/02 1:04:02/00 28800/33600 PPP 10.168.6.24 jake
<end user list> 2 active user(s)
The output contains the following fields:

Field

Description

SessionID
Unique ID assigned to the session.

Line/Chan
Physical address (shelf.slot.line/channel) of the network port on which the connection was established, such as a T1 line/channel.

Slot:Item
Shelf:slot:item/logical-item of the host port to which the call was routed.

Tx/Rx Rate
Transmit and receive rates. Note that for modem connections, the transmit rate is set automatically to the receive rate, because modem cards do not support asymmetric data-rate connections.

Svc
Type of service in use for the session. Following are the possible values:

--- (The service is being negotiated.)
PPP (Point-to-Point Protocol)
SLP (Serial Line IP)
MPP (Multilink Protocol Plus)
MP (Multilink Protocol)
FRY (Frame Relay)
TLN (Telnet)
BTN (Binary Telnet)
TCP (raw TCP)
TRM (Terminal Server)
VCN (Virtual Connect)
DTP (DTPT)

Dialed#
(displays only with -l option)
The number dialed to initiate this session.

ConnTime
(displays only with -l option)
The amount of time (in hours:minutes:seconds format) since the session was established.

IdleTime
(displays only with -l option)
The amount of time (in hours:minutes:seconds format) since data was last transmitted across the connection.

To terminate a user session, include the -k option and session ID with the Userstat command. For example:

admin> userstat
SessionID Line/Chan Slot:Item Rate Svc Address Username
246986325 1.01.02/01 1:13:01/000 33600 PPP 100.100.8.2 100.100.8.2
<end user list> 1 active user(s)
admin> userstat -k 246986325
Session 246986325 cleared

Version

Description: Displays the current system software version.

Permission level: System

Usage: version

Example: To display the current system software version:

admin> version
Software version 1.2

View

Description: Changes the information displayed in the top or bottom status window.

Permission level: System

Usage: view position status-type

Syntax element

Description

position
The window position may be top, bottom, or left, indicating which area of the status window will be affected by the command.

status-type
If the specified window position is top or bottom, the window can display one of the following types of status information:

· general (general status information)

· log (the 32-message log buffer)

· line (T1 line and channel status)

If the specified window position is left, the window can display one of the following types of status information:

· connection (WAN connection status)

· session (management status)

Example: To display session information:

admin> view left session
The left window position changes to show session information:

See Also: Connection, Line, Log, Status

WANdisplay

Description: Shows all WAN data as it is received and transmitted for each session. This information can be very helpful in troubleshooting PPP negotiation problems.

If your MAX TNT has several simultaneous active connections, WANdisplay might not be the most efficient command, because the MAX TNT displays all traffic from all connections in a constant stream. You might prefer to use WANdsess or WANopening, depending on the types of data you are interested in gathering.

Use the WANdisplay command with host cards only. You must first execute the Open command to open a session with the modem or HDLC card.

Permission level: Debug

Usage: wandisplay octets

The octets value specifies the maximum number of octets to display per packet. If you specify 0 (zero), the MAX TNT does not log WAN data.

Example: To open a session with a modem card, and activate the display of the card's WAN data:

admin> open 1 7
modem-1/7> wandisplay
Display the first 24 bytes of WAN messages
RECV-272:: 1 octets @ 5E138F74
[0000]: 0D
RECV-272:: 13 octets @ 5E13958C
[0000]: 0A 41 63 63 65 70 74 3A 20 69 6D 61 67
XMIT-276:: 1011 octets @ 2E12D8A4
[0000]: 7E 21 45 00 03 EE 54 2B 40 00 37 06 BA 09 CF 2B
[0010]: 00 86 D0 93 91 90 1A 0A
Note that the bytes are displayed in hexadecimal format.

See Also: WANdsess, WANopening

WANdsess

Description: Shows WAN data as it is received and transmitted for a particular user. The WANdsess command is very similar to the WANdisplay command, but when you use WANdsess, the MAX TNT displays only incoming and outgoing packets for a specific user. WANdsess is particularly helpful on a MAX TNT with several simultaneous active connections. The command acts as a filter, allowing you to focus your troubleshooting.

Use the WANdsess command with host cards only. You must first execute the Open command to open a session with the modem or HDLC card.

Permission level: Debug

Usage: wandsess session-name octets

Syntax element

Description

session-name 
The name of a local Connection profile or a RADIUS user profile.

octets 
The maximum number of octets to display per packet. If you specify 0 (zero), the MAX TNT does not display any data.

Example: To open a session with a modem card, and activate the display of WAN data for Tim's sessions:

admin> open 1 7
modem-1/7> wandsess tim
RECV-tim:300:: 1 octets @ 3E13403C
[0000]: 7E 21 45 00 00 3E 15 00 00 00 20 7D 31 C2 D2
RECV-tim:300:: 15 octets @ 3E133A24
[0000]: D0 7D B3 7D B1 B3 D0 7D B3 90 02 04 03 00 35
XMIT-tim:300:: 84 octets @ 3E12D28C
[0000]: 7E 21 45 00 00 4E C4 63 00 00 1C 7D 31 17 5F D0
[0010]: 93 90 02 D0 93 91 B3 00
Note that the bytes are displayed in hexadecimal format.

See Also: WANdisplay, WANopening

WANopening

Description: Shows WAN data as it is received and transmitted during connection establishment for all users. The WANopening command is particularly helpful for troubleshooting connection problems in which users make the initial connection, but are disconnected within a few seconds. The output of WANopening is very similar to the output of WANdisplay, but WANopening only shows packets to the point at which the connection has been completely negotiated.

Use the WANopening command with host cards only. You must first execute the Open command to open a session with the modem or HDLC card.

Permission level: Debug

Usage: wanopening octets

The octets value specifies the maximum number of octets to display per packet. If you specify 0 (zero), the MAX TNT does not log WAN data.

Example: To open a session with a modem card, and activate the display of WAN data received and transmitted during connection establishment:

admin> open 1 7
modem-1/7> wanopening
Display the first 24 bytes of WAN messages
RECV-272:: 1 octets @ 5E138F74
[0000]: 0D
RECV-272:: 13 octets @ 5E13958C
[0000]: 0A 41 63 63 65 70 74 3A 20 69 6D 61 67
XMIT-276:: 1011 octets @ 2E12D8A4
[0000]: 7E 21 45 00 03 EE 54 2B 40 00 37 06 BA 09 CF 2B
[0010]: 00 86 D0 93 91 90 1A 0A
Note that the bytes are displayed in hexadecimal format.

See Also: WANdisplay, WANdsess

Whoami

Description: Displays the name of the User profile associated with the current session.

Permission level: User

Usage: whoami

Example: To display the name of your User profile:

admin> whoami
tommy
See Also: Auth

Write

Description: Validates the settings of the working profile and then writes it from the edit buffer to NVRAM.


Note: If the working profile has an index field (a parameter followed by an asterisk), that parameter must have a value or the write is not allowed. If you modify a profile and do not use the Write command before reading another profile, the changes are lost.

Permission level: Update

Usage: write [-f]

Syntax element

Description

-f
Force the write without prompting for confirmation, overwriting an existing profile if one exists with the same index.

Example: To create a new Connection profile, modify it, and write it to NVRAM:

admin> new conn newyork
CONNECTION/newyork read
admin> list
station*=newyork
active=no
encapsulation-protocol=mpp
called-number-type=national
dial-number=""
clid=""
ip-options={ yes yes 0.0.0.0/0 0.0.0.0/0 7 100 255 no no 0 0.0.0.0 rou+
session-options={ "" "" no 120 no-idle 120 "" }
telco-options={ ans-and-orig no off 1 no no 56k-restricted 0 "" "" no +
ppp-options={ "" "" stac 1524 no 600 600 }
mp-options={ 1 1 2 }
mpp-options={ "" quadratic transmit 1 1 15 5 10 70 }
tcp-clear-options={ "" 0 }
answer-options={ }
usrRad-options={ global 0.0.0.0 1646 "" 1 acct-base-10 }
calledNumber=""
admin> write
CONNECTION/newyork written
See Also: List, New, Read, Set

XDSLcmd

Description: Enables you to manually activate a loopback test. XDSLcmd is supported on SDSL and ADSL-Cap cards only. You must first execute the Open command to open a session with the card.

Permission level: Diagnostic

Usage: xdslcmd -l [channel][[count][buffersize]]

Syntax element

Description

-l [channel]
The channel to test. Specify a number from 0 to 15. If you do not specify a channel number, or if you specify 0 (zero), all channels are tested.

count
The number of frames to be sent in the loopback. The default is 10.

buffersize
The size of the looped frames to be sent. The default is 128 bytes.

Example: To run a loopback test on channel 8 of an SDSL card in shelf 1, slot 6:

admin> open 1 6
sdsl-1/6> xdslcmd -l 8
The test collects statistics until you press Ctrl-C, which stops the test and displays the collected statistics.



[Top][Contents][Prev][Next][Last]Search

techpubs@eng.ascend.com

Copyright © 1998, Ascend Communications, Inc. All rights reserved.