Skip to content

FIELD

FUNCTION

This numeric variable interacts with the INPUT SCREEN command. It specifies the field that contains the cursor.

SYNTAX

screen-name.FIELD
screen-name
the name of a screen defined in Dictionary-IV.

NOTES

  • This variable must be qualified by preceding it with the name of a screen. The screen name must be delimited from the variable by a period.
  • The cursor can be placed on a field on the screen depending upon the value of the variable. The value set for the variable is relative to the current field:
value cursor position
-n nth previous
-1 previous
0 current
1 next
n nth next
  • The FIELD variable is useful for overriding, from within a pre-processing or post-processing procedure, the order in which data are automatically collected from fields on a screen. The FIELD variable is not valid in a post-help procedure.
  • The value of the variable defaults to 1 (next field) in post-processing and to 0 (current field) in preprocessing. These values can be overridden by using the FIELD variable.
  • A value of 99 moves the cursor to the last field on the screen.
  • When operator input to a field is completed by pressing an input termination key such as Enter or F1, the FIELD variable is automatically set to 1 to send the cursor to the next field. You can override the default and send the cursor to another field by setting the FIELD variable within pre-processing or post-processing procedures.
  • If the input termination key serves a field control function, as do the down arrow, F10-GOTO, Page Up, or Page Down keys, the cursor location will be controlled by the selected function. In this case however, if the field has post-processing, the FIELD variable can be used to override the field control function.

EXAMPLES

LET 4STOPSC1.FIELD = 99

SEE ALSO

COLUMN, LENGTH, LINE, TERM-KEY, INPUT SCREEN, FIELD-NO, SN

From the Script-IV Language Reference, version 8.9.1. Open this page in the PDF