|
Table Of Contents
The User Command Screen Layout
The Numbering of Trunks, Lines, and Channels
Clearing and Redrawing the Screen
Accessing Physically Remote Nodes
Command Line Fundamentals
A workstation, terminal, or personal computer can function as a control terminal for an IGX or BPX node through an EIA/TIA-232 link or over an Ethernet TCP/IP LAN. All command input takes place at the terminal, and all displays appear on the terminal screen. Through displays that show status, alarm, or statistics, the terminal constantly provides a view of an individual node, a trunk, a connection, or the entire network.
The control terminal gives you the ability to control the network from any routing node. A remote access command is available for controlling the network from a node other than the node physically connected to the terminal. This command is the Virtual Terminal (vt) command. The vt command creates a communication channel for the operator to a remote node. After you access a node by using vt, you can begin executing commands at the accessed node. Most commands and tasks that you can execute at the local node are also executable at a remote node.
The WAN Manager Network Management Station provides network management capabilities for multinode networks. WAN Manager also collects and displays statistics. For access, WAN Manager operates in LAN mode or telnet mode. (As of Release 8.0, you can no longer access a node through the serial port.) Refer to the Cisco WAN Manager Operations Manual for more information.
The User Command Screen Layout
After the node receives power and correctly starts up, the terminal screen appears as shown below. If the screen is blank or does not display the initial screen, check all connections to the node, and make sure the terminal and node are receiving power. If the connections are correct, press the Delete key a few times or cycle the terminal power.
sw180 TN No User IGX 8420 9.3.g0 Oct. 20 2000 06:09 GMT
Enter User ID:
The user command screen is divided into three areas:
•The top line of the screen (status line) displays the node name, current user name, software revision level, date, time and time zone. If the date and time have not been configured on the node, the screen states this.
•The middle part of the screen shows the information returned by the executed commands. This could be, for example, configuration or statistical information.
•The bottom area of the screen displays prompts for the next command or the current command parameters. As the system receives the parameters you enter, it duplicates them above the command entry line to serve as a record of the entries. The bottom area also shows the command last entered.
All command screens eventually time out. This includes dynamically updated screens such as the display for the dspbob command. Furthermore, if sufficient time passes, you are logged out.
Entering a Command
This section describes how to enter a command for those who are unfamiliar with Cisco WAN switch equipment. It also describes the online help for the commands.
Each user command can have one or more access privilege levels (see Access Privileges). Entering a particular command is possible for a user at the same or higher privilege of the command. Each command definition in this manual shows the privilege or range of privileges for the command. Most commands are not case-sensitive.
When the Next Command prompt is at the bottom of the screen, the system is ready for a new command. Some commands, such as those for simply displaying information, do not require parameters. Display commands often have no required parameters but have one or more optional parameters for changing the scope of displayed information. Commands that require parameters usually prompt for each parameter.
To abort a command for any reason, press the Delete key. If you make a mistake or need to edit the command line, see To Edit a Typed Command.
The general syntax is command <parameter(s)> [optional parameter(s)]. When a command definition displays actual parameters, the required parameters appear within the arrow heads (< >). If the list of command parameters is too long, the command definition's "Syntax" field just shows "parameters," which means the parameters are available only in the parameters table for the definition. For information on the format of system resource numbering, see The Numbering of Trunks, Lines, and Channels.
Those unfamiliar with the system can use the online help feature to view the seven categories of commands and get syntax information on a command (see About Command Categories).
To enter a command from the menu:
Step 1 At the Next Command prompt, either press the Escape key or enter the word help or a question mark. A list of command categories appears as in the example below.
gamma TRM YourID:1 IGX 8420 9.3.20 Aug. 15 2000 13:47 CST
All commands fall into one (or more) of the following categories:
Control Terminal
Configuration
Lines
Network
Connections
Cards
Alarms and Failures
This Command: ?
Use cursor keys to select category and then hit <RETURN> key:
Step 2 Use the up/down arrow keys to select a command category, then press Return. A list of all the commands in that category appears. (The next example is from the "line" category of commands.)
Step 3 Use the cursor key to select the command you want to enter (dsptrks for example), then press Return. The selected command appears on the screen, and the system prompts you for any additional parameters needed to complete the command.
Figure 1-1 Entering a Command
A faster way to enter a command, using fewer keystrokes, is to enter the command on the command line, then press the Return key. The system prompts you for any additional parameters required to complete the command.
The fastest way to enter a command, using the fewest keystrokes, requires that you know the command along with the necessary parameters. Enter the command name and all of the required parameters in the correct format, then press the Return key.
About Command Categories
The command category menu is displayed when you press the Escape or ? or Help key. The commands are organized into seven categories. (These categories are not the categories used to organize this manual.) Table 1-1 lists and describes the command categories.
Aborting a Command
To abort any command, press Delete
On terminals without a Delete key, you might need to press Shift-Backspace or other keys to perform the Delete function.
The Next Command: prompt appears at the bottom of the screen indicating that you can enter another command. The command you aborted appears in low intensity letters on the screen after the Last Command: prompt.
Command Shortcuts
When you enter a command, it is displayed next to the Last Command: prompt at the bottom of the screen. To copy the command to the new command line, press the Ctrl and A keys simultaneously.
To execute the previous command:
•Edit the command line and then press the Return key,
OR:
•Enter an exclamation mark (!) followed by the first letter or letters of a previous command and press the Return key.
For example, to repeat the dspcons command:
Last Command: dspcons
Next Command: !dsp
Press the Return key. You can use the Display Command History (.) command to display the 12 most recently executed commands:
Step 1 Type . (a period) and press Return. A numbered list of commands displays. In the following example, the most recently executed command is number 1.
12: 11: 10: 9: 8: 7: prtscrn 6: addcon 12.1 alpha 12.1 v 5: delcon 12.1 4: cnfport a 1200 n 8 1 x x n 3: cnftime 17 19 34 2: redscrn 1: help
Step 2 Type the number of the command you want to re-execute, then press the Return key. The command is displayed after the Next Command: prompt. Press the Return key to execute the command, or edit the command line and then press the Return key. Whenever you end a terminal session by signing off (with the bye command), the command list is cleared.
To Edit a Typed Command
Before you press Return, you can use control keys to edit a typed command. Table 1-2 lists the control key to edit information on the command line. Not all terminals have the same key characters. If the exact key is not available, determine which alternate key performs the function.
Access Privileges
Access to the commands is password protected. To access the commands, type your user ID and user password at the log-in prompts. Each user is assigned a privilege level by the System Manager that determines which commands you can use.
The six user privilege levels follow this basic convention:
Level 0 is the SuperUser access level permitting use of SuperUser commands. See SuperUser Commands, page 2-33. SuperUser commands are identified in the Attributes table of the command definition.
Level 1 has access to all the commands.
Level 6 has access to the fewest commands.
A given privilege level has access to all levels below it. For example, level 3 has access to levels 3 through 6. The privilege level for each command is part of the command summary.
Help
The system software provides a help function for commands. The help command gives you access to a general help menu or to information on a specific command.
To access the Command Category menu, enter either help or ?.
Either of these commands displays the Command Category menu listing all commands and command syntax. You are prompted to make a selection. Use the arrow keys to move the cursor to the correct category, then press the Return key.
The Command Category Menu:
•Control terminal
•Configuration
•Lines
•Network
•Connections
•Cards
•Alarms and failures
For information on a specific command, enter help or ? followed by a command name. For example, enter the following for information on adding a trunk:
help addtrk
Press Return to display the information.
Enter help or ? followed by a character string to display all those commands containing the character string. For example, for a list of all commands that contain the string "fr," enter the following:
? fr
You can then select a particular command from this list for help information.
The Online Help feature of WAN Manager provides more detailed command information. Hypertext links allow you to navigate through command category lists, alphabetical indexes, and the command descriptions. Refer to the Cisco WAN Manager Operations manual for more information.
About Command Names
Most of the command names use the convention of a descriptive verb and noun. For example, the addcon command adds a connection, the delcon command deletes a connection, and the dspcon command displays information about a connection. Table 1-3 lists the command-related abbreviations.
The Numbering of Trunks, Lines, and Channels
The information contained in this manual allows you to set up, configure, and maintain traffic on trunks and lines. Table 1-4 lists the format conventions for the names of trunks, lines, and channels.
User Interface Commands
The user interface commands:
•Provide help on how to use the commands
•Display the twelve most recent commands entered into the system
•Connect to another node
•Sign on and off
•Clear, print, or redraw the screen
These commands are all simple to use and have no command parameters except the virtual terminal command (vt), in which you must specify the node name, and the help commands, in which you must enter a command character string.
See the section Basic User Interface Commands in Chapter 2 for a list of these commands linked to their full command definitions.
Signing On
Signing on to the system is a two-step process requiring you to enter both a User ID and a password. The system administrator can provide a User ID and password for the network. Only the system administrator can assign and change User IDs. Once a password is assigned, you can change your own password. For security reasons, users should periodically change their passwords.
Note: User ID and passwords are case-sensitive.
When the following prompt appears at the bottom of the initial screen, the system is ready for you to log in:
Enter User ID:
Entering a User ID and password gives access at a particular level of user privilege. (Each command has one or more levels of associated user privilege.) User IDs can have up to twelve (12) characters. At the prompt, enter the User ID. The system responds with the following prompt:
Enter Password:
When you initially sign on, enter the password. (The password does not appear on the screen.) Upon receiving the correct User ID and password, the log-in is recorded by the event log, and the screen displays the following prompt:
Next Command:
The system is ready to receive commands.
Logging Out
To log out, enter bye. When the terminal connection is local, this returns you to the initial screen.
To log out completely from a remote (virtual terminal) session, enter bye twice.
Clearing and Redrawing the Screen
To clear the screen, use the Clear Terminal Screen (clrscrn). The clrscrn command clears any information displayed in the top portion of the screen. This information could consist of status displays on lines and connections or Help text.
To clear and redraw the screen, use the Redraw Terminal Screen (redscrn) command. The redscrn command redraws the screen and updates the status lines. To make sure the status lines have been updated, enter the redscrn command. For example, to redraw a screen's display with the latest statistics before printing the screen, enter redscrn.
Printing Screens
Use the Print Terminal Screen (prtscrn) command prints the current screen display. Verify that the node printer is correctly configured before attempting to print a screen. Upon entering the prtscrn command, the screen display goes to either a local or remote printer. To print all the information in a screen, enter prtscrn.
Accessing Physically Remote Nodes
The Make Virtual Terminal Connection (vt) command establishes a virtual terminal connection to a remote node. Once the connection is established, entering and executing commands takes place as if the terminal were the local terminal on the remote node. The vt command lets network configuration take place from a central site. The only command that cannot run remotely is the vt command itself.
The privilege of user commands available through a vt connection is the same as that of the user who logged into a node with vt. To establish a virtual terminal connection with a remote node, enter vt and the name of the node name. For example, to vt to node "alpha," enter:
vt alpha
The words Virtual Terminal appear on the screen at the lower left corner to indicate that a virtual terminal connection exists. The remote node name appears at the upper left corner of the screen. To terminate the virtual terminal connection and return to your local terminal connection, enter the bye command.
The bye command has two separate functions:
•If the terminal connection is local, bye logs you off the system.
•If the connection is remote (a vt connection), the bye command breaks the remote connection and returns the terminal to a local connection.
To log out of the system during a remote (vt) session, enter the bye command twice. Note that after a default period of four minutes of inactivity, the vt session automatically ends, and the connection reverts back to being local. The timeout is configurable.
If the multiple vt feature has been purchased, multiple users can log into a node with the vt command. Cisco personnel must activate this feature.
Posted: Sat Apr 22 17:26:31 PDT 2006
All contents are Copyright © 1992--2006 Cisco Systems, Inc. All rights reserved.
Important Notices and Privacy Statement.