Restricted Video Modes

The action of ACUCOBOL-GT on a terminal with non-hidden attributes is determined by the setting of the RESTRICTED_VIDEO_MODE runtime configuration variable. This variable can take several different settings to control the rules ACUCOBOL-GT uses for these terminals.

Note: The following rules do not apply to intensity. These terminals can apply intensity attributes individually to each screen position. The Terminal Manager treats high and low intensity in the normal manner for these types of terminals.

By default, the RESTRICTED-VIDEO-MODE value is zero, which causes the Terminal Manager to ignore attributes other than intensity; the application will run correctly, but without any video attributes. This is convenient when you are running a program that has not been written to conform to the following rules.

To use video attributes with these terminals, you must set RESTRICTED-VIDEO-MODE to a non-zero value; the syntax is:


Optional values are:

1    When the variable is set to 1, the Terminal Manager uses rules that tend to emphasize getting the fields in the right location over getting all the attributes correct. These rules are as follows:
  • Every ACCEPT and DISPLAY is preceded by the appropriate attribute-setting character.
  • This character is placed immediately to the left of the beginning of the field. Note that this may overwrite existing data.
  • If the field position is column 1 of the current window, and the attribute is normal white on black, then the attribute-setting character is not displayed.
  • If the field position is column 1 of the current window, and the attribute is other than white on black, the field is moved over to column 2 to allow space for the attribute character.
  • The field is then accepted or displayed using the normal rules.
  • If the screen location immediately after the end of the field does not contain an attribute-setting character, a normal white-on-black attribute character is placed there. If this statement is an ACCEPT statement, this is done before the ACCEPT occurs. The current cursor location is then set according to the normal ACUCOBOL-GT rules (this will cause the cursor location to be where this terminating attribute character is located).
3 When RESTRICTED-VIDEO-MODE is set to 3, the Terminal Manager follows all the rules listed under value1 except for rule (c). This causes all ACCEPT and DISPLAY statements that reference column 1 to be placed in column 2. This setting prevents you from placing data in column 1, but causes all fields placed in column 1 to line up vertically regardless of which attributes they use.
5 When RESTRICTED-VIDEO-MODE is set to 5, the Terminal Manager follows all the rules listed under 1 except for rule (b). The attribute character is placed in the first position of the field, and the field is moved to the right one character. This setting will cause all fields to shift to the right by one, but will not overwrite data if two fields are adjacent.
7 When RESTRICTED-VIDEO-MODE is set to 7, the Terminal Manager follows all the rules listed for 1 except for rules (b) and (c). Thus, every ACCEPT and DISPLAY will always be preceded by an attribute character, and this character will always occupy the first field position. This value emphasizes getting the attributes correct over getting the fields in the correct screen location.

These rules give a certain amount of flexibility, but also have restrictions.