Line Configuration and Terminal Setting Commands

This chapter describes the function and displays the syntax of each terminal line and modem support command. For more information about defaults and usage guidelines, see the corresponding chapter of the Router Products Command Reference publication.

To set the interval for closing the connection, use the absolute-timeout line configuration command. Use the no form of this command to restore the default.

To set the activation character, use the activation-character line configuration command. This command defines the character you type at a vacant terminal to begin a terminal session. Use the no form of this command to make any character activate a terminal.

To set the line for automatic baud detection, use the autobaud line configuration command. Use the no form of this command to restore the default.

To configure the router to automatically execute a command or list of commands automatically when a user connects to a particular line, use the autocommand line configuration command.

To configure automatic line disconnect, use the autohangup line configuration command. The command causes the EXEC to issue the exit command when the last connection closes.

To configure a line to start an ARA, Point-to-Point (PPP), or SLIP session, use the autoselect line configuration command. Use the no form of this command to disable this function on a line.

arap	Configures the router to allow an ARA session to start up automatically.
ppp	Configures the router to allow a PPP session to start up automatically.
slip	Configures the router to allow a SLIP session to start up automatically.
during-login	(Optional) The user receives a username and/or password prompt without pressing the Return key. After the user logs in, the autoselect function begins.

To display a message on terminals with an interactive EXEC, use the banner exec global configuration command. This command specifies a message to be displayed when an EXEC process is created (line activated, or incoming connection to VTY).

d	Delimiting character of your choice—a pound sign (#), for example. You cannot use the delimiting character in the banner message.
message	Message text.

To specify a message used when you have an incoming connection to a line from a host on the network, use the banner incoming global configuration command. An incoming connection is one initiated from the network side of the router. To suppress the EXEC banner on certain lines, use the no exec-banner line configuration command. This line should not display the EXEC or MOTD banners when an EXEC is created.

d	Delimiting character of your choice—a pound sign (#), for example. You cannot use the delimiting character in the banner message.
message	0000000000

To specify a message-of-the-day (MOTD) banner, use the banner motd global configuration command.

d	Delimiting character of your choice—a pound sign (#), for example. You cannot use the delimiting character in the banner message.
message	Message text.

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.

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 set the number of data bits per character that are interpreted and generated by hardware, use the databits line configuration command.

5	Five data bits per character.
6	Six data bits per character.
7	Seven data bits per character.
8	Eight data bits per character.

To set the number of data bits per character that are interpreted and generated by software, use the data-character-bits line configuration command.

7	Seven data bits per character.
8	Eight data bits per character.

To define the EXEC character width for either 7 bits or 8 bits, use the default-value exec-character-bits global configuration command.

7	Selects the 7-bit ASCII character set.
8	Selects the full 8-bit ASCII character set.

To configure the flow control default value from a 7-bit width to an 8-bit width, use the default-value special-character-bits global configuration command.

7	Selects the 7-bit character set.
8	Selects the full 8-bit character set.

To define a character to disconnect a session, use the disconnect-character line configuration command. This command defines the character you enter to end a terminal session. Use the no form of this command to remove the disconnect character.

To define a character that causes a packet to be sent, use the dispatch-character line configuration command. Use the no form of this command to remove the definition of the specified dispatch character.

To set the character dispatch timer, use the dispatch-timeout line configuration command. Use the no form of this command to remove the timeout definition.

milliseconds

Integer that specifies the number of milliseconds the router waits after putting the first character into a packet buffer before sending the packet. During this interval, more characters may be added to the packet, which increases the processing efficiency of the remote host.

To define a system escape character, use the escape-character line configuration command. The no form of this command sets the escape character to Break.

To allow an EXEC process on a line, use the exec line configuration command. The no form of this command turns off the EXEC process for the line specified.

To control whether banners are displayed or suppressed, use the exec-banner line configuration command. This command determines whether the router will display the EXEC banner or the message-of-the-day (MOTD) banner when an EXEC is created. The no form of this command suppresses the banner messages.

To configure the character widths of EXEC and configuration command characters, use the exec-character-bits line configuration command.

7	Selects the 7-bit character set.
8	Selects the full 8-bit character set for use of international and graphical characters in banner messages, prompts, and so forth.

To set the interval that the EXEC command interpreter waits until user input is detected, use the exec-timeout line configuration command. The no form of this command removes the timeout definition. It has the same effect as exec-timeout 0.

minutes	Integer that specifies the number of minutes.
seconds	(Optional) Additional time intervals in seconds. An interval of zero specifies no time-outs.

To set the method of data flow control between the terminal or other serial device and the router, use the flowcontrol line configuration command. To disable flow control, use the no form of this command.

none	Turns off flow control.
software	Sets software flow control. An optional keyword specifies the direction: in causes the router to listen to flow control from the attached device, and out causes the router to send flow control information to the attached device. If you do not specify a direction, both are assumed.
hardware	Sets hardware flow control. An optional keyword specifies the direction: in causes the router to listen to flow control from the attached device, and out causes the router to send flow control information to the attached device. If you do not specify a direction, both are assumed. For more information about hardware flow control, see the hardware installation and maintenance manual for your router.

To define the local hold character used to pause output to the terminal screen, use the hold-character line configuration command. The no form of this command restores the default.

To set the terminal screen length, use the length line configuration command.

To configure a console port line, auxiliary port line, or virtual terminal lines, use the line global configuration command.

aux	(Optional) Enables the auxiliary RS-232 DTE port. Must be addressed as relative line 0. The auxiliary port can be used for modem support and asynchronous connections.
console	(Optional) Specifies the console terminal line. The console port is DCE.
vty	(Optional) Specifies a virtual terminal for remote console access.
line-number	Specifies the relative number of the terminal line (or the first line in a contiguous group) you want to configure when the line type is specified. Numbering begins with zero.
ending-line-number	(Optional) Specifies the relative number of the last line in a contiguous group you want to configure. If you omit the keyword, then line-number and ending-line-number are absolute rather than relative line numbers.

To record the location of a serial device, use the location line configuration command. The no form of this command removes the description.

To enable the EXEC command lock, use the lockable global configuration command. The no form of this command reinstates the default, which does not allow the terminal to be locked.

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.

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 enable AAA/TACACS+ authentication for logins, use the login authentication line configuration command. Use the no form of the command to return to the default.

default	Uses the default list created with the aaa authentication login command.
list-name	Uses the indicated list created with the aaa authentication login command.

To define a string of characters that the router sends to a host after a successful Telnet connection, use the login-string global configuration command. This command applies only to rlogin and Telnet sessions. The no form of this command removes the login string.

hostname	Specifies the name of the host.
d	Sets a delimiting character of your choice—a pound sign (#) for example. You cannot use the delimiting character in the busy message.
message	Specifies the login string.
%secp	(Optional) Sets a pause in seconds. To insert pauses into the login string, embed a percent sign (%) followed by the number of seconds to pause and the letter "p."
%secw	(Optional) Prevents users from issuing commands or keystrokes during a pause.
%b	(Optional) Sends a Break character.

To set the amount of time that the router waits for CTS after raising DTR in response to RING, use the modem answer-timeout line configuration command. The no form of this command reverts the router to the default value.

To support dial-in modems that use DTR to control the off-hook status of the modem, use the modem callin line configuration command. In response to RING, the modem raises the DTR signal, which answers the modem. At the end of the session, the router lowers DTR, which disconnects the modem. The no form of this command disables this feature.

To configure a line for reverse connections, use the modem callout line configuration command. The no form of this command disables this feature.

To configure a line to require a Clear To Send (CTS) signal, use the modem cts-required line configuration command. Use the no form of this command to disable this feature.

To configure a line to leave DTR low unless the line has an active incoming connection or an EXEC process, use the modem dtr-active line configuration command. The no form of this command disables this feature.

To configure a line for both incoming and outgoing calls, use the modem in-out line configuration command. The no form of this command disables this feature.

To configure a line for a high-speed modem, use the modem ri-is-cd line configuration command. The no form of this command disables this feature.

To enable terminal notification about pending output from other connections, use the notify line configuration command. The no form of this command ends notification.

To set the padding on a specific output character, use the padding line configuration command. To remove padding for the specified output character, use the no padding line configuration command

ascii-number	ASCII decimal representation of the character.
count	Number of NULL bytes sent after that character; the maximum is 255.

To define generation of a parity bit, use the parity line configuration command.

none	No parity.
even	Even parity.
odd	Odd parity.
space	Space parity.
mark	Mark parity.

To specify a password on a line, use the password line configuration command. Use the no form of this command to remove the password.

password

Case-sensitive character string that specifies the line password. The string can contain any alphanumeric characters, including spaces, up to 80 characters, except that the first character cannot be a number. You cannot specify the password in the format number-space-anything because the space after the number causes problems. For example, "hello 21" is a legal password, but "21 hello" is not.

To save user EXEC command changes between terminal sessions, use the private line configuration command. Use the no form of this command to restore the default condition.

To define a line-in-use message, use the refuse-message line configuration command. Use the no form of the command to disable the message.

d	Delimiting character of your choice—a pound sign (#), for example. You cannot use the delimiting character in the message.
message	Message text.

To define a group of lines consisting of one or more virtual terminal lines or one auxiliary port line, use the rotary line configuration command. Use the no form of this command to remove a line or group of lines from a rotary group.

To set the terminal baud rate receive (from terminal) speed, use the rxspeed line configuration command.

bps

Baud rate in bits per second (bps); see the line speeds table in the terminal lines chapter of the Router Products Command Reference publication for settings.

To specify that a chat script start on a line any time the line is activated, use the script activation line configuration command. The no form of this command disables this feature.

regexp

Regular expression that specifies the set of modem scripts that might be executed. The first script name that matches the argument regexp will be used.

To specify that a chat script start on a line any time a remote network connection is made to a line, use the script connection line configuration command. The no form of this command disables this feature.

To specify that a chat script start on a line any time the specified line is reset, use the script reset line configuration command. The no form of this command disables this feature.

To specify that a chat script start on a line any time the router is powered up, use the script startup line configuration command. The no form of this command disables this feature.

To configure the router to display line number information after the EXEC or incoming banner, use the service linenumber global configuration command. To disable this function, use the no form of this command.

To set the maximum number of terminal sessions per line, use the session-limit line configuration command. The no form of this command removes any specified session limit.

To set the interval for closing the connection when there is no input or output traffic, use the session-timeout line configuration command. The no form of this command removes the timeout definition.

minutes	Specifies the time interval in minutes.
output	(Optional) Specifies that when traffic is sent to an asynchronous line from the router (within the specified interval), the connection is retained.

To configure the number of data bits per character for special characters such as software flow control characters and escape characters, use the special-character-bits line configuration command.

7	Selects the 7-bit ASCII character set.
8	Selects the full 8-bit character set for special characters.

To set the terminal baud rate, use the speed line configuration command. The command sets both the transmit (to terminal) and receive (from terminal) speeds.

bps

Baud rate in bits per second (bps); see the lines speeds table in the terminal lines chapter of the Router Products Command Reference publication for settings.

To define the character that signals the start of data transmission when software flow control is in effect, use the start-character line configuration command. The no form of this command removes the character.

To manually start a chat script, use the start-chat privileged EXEC command. The no form of the command stops the chat script.

regexp	Specifies the name of a regular expression or modem script to be executed. If there is more than one script with a name that matches the argument regexp, the first script found will be used.
aux 0	(Optional) Indicates the line number on which to execute the chat script. If you do not specify a line number, the current line number is chosen. If the specified line is busy, the script is not executed and an error message appears. If the dialer-string argument is specified, the line number (aux 0) must be entered; it is not optional if you specify a dialer string. This command functions only on physical terminal (tty) lines. It does not function on virtual terminal (vty) lines.
dialer-string	String of characters (often a telephone number) to be sent to a DCE. If you enter a dialer string, you must also specify the line number (aux 0), or the chat script regexp will not start.

To set the number of the stop bits transmitted per byte, use the stopbits line configuration command.

1	One stop bit.
1.5	One and one-half stop bits.
2	Two stop bits.

To set the flow control stop character, use the stop-character line configuration command. The no form of this command removes the character.

To configure the router to generate a hardware Break signal upon receiving an Interrupt Process (IP) command, use the telnet break-on-ip line configuration command.

To configure a line using Telnet to refuse to negotiate full-duplex, remote echo options on incoming connections, use the telnet refuse-negotiations line configuration command.

To allow the router to negotiate transmission speed of the line to a connected device, use the telnet speed line configuration command.

default-speed	Line speed (in bps) that the router 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 router 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.

To configure the router 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.

Use the terminal-type line configuration command to specify the type of terminal connected to a line. Use the no form of this command to remove any information about the type of terminal and reset the line to the default terminal emulation.

To allow the system administrator to define which protocols to use to connect to a specific line of the router, use the transport input line configuration command.

mop	Selects the MOP protocol.
telnet	Specifies all types of incoming TCP/IP connections.
none	Prevents any protocol selection on the line. This makes the port unusable by incoming connections.

To determine the protocols that can be used for outgoing connections from a line, use the transport output line configuration command.

telnet	Selects the TCP/IP Telnet protocol. It allows a user at one site to establish a TCP connection to a login server at another site.
none	Prevents any protocol selection on the line. The system normally assumes that any unrecognized command is a host name. If the protocol is set to none, the system no longer makes that assumption. No connection will be attempted if the command is not recognized.

To specify the transport protocol the router uses if the user does not specify one when initiating a connection, use the transport preferred line configuration command.

telnet	Selects the TCP/IP Telnet protocol. It allows a user at one site to establish a TCP connection to a login server at another site.
none	Prevents any protocol selection on the line. The system normally assumes that any unrecognized command is a host name. If the protocol is set to none, the system no longer makes that assumption. No connection will be attempted if the command is not recognized.

To set the terminal transmit baud rate (to terminal), use the txspeed line configuration command.

bps

Baud rate in bits per second (bps); see the line speeds table in the terminal lines chapter of the Router Products Command Reference publication for settings.

To display an idle terminal message, use the vacant-message line configuration command. The command enables the banner to be displayed on the screen of an idle terminal. The vacant-message command without any arguments restores the default message. The no form of this command removes the default vacant message or any other vacant message that might have been set.

d	(Optional) A delimiting character of your choice—a pound sign (#), for example. You cannot use the delimiting character in the banner message.
message	(Optional) Vacant terminal message.

To set the terminal screen width, use the width line configuration command. This command sets the number of character columns displayed on the attached terminal.

Table of Contents

Line Configuration and Terminal Setting Commands