iTS 1.0+)

Data Division

Compaq NonStop™ Pathway/iTS SCREEN COBOL Reference Manual—426750-001

5-36

Field-Characteristic Clauses

@ [ { + | - } numeric-literal ]

This form represents a location relative to the home position of the group containing

the field declaration. The home position is the first data character of the field and is

specified for the group with the AT clause.

Either the AT clause or the REDEFINES clause must be included in every screen field

declaration. If both clauses appear in the screen field declaration, they must refer to

exactly the same position.

CONTROLLED Clause

The CONTROLLED clause specifies a Working-Storage Section or Linkage Section

data item representing a structure capable of supporting run-time control of a screen

field’s display attributes.

When you use an appropriate combination of the CONTROLLED clause, the

DYNAMIC modifier, and the shadowed clause, you can combine the operations

DISPLAY BASE and DISPLAY OVERLAY, or TURN and DISPLAY, into one

operation.

data-name-1

is the name of a group data item structure that can support all of the currently

defined Pathway screen field attributes.

Specifying Data Items in a Control Structure

A control structure for a particular attribute definition must comply with the layout and

data types; otherwise, a compile-time error occurs.

An attribute control element (attrib-TOKEN) is a token consisting of an attribute

identifier (attrib-ID) and the attribute’s value (attrib-VALUE). The number of attrib-

TOKEN items in the structure, up to the maximum defined by MAX-TOKEN-PAIRS

(which has a maximum of 15), is controlled through the structure’s TOKEN-COUNT

data item. To support simultaneous attribute changes of a screen field (for example, in

TURN operation), you must define the appropriate number of attrib-TOKEN items. The

values are as specified in the following table.

CONTROLLED [ BY ] data-name-1