screen-length

Use screen-length to set the maximum number of lines to be displayed on a screen.

Use undo screen-length to restore the default.

Syntax

screen-length screen-length

undo screen-length

Default

Up to 24 lines are displayed on a screen.

Views

User line view, user line class view

Predefined user roles

network-admin

mdc-admin

Parameters

screen-length: Specifies the maximum number of lines to be displayed on a screen, in the range of 0 to 512. Setting this argument to 0 disables pausing between screens of output.

Usage guidelines

This command sets the maximum number of lines that can be displayed on one screen when the screen pause feature is enabled. If the screen pause feature is disabled, the system displays command output without any pause.

The actual number of lines that can be displayed on a screen is restricted by the display specification of the configuration terminal. For example, if you set the maximum number of lines for a screen to 40 when the display specification is 24 lines, the device sends 40 lines to the screen at a time, but only the last 24 lines are displayed on the screen. To view the previous 16 lines, you must press PgUp.

The screen pause feature is enabled by default. To disable this feature, use the screen-length 0 or screen-length disable command. The screen-length disable command is available in user view.

This command is available in both user line view and user line class view:

• If the setting in user line view is not the default setting, the setting in user line view takes effect.

• If the setting in user line view is the default setting but the setting in user line class view is not, the setting in user line class view takes effect.

Examples

# Set the maximum number of lines to be displayed on a screen to 30 for user line AUX 0.

<Sysname> system-view
[Sysname] line aux 0
[Sysname-line-aux0] screen-length 30

Related commands

screen-length disable