Pathway/iTS SCREEN COBOL Reference Manual (H06.10+, J06.03+)

Procedure Division
HP NonStop Pathway/iTS SCREEN COBOL Reference Manual—426750-003
6-140
USE FOR SCREEN RECOVERY Statement
USE FOR SCREEN RECOVERY Statement
The USE FOR SCREEN RECOVERY statement is entered in the Declaratives portion
of the Procedure Division. It identifies a procedure to restore the terminal display
should an error occur while the specified base screens are active. USE FOR SCREEN
RECOVERY clause is invoked when there are terminal or communication errors,
processor failures, or terminal suspensions. See the Pathway/iTS TCP and Terminal
Programming Guide for a list of errors that invoke the USE FOR SCREEN
RECOVERY clause. The Declaratives procedure is called automatically only after the
terminal is suspended and restarted with the PATHCOM command RESUME TERM.
Typically, the SCREEN COBOL program displays advisory text on the screen, and the
user must then take corrective action. If no user error recovery is provided in the
SCREEN COBOL program, then the TCP takes its own action on terminal errors.
The USE FOR TERMINAL-ERRORS clause is invoked when there is an irrecoverable
error due to a terminal error or communications device error. The Declaratives
procedure does not apply to errors detected by logic in the SCREEN COBOL program.
Note that the DISPLAY RECOVERY statement cannot be used in a USE FOR
SCREEN RECOVERY statement. The USE FOR SCREEN RECOVERY statement
cannot be used by programs that communicate with intelligent devices.
ON base-screen-name-n
specifies the base screens for which the declarative procedures are to be used. If
this phrase is omitted, the declarative procedures are used for all screens not
mentioned in another USE statement.
The recovery process performs the equivalent of a DISPLAY BASE for the current
base screen followed by a DISPLAY OVERLAY for all currently active overlay screens.
The applicable declarative procedure statements are then executed. When the
DIM
Text is
Hidden &
area is
Dim
Dim &
Protected
Dim &
Blink
Dim &
Mdton
Dim Dim &
Reverse
Dim &
Under-line
REVERSE
Reverse
& Hidden
Reverse &
Protected
Reverse &
Blink
Reverse &
Mdton
Reverse &
Dim
Reverse Reverse
& Under-
line
UNDER-
LINE
Underline
& Hidden
Underline
&
Protected
Underline
& Blink
Underline
& Mdton
Underline
& Dim
Underline
& Reverse
Under-line
USE [ FOR SCREEN ] RECOVERY
[ ON { base-screen-name-n } ,... ] .
HIDDEN
PROTEC-
TED BLINK MDTON DIM REVERSE
UNDER-
LINE