Window Directory

Config Window

The following displays show the Config window. After you open the window, use the window scroll < > up (PF19) and window scroll < > down (PF20) commands to display the entire Config window.

Config Window, View 1

[IMAGE]

Config Window, View 2

[IMAGE]

Config Window, View 3

[IMAGE]

Config Window, View 4

[IMAGE]

DESCRIPTION

The Config window customizes the configuration of the windowing interface. You can also use the window command to customize these features; however, the Config window provides a more intuitive and easier method of making configuration changes.

Config Window, View 1 shows the portion of the Config window that is visible when you first open the window. You can perform various functions by using the Config window.

Saving a configuration The top line of the window indicates your current configuration file and can be used to save the configuration. You can type any valid configuration filename following the Config file: prompt and then save the configuration to that file by typing a Y at the Save: prompt.

Changing border characters The Config window contains six fields that are used to select border characters: Top left, Top right, Horz border, Vert border, Bottom left, and Bottom right. These fields are shown with their default characters in Config Window, View 1. You can change any of the border characters by typing in a new character or its hexadecimal value according to the EBCDIC code sequence.

All windows with borders use the same border characters. See Selecting window, size, position, and borders for details.

Setting scroll amount The Scroll amount: field can be used to specify the scroll distance. Valid values for this field are as follows:

cursor

scrolls to the position of the cursor

half

scrolls one half page.

max

scrolls to the maximum amount. (Max is a temporary setting that can be used for the duration of your current session. You cannot specify window scroll amount max in a configuration file.)

page

scrolls one page.

The size of a page is determined by the size of the window that you are scrolling. By default, Scroll amount: is set to cursor.

Setting Source window context The Source window always attempts to keep a number of lines of contextual information to surround the current (highlighted) line in that window. The Config window is used to control the number of contextual lines the debugger attempts to maintain and the number of lines the debugger is allowed to jump without centering the current line in the Source window.

The fields that are used to control Source window context are shown in Config Window, View 1. The Border: field is used to enter the minimum number of lines that you would like to have displayed above and below the current line. If possible, the debugger maintains this minimum amount of contextual information within the Source window.

The Jump: field specifies the number of lines that can be jumped before the current line is centered in the Source window. Centering occurs whenever the next line to be executed is at least the number of lines that are specified away from the current line.

Allocating memory for window buffers The Command, Log, and Source windows each require buffer areas in memory. You specify the amount of memory to be allocated by typing the number of bytes at the Command:, Log:, or Source: prompts as shown in Config Window, View 1. Default and minimum allocation sizes are provided in MEMCMD Argument Values.

Selecting Log window trace line As shown in the Log Window Trace On: field of Config Window, View 1, trace lines are not displayed in the Log window by default. However, typing a Y in this field selects trace lines. If they are active, trace lines are displayed in the following cases:

each time the debugger gives you control
at the n - 1 hooks at which the debugger does not give you control, and in the step n or continue n case
when an on command is executed, provided that auto id is active
when a monitor request occurs.

Selecting window size, position, and borders The Window configuration and autopop status: fields, shown in Config Window, View 1, are used to select window size, position, and borders for each of the 15 windows. Each window has the following fields:

Window name: identifies the window.
Row: controls the starting row from the top of the window. Rows start with 0 and are numbered from the top to the bottom of the display.
Col: controls the starting column from the left side of the window. Columns start with 0 and are numbered from the left to right sides of the display.
Height: controls window height.
Width: controls window width.
Border: determines whether the window is displayed with or without a border.
Autopop: selects autopop status. If the status is set to Y, the window automatically becomes the top window whenever output is sent to the window and it is at least partially obscured by another window.

Changing window size, position, or border settings during a session has different effects depending on the type of window that is changed. The Dump and Print windows (class 4 windows, as described in window) that are already opened are not changed; however, any new appearances of these windows reflect the new settings.

All of the other windows (window classes 1 through 3 that are described in window) are automatically closed and reopened whenever window size, position, or border settings are changed. If a window is zoomed, it is zoomed when it is reopened.

Displaying borders requires additional display overhead on the part of the debugger and could result in exceeding the display limitations. These limitations are described in Number of Open Windows. If you add borders to the following (class 2 and 3) windows and the display limitations are exceeded, then the reopen will fail:

Config
Help
Keys
Message
Popup
Register
Termin
Watch

The following (class 1) windows are always reopened, even if the display limitations are exceeded:

Command
Log
Source
Status

However, if the display limitations are exceeded, these class 1 windows are opened without borders.

You should not use the configuration settings to temporarily move or resize a window. It is more effective to use the PF2 and PF14 keys, which have been assigned to the window move < > and window resize < > commands respectively. Using the Config window can result in moving the information in the window, or in placing the moved or resized window on top of the Config window.

Selecting window color, attribute, and intensity Each of the 15 windows comprises a number of areas with display characteristics that can be controlled by the Config window. The number of areas varies from one to five depending on the window. Config Window, View 1 through Config Window, View 4 show the areas that can be controlled for each of the 15 windows.

For each window area, you can set the following window coloring characteristics:

Color: selects area color.
Attribute: selects the display attribute for the area.
Intensity: selects either high or low intensity.

Each of these selections is limited by the capabilities of your terminal. When a selection is made, the characteristic is displayed in the area field of the Config window, enabling you to easily review the display characteristics of the entire window while the Config window is displayed.

ADDITIONAL DISCUSSION

Changing the Window Configuration

Chapter Contents
Previous
Next
Top of Page