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

Procedure Division
HP NonStop Pathway/iTS SCREEN COBOL Reference Manual—426750-003
6-137
TURN Statement
SHADOWED
selects from the screen-identifier list only those fields that have
SHADOWED items with the SELECT bit set; fields that do not have SHADOWED
items are not selected.
The attributes of the selected fields are changed to those specified by mnemonic-
name . The settings for attributes not specified by mnemonic-name are determined by
the initial attributes of the field.
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. It allows you to base the new display attributes specified by the
TURN statement on the run-time attribute settings, not the compile-time settings. To
return the attribute settings back to the compile-time values, use the RESET
statement.
Tabl e 6- 7 shows the criteria for determining the selection of a screen field in a TURN
operation.
TURN does not cause a physical write to the screen but causes data to be written to
the terminal buffer. A physical write to the screen occurs when one of the following
events occurs:
•
TERMBUF fills up
•
One of the following statements is executed: ACCEPT; BEGIN-TRANSACTION,
END-TRANSACTION, RESTART-TRANSACTION, or ABORT-TRANSACTION;
CALL; CHECKPOINT; DELAY; EXIT PROGRAM; PRINT SCREEN; or SEND
•
The DISPLAY statement is executed for a conversational terminal
Note. If neither the DEPENDING ON modifier nor the SHADOWED modifier is specified, all
fields in the screen-identifier list are selected.
Table 6-7. Screen Field Selection Criteria in TURN Operation
DYNAMIC SHADOWED Selected Not Selected Selected
Screen Fields With These Characteristics Are…
TURN Operation
Specifiers
SHADOWED:
YES, SELECT=1
SHADOWED:
YES, SELECT=0
SHADOWED:
NO
mnemonic-name Selected Selected Selected
mnemonic-name
SHADOWED
Selected Not selected Selected
DYNAMIC Selected Selected Selected