Chapter Contents |
Previous |
Next |
Command Directory |
Perform Window Management Functions
wi{ndow}
window
SUBCOMMAND
[WINDOW-FIND] [WINDOW-NAME] [SUBCOMMAND-PARAMETERS]
window
command is used to perform a wide variety of window management functions.
Furthermore, it may be issued three ways in line mode and five ways in full-screen
mode:
The window
command is
always issued with a SUBCOMMAND argument, and sometimes with parameters to
the subcommand, SUBCOMMAND-PARAMETERS. The subcommands that are available
to you depend on how you issue the command. window Subcommands lists the subcommands and where they are
valid.
Subcommand | PROFILE |
Configuration
File |
Command
Window |
Line
Mode |
---|---|---|---|---|
autopop |
no | yes | yes | no |
border |
no | yes | yes | no |
clear |
no | no | yes | no |
close |
no | no | yes | no |
color |
no | yes | yes | no |
config |
no | yes | no | no |
context |
no | yes | yes | no |
find |
no | no | yes | no |
memory |
no | yes | no | no |
move |
no | no | yes | no |
next |
no | no | yes | no |
off |
yes | no | yes | no |
on |
no | yes | yes | no |
open |
no | yes | yes | no |
previous |
no | no | yes | no |
resize |
no | no | yes | no |
scroll |
no |
yes (table note 1) |
yes | no |
top |
no | no | yes | no |
trace |
no | yes | yes | no |
zoom |
no | no | yes | no |
TABLE NOTE 1: Format 2 of the scroll subcommand cannot be specified in the configuration file.
Each of these subcommands is described in detail later in this section.
The windows that can be specified with the WINDOW-NAME argument fall into four classes:
In Class 1 these windows are always present:
In Class 2 these windows are under debugger control for error correction or reporting:
In Class 3 you control the presence of these windows; there can be one instance only of each:
In Class 4 you control the presence of these windows; there can be multiple instances of each:
window close dump |
However, the same command would not be ambiguous if only one Dump window was open.
window close < > |
window
subcommands is discussed in detail in the following paragraphs.
autopop
autopop
subcommand is used to select the autopop status for a window. (This can also
be accomplished with the Config window.) Autopop status is either on or off.
If the autopop status is set to on, the window is automatically made the top
window; that is, the window is popped to the top and the cursor is placed
inside the window whenever output is sent to the window, provided the window
is at least partially obscured. If the window is completely unobscured, autopop
does not cause the window to become the top window. If specified for windows
for which there can be multiple instances, the attribute applies to all instances.
The format of the autopop
subcommand is as follows:
autopop WINDOW-NAME on|off |
window autopop dump on |
By default, autopop is off for all windows except the following:
border
border
subcommand is as follows:
border "STRING" |
The six characters used to make up the border are specified
as the STRING argument in the form of a string literal. For example, the following
STRING argument specifies the characters
"++++|-"
:
window border "++++|-" |
clear
clear
subcommand clears the Command, Log, or Termout windows. The format of the clear
subcommand is as follows:
clear WINDOW-NAME |
window clear log |
close
close
subcommand can be used to close any Class 3 or 4 window. This subcommand is
not valid in a configuration file and can only be used during a full-screen
session. The format of the close
subcommand
is as follows:
close WINDOW-NAME |
For example, to close the Register window, you can issue the following command:
window close register |
window close < > |
When you press the ENTER key, the command is issued and the Print window is closed.
color
color
subcommand can also be entered from the Command window or
typed directly into a configuration file. The format of the color
subcommand is as follows:
color WINDOW-NAME C-A-I-TRIPLET C-A-I-TRIPLET . . . |
C-A-I-TRIPLET Arguments by Window shows how many triplets are required for each window and what they are used for.
When
using the color
subcommand, you must provide the number of C-A-I-TRIPLET arguments shown in
the second column of C-A-I-TRIPLET Arguments by Window.
For example, the Keys window requires three C-A-I-TRIPLET arguments to set
the characteristics of the border, key name pad, and key definition text pad
as follows:
window color keys m r l y n l r n l |
config
config
subcommand can also be typed directly into a configuration file. The format
of the config
subcommand is as follows:
config WINDOW-NAME position ROW-POS COL-POS size HEIGHT WIDTH border|noborder |
Window |
Min.
Height |
Def.
Height |
Max.
Height |
Min.
Width |
Def.
Width (table note 1) |
Max.
Width |
Def.
Border |
---|---|---|---|---|---|---|---|
Command | 1 | 1 | 1 | 24 | W | W | no |
Config | 3 | H | 104 | 12 | W | 84 | yes |
Dump | 5 | H/2 | H | 51 | W | W | yes |
Help | 4 | H/2 | H | 20 | W | W | yes |
Keys | 3 | 14 | 27 | 12 | 80 | 94 | yes |
Log | 3 | .45X(th-2) | H | 10 | W | W | yes |
5 | H/2 | H | 49 | W | W | yes | |
Register | 3 | 11 | 11 (table note 2) | 8 | 75 | 75 | yes |
Source | 4 | rest (table note 3) | H | 32 | W | W | yes |
Status | 1 | 1 | 1 | 10 | W | W | no |
Termin | 5 | 5 | 5 (table note 4) | 30 | W | W | yes |
Termout | 5 | H/2 | H | 20 | W | W | yes |
Watch | 5 | H/3 | H | 20 | W | W | yes |
TABLE NOTE 1: If the terminal width is greater than the maximum width, then the default width is the maximum width.
TABLE NOTE 2: This assumes default border.
TABLE NOTE 3: rest = terminal-height - (command-window-height + log-window-height + status-window-height)
TABLE NOTE 4: This assumes default border and scale.
context
context
subcommand
is as follows:
context source N M |
find
window find
subcommand is used to
search for strings and is supported in the following windows:
The
following format is used with the
window find
subcommand:
window
find
WINDOW-NAME
The WINDOW-NAME argument can be any of the following:
If
the
<>
WINDOW-NAME argument is used, the position
of the cursor determines the window to which the command is applied. If a
window name is specified as the window-name
argument, the position of the logical cursor is used to determine the starting
point of the search, if the search is cursor dependent.
intercepts
intercepts
subcommand
is as follows:
intercepts "STRING" |
The STRING argument is eight characters long; each position controls one intercept. intercepts Subcommand STRING Argument lists the meaning of each position and the valid values for each character.
memory
memory
subcommand is as follows:
memory MEMBRW MEMCMD MEMLOG MEMSRC |
The MEMBRW argument specifies the memory allocated to the Browse window, MEMCMD for the Command window, MEMLOG for the Log window, and MEMSRC for the Source window. MEMCMD Argument Values lists the default and minimum memory sizes in bytes for each of these windows (H=terminal height).
Window | Minimum Memory | Default Memory |
---|---|---|
Browse | 255 * H | max (255 * H, 6000) |
Command | 360 | 1000 |
Log | 1000 | 12000 |
Source | 255 * H | max (255 * H, 12000) |
move
move
subcommand
is as follows:
move WINDOW-NAME |
next
next
subcommand moves the top window to
the bottom of the stack. Thus, the next window below the window just moved
becomes the top window. The format of the next
subcommand is as follows:
next |
off
off
subcommand is as
follows:
off |
on
on
subcommand is as
follows:
on |
Only class 1 type windows will reappear.
The on
subcommand has
no effect if you are already in full-screen mode.
Any other command specified on the same line as the window on
command in line mode is
ignored.
open
open
subcommand is as follows:
open WINDOW-NAME |
previous
previous
subcommand positions the bottom
window at the top of the stack and makes it the top window. The format of
the previous
subcommand is as follows:
previous |
resize
resize
subcommand is as follows:
resize WINDOW-NAME |
scroll
scroll
subcommand has two formats:
Format 1: scroll amount
SCROLL-AMOUNT | |
Format 2: scroll WINDOW-NAME
up/down/right/left |
Valid values for the SCROLL-AMOUNT argument are
The following windows may be scrolled left and right:
Format
2 of the scroll
subcommand can also be used to change command scope. By issuing a window scroll < > up
or a window scroll
status up
command, the command scope can be moved up in the
calling sequence. Similarly, the down keyword causes command scope to be moved
down in the calling sequence. See Using the Status Window more information.
The WINDOW-NAME argument can be any of these windows or the < > placeholder.
top
top WINDOW-NAME |
trace
trace
subcommand is as follows:
trace log on|off |
n -
1 hooks at which the debugger does not give you control, in the step n
or continue n
case
on
is executed
provided auto id
is on
monitor
request occurs.
zoom
zoom
subcommand is as follows:
zoom WINDOW-NAME |
Chapter Contents |
Previous |
Next |
Top of Page |
Copyright © 2001 by SAS Institute Inc., Cary, NC, USA. All rights reserved.