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-103
TURN Statement
mnemonic-name
specifies the display attributes to be used. The mnemonic-name must be
associated with one or more display attributes through an IS phrase in the
SPECIAL-NAMES paragraph in the Environment Division of the program.
DYNAMIC
indicates that the specified screen field can have its screen attributes constructed
from a combination of the screen field’s attributes as defined at compile time and the
attribute settings as defined in the control structure.
RECEIVE FROM
specifies the type of device from which data can be accepted for a screen field. This
clause is supported only for applications running on 6530 or 6540 terminals with
6AI (revision A00 or later) firmware.
screen-identifier
specifies the fields whose attributes can be changed. Each identifier can be the
name of an entire screen, a screen group, or an elementary item of any base or
overlay screen that is currently displayed. If screen-identifier is not an
elementary item, screen-identifier refers to all subordinate elementary
items that have a TO, FROM, or USING clause in their definitions. There may be at
most 127 screen identifiers per TURN statement.
DEPENDING ON identifier
selects zero or one screen-identifier from the list. The statement whose
position in the screen-identifier list is the same as the value in
identifier is selected. If the value in identifier is less than 1 or greater
than the number of screen identifiers, no screen-identifier is selected.
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.
Note. If neither the DEPENDING ON modifier nor the SHADOWED modifier is specified, all
fields in the screen-identifier list are selected.