Pathway/iTS SCREEN COBOL Reference Manual (H06.10+, J06.03+)

Data Division
HP NonStop Pathway/iTS SCREEN COBOL Reference Manual—426750-003
5-46
Field-Characteristic Clauses
SKIPPING 1.
07 JOB-STATE AT 6,22 PIC X(5)
FROM JOB-STATE OF SCREEN-TEMP
OCCURS ON 10 LINES
SKIPPING 1.
•
A reference to a screen field that is described with an OCCURS clause should
appear without a subscript when the field is used as one of the screen identifiers in
an ACCEPT statement. In other statements where screen identifiers can be used,
a reference to a screen field described with an OCCURS clause can appear with or
without a subscript. A reference without a subscript refers to all occurrences of the
table. A reference that includes a subscript refers only to the occurrence selected
by the value of the subscript.
•
When a screen field described with a DEPENDING phrase is referred to in an
ACCEPT statement, part of the ACCEPT statement processing performed by the
TCP is the determination of the size of the table—the value to be stored into
data-name-1 . All occurrences of the field are examined and the TCP sets
data-name-1 to the occurrence number of the last occurrence that was entered.
If the field is also a required field, all preceding occurrences of the field must also
be entered. Failure to do this causes a PREVIOUS FIELD MISSING error
message to be displayed for the terminal operator.
•
Several tables on the same screen might have the same data-name-1 in their
DEPENDING phrase. If the tables are referred to in the same ACCEPT statement,
the value of data-name-1 is set to the maximum of the values that would be
computed when considering each table separately. If this causes the value of
data-name-1 to be set greater than the highest supplied occurrence of a table
whose fields are required, the input is in error and a REQUIRED FIELD MISSING
or EARLIER FIELD MISSING (depending on the order of the fields) message is
displayed for the terminal operator.
•
When a reference to a screen field described with a DEPENDING phrase appears
without a subscript in any statement other than an ACCEPT statement, the
reference is to all occurrences within the current size of the table, as specified by
the value in
data-name-1 .
•
When the value of data-name-1 of the DEPENDING phrase decreases and a
DISPLAY statement displays the table of screen field values, the fields previously
displayed beyond the current limit remain on the screen. To avoid having old
screen field values remain on the screen, you can handle the display in one of the
following ways:
°
Specify a DISPLAY BASE or DISPLAY RECOVERY statement before the
DISPLAY statement for the current table of values.
°
Do not use the DEPENDING phrase; define the table for the maximum length
and always display the full table with field values set appropriately.