Viewing Status Information

This chapter covers the following topics:

Commands for viewing status information

Getting information about the system

Getting information about slot cards

Working with the status window

Commands for viewing status information
Getting information about the system
Getting information about slot cards
Working with the status window

Commands for viewing status information

Table 4-1 shows some of the commands available for accessing system status and log information:

Table 4-1. Commands for displaying status information


Command	Purpose
Callroute	Display entries in the call-routing database.
Fatal-History	Display the log of fatal errors that have occurred and the dates and times at which they occurred.
Debug	Toggle display of diagnostic messages on the screen in real time.
Userstat	Display user session status.
Show	Show which slot cards are installed and in which slots, or show information about a specific card.
HDLC	Report the status of each HDLC channel on a card, or display only channels that are in use, that have failed, or that are available.
Modem	Report the status of each modem on a card, or display only modems that are in use, that are suspect, or that are available.
Status	Display or hide the status window. If no status window has been opened, this command opens the default status window. If a status window has been opened previously and then closed, this command opens that status window. If a status window is currently open, this command closes the window.
Connection	Display connection status in the window and interpret certain keystroke sequences to display additional connection status information.
Line	Display T1 line status in the window and interpret certain keystroke sequences to display additional line status information.
Log	Display event log information in the window and interpret certain keystroke sequences to display additional log messages.
View	Specify which area of the status window should display a particular kind of status information. Or, redisplay general status information.

For information about these and other diagnostic or system-level commands, see the MAX TNT Reference Guide. To display the list of options each command supports, enter the command with no options. For example:

admin> callroute
usage: callroute -option [ params ]
       -ad list (a)vail (d)ual (net and host) side call routing entries
       -ah list (a)vail (h)ost-side call routing entries
       -an list (a)vail (n)etwork-side call routing entries
       -d  list call routing tables by (d)evice
       -t  (t)oggle module debug level
       -?  display this summary

Getting information about the system

Some MAX TNT commands display real-time information about system activities. Other commands report more static information, such as the system software version. In addition, the MAX TNT maintains log buffers that record different levels of events. This section describes the following commands:

Displaying the call-routing database

The call-routing database determines how the MAX TNT routes calls to a modem or to an HDLC card for host-side processing. To display the database, use the Callroute command. For example, the following command displays database entries that route calls to host (modem or HDLC) ports:

admin> callroute -ah
  device     #  source        type          tg sa phone
 1:16:01/3   0 0:00:00/0  digital-call-type  0  0
 1:16:01/4   0 0:00:00/0  digital-call-type  0  0
 1:16:01/5   0 0:00:00/0  digital-call-type  0  0
 1:16:01/6   0 0:00:00/0  digital-call-type  0  0
 1:16:01/7   0 0:00:00/0  digital-call-type  0  0
 1:16:01/8   0 0:00:00/0  digital-call-type  0  0
 1:16:01/9   0 0:00:00/0  digital-call-type  0  0
 1:16:01/10  0 0:00:00/0  digital-call-type  0  0
 1:16:01/11  0 0:00:00/0  digital-call-type  0  0
 1:16:01/12  0 0:00:00/0  digital-call-type  0  0
 1:16:01/13  0 0:00:00/0  digital-call-type  0  0
 1:16:01/14  0 0:00:00/0  digital-call-type  0  0
 1:16:01/15  0 0:00:00/0  digital-call-type  0  0
 1:16:01/16  0 0:00:00/0  digital-call-type  0  0
 1:16:01/17  0 0:00:00/0  digital-call-type  0  0
 1:16:01/18  0 0:00:00/0  digital-call-type  0  0
 1:16:01/19  0 0:00:00/0  digital-call-type  0  0
 1:16:01/20  0 0:00:00/0  digital-call-type  0  0
 1:16:01/21  0 0:00:00/0  digital-call-type  0  0
 1:16:01/22  0 0:00:00/0  digital-call-type  0  0
 1:16:01/23  0 0:00:00/0  digital-call-type  0  0
 1:16:01/24  0 0:00:00/0  digital-call-type  0  0
[More? <ret>=next entry, <sp>=next page, <^C>=abort]

For details about call routing, see the MAX TNT Hardware Installation Guide.

Checking the fatal error log

All fatal errors are logged to the fatal error history log. To display the events logged there, enter the Fatal-History command:

admin> fatal-history

FATAL ERROR:  Index:   1  Revision: 2.0    Slot 13 (tnt8t1)
        Date: 02/16/1998.      Time: 12:01:10
        Location: 1006f87c 10000068 10068384 10067cec 100677e0 100585dc

FATAL ERROR:  Index:   1  Revision: 2.0    Slot 13 (tnt8t1)
        Date: 02/16/1998.      Time: 12:25:10
        Location: 1006f87c 10000068 10068384 10067cec 100677e0 100585dc

Each entry shows the system software version (2.0 in the sample entries above), the slot on which the error occurred, and the date and time at which the error occurred. To clear the log, enter the Clr-History command:

admin> clr-history

Toggling real-time log message display

Each User profile contains a Log-Display-Level parameter, which specifies the level of messages to be displayed immediately in the interface (as well as written to a log buffer). The Admin User profile sets this level to error by default, which means that messages indicating an error condition should be displayed immediately.

If you are working in the interface and need to temporarily turn off unlogged diagnostic output, use the Debug command. For example:

admin> debug off
Diagnostic output disabled

To turn it back on:

admin> debug on
Diagnostic output enabled.

Displaying user-session status information

To show user-session status, enter the Userstat command with the -s option:

admin> userstat -s
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 SessionID field shows the unique ID assigned to the session.

The Line/Chan field shows the physical address (shelf.slot.line/channel) of the network port on which the connection was established (for example, a T1 line/channel).

The Slot:Item field shows shelf:slot:item/logical-item of host port to which the call was routed (for example, to a modem or HDLC-channel).

The Tx/Rx Rate fields show the transmit and receive rate, respectively. Note that for digital connections, the transmit rate is the same as the receive rate. Usually only modems use asymmetric data-rate connections.

The Svc field contains a three-letter code that shows the type of service in use for the session. (For details, see the MAX TNT Reference Guide.)

Getting information about slot cards

This section provides a few examples of how to check the status of slot cards and the individual ports or channels on the card. The examples use the following commands:

Show

HDLC

Modem

Note: The HDLC and Modem sections describe commands for viewing information about individual modems and HDLC channels. They are representative of the kinds of status commands available for a variety of slot cards. For more specific information about these and other commands related to slot cards, see your online help.

Using the Show command

The Show command displays information about the status of installed slot cards. For example:

admin> show
Shelf 1 ( standalone ):
    { shelf-1 slot-1 0 }       UP       8t1-card
    { shelf-1 slot-2 0 }       UP       48modem-card
    { shelf-1 slot-3 }         OCCUPIED
    { shelf-1 slot-4 0 }       UP       4ether-card
    { shelf-1 slot-5 0 }       UP       128hdlc-card

The status of a slot can be one of the following:

UP (Normal operational mode.)
DOWN (Not in an operational mode.)
OCCUPIED (Slot 2 of a two-slot card.)
POST (The devices in the card are running power-on self tests.)
LOAD (The card is loading code as part of coming up.)
NONE (The card has been swapped out, but its configuration remains in flash space.)

To display additional information about a card, append the shelf and slot number to the Show command.

Checking the status of HDLC channels

The HDLC command displays detailed information about each of the channels on the card. You can use the command to find out which channels are available, if any channels are disabled or failed, or which channels are currently in use. For example, to see which HDLC channels are available for use, use 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]

This output shows the interface address of each HDLC channel (six groups of 32 channels), followed by the operational status, up-state, required-state, and admin-state of each channel.

Checking modem status

The Modem command reports the status of individual modems. You can use the command to find out which modems are available or in use, if there are any failed or suspect modems, and to obtain a list of modems that have been verified as not suspect and are available for use. For example, to list the non-suspect (good) modems, 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]

This output shows the address of each modem, the operational state (UP or DOWN) the status (Idle or Active), SNMP interface information, and whether the modem has been disabled.

Working with the status window

The MAX TNT generates a continuous stream of statistics about its activities. You can specify in a User profile that these statistics should always be displayed when a user logs in with that profile. Or, you can simply display the status window on demand.

You can also specify in a User profile which status information to display in each of the three areas of the status window. Figure 4-1 shows the default settings.

To display the status window and control what information is contained in which part of the window, use the following commands:

Note: Opening the status window requires an 80-column by 24-row VT100 window.

Opening and closing the status window

The status window has three main areas:

Left-the left side of the window
Top-the upper-right side of the window
Bottom-the lower-right side of the window

To redraw your VT100 window to display the status window, enter the Status command:

admin> status

The system prompt moves to just below the status window. To close the status window, enter the command again:

admin> status

If the system prompt is not visible below the status window, press Escape to display it.

Default contents of the window

Figure 4-1 shows the default contents of the status window:

Figure 4-1. Information in the status window

The default contents are determined by the following settings in a User profile:

left-status = connection-list

top-status = general-info

bottom-status = log-window

You can change these defaults by modifying your User profile.

Connection status information

With the default setting in a User profile, the left area of the status window initially displays connection information, as shown in Figure 4-1. One line appears for each active connection, showing 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 of the connection.

If the status window is not already displayed, the Connection command opens it with the connection-status information displayed:

admin> connection

In effect, this command puts the window in connection-status mode, with the following message displayed below the status window:

[ Next/Last Conn: <dn/up arw>, Next/Last Page: <pg dn/up>, Exit: <esc> ]

This message indicates the keystroke sequences you can use for displaying additional information in the Connection status area. The Down Arrow and Up Arrow keys display the next or previous connection in the list of active connections. The Page Down and Page Up keys display the list a screen at a time.

When the connection-status mode message is displayed, the system prompt does not appear at the bottom of the window. Press the Escape key to exit this mode and return to the system prompt.

General status information

With the default setting in a User profile, the top area of the status window initially displays general status information about the MAX TNT, including its serial number, the version of system software that is running, and the number of packets transmitted and received. This area also shows the current system date and time and how long the system has been up.

If the top of the status window is displaying another kind of information, such as T1 line information, you can redisplay the general status information with the View command:

admin> view top general

Log messages

With the default setting in a User profile, the bottom area of the status window initially displays the most recent message from the MAX TNT log buffer. The number of system event messages stored in the log is specified by the Save-Number parameter in the Log profile.

If the status window is not already displayed, the following Log command:

admin> log

opens it, with log-message information displayed in the bottom of the window.

Or, you can use the following command to specify that log messages appear in the top of the window instead, replacing the general status information:

admin> log top

In effect, these commands put the window in log mode, which displays the following message below the status window:

[ Back:<up arw>, Forward:<dn arw>, Start:<pg up>, End:<pg dn>, Exit: <esc> ]

This message indicates the key sequences you can use for displaying additional information in the Log area. The Down Arrow and Up Arrow keys display the next and previous message in the buffer, respectively. The Page Up and Page Down keys display the last and first message in the buffer, respectively.

When the log-mode message is displayed, the system prompt does not appear at the bottom of the window. Press the Escape key to exit this mode and return to the system prompt.

T1 line information

To view information about WAN lines and channels (for example, T1, E1, SWAN, T3, and so forth), use the Line command. Because space is so limited for this graphical display of line and channel status information, the line-status window uses identifiers and codes. For example, the line's link status uses a two-character code such as LA (link active), RA (red alarm), YA (yellow alarm), and so forth. For details, see the MAX TNT Reference Guide.

If the status window is not already displayed, the following Line command opens it with T1 line status information displayed in the bottom (lower-right) of the window:

admin> line

Or, you can use the following command to specify that the line-status information appear in the top of the window instead, replacing the general status information:

admin> line top

You can view information about all T1 lines installed in the system if you wish, but the default is to show information only about enabled lines. To view the status of all lines:

admin> line all

In effect, the Line commands put the window in line-status mode, which displays the following message below the status window:

[ Next/Last Line: <dn/up arw>, Next/Last Page: <pg dn/up>, Exit: <esc> ]

This message indicates the key sequences you can use for displaying additional information in the line status area. The Down Arrow and Up Arrow keys display the next or previous T1 line in the list. The Page Down and Page Up keys display the list a screen at a time.

When the line-status mode message is displayed, the system prompt does not appear at the bottom of the window. Press the Escape key to exit this mode and return to the system prompt.

techpubs@eng.ascend.com

Command

Purpose

Toggling real-time log message display

Displaying user-session status information

Log messages