Use this record-level keyword to specify that the record format you are defining will be displayed using a window. A window is information that overlays part of the display. A window is usually smaller than the actual work station display, and can be positioned anywhere on the display.
The WINDOW keyword has two formats that can be used. These formats do the following:
The format for the keyword is one of the following:
WINDOW(start-line | &start-line-field start-position | &start-position-field window-lines window-positions [*MSGLIN | *NOMSGLIN]) [*RSTCSR | *NORSTCSR]) or WINDOW(*DFT window-lines window-position [*MSGLIN | *NOMSGLIN] [*RSTCSR | *NORSTCSR])
Specify this format of the WINDOW keyword to define a window. The record format you are defining is displayed in this window. Up to 12 windows can be shown on the display at one time. You can define more than 12 windows in DDS, but only 12 can be displayed at the same time. However, if USRRSTDSP is specified, the number of windows is unlimited. All fields defined in this record must fit within the window.
The parameters specify:
The last window-line in a window is used as the message line and cannot contain any fields. For example, if a WINDOW keyword is coded that specifies 10 window-lines for the window, only 9 of those lines can contain fields; the 10th line is the message line.
The special value, *DFT, specified in place of the start-line and start-position parameters, indicates that the system will determine the start line and start position of the window. The window is positioned relative to the cursor location, similar to application help windows with variable starting locations. More information on the rules the system uses to position the window can be found in the Application Display Programming book.
The second format for the WINDOW keyword is:
WINDOW(record-format-name)
Specify this format of the WINDOW keyword to display the record format you are defining in a window that is defined on another record format.
The parameter specifies the record format name that has the window attributes specified. The record format that uses this parameter is displayed in the window defined on the referenced record.
The field locations specified within a record format with the WINDOW keyword are relative to the first usable window location in the upper-left corner of the window. The first usable window location is on the first line below the upper border and two positions to the right of the left border (an ending attribute byte occupies the first byte to the right of the border).
When a window is displayed, any records currently on the display are suspended if USRRSTDSP is not specified. The suspended records may be visible around the sides of the window. Input is allowed only within the active window. To remove the window from the display, a record can be written to an underlying window or a non-window record must be overlaid on the display.
The WINDOW keyword is not allowed on a record format that has any one of
the following keywords specified:
ALWROL ASSUME MNUBAR |
PULLDOWN SFL USRDFN |
WINDOW cannot be specified for the record format specified by the PASSRCD keyword.
The ERRSFL keyword is ignored for records that have the WINDOW keyword specified.
The MSGLOC keyword is ignored for records that have the WINDOW keyword specified, unless NOMSGLIN is specified.
If a record format has both a WINDOW and WDWBORDER keyword specified, specify the start-line, start-position, window-lines, and window-positions parameters on the WINDOW keyword. The WINDOW keyword should not specify the record-format-name parameter.
Option indicators are not valid for this keyword. However, display size condition names can be used.
(C) Copyright IBM Corporation 1992, 2006. All Rights Reserved.