3270 field attributes

As noted above, the field attributes byte holds the protection, modification and display intensity attributes of a field. Your choices for each of these attributes are described here using the terms that BMS uses in defining formats. If you use terminal control commands, you need to set the corresponding bits in the attributes byte to reflect the value you choose.

(See the IBM® 3270 Information Display System Data Stream Programmer’s Reference manual for the bit assignments. See also Attribute value definitions: DFHBMSCA for help from CICS® in this area.)

Protection

There are four choices for the protection attribute, using up two bit positions in the attributes byte. They are:

Unprotected
The operator can enter any data character into an unprotected field.
Numeric-only
The effect of this designation depends on the keyboard type of the terminal. On a data entry keyboard, a numeric shift occurs, so that the operator can key numbers without shifting. On keyboards equipped with the "numeric lock" special feature, the keyboard locks if the operator uses any key except one of the digits 0 through 9, a period (decimal point), a dash (minus sign) or the DUP key. This prevents the operator from keying alphabetic data into the field, although the receiving program must still inspect the entry to ensure that it is a number of the form it expects. Without the numeric lock feature, numeric-only allows any data into the field.
Protected
The operator cannot key into a protected field. Attempting to do so locks the keyboard.
Autoskip
The operator cannot key into an autoskip field either, but the cursor behaves differently. (The cursor indicates where the operator’s next keystroke will go; for more information about this, see Input from a 3270 terminal.) Whenever the cursor is being advanced to a new field (either because the previous field filled or because a field advance key was used), the cursor skips over any autoskip fields in its path and goes to the first field that is either unprotected or numeric-only.

Modification

The second item of information in the field attributes byte occupies only a single bit, called the modified data tag or MDT. The MDT indicates whether the field has been modified or not. The hardware turns on this bit automatically whenever the operator makes any change to the field contents. The MDT bit is very important because, for the read command that CICS normally uses, it determines whether the field is included in the inbound data or not. If the bit is on (that is, the field was changed), the 3270 sends the field; if not, the field is not sent.

You can also turn the MDT on by program, when you send a field to the screen. Using this feature ensures that a field is returned on a read, even if the operator cannot or does not change it. The FRSET option on BMS SEND commands allows you to turn off the tags for all the fields on the screen by program; you cannot turn off individual tags by program. If you are using terminal control commands, you turn on a bit in the WCC to turn off an individual tag.

Intensity

The third characteristic stored in the attributes byte is the display intensity of the field. There are three mutually exclusive choices:

Normal intensity
The field is displayed at normal brightness for the device.
Bright
The field is displayed at higher than normal intensity, so that it appears highlighted.
Nondisplay
The field is not displayed at all. The field may contain data in the buffer, and the operator can key into it (provided it is not protected or autoskip), but the data is not visible on the screen.

Two bits are used for display intensity, which allows one more value to be expressed than the three listed above. For terminals that have either of the associated special hardware features, these same two bits are used to determine whether a field is light-pen detectable or cursor selectable. Because there are only two bits, not all combinations of intensity and selectability are possible. The compromise is that bright fields are always detectable, nondisplay fields are never detectable, and normal intensity fields may be either. Cursor and pen-detectable fields contains more information about these features.

Base color

Some terminals support base color without, or in addition to, the extended colors included in the extended attributes. There is a mode switch on the front of such a terminal, allowing the operator to select base or default color. Default color shows characters in green unless field attributes specify bright intensity, in which case they are white. In base color mode, the protection and intensity bits are used in combination to select among four colors: normally white, red, blue, and green; the protection bits retain their protection functions as well as determining color. (If you use extended color, rather than base color, for 3270 terminals, note that you cannot specify "white" as a color. You need to specify "neutral", which is displayed as white on a terminal.)

Extended attributes

In addition to the field attributes just described, some 3270 terminals have extended attributes as well. Table 27 lists the types of extended attributes in the first column and the possible values for each type in the second column.

Table 27. 3270 extended attributes
Attribute type Values
Extended color Blue, red, pink, green, turquoise, yellow, neutral
Extended highlighting Blinking, reverse video, underscoring
Field outlining Lines over, under, left and right, in any combination
Background transparency Background transparent, background opaque
Field validation Field must be entered; field must be filled; field triggers input
Programmed symbol sets Number identifying the symbol set
Note:
The control unit associated with a terminal contains a default symbol set and can store up to five additional ones. To use one of these others, you need to load the symbol set into the controller prior to use. You can use a terminal control SEND command to do this.
SO/SI creation Shift characters indicating double-byte characters may be present; shift characters are not present

The IBM 3270 Information Display System Data Stream Programmer’s Reference manual contains details about extended attributes and explains how default values are determined. You can use ASSIGN and INQUIRE commands to determine which extended attributes your particular terminal has. These commands are described in Finding out about your terminal.

Some models of the 3270 also allow you to assign extended attribute values to individual characters within a field that are different from the value for the field as a whole. Generally, you need to use terminal control commands to do this, because BMS does not make explicit provision for character attributes. However, you can insert the control sequences for character attributes in text output under BMS, as explained in Text lines. The set attribute order describes the format of such a sequence.

[[ Contents Previous Page | Next Page Index ]]