[ Contents] [ Prev] [ Next] [ Index] [ Report an Error]

Configuring the CLI Environment

You can configure the CLI environment for your current login session. Your settings are not retained when you exit the CLI.

To display the current CLI settings, enter the show cli command:

user@host> show cli

CLI complete-on-space set to on CLI idle-timeout disabled CLI restart-on-upgrade set to on CLI screen-length set to 49 CLI screen-width set to 132 CLI terminal is 'vt100' CLI is operating in enhanced mode CLI working directory is '/cf/var/home/remote'

To change the CLI environment, use the set cli operational mode command:

user@host> set cli ?

Possible completions:   complete-on-space    Set whether typing space completes current word   directory            Set working directory   idle-timeout         Set maximum idle time before login session ends   prompt               Set CLI command prompt string   restart-on-upgrade   Set whether CLI prompts to restart after software upgrade   screen-length        Set number of lines on screen   screen-width         Set number of characters on a line   terminal             Set terminal type

Table 28 shows how you can change the CLI environment features.

Table 28: Configuring the CLI Environment

Environment Feature	CLI Command	Default Setting	Options
Command completion	set cli complete-on-space (on \| off)	on—Pressing Tab or Spacebar completes a command.	Set off to allow only Tab for command completion. Set on to re-enable Tab and Spacebar for command completion.
Your working directory	set cli directory path8	/cf/var/home/remote	Replace path with the directory you want to enter when you log in to the device.
Minutes of idle time	set cli idle-time minutes	Your session never times out unless your login class specifies a timeout.	To enable the timeout feature, replace timeout with a value between 1 and 100,000. To disable the timeout feature, replace timeout with 0.
Your session prompt	set cli prompt string	user@host>	Replace string with the prompt you want. If the prompt contains spaces or special characters, enclose string in quotation marks (“ “).
Restart-after-upgrade prompt	set cli restart-on-upgrade (on \| off)	CLI prompts you to restart the device after a software upgrade.	Set off to disable the prompt for the session. Set on to reenable the prompt.
Number of CLI output line displayed at once	set cli screen-length length	Variable (depends on terminal type).	To change the number of lines displayed on the screen, replace length with a value between 1 and 100,000. To disable the display of a set number of lines, replace length with 0. (This feature can be useful when you are issuing CLI commands from scripts.)
Number of CLI characters displayed on a line	set cli screen-width width	Variable (depends on terminal type).	To change the number of characters displayed on a line, replace width with a value between 0 and 100,000.
Your terminal type.	set cli terminal terminal-type	unknown, or set by console.	Replace terminal-type with one of the following values: ansi vt100 small-xterm xterm

[ Contents] [ Prev] [ Next] [ Index] [ Report an Error]