|
|
This chapter describes the function and displays the syntax for commands used to configure support for asynchronous character stream calls running the protocols Telnet, rlogin, LAT, XRemote, and TN3270. For more information about defaults and usage guidelines, see the corresponding chapter of the Dial Solutions Command Reference.
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}
access-list-number | Specifies an integer between 1 and 199 that defines the access list. |
in | Controls which nodes can make LAT connections into the server. |
out | Defines the access checks made on outgoing connections. (A user who types a node name at the system prompt to initiate a LAT connection is making an outgoing connection.) |
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
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. |
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
number | An entry number obtained from the show entry EXEC command. |
To log on to a host that supports Telnet, rlogin, or LAT, use the connect EXEC command.
connect host [port] [keyword]
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 | (Optional) One of the options. |
To disconnect a line, use the disconnect EXEC command.
disconnect [connection]
connection | (Optional) Number of the line or name of the active network connection to be disconnected. |
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
ip-address | Specifies the IP address for the service. |
tcp-port | Specifies the number of the TCP port. |
To enable a faster response to user interrupt characters, use the ip tcp chunk-size global configuration command.
ip tcp chunk-size number
number | The number of characters output before the interrupt executes. The suggested value is 80, which will typically abort output within a line or two of where the user types the interrupt character. For efficiency reasons, values of less than 50 are not recommended. |
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
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. |
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
keymap-name | Name of a keymap defined within the configuration file of the router. The TN3270 terminal-type negotiations use the specified keymap type when setting up a connection with the remote host. |
To connect to a LAT host, use the lat EXEC command.
lat name [node nodename | port portname | /debug]
name | LAT-learned service name. |
node nodename | (Optional) Specifies a connection to a particular LAT node that offers a service. If you do not include the node name option, the node with the highest rating offering the service is used. Use the show lat nodes EXEC command to display information about all known LAT nodes. |
port portname | (Optional) Specifies a destination LAT port name. This keyword is ignored in most time-sharing systems, but is used by routers and network access servers offering reverse LAT services. Reverse LAT involves connecting to one router from another, so that the target router runs the host portion of the protocol. Enter the port name in the format of the remote system as the portname argument. |
/debug | (Optional) Enables a switch to display parameter changes and other special messages. |
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
number | Specifies a number between 1 and 199 assigned to the line using the access-class line configuration command. |
permit | Allows any matching node name to access the line. |
deny | Denies access to any matching node name. |
nodename | Specifies the name of the LAT node, with or without regular expression pattern matching characters, with which to compare for access. The UNIX-style regular expression characters allow for pattern matching of characters and character strings in the node name. |
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]
groupname | Specifies a group code name. |
number | Specifies a group code number. You can enter both a group code name and group code numbers. |
range | Specifies a hyphenated range of numbers. |
all | Specifies the range from 0 to 255. |
enabled | (Optional) Allows incremental changes to the list; that is, you can add a group code without retyping the entire command. |
disabled | (Optional) Allows selective removal of a group code from the list. |
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
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. |
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
number | The delay in milliseconds. |
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
seconds | The timer rate in seconds. |
To change the LAT node name without changing the system host name, use the lat node global configuration command.
lat node node-name
node-name | Name of the LAT node. |
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 command to return to the default value.
lat out-group {groupname number range | all}
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. |
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-modificationTo 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
number | Number of retries; any number between 4 and 255. |
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
receive-buffers | Integer that specifies the number of receive buffers that will be negotiated. The argument can be any number between 1 and 128. |
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-announcementsTo 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
service-name | Name of the service. |
command | Command to be associated with the service. |
service-name | Name of the service. |
groupname | Specifies a group code name. |
number | Specifies a group code number. |
range | Specifies a hyphenated range of numbers between 0 and 255. |
all | Specifies the range from 0 to 255. |
enabled | (Optional) Allows incremental changes to the list; that is, you can add a group code without retyping the entire command. |
disabled | (Optional) Allows selective removal of a group code from the list. |
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
service-name | Name of the service. |
identification | Descriptive name (text only) that identifies the service. |
service-name | Name of the service. |
password | Password used to gain access to the service. |
service-name | Name of the service. |
static-rating | Static service rating. The rating must be in the range of 1 to 255. |
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
service-name | Name of the service. |
group | Rotary group number. |
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. |
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
number | Specifies the number of sessions that will be multiplexed onto a single LAT virtual circuit. This number cannot be greater than 255. |
milliseconds | Timer value. Specifies the amount of time LAT will wait before sending traffic. Acceptable values are between 10 and 1000 milliseconds. |
To log in to a UNIX host using rlogin, use the rlogin EXEC command:
rlogin host [-l username] [/user username] [debug]
host | Specifies the host name or IP address. |
-l username | (Optional) The BSD UNIX syntax which specifies a user name for the remote login. If you do not use this option, the remote user name is your local user name. |
/user username | (Optional) The EXEC command syntax which specifies a remote user name in the initial exchange with the remote host. The rlogin protocol will not present you with the |
debug | (Optional) Enables debugging output from the rlogin protocol. |
To set up a temporary password on a line, use the lock EXEC command.
lockTo change a login username, use the login EXEC command.
loginTo 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]
local | (Optional) Selects local password checking. Authentication is based on the username specified with the username global configuration command. |
tacacs | (Optional) Selects the TACACS-style user ID and password-checking mechanism. |
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] dTo 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.
notifyTo switch to another open Telnet, rlogin, LAT, or PAD session, use the resume EXEC command.
resume [connection] [keyword] [/set parameter:value]
connection | (Optional) The name or number of the connection; the default is the most recent connection. |
keyword | (Optional) One of the options. |
/set parameter:value | (Optional) Sets PAD parameters for the Cisco IOS software. |
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]
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. |
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 localTo 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 entryUse 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]
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. |
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 advertisedTo 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 groupsTo display information about all known LAT nodes, use the show lat nodes EXEC command.
show lat nodesTo display information about learned LAT services in the Cisco IOS software, use the show lat services user EXEC command.
show lat services [service-name]
service-name | (Optional) Name of a specific LAT service. |
To display active LAT sessions, use the show lat sessions user EXEC command.
show lat sessions [line-number]
line-number | (Optional) Shows an active LAT session on a specific line. |
Use the show lat traffic EXEC command to display information about traffic and resource utilization statistics on all active lines.
show lat trafficTo 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]
all | (Optional) Specifies all nodes. |
node-name | (Optional) Indicates the name of the node for which status is required. |
counters | (Optional) Specifies the various node counters. |
status | (Optional) Specifies detailed node status. This is the default if a node name is specified. |
summary | (Optional) Specifies a status summary for the node. This is the default if no node name is specified. |
Use the show service EXEC command to display specific LAT learned services.
show service [service-name]
service-name | (Optional) The name of a specific LAT service. |
To display information about open LAT, Telnet, or rlogin connections, use the show sessions user EXEC command.
show sessionsTo display the status of a TCP connection, use the show tcp user EXEC command.
show tcp [line-number]
line-number | (Optional) Displays (in octal) the status of the TCP connections for a particular line. |
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]
all | (Optional) Shows the status for all end points. Endpoints in the LISTEN state are usually not shown. |
To determine ASCII-hexadecimal character mappings, use the show tn3270 ascii-hexval EXEC command.
show tn3270 ascii-hexvalTo display character mappings between ASCII and EBCDIC, use the show tn3270 character-map EXEC command.
show tn3270 character-map {all | ebcdic-in-hex}
all | Displays all nonstandard character mappings. |
ebcdic-in-hex | Displays the ASCII mapping for a specific EBCDIC character. |
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]
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. |
To display XRemote connections and monitor XRemote traffic through the router, use the show xremote EXEC command.
show xremoteTo list XRemote connections and monitor XRemote traffic, use the show xremote line EXEC command.
show xremote line number
number | A decimal value representing the number of virtual terminal lines about which to display information. |
To log on to a host that supports Telnet, use the telnet EXEC command.
telnet host [port] [keyword]
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 | (Optional) One of the options. |
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-ipTo 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-negotiationsTo 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
default-speed | Line speed (in bps) that the Cisco IOS software will use if the device on the other end of the connection has not specified a speed. |
maximum-speed | Maximum speed (in bps) that the device on the port will use. |
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-breakTo 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 transparentTo temporarily define the list of services to which you or another user can connect, use the terminal lat EXEC command.
terminal lat remote-modification
remote-modification | Sets the line to be remotely modifiable. |
out-group | Defines a group list for outgoing user-initiated connections. |
group-number | Number of the group that has access to the system through the specified line. This number is identified by the system administrator. |
start-end | (Optional) Specifies the beginning and end of a range of group numbers. Use the hyphen to separate the two numbers. |
disabled | Incrementally removes specified groups from list. |
enabled | Incrementally adds specified groups to list. |
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}
all | Specifies all recognized protocols. |
lat | Specifies the LAT protocol. |
mop | Specifies the Maintenance Operation Protocol (MOP). |
nasi | Specifies the NetWare Asynchronous Services Interface (NASI) protocol. |
none | Prevents any protocol selection on the line. The router default is that any unrecognized command is a host name. If the preferred protocol is set to none, the router will not attempt any connections if the command is not recognized. |
pad | Specifies X.3 PAD, which is used most often to connect a server product to X.25 hosts. |
rlogin | Specifies UNIX rlogin. |
telnet | Specifies the TCP/IP Telnet protocol. |
To begin a TN3270 session, use the tn3270 EXEC command.
tn3270 host
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. |
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 displayTo 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
ebcdic-in-hex | Hexadecimal value of an EBCDIC character. |
ascii-in-hex | Hexadecimal value of an ASCII character. |
all | Indicates all character mappings. |
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}
extended | Extended datastream. |
normal | Normal datastream. |
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]
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. |
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-moveTo 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-requiredTo 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-messageTo 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 typeaheadTo 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
ttycap-name | Name of a file. It can be up to 32 characters long and must be unique. |
termcap-entry | Commands that define the ttycap. |
To set up a network layer connection to a router, use the tunnel user EXEC command.
tunnel host
host | Name or IP address of a specific host on a network that can be reached by the router. |
To list the open sessions, use the where EXEC command.
whereTo prepare the router for manual startup and initiate an XRemote connection, use the xremote EXEC command. This command begins the instructions that prompt you through the connection.
xremoteTo initiate a DECwindow session over a LAT connection, use the xremote lat EXEC command.
xremote lat service
service | Name of the desired LAT service. |
To change the buffer size used for loading font files, use the xremote tftp buffersize global configuration command. To restore the buffer size to the default value, use the no form of this command.
xremote tftp buffersize buffersize
buffersize | (Optional) Buffer size in bytes. This is a decimal number in the range from 4096 to 70000 bytes. The default is 70000. |
To add a specific TFTP font server as a source of fonts for the terminal, use the xremote tftp host global configuration command. To remove a font server from the list, use the no form of this command.
xremote tftp host hostname
hostname | IP address or name of the host containing fonts. |
To specify the number of retries the font loader will attempt before declaring an error condition, use the xremote tftp retries global configuration command. To restore the default retries number, use the no form of this command.
xremote tftp retries retries
retries | (Optional) Number of retries. Acceptable values are decimal numbers in the range from 1 to 15. |
To activate automatic session startup for an XRemote connection, use the xremote xdm EXEC command.
xremote xdm [hostname]
hostname | (Optional) Host computer name or IP address. |
Posted: Mon Feb 8 14:20:55 PST 1999
Copyright 1989-1999©Cisco Systems Inc.