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-39
DISPLAY Statement
falls through (execution continues with the next statement) and no screen field is
displayed.
The execution of DISPLAY in block mode 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:
•
Terminal buffer (TERMBUF) fills up
•
Execution of one of the following statements: ACCEPT; BEGIN-TRANSACTION,
END-TRANSACTION, RESTART-TRANSACTION, or ABORT-TRANSACTION;
CALL; CHECKPOINT; DELAY; EXIT PROGRAM; PRINT SCREEN; or
SEND
•
Execution of DISPLAY for a conversational terminal
For terminals operating in conversational mode, the DISPLAY statement presents output
in order by rows. A screen field value appears on the screen at the column number
position specified in the screen field description. Blank lines are not generated (for
formatting purposes), so screen lines generally do not correspond with the line numbers
specified in the Screen Section.
To display fully line-formatted screens, define at least one item for every line (row) of
the screen. If a row of spacing is required, define the screen item for that row with a
VALUE clause specifying blanks; for example, VALUE " ". Then, prepare the entire
screen buffer by specifying the screen name as the screen identifier in the DISPLAY
statement.
For terminals operating in conversational mode, the DISPLAY statement performs as
follows:
•
The DISPLAY statement places screen items on the output line in the column
location specified in the Screen Section. If another screen item has the same line
number description, but is not named in the DISPLAY statement, that screen item
appears in the screen display.
•
If you specify a screen group name to display multiple screen fields, each screen
field appears in the column described for that field. However, the screen fields are
on consecutively numbered lines regardless of the screen field descriptions.
•
Any nonfiller screen item must be defined with a TO, FROM, or USING clause in
the Screen Section. If a screen item is defined with both a VALUE clause and a TO,
FROM, or USING clause, the literal in the VALUE clause is never displayed. The
DISPLAY statement output is always from the associated Working-Storage data
items.
•
If nonnumeric-literal is listed in a DISPLAY statement and the screen-
identifier list contains more than one field, the literal appears in each of the screen
fields named in the list.
The Break key for conversational terminals can be enabled to terminate a DISPLAY
operation. The Break key is enabled through the PATHCOM commands SET TERM or
SET PROGRAM TYPE in the Pathway system configuration. If the Break key is