Pathway/iTS SCREEN COBOL Reference Manual (H06.10+, J06.03+)
Procedure Division
HP NonStop Pathway/iTS SCREEN COBOL Reference Manual—426750-003
6-62
DISPLAY OVERLAY Statement
DISPLAY OVERLAY Statement
The DISPLAY OVERLAY statement formats the specified overlay screen from the
screen definition in the Screen Section and associates the overlay screen with the
overlay area in the current base screen. The statement also selects the overlay screen
description for subsequent operations, but does not display the screen.
The DISPLAY OVERLAY DYNAMIC statement performs the same function as the two-
statement sequence DISPLAY OVERLAY and DISPLAY. (DISPLAY follows DISPLAY
BASE.)
The DISPLAY OVERLAY statement operates differently for terminals in block mode
from terminals in conversational mode. It cannot be used for communication with
intelligent devices.
For terminals in block mode, DISPLAY OVERLAY formats data for screen literals,
VALUE clauses, null characters, and fill characters, and establishes attributes for
screen fields. The overlay screen replaces any previous screen in the overlay area.
DISPLAY OVERLAY does not transmit current values from Working-Storage items to
output fields of the screen; DISPLAY transmits these values.
For terminals in both block and conversational mode, DISPLAY OVERLAY establishes
the current overlay screen and must run before other screen operations using the
overlay screen.
DYNAMIC
specifies that nonliteral screen fields can acquire their initial contents from their
FROM or USING Working-Storage data item. A subsequent DISPLAY statement is
not needed to display the initial Working-Storage values.
In addition, the DYNAMIC modifier provides the capability of changing the screen
field attribute settings at run-time using the contents of individual attribute elements
in an associated control structure.
overlay-screen-name
is the name of the overlay screen to be displayed.
AT
overlay-area
is the name of the overlay area of the currently displayed base screen into which
the overlay screen is to be placed.
SPACES
causes the overlay area to become blank and restores the area to the state it was
in immediately after the base screen was displayed. Any association of an overlay
screen with the overlay area is broken.
DISPLAY OVERLAY { [DYNAMIC]
overlay-screen-name
} AT
overlay-
{ SPACES }
area