-
Cisco IOS Release 12.0 Dial Solutions Command Reference
-
About This Manual
-
Using Cisco IOS Software
- Part 1: Dial-In Port Setup
- Part 2: Dial-In Terminal Service & Remote Node Config
- Part 3: Dial-on-Demand Routing
- Part 4: Dial Backup
- Part 5: NASI Client Commands
- Part 6: Large-Scale Dial Solutions
- Part 7: Cost-Control Solutions
- Part 8: Virtual Private Dialup Networks
- Part 9: Other Network Traffic on ISDN Channels
- Part 10: Dial-Related Addressing Services
- Part 11: Appendixes
-
Index
-
Table Of Contents
Dial-In Terminal Service Commands
rlogin trusted-localuser-source
rlogin trusted-remoteuser-source local
Sample Display with No Keywords
Sample Display with a Node Name
Sample Display with the Counters Keyword
Dial-In Terminal Service Commands
The commands described in this chapter are used to configure support for asynchronous character stream calls running the protocols Telnet, rlogin, LAT, XRemote, and TN3270.
Note
Some commands previously documented in this chapter have been replaced by new commands. Although these commands continue to perform their normal functions in the current release, support for these commands will cease in future releases.
For configuration information and examples, refer to the chapter "Configuring Dial-In Terminal Services" in the Dial Solutions Configuration Guide.
This chapter provides command reference documentation for the following types of dial-in terminal service calls:
•
•
•
•
Telnet is a simple remote terminal protocol that is part of the Internet Protocol (IP) suite. Telnet allows a user at one site to establish a TCP connection to a login server at another site; then, Telnet passes the keystrokes from one system to the other. Telnet can accept either an IP address or a domain name as the remote system address.
The Digital Equipment Corporation (Digital) Local Area Transport (LAT) protocol is the protocol used most often to connect to Digital hosts. LAT is a Digital-proprietary protocol. Cisco provides LAT technology licensed from Digital.
TN3270 terminal emulation software allows any terminal to be used as an IBM 3270-type terminal. Users with non-3270 terminals can take advantage of the emulation capabilities to perform the functions of an IBM 3270-type terminal. Specifically, the Cisco IOS software supports emulation of an IBM 3278-2 terminal providing an 80-by-24 display.
XRemote is a protocol developed specifically to optimize support for the X Window System over a serial communications link. Its compression and decompression algorithms are designed to handle bit-mapped displays and windowing systems.
access-class
To define restrictions on incoming and outgoing connections, use the access-class line configuration command. To remove the access-list number, use the no form of this command.
access-class access-list-number {in | out}
no access-class numberSyntax Description
Default
Disabled
Command Mode
Line configuration
Usage Guidelines
This command first appeared in Cisco IOS Release 10.0.
This command defines access list numbers that will then be used with the lat access-list command to specify the access conditions.
The value supplied for the access-list-number argument is used for all protocols supported by the Cisco IOS software. If you are already using an IP access list, you must define LAT (and possibly X.25) access lists permitting connections to everything, to emulate the behavior of previous software versions.
When both IP and LAT connections are allowed from a terminal line and an IP access list is applied to that line with the access-class line command, you must also create a LAT access list with the same number if you want to allow any LAT connections from that terminal. You can specify only one incoming and one outgoing access list number for each terminal line. When checking LAT access lists, if the specified list does not exist, the system denies all LAT connections.
Example
The following example configures an incoming access class on virtual terminal line 4:
line vty 4 access-class 4 inRelated Commands
You can use the master indexes or search online to find documentation of related commands.
lat access-list
busy-message
To create a "host failed" message that displays when a connection fails, use the busy-message global configuration command. Use the no form of this command to disable the "host failed" message from displaying on the specified host.
busy-message hostname d message d
no busy-message hostnameSyntax Description
hostname
Name of the host that cannot be reached.
d
Delimiting character of your choice—a pound sign (#) for example. You cannot use the delimiting character in the message.
message
Message text.
Default
No message is displayed.
Command Mode
Global configuration
Usage Guidelines
This command first appeared in Cisco IOS Release 10.0.
This command applies only to Telnet connections.
Follow the busy-message command with one or more blank spaces and a delimiting character of your choice. Then enter one or more lines of text, terminating the message with the second occurrence of the delimiting character.
Defining a "host failed" message for a host prevents all Cisco IOS software-initiated user messages, including the initial message that indicates the connection is "Trying..." The busy-message command can be used in the autocommand command to suppress these messages.
Example
The following example sets a message that will be displayed on the terminal whenever an attempt to connect to the host named dross fails. The pound sign (#) is used as a delimiting character.
busy-message dross # Cannot connect to host. Contact the computer center. #clear entry
To delete an entry from the list of queued host-initiated connections, enter the clear entry EXEC command at the system prompt.
clear entry number
Syntax Description
Command Mode
EXEC
Usage Guidelines
This command first appeared in Cisco IOS Release 10.0.
Example
The following example deletes pending entry number 3 from the queue:
router# clear entry 3Related Commands
You can use the master indexes or search online to find documentation of related commands.
show entry
connect
To log on to a host that supports Telnet, rlogin, or LAT, use the connect EXEC command.
connect host [port] [keyword]
Syntax Description
host
A host name or an IP address.
port
(Optional) A decimal TCP port number; the default is the Telnet router port (decimal 23) on the host.
keyword
Command Mode
EXEC
Usage Guidelines
This command first appeared in a release prior to Cisco IOS Release 10.0.
With the Cisco IOS software implementation of TCP/IP, you are not required to enter the connect, telnet, lat, or rlogin commands to establish a terminal connection. You can just enter the learned host name—as long as the host name is different from a command word in the Cisco IOS software.
To display a list of the available hosts, enter the following command:
show hosts
To display the status of all TCP connections, enter the following command:
show tcp
The Cisco IOS software assigns a logical name to each connection, and several commands use these names to identify connections. The logical name is the same as the host name, unless that name is already in use, or you change the connection name with the EXEC command name-connection. If the name is already in use, the Cisco IOS software assigns a null name to the connection.
Examples
The following example establishes an encrypted Telnet session from a router to a remote host named host1:
router> connect host1 /encrypt kerberosThe following example routes packets from the source system host1 to kl.sri.com, then to 10.1.0.11, and finally back to host1:
router> connect host1 /route:kl.sri.com 10.1.0.11 host1The following example connects to a host with logical name host1:
router> host1Related Commands
You can use the master indexes or search online to find documentation of related commands.
disconnect
To disconnect a line, use the disconnect EXEC command.
disconnect [connection]
Syntax Description
connection
(Optional) Number of the line or name of the active network connection to be disconnected.
Command Mode
EXEC
Usage Guidelines
This command first appeared in a release prior to Cisco IOS Release 10.0.
Do not disconnect a line to end a session. Instead, log off the host, so that the Cisco IOS software can clear the connection. Then end the session. If you cannot log out of an active session, disconnect the line.
Example
In the following example, the user disconnects from the device Slab to return back to the router.
Slab% disconnectConnection closed by remote hostrouter#Related Commands
You can use the master indexes or search online to find documentation of related commands.
flush-at-activation
To discard any data or noise characters that are sitting in the input buffer of the asynchronous line before the line is activated, use the flush-at-activation command in line configuration mode. To keep any data or noise characters that are sitting in the input buffer of the asynchronous line before the line is activated, use the no form of this command.
flush-at-activation
no flush-at-activationSyntax Description
This command has no keywords or arguments.
Default
Enabled by default.
Command Mode
Line configuration
Usage Guidelines
For an incoming call on a line configured with modem control (using the modem inout and modem dialin commands), the line will be activated when the data set ready (DSR) signal goes high and will be dropped when the DSR signal goes low. While the line is idle, its input buffer may receive characters; for example, modem result codes such as "NO CARRIER" or "RING" or line noise. Such characters are not useful to the line application. Flushing the line input buffer when the DSR goes high using the flush-at-activation command is the preferred behavior.
Note
On most Cisco IOS platforms, there may be up to a one-second delay between when the DSR signal goes high and Cisco IOS activates the line. Therefore, some valid data received from the line may be discarded when you issue the flush-at-activation command. If it is important to process this valid data rather than discarding it and the application is tolerant of receiving bad data, configure the no flush-at-activation command.
The application that is used determines whether the system can differentiate the valid data from the bad data or the system is tolerant of receiving any data. For example, consider that the application used is TCP over IP over PPP. PPP uses a Frame Check Sequence (FCS) in a data frame format to verify the integrity of the received data. If an invalid data pattern is delivered to a PPP receiver, PPP will discard it as a framing or FCS error. So the bad data will not be delivered to the higher layers. Even if some data is delivered up to IP and TCP, TCP has its own FCS which will reject bad data. Therefore, the application is tolerant of receiving the bad data that the line delivers.
Consider another application where incoming character data received from the line is delivered as TCP payload to a server running a pager application. Unless the pager application has implemented its own protocol to verify data integrity, this bad data may cause the pager not to be delivered, or to deliver bad data within the message payload to the receiving pager. So the bad data should not be delivered as payload to the line.
Where an upper-layer framed protocol such as PPP or Serial Line Internet Protocol (SLIP) is always used (asynchronous mode dedicated), the framed protocol may reach link status more quickly when you issue the no flush-at-activation command. Since the framed protocol discards any erroneous data received, you do not have to use the flush-at-activation command.
If the line application is not tolerant of receiving bad data; for example, when you are using character-mode username/password authentication, always use the flush-at-activation command. Otherwise, the bad data may trigger an application failure.
Note
The modem state STEADY_STATE is mapped to DSR high and TERMINATING is mapped to DSR low when asynchronous lines are the internal digital modem ports.
Example
The following example shows how to configure lines 1/0 through 1/59 to flush any data in their input buffers when the lines are activated:
Router(config)# line 1/0 1/59 Router(config-line)# flush-at-activationRelated Commands
You can use the master indexes or search online to find documentation of related commands.
activation-character
debug modem
modem dialin
modem inout
show line
ip alias
To assign an IP address to the service provided on a TCP port, use the ip alias interface configuration command. Use the no form of this command to remove the specified address for the router.
ip alias ip-address tcp-port
no ip alias ip-addressSyntax Description
Default
None
Command Mode
Interface configuration
Usage Guidelines
This command first appeared in Cisco IOS Release 10.0.
A user attempting to establish a connection is connected to the first free line in a rotary group using the Telnet protocol.
The IP address must be on the same network or subnet as the router's main address, and must not be used by another host on that network or subnet. Connecting to the IP address has the same effect as connecting to the router's main address, using tcp-port as the TCP port.
You can use the ip alias command to assign multiple IP addresses to the router. For example, in addition to the primary alias address, you can specify addresses that correspond to lines or rotary groups. Using the ip alias command in this way makes the process of connecting to a specific rotary group transparent to the user.
When asynchronous mode is implemented, the Cisco IOS software creates the appropriate IP aliases, which map the asynchronous addresses for the lines to which they are connect. This process is automatic and does not require configuration.
Example
The following example configures connections to IP address 172.30.42.42 to act identically to connections made to the server's primary IP address on TCP port 3001. In other words, a user is connected to the first free line on port 1 of the rotary group that uses the Telnet protocol.
ip alias 172.30.42.42 3001ip tcp chunk-size
To enable a faster response to user interrupt characters, use the ip tcp chunk-size global configuration command.
ip tcp chunk-size number
Syntax Description
Command Mode
Global configuration
Usage Guidelines
This command first appeared in Cisco IOS Release 10.0.
When used with a correctly operating host, the Cisco IOS software implements the Telnet Synchronize and Abort Output signals, which can stop output within one packet's worth of data from the time the user types the interrupt character.
Changing the chunk size (the number of characters output before the interrupt executes) affects neither the size of the packet used nor the TCP window size, either of which would cause serious efficiency problems for the remote host as well as for the router. Instead, the Telnet status is checked after the number of characters specified, causing only a relatively minor performance loss.
Example
The following example allows a router to execute an interrupt after an output of 100 characters, when an interrupt character or sequence is entered (Ctrl-C, for example):
ip tcp chunk-size 100keymap
To define specific characteristics of keyboard mappings, use the keymap global configuration command. To remove the named keymap from the current image of the configuration file, use the no form of this command.
keymap keymap-name keymap-entry
no keymap keymap-nameSyntax Description
keymap-name
Name of the file containing the keyboard mappings. The name can be up to 32 characters long and must be unique.
keymap-entry
Commands that define the keymap.
Default
VT100 keyboard emulation
Command Mode
Global configuration
Usage Guidelines
This command first appeared in Cisco IOS Release 10.0.
The keymap command maps individual keys on a non-3270 keyboard to perform the function defined for the 3270 keyboard. Use the EXEC command show keymap to test for the availability of a keymap.
The guidelines for creating a keymap file follow.
Do not name a ttycap entry filename default or the Cisco IOS software will adopt the newly defined entry as the default.
The Keymap Entry Structure
A keymap is a keyboard map file. A keymap consists of an entry for a keyboard. The first part of a keymap lists the names of the keyboards that use that entry. These names will often be the same as in the ttycaps (terminal emulation) file, and often the terminals from various ttycap entries will use the same keymap entry. For example, both 925 and 925vb (for 925 with visual bells) terminals would probably use the same keymap entry. There are other circumstances in which it is necessary to specify a keyboard name as the name of the entry (for example, if a user requires a custom key layout).
After the names, which are separated by vertical bars (|), comes a left brace ({), the text that forms the definitions, and a right brace (}), as follows:
ciscodefault{ clear = '^z';\ flinp = '^x';\ enter = '^m';\ delete = '^d' | '^?';\ synch = '^r';\ ebcdic_xx='string' reshow = '^v';\ eeof = '^e';\ tab = '^i';\ btab = '^b';\ nl = '^n';\ left = '^h';\ right = '^l';\ up = '^k';\ down = '^j';\ einp = '^w';\ reset = '^t';\ ferase = '^u';\ insrt = '\E ';\ pa1 = '^p1'; pa2 = '^p2'; pa3 = '^p3';\ pfk1 = '\E1'; pfk2 = '\E2'; pfk3 = '\E3'; pfk4 = '\E4';\ pfk5 = '\E5'; pfk6 = '\E6'; pfk7 = '\E7'; pfk8 = '\E8';\ pfk9 = '\E9'; pfk10 = '\E0'; pfk11 = '\E-'; pfk12 = '\E=';\ pfk13 = '\E!'; pfk14 = '\E@'; pfk15 = '\E#'; pfk16 = '\E$';\ pfk17 = '\E%'; pfk18 = '\E'; pfk19 = '\E&'; pfk20 = '\E*';\ pfk21 = '\E('; pfk22 = '\E)'; pfk23 = '\E_'; pfk24 = '\E+';\ }Each definition consists of a reserved keyword, which identifies the 3270 function, followed by an equal sign (=), followed by the various ways to generate this particular function, followed by a semicolon (;), as follows:
pa1 = '^p1'; pa2 = '^p2'; pa3 = '^p3';\Each alternative way to generate the function is a sequence of ASCII characters enclosed inside single quotes (`'); the alternatives are separated by vertical bars (|), as follows:
delete = '^d' | '^?';\Inside the single quotes, a few characters are special. A caret (^) specifies that the next character is a control (Ctrl) character. The two-character string caret-a (^a) represents Ctrl-a. The caret-A sequence (^A) generates the same code as caret-a (^a). To generate Delete (or DEL), enter the caret-question mark (^?) sequence.
Note
In addition to the caret, a letter can be preceded by a backslash (\). Because this has little effect for most characters, its use is usually not recommended. In the case of a single quote ('), the backslash prevents that single quote from terminating the string. In the case of a caret (^), the backslash prevents the caret from having its special meaning. To include the backslash in the string, place two backslashes (\\) in the keymap. lists other supported special characters.
Table 61 Special Characters Supported by TN3270 Keymap Capability
\E
Escape character
\n
Newline
\t
Tab
\r
Carriage return
It is not necessary for each character in a string to be enclosed within single quotes. For example, \E\E\E means three escape characters.
To enter a keymap, provide a unique name for it and explicitly define all special keys you intend to include in it within curly brackets. Also, except for the last line, each line must be terminated with a backslash symbol (\). The last line ends with the closing curly brackets (}) symbol and an end-of-line character.
Keymap Restrictions
When emulating IBM-style 3270 terminals, a mapping must be performed between sequences of keys pressed at a user's (ASCII) keyboard and the keys available on a 3270-type keyboard. For example, a 3270-type keyboard has a key labeled EEOF that erases the contents of the current field from the location of the cursor to the end. To accomplish this function, the terminal user and a program emulating a 3270-type keyboard must agree on what keys will be typed to invoke the function. The requirements for these sequences follow:
•
characters.•
Following are examples of acceptable keymap entries:
pfk1 = '\E1';pfk2 = '\E2';Following are examples of unacceptable keymap entries:
pfk1 = '\E1';pfk11 = '\E11';In the acceptable example, the keymap entry for pfk1 is not completely included in the keymap entry for pfk2. By contrast, in the unacceptable, or conflicting keymap pair, the sequence used to represent pfk1 is a complete subset of the sequence used to represent pfk11. Refer to the keymap entry provided later in this section for an example of how various keys can be represented to avoid this kind of conflict.
lists 3270 key names that are supported in this keymap. Note that some of the keys do not really exist on a 3270-type keyboard. An unsupported function will cause the Cisco IOS software to send a (possibly visual) bell sequence to the user's terminal.
Table 62 3270 Key Names Supported by Default Keymap
LPRT1
Local print
DP
Duplicate character
FM
Field mark character
CURSEL
Cursor select
CENTSIGN
EBCDIC cent sign
RESHOW
Redisplay the screen
EINP
Erase input
EEOF
Erase end of field
DELETE
Delete character
INSRT
Toggle insert mode
TAB
Field tab
BTAB
Field back tab
COLTAB
Column tab
COLBAK
Column back tab
INDENT
Indent one tab stop
UNDENT
Undent one tab stop
NL
New line
HOME
Home the cursor
UP
Up cursor
DOWN
Down cursor
RIGHT
Right cursor
LEFT
Left cursor
SETTAB
Set a column tab
DELTAB
Delete a column tab
SETMRG
Set left margin
SETHOM
Set home position
CLRTAB
Clear all column tabs
APLON1
Apl on
APLOFF1
Apl off
APLEND1
Treat input as ASCII
PCON1
Xon/xoff on
PCOFF1
Xon/xoff off
DISC
Disconnect (suspend)
INIT1
New terminal type
ALTK1
Alternate keyboard dvorak
FLINP
Flush input
ERASE
Erase last character
WERASE
Erase last word
FERASE
Erase field
SYNCH
We are in synch with the user
RESET
Reset key-unlock keyboard
MASTER_RESET
Reset, unlock and redisplay
XOFF1
Please hold output
XON1
Please give me output
WORDTAB
Tab to beginning of next word
WORDBACKTAB
Tab to beginning of current/last word
WORDEND
Tab to end of current/next word
FIELDEND
Tab to last nonblank of current/next unprotected (writable) field
PA1
Program attention 1
PA2
Program attention 2
PA3
Program attention 3
CLEAR
Local clear of the 3270 screen
TREQ
Test request
ENTER
Enter key
PFK1 to PFK30
Program function key 1 program function key 30
1 Not supported by Cisco's TN3270 implementation.
illustrates the proper keys used to emulate each 3270 function when using default key mappings.
Table 63 Keys Used to Emulate Each 3270 Function with Default Keymap
Cursor Movement Keys
New Line
Tab
Back Tab
Back Tab
Cursor Left
Cursor Right
Cursor Up
Cursor Down
Ctrl-n or Home
Ctrl-i
Ctrl-b
Ctrl-b
Ctrl-h
Ctrl-l
Ctrl-k
Ctrl-j or LINE FEED
Edit Control Keys
Delete Char
Erase EOF
Erase Input
Insert Mode
End Insert
Ctrl-d or RUB
Ctrl-e
Ctrl-w
ESC-Space1
ESC-Space
Program Function Keys
PF1
PF2
...
PF10
PF11
PF12
PF13
PF14
...
PF24
ESC 1
ESC 2
...
ESC 0
ESC -
ESC =
ESC !
ESC @
...
ESC +
Program Attention Keys
PA1
PA2
PA3
Ctrl-p 1
Ctrl-p 2
Ctrl-p 3
Local Control Keys
Reset After Error
Purge Input Buffer
Keyboard Unlock
Redisplay Screen
Ctrl-r
Ctrl-x
Ctrl-t
Ctrl-v
Other Keys
Enter
Clear
Erase current field
Return
Ctrl-z
Ctrl-u
1 ESC refers to the Escape key.
Example
The following example is the default entry used by the TN3270 emulation software when it is unable to locate a valid keymap in the active configuration image. lists the key names supported by the default Cisco TN3270 keymap.
ciscodefault{ clear = '^z';\ flinp = '^x';\ enter = '^m';\ delete = '^d' | '^?';\ synch = '^r';\ reshow = '^v';\ ebcdic_xx='string' eeof = '^e';\ tab = '^i';\ btab = '^b';\ nl = '^n';\ left = '^h';\ right = '^l';\ up = '^k';\ down = '^j';\ einp = '^w';\ reset = '^t';\ ferase = '^u';\ insrt = '\E ';\ pa1 = '^p1'; pa2 = '^p2'; pa3 = '^p3';\ pfk1 = '\E1'; pfk2 = '\E2'; pfk3 = '\E3'; pfk4 = '\E4';\ pfk5 = '\E5'; pfk6 = '\E6'; pfk7 = '\E7'; pfk8 = '\E8';\ pfk9 = '\E9'; pfk10 = '\E0'; pfk11 = '\E-'; pfk12 = '\E=';\ pfk13 = '\E!'; pfk14 = '\E@'; pfk15 = '\E#'; pfk16 = '\E$';\ pfk17 = '\E%'; pfk18 = '\E'; pfk19 = '\E&'; pfk20 = '\E*';\ pfk21 = '\E('; pfk22 = '\E)'; pfk23 = '\E_'; pfk24 = '\E+';\ }The following keymap statement maps the "|" character to send EBCDIC 0x6A:
ebcdic_6f='|'Related Commands
You can use the master indexes or search online to find documentation of related commands.
keymap-type
show keymap
terminal-typekeymap-type
To specify the keyboard map for a terminal connected to the line, use the keymap-type line configuration command. To reset the keyboard type for the line to the default, use the no form of this command.
keymap-type keymap-name
no keymap-typeSyntax Description
Default
VT100
Command Mode
Line configuration
Usage Guidelines
This command first appeared in Cisco IOS Release 10.0.
This command must follow the corresponding keymap global configuration entry in the configuration file. The TN3270 terminal-type negotiations use the specified keymap type when setting up a connection with the remote host.
Setting the keyboard to a different keymap requires that a keymap be defined with the Cisco IOS software's configuration either by obtaining a configuration file over the network that includes the keymap definition or by defining the keyboard mapping using the global configuration command keymap.
Use the EXEC command show keymap to test for the availability of a keymap.
Example
The following example sets the keyboard mapping to a keymap named vt100map:
line 3 keymap-type vt100mapRelated Commands
You can use the master indexes or search online to find documentation of related commands.
lat
To connect to a LAT host, use the lat EXEC command.
lat name [node nodename | port portname | /debug]
Syntax Description
Command Mode
EXEC
Usage Guidelines
This command first appeared in Cisco IOS Release 11.0.
After entering the lat command, you can quit the connection by pressing Ctrl-C, or complete the connection by entering the password for a given service.
You can have several concurrent LAT sessions open and switch back and forth between them. To open a subsequent session, first enter the escape sequence (Ctrl-Shift-6 then x [Ctrl^x] by default) to suspend the current session. Then open a new session.
To list the available LAT services, use the show lat services EXEC command.
You can temporarily define the list of services to which you or another user can connect. To do so, use the terminal lat out-group command to define the group code lists used for connections from specific lines.
To exit a session, simply log off the remote system. Then terminate an active LAT session by entering exit.
If your preferred transport is set to lat, you can use the connect command in place of the lat command. Refer to the Dial Solutions Configuration Guide for more information about configuring a preferred transport type. When your preferred transport is set to none or to another protocol, you must use the lat command to connect to a LAT host.
Examples
The following example establishes a LAT connection from the router named Router_A to host eng2:
Router_A> lat eng2Trying ENG2...OpenENG2 - VAX/VMS V5.2Username: JSmithPassword:Welcome to VAX/VMS version V5.2 on node ENG2Last interactive login on Friday, 1-APR-1994 19:46The system informs you of its progress by displaying the messages "Trying <system>..." and then "Open." If the connection attempt is not successful, you receive a failure message.
The following example establishes a LAT connection from the router named Router_B to something named our-modems and specifies port 24, which is a special modem:
Router_B> lat our-modems port 24The following example establishes a LAT connection from the router named Router_C to something named our-modems and specifies a node named eng:
Router_C> lat our-modems node engThe following example uses the LAT session debugging capability:
Router_D> lat Eng2 /debugTrying ENG2...OpenENG2 - VAX/VMS V5.2Username: JSmithPassword:Welcome to VAX/VMS version V5.2 on node ENG2Last interactive login on Tuesday, 5-APR-1994 19:02[Set Flow out off, Flow in on, Format 8:none, Speed 9600/9600][Set Flow out off, Flow in on, Format 8:none, Speed 9600/9600]$ set ter/speed=2400[Set Flow out off, Flow in on, Format 8:none, Speed 2400/2400]A variety of LAT events are reported, including all requests by the remote system to set local line parameters. The messages within brackets ([ ]) are the messages produced by the remote system setting line characteristics to operating system defaults.
Related Commands
You can use the master indexes or search online to find documentation of related commands.
connect
show lat services
terminal lat out-grouplat access-list
To specify access conditions to nodes on the LAT network, use the lat access-list global configuration command. To remove a specified access list number, use the no form of this command.
lat access-list number {permit | deny} nodename
no lat access-list numberSyntax Description
Default
No access conditions defined
Command Mode
Global configuration
Usage Guidelines
This command first appeared in Cisco IOS Release 10.0.
Regular expressions are case sensitive. Because LAT node names are always in all capital letters, make sure you use only all capital-letter regular expressions.
and summarize pattern and character matching symbols and their use. A more complete description of the pattern matching characters is found in the "Regular Expressions" appendix later in this publication.
Examples
The following example permits all packets destined for any LAT node named WHEEL:
lat access-list 1 permit WHEELThe following example denies all packets destined for any LAT node name beginning with the BLDG1- prefix:
lat access-list 2 deny ^BLDG1-Related Commands
You can use the master indexes or search online to find documentation of related commands.
access-class
lat enabled
To enable LAT, use the lat enabled interface configuration command. To disable LAT, use the no form of this command.
lat enabled
no lat enabledSyntax Description
This command has no arguments or keywords.
Default
Enabled
Command Mode
Interface configuration
Usage Guidelines
This command first appeared in Cisco IOS Release 10.0.
Examples
The following example enables LAT on Ethernet interface 0:
interface ethernet 0lat enabledThe following example disables LAT on the same Ethernet interface:
interface ethernet 0no lat enabledlat group-list
Use the lat group-list global configuration command to allow a name to be assigned to the group list. A group list is any combination of group names, numbers, or ranges. To remove the specified group list, use the no form of this command.
lat group-list groupname {number | range | all} [enabled | disabled]
no lat group-list groupname {number | range | all} [enabled | disabled]Syntax Description
Default
No group names are assigned to the list.
Command Mode
Global configuration
Usage Guidelines
This command first appeared in Cisco IOS Release 11.1.
Specifying a name for a group list simplifies the task of entering individual group codes. In other words, a name makes it easier to refer to a long list of group code numbers. The group list must already exist. Use the EXEC command show lat groups to see a list of existing groups.
Examples
The following example creates the new group named stockroom and defines it to include the group numbers 71 and 99:
lat group-list stockroom 71 99The following example adds group code 101 to the group named stockroom:
lat group-list stockroom 101 enabledThe following example deletes the group named Bldg-2:
no lat group-list Bldg-2Related Commands
You can use the master indexes or search online to find documentation of related commands.
lat out-group
lat service-grouplat host-buffers
To set the number of receive buffers that will be negotiated when the router is acting as a LAT host, use the lat host-buffers global configuration command. To return to the default of one receive buffer, use the no form of this command.
lat host-buffers receive-buffers
no lat host-buffers receive-buffersSyntax Description
receive-buffers
An integer that specifies the number of receive buffers that will be negotiated. The argument can be any number between 1 and 128.
Default
One receive buffer
Command Mode
Global configuration
Usage Guidelines
This command first appeared in Cisco IOS Release 10.0.
Before LAT Version 5.2, LAT allowed only one outstanding message at a time on a virtual circuit. This could limit the performance of large routers. For example, only one Ethernet packet of data could be in transit at a time. With LAT Version 5.2, nodes can indicate that they are willing to receive more than one message at a time. During virtual circuit startup, each side communicates to the other how many outstanding messages it is willing to accept.
Example
The following example enables LAT and configures the LAT host to negotiate 100 receive buffers:
lat enabledlat host-buffers 100Related Commands
You can use the master indexes or search online to find documentation of related commands.
lat server-buffers
lat host-delay
To set the delayed acknowledgment for incoming LAT slave connections, use the lat host-delay global configuration command. To restore the default, use the no form of this command.
lat host-delay number
no host-delaySyntax Description
Default
Disabled
Command Mode
Global configuration
Usage Guidelines
This command first appeared in Cisco IOS Release 10.3.
Example
The following example sets the acknowledgment for incoming LAT slave connections to 100 milliseconds:
lat host-delay 100lat ka-timer
To set the rate of the keepalive timer, use the lat ka-timer global configuration command. To restore the default, use the no form of this command.
lat ka-timer seconds
no lat ka-timerSyntax Description
Default
20 seconds
Command Mode
Global configuration
Usage Guidelines
This command first appeared in Cisco IOS Release 10.0.
The keepalive timer sets the rate that messages are sent in the absence of actual traffic between the router and the remote node. The server uses keepalive messages to detect when communication with a remote node is disrupted or when the remote node has crashed.
Example
The following example sets the keepalive timer rate to 5 seconds:
lat ka-timer 5lat node
To change the LAT node name without changing the system host name, use the lat node global configuration command.
lat node node-name
Syntax Description
Default
No default LAT node name
Command Mode
Global configuration
Usage Guidelines
This command first appeared in Cisco IOS Release 10.0.
This command allows you to give the server a node name that is different from the host name. Use the EXEC command show entry to determine which LAT hosts have queue entries for printers on the servers. Use the EXEC command clear entry to delete entries from the queue.
Example
The following example specifies the LAT node name as DEC2:
lat node DEC2Related Commands
You can use the master indexes or search online to find documentation of related commands.
clear entry
hostname
show entrylat out-group
To define a group list for a line's outgoing user-initiated connections, use the lat out-group line configuration command. Use the lat out-group 0 command to return to the default value.
lat out-group {groupname number | range | all}
Syntax Description
groupname
Group code name.
number
Group code number. You can also enter both a group code name and group code numbers.
range
Hyphenated range of numbers.
all
Range from 0 to 255.
Default
The default group code number is 0.
Command Mode
Line configuration
Usage Guidelines
This command first appeared in Cisco IOS Release 10.0.
You can have values for one, two, or all three arguments. If the keyword all is specified, no arguments can be used. You can enter the arguments groupname, number, and range in any order.
Use the EXEC command show lat to display group numbers. If the host node and router do not share a common group number, the host's services will not be displayed.
Example
The following example defines the services for lines 1 through 7, 10 through 17, and 20 through 24. Access to systems on the first set of lines is limited to groups 12 and 18 through 23; the second set is limited to group 12; the third set is limited to group codes 12, 18 through 23, and 44. All other lines use the default of group zero.
line 1 7lat out-group 12 18-23line 10 17lat out-group 12line 20 24lat out-group 12 18-23 44Related Commands
You can use the master indexes or search online to find documentation of related commands.
lat group-list
terminal lat out-grouplat remote-modification
To enable remote LAT modification of a line's characteristics (for example, baud rate), use the lat remote-modification line configuration command. To disable remote LAT modification of line characteristics, use the no form of this command.
lat remote-modification
no lat remote-modificationSyntax Description
This command has no arguments or keywords.
Default
Remote modification is disabled.
Command Mode
Line configuration
Usage Guidelines
This command first appeared in Cisco IOS Release 10.0.
Enabling the line for remote modification allows the remote LAT node to change the line's characteristics (for example, baud rate, parity, and so forth).
Example
The following example enables remote LAT modification on line 4:
line 4lat remote-modificationRelated Commands
You can use the master indexes or search online to find documentation of related commands.
terminal lat remote-modification
lat retransmit-limit
To set the number of times that LAT retransmits a message before declaring the remote system unreachable, use the lat retransmit-limit global configuration command. To restore the default retry value, use the no form of this command.
lat retransmit-limit number
no lat retransmit-limitSyntax Description
Default
8 retries
Command Mode
Global configuration
Usage Guidelines
This command first appeared in Cisco IOS Release 10.0.
Assigning larger values to the number of tries increases the robustness of the LAT service at the cost of longer delays when communications are disrupted. Because LAT generally retransmits messages once per second, the value is approximately the number of seconds that LAT connections will survive connection disruption.
If you bridge LAT, the retransmission limit should be set to at least 20 tries for LAT sessions to survive a worst-case spanning-tree reconfiguration, because bridging spanning-tree reconfiguration can take up to 15 seconds.
Example
The following example sets the retransmission limit to 30 tries, enough time to sustain the down time incurred when the system must reconfigure a spanning-tree topology:
lat retransmit-limit 30lat server-buffers
To set the number of receive buffers that will be negotiated when the router is acting as a LAT server, use the lat server-buffers global configuration command. To return to the default of one receive buffer, use the no form of this command.
lat server-buffers receive-buffers
no lat server-buffers receive-buffersSyntax Description
receive-buffers
Integer that specifies the number of receive buffers that will be negotiated. The argument can be any number between 1 and 128.
Default
1 receive buffer
Command Mode
Global configuration
Usage Guidelines
This command first appeared in Cisco IOS Release 10.0.
Before LAT Version 5.2, LAT allowed only one outstanding message on a virtual circuit at a time. This could limit the performance of large routers because only one Ethernet packet of data could be in transit at a time. With LAT Version 5.2, nodes can indicate that they are willing to receive more than one message at a time. During virtual circuit startup, each side communicates to the other how many outstanding messages it is willing to accept.
Example
The following example enables LAT and configures the server to negotiate 25 receive buffers:
lat enabledlat server-buffers 25Related Commands
You can use the master indexes or search online to find documentation of related commands.
lat host-buffers
lat service-announcements
To reenable LAT broadcast service announcements, use the lat service-announcements global configuration command. To disable the sending of LAT service announcements, use the no form of this command.
lat service-announcements
no lat service-announcementsSyntax Description
This command has no arguments or keywords.
Default
Enabled
Command Mode
Global configuration
Usage Guidelines
This command first appeared in Cisco IOS Release 10.0.
If this command is enabled, the LAT code will periodically broadcast service advertisements. If the command is disabled, the LAT code will not send service announcements, so solicit information messages will have to be used to look up node information.
Note
Example
The following example reenables the sending of broadcast service announcements:
lat service-announcementsRelated Commands
You can use the master indexes or search online to find documentation of related commands.
lat service-responder
lat service autocommand
To associate a command with a service, use the lat service autocommand global configuration command. To remove the specified autocommand, use the no form of this command.
lat service service-name autocommand command
no lat service service-name autocommand commandSyntax Description
Default
No commands are automatically associated with a service.
Command Mode
Global configuration
Usage Guidelines
This command first appeared in Cisco IOS Release 10.0.
When an inbound connection is received for the specified service, the command associated with the service is automatically executed instead of the user receiving a virtual terminal session.
Authentication is bypassed for these services; only the LAT password is checked.
Note
Example
The following example associates the command telnet ramana to the service RAMANA:
lat service RAMANA autocommand telnet ramanalat service enabled
To enable inbound connections to the specified service and enable the advertisement of this service to routers on the network, use the lat service enabled global configuration command. To delete the named service, use the no form of this command.
lat service service-name enabled
no lat service service-name enabledSyntax Description
Default
No services enabled
Command Mode
Global configuration
Usage Guidelines
This command first appeared in Cisco IOS Release 10.0.
In the simplest form, this command creates a service that gives connecting users access to a VTY port on the server.
Use the enabled keyword after commands that define a service so that users do not connect to a service before all the parameters are set.
Deleting a service does not disconnect existing connections.
Example
The following example enables inbound connections to the service WHEEL:
lat service WHEEL enabledlat service-group
To specify a group code mask to use when advertising all services for this node and to control incoming services, use the lat service-group global configuration command. To remove the group code mask specified, use the no form of this command.
lat service-group {groupname | number | range | all} [enabled | disabled]
no lat service-group {groupname | number | range | all} [enabled | disabled]Syntax Description
Default
If no service group is specified, the Cisco IOS software defaults to advertising to group 0.
Command Mode
Global configuration
Usage Guidelines
This command first appeared in Cisco IOS Release 10.0.
When this command is written to nonvolatile memory (using the EXEC write memory command), the system looks for an exact match on a group code name. If it finds one, it uses that name in the command. Otherwise, it writes out a list of numbers, using the range syntax whenever possible.
Examples
The following example specifies groups 100 through 103, then defines engineering as the group code list to advertise:
lat group-list engineering 100-103lat service-group engineering enabledThe following example specifies the groups 1, 5, 20 through 36, and 52:
lat service-group 1 5 20-36 52You can enter the following command to add group 99:
lat service-group 99 enabledRelated Commands
You can use the master indexes or search online to find documentation of related commands.
lat group-list
lat service ident
To set the LAT service identification for a specified service, use the lat service ident global configuration command. To remove the identification, use the no form of this command.
lat service service-name ident identification
no lat service service-name identSyntax Description
service-name
Name of the service.
identification
Descriptive name (text only) that identifies the service.
Default
No LAT service identification is set for specific services.
Command Mode
Global configuration
Usage Guidelines
This command first appeared in Cisco IOS Release 10.0.
The identification is advertised to other servers on the network and is displayed along with the list of name services on the LAN.
Example
The following example specifies the identification "Welcome to Gateway-A" on service STELLA:
lat service STELLA ident Welcome to Gateway-Alat service password
To set up a LAT password for a service, use the lat service password global configuration command. To remove the password, use the no form of this command.
lat service service-name password password
no lat service service-name passwordSyntax Description
Default
No default LAT service passwords
Command Mode
Global configuration
Usage Guidelines
This command first appeared in Cisco IOS Release 10.0.
The connecting user will be required to enter the password to complete the connection.
The password is obtained through the LAT password mechanism.
Example
The following example specifies a service named BLUE and the password secret:
lat service BLUE password secretlat service rating
To set a static service rating for the specified service, use the lat service rating global configuration command. To remove the service rating, use the no form of this command.
lat service service-name rating static-rating
no lat service service-name ratingSyntax Description
service-name
Name of the service.
static-rating
Static service rating. The rating must be in the range of 1 to 255.
Default
Dynamic rating
Command Mode
Global configuration
Usage Guidelines
This command first appeared in Cisco IOS Release 10.0.
If this command is not entered, the Cisco IOS software calculates a dynamic rating based on the number of free ports that can handle connections to the service. Setting a static rating overrides this calculation and causes the specified value to be used.
Example
The following example specifies a service rating of 84 on the service WHEEL:
lat service WHEEL rating 84lat service-responder
To configure a node to act as proxy for other nodes when a solicit-information multicast message is received, use the lat service-responder global configuration command. To remove any proxy definition set up using the lat service-responder command, use the no form of this command.
lat service-responder
no lat service responderSyntax Description
This command has no arguments or keywords.
Default
Disabled
Command Mode
Global configuration
Usage Guidelines
This command first appeared in Cisco IOS Release 10.0.
The Cisco IOS software can be configured to support the service responder feature that is part of the latest LAT Version 5.2 specification.
Specifically, the DECserver90L+, which has less memory than other DECservers, does not maintain a cache of learned services. Instead, the DECserver90L+ solicits information about services as they are needed.
LAT Version 5.2 nodes can respond for themselves; LAT Version 5.1 nodes, for example VMS Version 5.4 or earlier nodes, cannot. Instead, a LAT Version 5.2 node configured as a service responder can respond in proxy for those LAT Version 5.1 nodes.
The Cisco IOS software can be configured as a LAT service responder. If all your nodes are LAT Version 5.2 nodes, you do not need to enable the service responder features.
Example
The following example configures a node to act as a proxy for a node when a solicit information multicast message is received. The node configured with this command will respond to solicit messages.
lat service-responderRelated Commands
You can use the master indexes or search online to find documentation of related commands.
lat service-announcements
lat service rotary
To associate a rotary group with a service, use the lat service rotary global configuration command. To remove the association, use the no form of this command.
lat service service-name rotary group
no lat service service-name rotarySyntax Description
Default
Disabled
Command Mode
Global configuration
Usage Guidelines
This command first appeared in Cisco IOS Release 10.0.
Establish rotary groups using the rotary line configuration command.
When an inbound connection is received for this service, the router establishes a reverse LAT connection to a terminal in that rotary group.
If the rotary option is not set, the connection will be to a virtual terminal session on the router.
Example
The following example creates a service called MODEM to establish a rotary group:
lat services MODEM rotary 1Related Commands
You can use the master indexes or search online to find documentation of related commands.
rotary
lat service-timer
To adjust the time between LAT service advertisements, use the lat service-timer global configuration command.
lat service-timer interval
Syntax Description
interval
Number of seconds between service announcements. Note that the granularity offered by this command is ten-second intervals, and the interval value is rounded up.
Default
20 seconds
Command Mode
Global configuration
Usage Guidelines
This command first appeared in Cisco IOS Release 11.1.
This command adjusts the time, in seconds, between LAT service announcements for services offered by the router. This is useful in large networks with many LAT services and limited bandwidth.
Example
The following example sets the interval between LAT service advertisements to 11, and illustrates the rough granularity of the lat service-timer command:
! The time between LAT service advertisements is set to 11. Because the! granularity is in ten-second intervals, the actual time between advertisement! is 20 seconds.lat service-timer 11! 20 seconds between updateslat service-timer 19! 120 seconds between updateslat service-timer 120lat vc-sessions
To set the maximum number of sessions to be multiplexed onto a single LAT virtual circuit, use the lat vc-sessions global configuration command. To remove a prior session's definition, use the no form of this command.
lat vc-sessions number
no lat vc-sessions numberSyntax Description
number
Specifies the number of sessions that will be multiplexed onto a single LAT virtual circuit. This number cannot be greater than 255.
Default
255 sessions per virtual circuit
Command Mode
Global configuration
Usage Guidelines
This command first appeared in Cisco IOS Release 10.0.
Setting the number of sessions to a smaller number can increase throughput if there are many sessions on one host, especially with routers with many physical ports. It can also increase overhead if there is little traffic but a large number of sessions to the same host.
Example
The following example sets the maximum number of sessions to be multiplexed onto a single LAT virtual circuit at 100:
lat vc-sessions 100lat vc-timer
To set the interval of time LAT waits before sending any traffic, use the lat vc-timer global configuration command. To remove a timer definition, use the no form of this command.
lat vc-timer milliseconds
no lat vc-timer millisecondsSyntax Description
milliseconds
Timer value. Specifies the amount of time LAT will wait before sending traffic. Acceptable values are between 10 and 1000 milliseconds.
Default
80 milliseconds
Command Mode
Global configuration
Usage Guidelines
This command first appeared in Cisco IOS Release 10.0.
Smaller timer values increase the overhead on both the router and the host. However, you can use smaller values to correct buffer overflows, which happen when the router receives more data than it can buffer during a virtual circuit timer interval.
Larger values increase the need for buffering and can cause noticeable echoing delay. However, increased values can reduce traffic. In environments with slow bridging, retransmissions can be reduced if you increase the value to at least three times the worst-case, round-trip interval.
Example
The following example sets the time between transmitting messages to 500 milliseconds:
lat vc-timer 500lock
To set up a temporary password on a line, use the lock EXEC command.
lock
Syntax Description
This command has no arguments or keywords.
Command Mode
EXEC
Usage Guidelines
This command first appeared in a release prior to Cisco IOS Release 10.0.
You can prevent access to your session while keeping your connection open by setting up a temporary password. To lock access to the terminal, follow this procedure:
Step 1
When you issue this command, the system prompts you for a password.
Step 2
The screen clears and displays the message "Locked."
Step 3
The Cisco IOS software honors session timeouts on a locked lines. You must clear the line to remove this feature. The system administrator must set the line up to allow use of the temporary locking feature by using the lockable line configuration command.
Example
The following command locks access to the terminal line to which the user is connected. Only this user can access the session:
router(config-line)# lockablerouter(config-line)# Ctrl-zrouter# copy system:running-config nvram:startup-configBuilding configuration...OKrouter# lockPassword:Again:LockedPassword:router#Related Commands
You can use the master indexes or search online to find documentation of related commands.
lockable
login (EXEC)login (EXEC)
To change a login username, use the login EXEC command.
login
Syntax Description
This command has no arguments or keywords.
Command Mode
EXEC
Usage Guidelines
This command first appeared in a release prior to Cisco IOS Release 10.0.
You can change a login username if you must match outgoing access list requirements or other login prompt requirements.
When you enter this command, the Cisco IOS software prompts you for a username and password. Enter the new username and the original password. If the username does not match, but the password does, the Cisco IOS software updates the session to the new username with which the login command attempt was made.
If no username and password prompts appear when you enter this command, the network administrator did not specify that a username and password be required at login time. If both the username and password are entered correctly, the session becomes associated with the specified username.
When you access a system using TACACS security with this command, you can enter your login name or specify a TACACS server by using the following command when the "Username:" prompt appears:
user @tacacs-server
The TACACS server must be one of those defined in a Cisco IOS software configuration file. For more information, refer to the "Specify a TACACS Host" section in the Security Configuration Guide, or refer to the tacacs-server host command in the Security Command Reference book.
If you do not specify a host, the Cisco IOS software tries each of the TACACS servers in the list until it receives a response.
If you do specify a host that does not respond, no other TACACS server is queried. The Cisco IOS software will deny access or function according to the action specified by the tacacs-server last-resort command, if one is configured.
If you specified a TACACS server host with the user @tacacs-server argument, the TACACS server specified will be used for all subsequent authentication or notification queries, with the possible exception of SLIP address queries.
Example
The following example shows how login usernames and passwords can be changed. In this example, a user currently logged on under the username user1 attempts to change that login name to user2. After entering the login command, the user enters the new username, but enters an incorrect password. Because the password does not match the original password, the system rejects the attempt to change the username.
router> loginUsername: user2Password:% Access deniedStill logged in as "user1"Next, the user attempts the login change again, with the user name user2, but enters the correct (original) password. This time the password matches the current login information, the login username is changed to user2, and the user is allowed access to the EXEC at the user-level.
router> loginUsername: user2Password:router>Related Commands
You can use the master indexes or search online to find documentation of related commands.
lock
lockablelogin (line)
To enable password checking at login, use the login line configuration command. Use the no form of this command to disable password checking and allow connections without a password.
login [local | tacacs]
no loginSyntax Description
Default
Virtual terminals require a password. If you do not set a password for a virtual terminal, it responds to attempted connections by displaying an error message and closing the connection.
Command Mode
Line configuration
Usage Guidelines
This command first appeared in Cisco IOS Release 10.0.
If you specify the login command without the local or tacacs option, authentication is based on the password specified with the password line configuration command.
Note
Examples
The following example sets the password letmein on virtual terminal line 4:
line vty 4 password letmein loginThe following example enables the TACACS-style user ID and password-checking mechanism:
line 0 password mypassword login tacacsRelated Commands
You can use the master indexes or search online to find documentation of related commands.
enable password
password
usernamelogin-string
To define a string of characters that the Cisco IOS software sends to a host after a successful Telnet connection, use the login-string global configuration command. Use the no form of this command to remove the login string.
login-string hostname d message [%secp] [%secw] [%b] [%m] d
no login-string hostnameSyntax Description
Default
No login strings are defined.
Command Mode
Global configuration
Usage Guidelines
This command first appeared in Cisco IOS Release 10.0.
Follow this command with one or more blank spaces and a delimiting character of your choice. Then enter one or more lines of text, terminating the message with the second occurrence of the delimiting character. To use a percent sign in the login string, precede it with another percent sign; that is, type the characters "%%." The options can be used anywhere within the message string.
This command applies only to rlogin and Telnet sessions.
Example
In the following example, the value %5p causes a 5-second pause:
login-string office #ATDT 555-1234 %5p hello #notify
To enable terminal notification about pending output from other Telnet connections, use the notify line configuration command. Use the no form of this command to end notification.
notify
no notifySyntax Description
This command has no arguments or keywords.
Default
Disabled
Command Mode
Line configuration
Usage Guidelines
This command first appeared in Cisco IOS Release 10.0.
This command sets a line to inform a user who has multiple, concurrent Telnet connections when output is pending on a connection other than the current one.
Example
The following example sets up notification of pending output from connections on virtual terminal lines 0 to 4:
line vty 0 4 notifyRelated Commands
You can use the master indexes or search online to find documentation of related commands.
terminal notify
resume (switching sessions)
To switch to another open Telnet, rlogin, LAT, or PAD session, use the resume EXEC command.
resume [connection] [keyword] [/set parameter:value]
Syntax Description
connection
(Optional) The name or number of the connection; the default is the most recent connection.
keyword
/set parameter:value
(Optional) Sets PAD parameters for the Cisco IOS software (see ).
Table 66 Telnet and rlogin Resume Options
/debug
Displays parameter changes and messages. In the Cisco IOS software, this option displays informational messages whenever the remote host changes an X.3 parameter, or sends an X.29 control packet.
/echo
Performs local echo.
/line
Enables line-mode editing.
/nodebug
Cancels printing of parameter changes and messages.
/noecho
Disables local echo.
/noline1
Disables line mode and enables character-at-a-time mode, which is the default.
/nostream
Disables stream processing.
/set parameter:value
Sets X.3 connection options. Refer to the chapter "Configuring the Cisco PAD Facility to Make X.25 Connections" of the Dial Solutions Configuration Guide for a list of these connection options.
/stream
Enables stream processing.
1 /noline is the default keyword.
Command Mode
EXEC
Usage Guidelines
This command first appeared in a release prior to Cisco IOS Release 10.0.
You can have several concurrent sessions open and switch back and forth between them. The number of sessions that can be open is defined by the session-limit command.
You can switch between sessions by escaping one session and resuming a previously opened session, as follows:
Step 1
Step 2
Step 3
You also can resume the previous session by pressing the Return key.
The Ctrl^x, where, and resume commands are available with all supported connection protocols.
Examples
The following example shows how to escape out of a connection and to resume connection 2:
Swift% ^^Xrouter> resume 2You can omit the command name and simply enter the connection number to resume that connection. The following example illustrates how to resume connection 3:
router> 3Related Commands
You can use the master indexes or search online to find documentation of related commands.
rlogin
To log in to a UNIX host using rlogin, use the rlogin EXEC command:
rlogin host [-l username] [/user username] [debug]
Syntax Description
Command Mode
EXEC
Usage Guidelines
This command first appeared in Cisco IOS Release 10.0.
You can have several concurrent rlogin connections open and switch back and forth between them. To open a new connection, suspend the current connection by pressing the escape sequence (Ctrl-Shift-6 then x [Ctrl^x] by default) to return to the EXEC prompt, then open a new connection. A user cannot automatically log in to a UNIX system from the router, but must provide a user ID and a password for each connection.
If your preferred transport is set to rlogin, you can use the connect command in place of the rlogin command. Refer to the Dial Solutions Configuration Guide for more information about configuring a preferred transport type. When your preferred transport is set to none or to another protocol, you must use the rlogin command to connect to a host.
To terminate an active rlogin session, issue the appropriate command from the following list at the UNIX prompt of the device to which you are connecting:
•
•
•
•
•
Examples
The following example illustrates how the user, Joe Smith, can use rlogin ? (help) to make and debug a remote connection to the host Alviso:
4500> rlogin ?WORD IP address or hostname of a remote system4500> rlogin Alviso ?-l Specify remote username/user Specify remote usernamedebug Enable rlogin debugging output<cr>4500> rlogin Alviso -l ?WORD Remote user name4500> rlogin Alviso -l jsmith?debug Enable rlogin debugging output<cr>4500> rlogin Alviso -l jsmith debugThe following example illustrates debug return on the host, zipper, by the user, staff:
yak# rlogin zipper.cisco.com -l staff debugTrying zipper.cisco.com (171.69.63.31)... OpenRLOGIN: local username is: ciscoTSRLOGIN: remote username is: staffPassword:Last login: Wed Jun 24 06:15:36 from itech-view3.cisc1 zipper> uptime1:40pm up 42 day(s), 20:53, 80 users, load average: 1.44, 2.67, 3.392 zipper> logout[Connection to zipper.cisco.com closed by foreign host]yak#The following example makes an rlogin connection to a host at address 108.33.21.2 for a user named supervisor and enables the message mode for debugging:
router> rlogin 108.33.21.2 -l supervisor debugThe following example makes an rlogin connection to a host named headquarters for the user named admin:
router> rlogin headquarters -l adminRelated Commands
You can use the master indexes or search online to find documentation of related commands.
connect
telnetrlogin trusted-localuser-source
To choose an authentication method for determining the local username to send to the remote rlogin server, use the rlogin trusted-localuser-source global configuration command. Use the no form of this command to restore the default rlogin behavior.
rlogin trusted-localuser-source [local | radius | tacacs]
no rlogin trusted-localuser-source [local | radius | tacacs]Syntax Description
local
(Optional) Use local username from any authentication method.
radius
(Optional) Use local username from RADIUS authentication.
tacacs
(Optional) Use local username from TACACS authentication.
Default
The user must enter their rlogin username and password when connecting to the rlogin server.
Command Mode
Global configuration
Usage Guidelines
This command first appeared in Cisco IOS Release 11.1
Use this command to define which of the sources of local usernames are valid. You can define more than one.
Example
The following example uses the local username from RADIUS authentication.
router# configure terminalEnter configuration commands, one per line. End with CNTL/Z.router(config)# rlogin trusted-localuser-source ?local Use local username from any authentication methodradius Use local username from radius authenticationtacacs Use local username from tacacs authenticationrouter(config)# rlogin trusted-localuser-source radiusRelated Commands
You can use the master indexes or search online to find documentation of related commands.
connect
rlogin
rlogin trusted-remoteuser-source-local
telnetrlogin trusted-remoteuser-source local
To determine the remote username to send to the remote rlogin server, use the rlogin trusted-remoteuser-source local global configuration command. Use the no form of this command to restore the default rlogin behavior, which is to prompt the user for the remote username.
rlogin trusted-remoteuser-source local
no rlogin trusted-remoteuser-source localSyntax Description
This command has no additional options.
Default
The user must enter their rlogin username and password when connecting to the rlogin server.
Command Mode
Global configuration
Usage Guidelines
This command first appeared in Cisco IOS Release 11.1
The current username is used only if the rlogin host /user username command is not enabled. If the current username is not known, rlogin falls back to providing the "login:" prompt to discover a remote username.
Configuring the remote host to consider the Cisco router a "trusted" host should be considered a security hole.
Examples
After you issue the rlogin trusted-remoteuser-source local command, you will not be prompted for a username. The first response you see is the password prompt from the remote system. For example, when this command is not enabled, you must enter your username twice (once at initial system login and once for the rlogin command).
User Access VerificationUsername: gmcmillaPassword: xxxxxrouter> rlogin puliTrying puli.cisco.com (170.69.3.154)... Openlogin: gmcmillaPassword: xxxxxAfter you issue the rlogin trusted-remoteuser-source local command, you no longer have to specify the username after the rlogin command. The username is automatically copied from the router's user ID.
router> enablePassword: xxxxxrouter# configure terminalEnter configuration commands, one per line. End with CNTL/Z.router(config)# rlogin ?trusted-localuser-source Allowed authentication types for local usernametrusted-remoteuser-source Method used to get remote usernamerouter(config)# rlogin trusted-remoteuser-source localrouter(config)# ^Zrouter# rlogin puliTrying puli.cisco.com (170.69.3.154)... OpenPassword: xxxxxThe following example uses the /user root option as an override.
router# rlogin puli /user rootTrying puli.cisco.com (170.69.3.154)... OpenPassword: xxxxxlogin:Related Commands
You can use the master indexes or search online to find documentation of related commands.
connect
rlogin
rlogin trusted-localuser-source
telnetshow entry
To display the list of queued host-initiated connections to a router, use the show entry EXEC command. You can also use this command to determine which LAT hosts have queue entries for printers on routers.
show entry
Syntax Description
This command has no arguments or keywords.
Command Mode
EXEC
Usage Guidelines
This command first appeared in Cisco IOS Release 11.1.
Sample Display
The following is sample output from the show entry command. The display shows that two LAT connections are waiting for access to port 5. The list is ordered so that the lower numbered entry has been waiting longer, and will get to use the line next.
sloth# show entry1 waiting 0:02:22 for port 5 from LAT node BLUE2 waiting 0:00:32 for port 5 from LAT node STELLAdescribes the fields in the first line of output shown in the display.
show keymap
Use the show keymap EXEC command to test for the availability of a keymap after a connection on a router takes place.
show keymap [keymap-name | all]
Syntax Description
keymap-name
(Optional) Name of the keymap.
all
(Optional) Lists the names of all defined keymaps. The name of the default keymap is not listed.
Command Mode
EXEC
Usage Guidelines
This command first appeared in Cisco IOS Release 10.0.
The Cisco IOS software searches for the specified keymap in its active configuration image and lists the complete entry if found. If the keymap is not found, an appropriate "not found" message appears.
If you do not use any arguments with the show keymap command, then the keymap currently used for the terminal is displayed.
Sample Display
The following is sample output from the show keymap command:
router# show keymapciscodefault { clear = '^z'; flinp = '^x'; enter = '^m';\delete = '^d' | '^?';\synch = '^r'; reshow = '^v'; eeof = '^e'; tab = '^i';\btab = '^b'; nl = '^n'; left = '^h'; right = '^l';\up = '^k'; down = '^j'; einp = '^w'; reset = '^t';\xoff = '^s'; xon = '^q'; escape = '^c'; ferase = '^u';\insrt = '\E ';\pa1 = '^p1'; pa2 = '^p2'; pa3 = '^p3';\pfk1 = '\E1'; pfk2 = '\E2'; pfk3 = '\E3'; pfk4 = '\E4';\pfk5 = '\E5'; pfk6 = '\E6'; pfk7 = '\E7'; pfk8 = '\E8';\pfk9 = '\E9'; pfk10 = '\E0'; pfk11 = '\E-'; pfk12 = '\E=';\pfk13 = '\E!'; pfk14 = '\E@'; pfk15 = '\E#'; pfk16 = '\E$';\pfk17 = '\E%'; pfk18 = '\E\^'; pfk19 = '\E&'; pfk20 = '\E*';\pfk21 = '\E('; pfk22 = '\E)'; pfk23 = '\E_'; pfk24 = '\E+';\}show lat advertised
To display the LAT services a router offers to other systems running LAT on the network, use the show lat advertised EXEC command.
show lat advertised
Syntax Description
This command has no arguments or keywords.
Command Mode
EXEC
Usage Guidelines
This command first appeared in Cisco IOS Release 10.0.
Advertised services are created with the lat service commands. The display includes the service rating, rotary group, if present, and whether or not the service is enabled for incoming connections.
Sample Display
The following is sample output from the show lat advertised command:
router# show lat advertisedService Name Rating Rotary FlagsBEAR-CAT 4(Dynamic) None EnabledAutocommand: telnet bear-catMODEMS 0(Dynamic) 12 EnabledIdent: SpaceBlazer modem servicesRECLUSE 4(Dynamic) None EnabledIdent: white recluse...The display shows output from a router, sloth, which has three services defined: BEAR-CAT, MODEMS, and RECLUSE:
describes significant fields shown in the display.
show lat groups
To display the groups that were defined in the Cisco IOS software with the lat group-list command, use the show lat groups EXEC command.
show lat groups
Syntax Description
This command has no arguments or keywords.
Command Mode
EXEC
Usage Guidelines
This command first appeared in Cisco IOS Release 10.0.
Sample Display
The following is sample output from the show lat groups command:
sloth# show lat groupsGroup Name Len Groupscafeteria 3 13 15 23engineering 7 55manufacturing 10 70 71 72describes only the significant fields shown in the previous display.
Related Commands
You can use the master indexes or search online to find documentation of related commands.
lat group-list
show lat nodes
To display information about all known LAT nodes, use the show lat nodes EXEC command.
show lat nodes
Syntax Description
This command has no arguments or keywords.
Command Mode
EXEC
Usage Guidelines
This command first appeared in Cisco IOS Release 10.0.
Sample Display
The following is sample output from the show lat nodes command:
router# show lat nodesNode "CHAOS", usage -1, Interface Ethernet0, Address 0000.0c01.0509Timer 89, sequence 188, changes 131, flags 0x0, protocol 5.1Facility 0, Product code 0, Product version 0Recv 0/0/0, Xmit 0/0/0, 0 Dups, 0 ReXmitBad messages: 0, Bad slots: 0, Solicits accepted: 0Solicits rejected: 0, Multiple nodes: 0Groups: 0Service classes: 1Node "CONFUSED", usage -1, LocalTimer 99, sequence 4, changes 151, flags 0x0, protocol 5.2Facility 0, Product code 0, Product version 0Recv 0/0/0, Xmit 0/0/0, 0 Dups, 0 ReXmitBad messages: 0, Bad slots: 0, Solicits accepted: 0Solicits rejected: 0, Multiple nodes: 0Groups: 0Service classes: 1Node "EMAN-cs", usage -1, Interface Ethernet0, Address 0000.0cff.c9edTimer 99, sequence 9, changes 159, flags 0x0, protocol 5.1Facility 0, Product code 0, Product version 0Recv 0/0/0, Xmit 0/0/0, 0 Dups, 0 ReXmitBad messages: 0, Bad slots: 0, Solicits accepted: 0Solicits rejected: 0, Multiple nodes: 0Groups: 0Service classes: 1Node "TARMAC", usage -1, Interface Ethernet0, Address 0000.0c02.c7c1Timer -10351, sequence 1, changes 131, flags 0x40, protocol 5.2Facility 0, Product code 0, Product version 0Recv 0/0/0, Xmit 0/0/0, 0 Dups, 0 ReXmitBad messages: 0, Bad slots: 0, Solicits accepted: 0Solicits rejected: 0, Multiple nodes: 0Groups: 0Service classes: 1describes significant fields shown in the display.
show lat services
To display information about learned LAT services in the Cisco IOS software, use the show lat services user EXEC command.
show lat services [service-name]
Syntax Description
Command Mode
User EXEC
Usage Guidelines
This command first appeared in Cisco IOS Release 11.2.
Sample Display
The following is sample output from the show lat services command:
router# show lat servicesService Name Rating Interface Node (Address)ABCDEFGHIJ 5 Ethernet0 CONFUSED (0000.0c00.391f)GLAD 84 Ethernet0 BLUE (aa00.0400.9205)Ident: Welcome to Big Blue GatewayWHEEL 83 Ethernet0 WHEEL (aa00.0400.9005)ZXYW 5 Ethernet0 CONFUSED (0000.0c00.391f)Table 71 describes significant fields shown in this display.
Related Commands
You can use the master indexes or search online to find documentation of related commands.
show lat sessions
show serviceshow lat sessions
To display active LAT sessions, use the show lat sessions user EXEC command.
show lat sessions [line-number]
Syntax Description
Command Mode
User EXEC
Usage Guidelines
This command first appeared in Cisco IOS Release 11.2.
Sample Display
The following is sample output from the show lat sessions command. In this example, information about all active LAT sessions is displayed. The output is divided into three sections for each session (in this case two sessions): TTY data, session data, and remote node data.
router> show lat sessionstty0, connection 1 to service TERM1TTY data:Name "0", Local usage 1/0, Remote usage disabledFlags: Local Connects, EnabledType flags: noneConfig flags: -FlowOut, -FlowIn, Parameter InfoFlow control ^S/^Q in ^S/^Q out, Mode Normal, Parity None, databits 8Groups: 0Session data:Name TERM1, Remote Id 1, Local Id 1Remote credits 2, Local credits 0, Advertised Credits 2Flags: noneMax Data Slot 255, Max Attn Slot 255, Stop Reason 0Remote Node data:Node "TERM1", Address 0000.0C00.291F, usage 1Timer 59, sequence 5, changes 159, flags 0x0, protocol 5.1Recv 56/22/83, Xmit 41/23/14, 0 Dups, 0 ReXmitGroups: 0tty10, connection 1 to service ENG2TTY data:Name "10", Local usage 1/0, Remote usage disabledFlags: Local Connects, EnabledType flags: noneConfig flags: -FlowOut, +FlowIn, Set Parameters, 0x40000000Flow control ^S/^Q in ^S/^Q out, Mode Normal, Parity None, databits 8Groups: 0Session data:Name ENG2, Remote Id 1, Local Id 1Remote credits 1, Local credits 0, Advertised Credits 2Flags: noneMax Data Slot 255, Max Attn Slot 255, Stop Reason 0Remote Node data:Node "ENG2", Address AA00.0400.34DC, usage 1Timer 179, sequence 60, changes 255, flags 0x0, protocol 5.1Recv 58/29/186, Xmit 50/36/21, 0 Dups, 0 ReXmitGroups: 0The following sample output displays information about active LAT sessions on one line (line 10). The output is divided into three sections: TTY data, session data, and remote node data.
router# show lat sessions 10tty10, connection 1 to service ENG2TTY data:Name "10", Local usage 1/0, Remote usage disabledFlags: Local Connects, EnabledType flags: noneConfig flags: -FlowOut, +FlowIn, Set Parameters, 0x40000000Flow control ^S/^Q in ^S/^Q out, Mode Normal, Parity None, databits 8Groups: 0Session data:Name ENG2, Remote Id 1, Local Id 1Remote credits 1, Local credits 0, Advertised Credits 2Flags: noneMax Data Slot 255, Max Attn Slot 255, Stop Reason 0Remote Node data:Node "ENG2", Address AA00.0400.34DC, usage 1Timer 189, sequence 61, changes 247, flags 0x0, protocol 5.1Recv 60/29/186, Xmit 52/36/21, 0 Dups, 0 ReXmitGroups: 0Table 72 describes the screen output for the preceding two examples.
Related Commands
You can use the master indexes or search online to find documentation of related commands.
show lat services
show serviceshow lat traffic
Use the show lat traffic EXEC command to display information about traffic and resource utilization statistics on all active lines.
show lat traffic
Syntax Description
This command has no arguments or keywords.
Command Mode
EXEC
Usage Guidelines
This command first appeared in Cisco IOS Release 10.0.
Sample Display
The following is sample output from the show lat traffic command:
router# show lat trafficLocal host statistics:0/100 circuits, 0/500 sessions, 1/500 services100 sessions/circuit, circuit timer 80, keep-alive timer 5Recv: 335535 messages (2478 duplicates), 161722 slots, 1950146 bytes0 bad circuit messages, 3458 service messages (52 used)Xmit: 182376 messages (2761 retransmit), 146490 slots, 36085 bytes1 circuit timeoutsTotal: 23 circuits created, 38 sessionsdescribes significant fields shown in the display.
show node
To display information about LAT nodes, use the show node EXEC command. The show node command with no further parameters shows a one-line summary of all known nodes. The show node command displays three different sets of information about a node: the node counters, the node status, or a one-line summary of the node status.
show node [all | node-name] [counters | status | summary]
Syntax Description
Command Mode
EXEC
Usage Guidelines
This command first appeared in Cisco IOS Release 10.0.
Entering the show node command with no arguments is the same as entering show node all summary.
You can enter the show node command with either a specific node name or the keyword all, but not both.
You can enter the show node command with only one of the keywords counters, status, or summary. If you enter show node and two of these keywords without specifying a node name, the first keyword is treated as a node name, causing an error. If you enter show node node-name and two of these keywords, the second keyword will be treated as ambiguous.
The show node command with a node-name argument but no counters, status, or summary keyword defaults to show node node-name status.
Sample Display with No Keywords
The following is sample output from the show node command with no further parameters (the same as show node all summary):
router> show nodeNode Name Status IdentificationCHAOS ReachableMUDDY-RIVER ReachableTARMAC ReachableWHEEL Reachable Welcome to VAX/VMS V5.4-2describes significant fields shown in the display.
Sample Display with a Node Name
The following is sample output from the show node output that defaults to show node chaos status. It results in a display of the detailed status of node chaos.
router> show node chaosNode: CHAOS Address: 00-00-0C-01-05-09LAT Protocol: V5.1 Data Link Frame Size: 1500Identification:Node Groups: 0Service Name Status Rating IdentificationCHAOS Available 80describes significant fields shown in the display.
Sample Display with the Counters Keyword
The following is sample output for the counter information for a specific node:
router> show node tarmac countersNode: tarmacSeconds Since Zeroed: 100 Multiple Node Addresses: 0Messages Received: 0 Duplicates Received: 0Messages Transmitted: 0 Messages Re-transmitted: 0Slots Received: 0 Illegal Messages Received: 0Slots Transmitted: 0 Illegal Slots Received: 0Bytes Received: 0 Solicitations Accepted: 0Bytes Transmitted: 0 Solicitations Rejected: 0Additional Sample Displays
In the following example, the keyword status is treated as the node name:
router> show node status countersLocal -710- Node STATUS not knownIn the following example, the second keyword counters is treated as ambiguous:
router> show node lager status countersLocal -702- Keyword "COUNTERS" not known or ambiguousshow service
Use the show service EXEC command to display specific LAT learned services.
show service [service-name]
Syntax Description
Command Mode
EXEC
Usage Guidelines
This command first appeared in Cisco IOS Release 10.0.
The show service command without a service name displays a list of known LAT learned services. When entered with the service-name argument, it displays a more-detailed status of the named service. If no LAT learned service by the specified name is known, then a lookup is done for an IP host of that name.
Sample Display
The following is sample output from the show service command:
router> show serviceService Name Status IdentificationBLUE Available Welcome to VAX/VMS V5.4CHAOS AvailableMRL12 AvailableMUDDY-RIVER AvailableSTELLA-BLUE Available Welcome to VAX/VMS V5.4The following display shows sample show service output for a specific service:
router> show service blueService BLUE - AvailableNode Name Status Rating IdentificationBLUE reachable 84 Welcome to VAX/VMS V5.4describes significant fields shown in the two previous displays.
show sessions
To display information about open LAT, Telnet, or rlogin connections, use the show sessions user EXEC command.
show sessions
Command Mode
User EXEC
Usage Guidelines
This command first appeared in a release prior to Cisco IOS Release 10.0.
This command display the host name, address, number of unread bytes for the user to receive, idle time, and connection name.
Sample Display
The following is sample output from the show sessions command:
sloth# show sessionsConn Host Address Byte Idle Conn Name1 MATHOM 192.31.7.21 0 0 MATHOM* 2 CHAFF 131.108.12.19 0 0 CHAFFThe asterisk (*) indicates the current terminal session.
describes significant fields shown in the display.
Related Commands
You can use the master indexes or search online to find documentation of related commands.
resume
whereshow tcp
To display the status of a TCP connection, use the show tcp user EXEC command.
show tcp [line-number]
Syntax Description
Command Mode
User EXEC
Usage Guidelines
This command first appeared in a release prior to Cisco IOS Release 10.0.
Sample Display
The following is sample output from the show tcp command:
router# show tcptty0, connection 1 to host ciderConnection state is ESTAB, I/O status: 1, unread input bytes: 0Local host: 171.69.232.17, Local port: 11184Foreign host: 171.69.1.137, Foreign port: 23Enqueued packets for retransmit: 0, input: 0, saved: 0Event Timers (current time is 67341276):Timer: Retrans TimeWait AckHold SendWnd KeepAliveStarts: 30 0 32 0 0Wakeups: 1 0 14 0 0Next: 0 0 0 0 0iss: 67317172 snduna: 67317228 sndnxt: 67317228 sndwnd: 4096irs: 1064896000 rcvnxt: 1064897597 rcvwnd: 2144 delrcvwnd: 0SRTT: 317 ms, RTTO: 900 ms, RTV: 133 ms, KRTT: 0 msminRTT: 4 ms, maxRTT: 300 ms, ACK hold: 300 msFlags: idle user, retransmission timeoutDatagrams (max data segment is 536 bytes):Rcvd: 41 (out of order: 0), with data: 34, total data bytes: 1596Sent: 57 (retransmit: 1), with data: 35, total data bytes: 55Table 78 describes the following lines of output shown in the display:
The following line of output shows the current time according to the system clock of the local host.
Event Timers (current time is 67341276):The following lines of output display the number of times that various local TCP timeout values were reached during a connection. In this example, the Cisco IOS software retransmitted once because it received no response from the remote host, and it transmitted an ACK-only segment 14 times because there was no data segment on which to piggyback. Table 79 describes the fields in the following lines of output:
Timer: Retrans TimeWait AckHold SendWnd KeepAliveStarts: 30 0 32 0 0Wakeups: 1 0 14 0 0Next: 0 0 0 0 0
The following lines of output display the sequence numbers that TCP uses to ensure sequenced, reliable transport of data. The router and remote host each use these sequence numbers for flow control and to acknowledge receipt of datagrams. Table 80 describes the fields in this output.
iss: 67317172 snduna: 67317228 sndnxt: 67317228 sndwnd: 4096irs: 1064896000 rcvnxt: 1064897597 rcvwnd: 2144 delrcvwnd: 0
The following lines of output show the values that the Cisco IOS uses to keep track of transmission times so that TCP can adjust to the network it is using. Table 81 describes the fields in this output.
SRTT: 317 ms, RTTO: 900 ms, RTV: 133 ms, KRTT: 0 msminRTT: 4 ms, maxRTT: 300 ms, ACK hold: 300 msFlags: higher precedence, idle user, retransmission timeout
For more information about these fields, refer to the article "Round Trip Time Estimation," by P. Karn and C. Partridge, ACM SIGCOMM-87, August 1987.
Table 82 describes the fields in the following lines of output from the show tcp command:
Datagrams (max data segment is 536 bytes):Rcvd: 41 (out of order: 0), with data: 34, total data bytes: 1596Sent: 57 (retransmit: 1), with data: 35, total data bytes: 55
Related Commands
You can use the master indexes or search online to find documentation of related commands.
show tcp brief
show tcp brief
To view a summary of the TCP connection end points in the system, use the show tcp brief user EXEC command.
show tcp brief [all]
Syntax Description
all
(Optional) Shows the status for all end points. End points in the LISTEN state are usually not shown.
Command Mode
User EXEC
Usage Guidelines
This command first appeared in Cisco IOS Release 11.2.
Sample Display
The following example is the output from the show tcp brief command after a user has connected to the router using Telnet:
router# show tcp briefTCB Local Address Foreign Address (state)609789AC Router.cisco.com.23 cider.cisco.com.3733 ESTABdescribes the fields shown in the example.
Related Commands
You can use the master indexes or search online to find documentation of related commands.
show tcp
show tn3270 ascii-hexval
To determine ASCII-hexadecimal character mappings, use the show tn3270 ascii-hexval EXEC command.
show tn3270 ascii-hexval
Syntax Description
This command has no arguments or keywords.
Command Mode
EXEC
Usage Guidelines
This command first appeared in Cisco IOS Release 10.3.
Use the show tn3270 ascii-hexval command to display the hexadecimal value of a character on your keyboard. After entering the show tn3270 ascii-hexval command, you are prompted to press a key. The hexadecimal value of the ASCII character is displayed. This command is useful for users who do not know the ASCII codes associated with various keys or do not have manuals for their terminals.
Sample Displays
The following is sample output from the show tn3270 ascii-hexval command:
router> show tn3270 ascii-hexvalPress key> 7 - hexadecimal value is 0x37.chaff> show tn3270 ascii-hexvalPress key> f - hexadecimal value is 0x66.tarmac> show tn3270 ascii-hexvalPress key> not printable - hexadecimal value is 0xD.Related Commands
You can use the master indexes or search online to find documentation of related commands.
show tn3270 character-map
tn3270 character-mapshow tn3270 character-map
To display character mappings between ASCII and EBCDIC, use the show tn3270 character-map EXEC command.
show tn3270 character-map {all | ebcdic-in-hex}
Syntax Description
all
Displays all nonstandard character mappings.
ebcdic-in-hex
Displays the ASCII mapping for a specific EBCDIC character.
Command Mode
EXEC
Usage Guidelines
This command first appeared in Cisco IOS Release 11.1.
Sample Display
The following is sample output from the show tn3270 character-map command:
router# show tn3270 character-map allEBCDIC 0x81 <=> 0x78 ASCIIEBCDIC 0x82 <=> 0x79 ASCIIEBCDIC 0x83 <=> 0x7A ASCIIRelated Commands
You can use the master indexes or search online to find documentation of related commands.
show tn3270 ascii-hexval
tn3270 character-mapshow ttycap
To test for the availability of a ttycap after a connection on a router takes place, use the show ttycap EXEC command.
show ttycap [ttycap-name | all]
Syntax Description
ttycap-name
(Optional) Name of a ttycap.
all
(Optional) Lists the names of all defined ttycaps. The name of the default ttycap is not listed.
Command Mode
EXEC
Usage Guidelines
This command first appeared in Cisco IOS Release 10.0.
The Cisco IOS software searches for the specified ttycap in its active configuration image, and lists the complete entry if found. If it is not found, an appropriate "not found" message appear.
If you do not include any arguments with the show ttycap command, then the current keymap used for the terminal is displayed.
Sample Display
The following is sample output from the show ttycap command:
router# show ttycapd0|vt100|vt100-am|vt100am|dec vt100:do=^J:co#80:li#24:\cl=50^[[;H^[[2J:bs:am:cm=5^[[%i%d;%dH:nd=2^[[C:up=2^[[A:\ce=3^[[K:so=2^[[7m:se=2^[[m:us=2^[[4m:ue=2^[[m:md=2^[[1m:\me=2^[[m:ho=^[[H:xn:sc=^[7:rc=^[8:cs=^[[%i%d;%dr:router# show ttycap allttycap3 d0|vt100|vt100-am|vt100am|dec vt100ttycap2 dl|vt200|vt220|vt200-js|vt220-js|dec vt200 series with jump scrollttycap1 ku|h19-u|h19u|heathkit with underscore cursorrouter# show ttycap ttycap1ttycap1 ku|h19-u|h19u|heathkit with underscore cursor:\:vs@:ve@:tc=h19-b:\:al=1*\EL:am:le=^H:bs:cd=\EJ:ce=\EK:cl=\EE:cm=\EY%+ %+\:co#80:dc=\EN:\:dl=1*\EM:do=\EB:ei=\EO:ho=\EH\:im=\E@:li#24:mi:nd=\EC:as=\EF:ae=\EG:\:ms:pt:sr=\EI:se=\Eq:so=\Ep:up=\EA:vs=\Ex4:ve=\Ey4:\:kb=^h:ku=\EA:kd=\EB:kl=\ED:kr=\EC:kh=\EH:kn#8:ke=\E>:ks=\E=:\:k1=\ES:k2=\ET:k3=\EU:k4=\EV:k5=\EW:\:l6=blue:l7=red:l8=white:k6=\EP:k7=\EQ:k8=\ER:\:es:hs:ts=\Ej\Ex5\Ex1\EY8%+ \Eo:fs=\Ek\Ey5:ds=\Ey1:show xremote
To display XRemote connections and monitor XRemote traffic through the router, use the show xremote EXEC command.
show xremote
Syntax Description
This command has no arguments or keywords.
Command Mode
EXEC
Usage Guidelines
This command first appeared in Cisco IOS Release 10.0.
The show xremote command displays XRemote parameters applied to the entire system, as well as statistics that are pulled for all active XRemote connections.
Sample Display
The following is sample output from the show xremote command when XRemote is enabled and XRemote sessions are active:
router# show xremoteXRemote server-wide parameters:Font buffersize: 72000 Font retries: 3Font memory errors: 0TFTP font load statistics for host 172.16.1.111:Bytes read: 2697239 Files read: 258Network errors: 4 File errors: 0LAT font load statistics for service WHEEL, incarnation 5:Bytes read 182401 Files read: 14Protocol errors: 0 Insufficient memory: 0XRemote statistics for tty2:Current clients: 9 Total clients: 17Requesting client: 5 Current request size: 0Replying client: 6 Current reply size: 0XDM state: 10 Next timeout: 172460Retransmit counter: 0 Local UDP port: 53616Keepalive dormancy: 180 Session id: 94Unread input: 0 Unwritten output: 0Input buffer size: 1024 Output buffer size: 108Protocol version: 2 Line state: ConnectedTransmit packets: 50768 Receive packets: 49444Transmit errors: 0 Receive errors: 37Retransmissions: 403 Receive out of sequence: 76Round trip time: 383 Retransmit interval: 766Transmit window: 7 Receive window: 7Transmit next: 6 Receive next: 3Transmit unacked: 6 Receive unacked: 0Connection 0 - TCP connection from 172.16.1.55 [Display Manager]Client state: CS_ACTIVE Byte order: MSBfirstUnread input: 0 Unwritten output: 0Input buffer size: 1024 Output buffer size: 1024Connection 1 - LAT connection from WHEEL
Client state: CS_ACTIVE Byte order: LSBfirst
Unread input: 0 Unwritten output: 0
Input buffer size: 1024 Output buffer size: 1024describes the significant fields shown in the display.
Table 84 Show XRemote Field Descriptions
This section displays XRemote parameters that apply to the protocol translator.
Font buffer size
XRemote font buffer size that was specified with the xremote tftp buffersize global configuration command.
Font retries
Number of retries the font loader (host) will attempt before declaring an error condition.
Font memory errors
Number of font memory error conditions that have been declared for the protocol translator.
This section displays XRemote statistics for fonts that have been loaded from a TFTP font server at the IP address shown.
Bytes read
Number of bytes the host read in order to load the fonts.
Files read
Number of files the host read in order to load the fonts.
This section displays XRemote for the specified line.
Current clients
Number of clients using this line for active XRemote sessions.
Total clients
Includes the number of clients using this line for active XRemote sessions.
Requesting client
Number of clients requesting XRemote service.
Retransmit counter
Number of times that XRemote connection requests were retransmitted.
Local UDP port
Number assigned to the local UDP port.
Keepalive dormancy
Amount of time between keepalive messages.
show xremote line
To list XRemote connections and monitor XRemote traffic, use the show xremote line EXEC command.
show xremote line number
Syntax Description
number
A decimal value representing the number of virtual terminal lines about which to display information.
Command Mode
EXEC
Usage Guidelines
This command first appeared in Cisco IOS Release 10.0.
Sample Display
The following is sample output from the show xremote line command (line 3 is specified) when XRemote is enabled and XRemote sessions are active. Only information specific to an individual terminal line is provided.
router# show xremote line 3Xremote statistics for tty3:Current clients: 11 Total clients: 19Requesting client: 10 Current request size: 0Replying client: 10 Current reply size: 0XDM state: 10 Next timeout: 173304Retransmit counter: 0 Local UDP port: 28384Keepalive dormancy: 180 Session id: 29Unread input: 0 Unwritten output: 0Input buffer size: 1024 Output buffer size: 108Protocol version: 2 Line state: ConnectedTransmit packets: 28875 Receive packets: 18644Transmit errors: 0 Receive errors: 13Retransmissions: 53 Receive out of sequence: 41Round trip time: 384 Retransmit interval: 768Transmit window: 7 Receive window: 7Transmit next: 2 Receive next: 7Transmit unacked: 2 Receive unacked: 0Connection 0 - TCP connection from 172.16.1.27 [Display Manager]Client state: CS_ACTIVE Byte order: MSBfirstUnread input: 0 Unwritten output: 0Input buffer size: 1024 Output buffer size: 1024Connection 1 - TCP connection from 172.16.1.27Client state: CS_ACTIVE Byte order: MSBfirstUnread input: 0 Unwritten output: 0Input buffer size: 1024 Output buffer size: 1024Connection 2 - TCP connection from 172.16.1.27Client state: CS_ACTIVE Byte order: MSBfirstUnread input: 0 Unwritten output: 0Input buffer size: 1024 Output buffer size: 1024See in the show xremote command description earlier in this chapter for show xremote line output field descriptions.
telnet
To log on to a host that supports Telnet, use the telnet EXEC command.
telnet host [port] [keyword]Syntax Description
host
A host name or an IP address.
port
(Optional) A decimal TCP port number; the default is the Telnet router port (decimal 23) on the host.
keyword
Command Mode
EXEC
Usage Guidelines
This command first appeared in a release prior to Cisco IOS Release 10.0.
With the Cisco IOS implementation of TCP/IP, you are not required to enter the connect or telnet commands to establish a Telnet connection. You can just enter the learned host name—as long as the following conditions are met:
•
•
To display a list of the available hosts, use the show hosts command. To display the status of all TCP connections, use the show tcp command.
The Cisco IOS software assigns a logical name to each connection, and several commands use these names to identify connections. The logical name is the same as the host name, unless that name is already in use, or you change the connection name with the name-connection EXEC command. If the name is already in use, the Cisco IOS software assigns a null name to the connection.
The Telnet software supports special Telnet commands in the form of Telnet sequences that map generic terminal control functions to operating system-specific functions. To issue a special Telnet command, enter the escape sequence and then a command character. The default escape sequence is Ctrl-^ (press and hold the Control and Shift keys and the 6 key). You can enter the command character as you hold down Ctrl or with Ctrl released; you can use either uppercase or lowercase letters. lists the special Telnet escape sequences.
Table 86 Special Telnet Escape Sequences
Ctrl-^ b
Break
Ctrl-^ c
Interrupt Process (IP)
Ctrl-^ h
Erase Character (EC)
Ctrl-^ o
Abort Output (AO)
Ctrl-^ t
Are You There? (AYT)
Ctrl-^ u
Erase Line (EL)
1 The caret (^) symbol refers to Shift-6 on your keyboard.
At any time during an active Telnet session, you can list the Telnet commands by pressing the escape sequence keys followed by a question mark at the system prompt:
Ctrl-^ ?
A sample of this list follows. In this sample output, the first caret (^) symbol represents the Control key, while the second caret represents Shift-6 on your keyboard:
router> ^^?[Special telnet escape help]^^B sends telnet BREAK^^C sends telnet IP^^H sends telnet EC^^O sends telnet AO^^T sends telnet AYT^^U sends telnet ELYou can have several concurrent Telnet sessions open and switch back and forth between them. To open a subsequent session, first suspend the current connection by pressing the escape sequence (Ctrl-Shift-6 then x [Ctrl^x] by default) to return to the system command prompt. Then open a new connection with the telnet command.
To terminate an active Telnet session, issue any of the following commands at the prompt of the device to which you are connecting:
close
disconnect
exit
logout
quitExamples
The following example establishes an encrypted Telnet session from a router to a remote host named host1:
router> telnet host1 /encrypt kerberosThe following example routes packets from the source system host1 to kl.sri.com, then to 10.1.0.11, and finally back to host1:
router> telnet host1 /route:kl.sri.com 10.1.0.11 host1The following example connects to a host with logical name host1:
router> host1Related Commands
You can use the master indexes or search online to find documentation of related commands.
connect
rlogintelnet break-on-ip
To cause the system to generate a hardware BREAK signal on the RS-232 line that is associated with a reverse Telnet connection when a Telnet Interrupt-Process command is received on that connection, use the telnet break-on-ip line configuration command.
telnet break-on-ip
Syntax Description
This command has no arguments or keywords.
Default
No hardware Break signal is generated when an Interrupt-Process command is received.
Command Mode
Line configuration
Usage Guidelines
This command first appeared in Cisco IOS Release 10.0.
This command causes the system to generate a hardware BREAK signal on the RS-232 line that is associated with a reverse Telnet connection. It is useful when a Telnet Interrupt-Process command is received on that connection because it can control the translation of Telnet Interrupt-Process commands into X.25 BREAK indications. It is also a useful workaround in the following situations:
•
•
•
A hardware BREAK signal is generated when a Telnet BREAK command is received.
Example
In the following example, line 5 is configured with the telnet break-on-ip command. The location text notes that this refers to the high-speed modem. The telnet transparent command sets end-of-line handling.
line 5location high-speed modemtelnet transparenttelnet break-on-ipRelated Commands
You can use the master indexes or search online to find documentation of related commands.
connect
telnet (EXEC)
telnet transparent
terminal telnet break-on-iptelnet refuse-negotiations
To set a line using Telnet to refuse to negotiate full duplex, remote echo requests on incoming connections, use the telnet refuse-negotiations line configuration command.
telnet refuse-negotiations
Syntax Description
This command has no arguments or keywords.
Command Mode
Line configuration
Usage Guidelines
This command first appeared in Cisco IOS Release 10.0.
Use this command on reverse Telnet connections to allow the Cisco IOS software to refuse full-duplex, remote echo option connection requests from the other end. This command suppresses negotiation of the Telnet Remote Echo and Suppress Go Ahead options.
This command does not apply to protocol translation configurations. It is intended for applications wherein the router is functioning as a terminal server to allow terminal connections to remote devices through the asynchronous terminal ports of the router. Terminal server connections are those where the user types a command similar to the following to access network resources:
telnet access-server 2005
where access-server is the host name of the Cisco router functioning as a terminal server, and 2005 is the port number on the router to which the remote terminal is connected.
Example
The following example shows how to set line 5 to refuse full-duplex, remote echo requests:
line 5telnet refuse-negotiationsRelated Commands
You can use the master indexes or search online to find documentation of related commands.
connect
telnet (EXEC)
terminal telnet refuse-negotiationstelnet speed
To allow the Cisco IOS software to negotiate transmission speed of the line to a connected device, use the telnet speed line configuration command.
telnet speed default-speed maximum-speed
Syntax Description
Command Mode
Line configuration
Usage Guidelines
This command first appeared in Cisco IOS Release 10.0.
Negotiates speeds on reverse Telnet lines. You can match line speeds on remote systems in reverse Telnet, on host machines hooked up to a router used to access the network, or on a group of console lines hooked up to the router, when disparate line speeds are in use at the local and remote ends of the connection. Line speed negotiation adheres to the Remote Flow Control option, defined in RFC 1080.
Example
The following example allows a router to negotiate a bit rate on the line using the Telnet option. If no speed is negotiated, the line will run at 2400 bits per second. If the remote host requests a speed of greater than 9600 bps, then 9600 will be used.
line 5telnet speed 2400 9600Related Commands
You can use the master indexes or search online to find documentation of related commands.
connect
telnet (EXEC)
terminal telnet speedtelnet sync-on-break
To configure the Cisco IOS software to cause an incoming connection to send a Telnet Synchronize signal when it receives a Telnet BREAK signal, use the telnet sync-on-break line configuration command.
telnet sync-on-break
Syntax Description
This command has no arguments or keywords.
Command Mode
Line configuration
Usage Guidelines
This command first appeared in Cisco IOS Release 10.0.
This command causes a reverse Telnet line to send a Telnet Synchronize signal when it receives a Telnet BREAK signal. This option is used very rarely to ensure the ordering of BREAK reception with respect to data characters sent after the BREAK.
Example
In the following example, line 8 is configured with the telnet sync-on-break command:
line aux 0telnet sync-on-breakRelated Commands
You can use the master indexes or search online to find documentation of related commands.
connect
telnet (EXEC)
terminal telnet sync-on-breaktelnet transparent
To configure the Cisco IOS software to send a CARRIAGE RETURN (CR) as a CR followed by a NULL instead of a CR followed by a LINE FEED (LF), use the telnet transparent line configuration command.
telnet transparent
Syntax Description
This command has no arguments or keywords.
Default
CARRIAGE RETURN followed by a LINE FEED.
Command Mode
Line configuration
Usage Guidelines
This command first appeared in Cisco IOS Release 10.0.
This command is useful for coping with different interpretations of end-of-line handling in the Telnet protocol specification.
Example
The following example causes the Cisco IOS software, when sending a CR, to send a CR followed by a NULL character:
line 7telnet transparentRelated Commands
You can use the master indexes or search online to find documentation of related commands.
connect
telnet (EXEC)
terminal telnet transparentterminal lat out-group
To temporarily define the list of services to which you or another user can connect, use the terminal lat out-groupEXEC command.
terminal lat remote-modification
terminal lat out-group group_number [start-end] {disabled | enabled}Syntax Description
Command Mode
EXEC
Usage Guidelines
This command first appeared in Cisco IOS Release 11.2.
To temporarily define the list of services to which you or another user can connect, you define the group code lists used for connections from specific lines. You limit the connection choices for an individual line by defining the group code lists for an outgoing connection. When a user initiates a connection with a LAT host, the user's line must share a common group number with the remote LAT host before a connection can be made.
The group code range entered in this command must fall within the group code range already configured for the line.
Example
The following example defines a group code list for the outgoing group 4:
router> terminal lat out-group 4, 6-189Related Commands
You can use the master indexes or search online to find documentation of related commands.
connect
latterminal transport preferred
To specify the preferred protocol to use for the current session when a command does not specify one, use the terminal transport preferred EXEC command.
terminal transport preferred {all | lat | mop | nasi | none | pad | rlogin | telnet | v120}
Syntax Description
Default
lat (if LAT is not supported, telnet)
Command Mode
EXEC
Usage Guidelines
The terminal transport [none | telnet] command first appeared in a release prior to Cisco IOS Release 10.0. The entire command first appeared in Cisco IOS Release 11.2.
Example
The following example configures the console so that it does not connect when an unrecognized command is entered:
router> terminal transport preferred noneRelated Commands
You can use the master indexes or search online to find documentation of related commands.
transport preferred
tn3270
To begin a TN3270 session, use the tn3270 EXEC command.
tn3270 host
Syntax Description
host
Name or IP address of a specific host on a network that can be reached by the router. The default terminal emulation mode allows access using a VT100 emulation.
Default
None
Command Mode
EXEC
Usage Guidelines
This command first appeared in Cisco IOS Release 11.1.
Unlike Telnet and LAT connections, you must enter the command tn3270 to make a connection to an IBM TN3278 host.
To terminate an active TN3270 session, enter the escape sequence (Ctrl-Shift-6 then x [Ctrl^x] by default) and enter the disconnect command at the EXEC prompt. Or log off the remote system by issuing the command specific to that system (such as exit, logout, quit, close, or disconnect).
Example
The following example establishes a terminal session with an IBM TN3270 host named finance:
router> tn3270 financetn3270 8bit display
To configure the Cisco IOS software to use the mask set by the data-character-bits {7 | 8} line configuration command or the terminal data-character bits {7 | 8} EXEC command, use the tn3270 8bit display line configuration command. To restore the default 7-bit mask used for TN3270 connections, use the no form of this command.
tn3270 8bit display
no tn3270 8bit displaySyntax Description
This command has no arguments or keywords.
Default
Disabled
Command Mode
Line configuration
Usage Guidelines
This command first appeared in Cisco IOS Release 10.0.
Use the tn3270-character-map command to map between extended EBCDIC or extended ASCII characters.
Example
The following example configures the Cisco IOS software to use the mask set by the data-character-bits line configuration and EXEC commands on line 5:
line 5tn3270 8bit displayRelated Commands
You can use the master indexes or search online to find documentation of related commands.
data-character-bits
terminal data-character-bitstn3270 8bit transparent-mode
To configure the Cisco IOS software to use the mask set by the data-character-bits {7 | 8} line configuration command or the terminal data-character bits {7 | 8} EXEC command, use the tn3270 8bit transparent-mode line configuration command. To restore the default 7-bit mask used for TN3270 connections, use the no form of this command.
tn3270 8bit transparent-mode
no tn3270 8bit transparent-modeSyntax Description
This command has no arguments or keywords.
Default
Disabled
Command Mode
Line configuration
Usage Guidelines
This command first appeared in Cisco IOS Release 10.0.
This command is needed if you are using a file transfer protocol such as Kermit in 8-bit mode or you are using 8-bit graphics, both of which rely on transparent mode.
Example
The following example configures the software to use the mask set by the data-character-bits line configuration and EXEC commands on line 5:
line 5tn3270 8bit transparent-modeRelated Commands
You can use the master indexes or search online to find documentation of related commands.
data-character-bits
terminal data-character-bitstn3270 character-map
To convert incoming EBCDIC characters into ASCII characters, use the tn3270 character-map global configuration command. To restore default character mappings, use the no form of this command.
tn3270 character-map ebcdic-in-hex ascii-in-hex
no tn3270 character-map {all | ebcdic-in-hex} [ascii-in-hex]Syntax Description
ebcdic-in-hex
Hexadecimal value of an EBCDIC character.
ascii-in-hex
Hexadecimal value of an ASCII character.
all
Indicates all character mappings.
Default
Disabled
Command Mode
Global configuration
Usage Guidelines
This command first appeared in Cisco IOS Release 10.0.
Use this command to print international characters that are EBCDIC characters not normally printed, including umlauts (ยจ) and tildes (~). The command first restores default mapping for both EBCDIC and ASCII characters. In the no form of the command, the all keyword resets all character mappings to Cisco defaults.
shows the default character mappings between ASCII and EBCDIC in decimal and hexadecimal format.
To convert outgoing ASCII characters into EBCDIC characters, use the keymap command to modify the keymap structure with the tag ebcdic_xx=string, where xx is a hexadecimal value and string is the sequence of characters that send the ESCDIC character.
Example
The following example creates a two-way binding between an EBCDIC character and an ASCII character:
tn3270 character-map 0x81 0x78Related Commands
You can use the master indexes or search online to find documentation of related commands.
show tn3270 ascii-hexval
show tn3270 character-maptn3270 datastream
Use the tn3270 datastream global configuration command to enable the TN3270 extended datastream. Use the no form of this command to return to the normal TN3270 datastream.
tn3270 datastream {extended | normal}
no tn3270 datastreamSyntax Description
Default
Normal datastream
Command Mode
Global configuration
Usage Guidelines
This command first appeared in Cisco IOS Release 10.3.
This command causes an "-E" to be appended to the terminal type string sent to the IBM host. This allows you to use the extended TN3270 features.
Example
The following example shows the supported tn3270 datastream options:
router(config)# tn3270 datastream ?extended Use extended TN3270 datastreamnormal Use normal TN3270 datastreamtn3270 null-processing
Use the tn3270 null-processing global configuration command to specify how NULLs are handled. Use the no form of the command to return to 7171 NULL processing.
tn3270 null-processing [3270 | 7171]
no tn3270 null-processing [3270 | 7171]Syntax Description
3270
(Optional) NULLs are compressed out of the string, as on a 3278-x terminal.
7171
(Optional) NULLs are converted to spaces, as on a 7171 controller.
Default
7171 NULL processing
Command Mode
Global configuration
Usage Guidelines
This command first appeared in Cisco IOS Release 10.3.
If a user enters data, uses an arrow key to move the cursor to the right on the screen, and then enters more data, the intervening spaces are filled with NULLs. To specify how NULLs are handled, enter the command tn3270 null-processing either with the argument 3270, where NULLs are compressed out of the string (as on a real 3278-x terminal) or the argument 7171, where NULLs are converted to spaces as on a 7171 controller. Enter this command in global configuration.
Example
This example shows the two available null processing methods:
router(config)# tn3270 null-processing ?3270 Use 3270-style null processing7171 Use 7171-style null processingtn3270 optimize-cursor-move
To increase performance between a remote user and a TN3270 host by limiting cursor movement information that is sent to user terminals, issue the tn3270 optimize-cursor-move global configuration command. To ensure that all cursor movement information is sent between the user's terminal and the TN3270 host, use the no form of the command.
tn3270 optimize-cursor-move
no tn3270 optimize-cursor-moveSyntax Description
This command has no arguments or keywords.
Default
Cursor movement escape strings are sent to the terminal.
Command Mode
Global configuration
Usage Guidelines
This command first appeared in Cisco IOS Release 11.2.
Issuing this command increases the speed of information transfer between users and TN3270 hosts through an access server.
If you do not issue this command, virtually every byte of information between the user's terminal and the TN3270 host is prepended and trailed by cursor-movement strings.
Example
The following example disables status messages to users who are connected to 3278 terminals:
router(config)# tn3270 optimize-cursor-move
Related Commands
You can use the master indexes or search online to find documentation of related commands.
tn3270 reset-required
To lock a terminal after input error until the user resets the terminal, use the tn3270 reset-required global configuration command. Use the no form of the command to return to the default of no reset required.
tn3270 reset-required
no tn3270 reset-requiredSyntax Description
This command has no arguments or keywords.
Default
No reset is required
Command Mode
Global configuration
Usage Guidelines
This command first appeared in Cisco IOS Release 10.3.
On a 3278-x terminal, the keyboard is locked and further input is not permitted after input error (due to field overflow, invalid entry, and so on), until the user presses the RESET key. Most TN3270 implementations leave the keyboard unlocked and remove any error message on the next key input after the error. Use this command to lock the keyboard until the user performs a reset.
tn3270 status-message
To reenable the display of status messages after they have been disabled, use the tn3270 status-message global configuration command. To save bandwidth on asynchronous lines by not displaying status messages, use the no form of this command.
tn3270 status-message
no tn3270 status-messageSyntax Description
This command has no arguments or keywords.
Default
Status messages appear.
Command Mode
Global configuration
Usage Guidelines
This command first appeared in Cisco IOS Release 11.2.
Status messages appear on the user's console by default. These messages include "System Locked," "Field error," and "System UnLocked" messages, among others. These messages are sent back to the user's terminal via the TTY line on the access server.
Disabling status messages saves bandwidth on asynchronous lines, which have very low bandwidth.
Example
The following example disables status messages to users who are connected to 3270 terminals:
router(config)# no tn3270 status-messageRelated Commands
You can use the master indexes or search online to find documentation of related commands.
tn3270 typeahead
To buffer keyboard data when a 3278 server is in locked mode, use the tn3270 typeahead global configuration command. To disable the typeahead function, use the no form of this command.
tn3270 typeahead
no tn3270 typeaheadSyntax Description
This command has no arguments or keywords.
Default
No typeahead
Command Mode
Global configuration
Usage Guidelines
This command first appeared in Cisco IOS Release 11.2.
When typeahead is enabled, the TN3270 client implementation in the Cisco IOS software permits you (the user) to continue typing while the system is trying to obtain a response from the TN3270 server. Information you type while a "System Locked" message appears on the terminal is stored in a buffer. After the "System Locked" message disappears, the information is then used as though it were just typed.
Example
The following example saves user information when "System Locked" messages appear on the screen:
router(config)# tn3270 typeaheadRelated Commands
You can use the master indexes or search online to find documentation of related commands.
ttycap
To define characteristics of a terminal emulation file, use the ttycap global configuration command. To delete any named ttycap entry from the configuration file, use the no form of this command.
ttycap ttycap-name termcap-entry
no ttycap ttycap-nameSyntax Description
