Pathway/iTS SCREEN COBOL Reference Manual (G06.24+, H06.03+, Pathway/iTS 1.0+)

Procedure Division
Compaq NonStop™ Pathway/iTS SCREEN COBOL Reference Manual—426750-001
6-36
DISPLAY RECOVERY Statement
For terminals in both block and conversational mode, DISPLAY OVERLAY establishes
the current overlay screen and must execute 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.
When a shadowed screen field has an associated Working-Storage item with its
SELECT bit set to 1, the screen field acquires its initial screen contents from its FROM
or USING Working-Storage data item. Otherwise, the initial screen contents are
acquired from the compile-time literal value or the default initial value.
The DISPLAY BASE statement must appear before the DISPLAY OVERLAY
statement, or else an error is generated.
The overlay area must be at least as large as the overlay screen. An overlay screen
cannot be displayed in more than one overlay area at the same time.
DISPLAY RECOVERY Statement
The DISPLAY RECOVERY statement initiates screen recovery. A program can use
this statement to implement a request by a terminal operator for screen recovery, thus
eliminating duplication of code for recovery actions.
This statement cannot be used by programs communicating with intelligent devices.
DISPLAY OVERLAY { [DYNAMIC]overlay-screen-name } AT overlay-
{ SPACES } area
DISPLAY RECOVERY