Syntax of the INPUT instruction

The INPUT statement supports data entry into the fields of the current form.

Syntax 1: Implicit field-to-variable mapping

INPUT BY NAME { variable | record.* } [,...]
  [ WITHOUT DEFAULTS ]
  [ ATTRIBUTES (
          { display-attribute
          | control-attribute
          } [,...] ) ]
  [ HELP help-number ]
  [ dialog-control-block
      [...] 
END INPUT ]

Syntax 2: Explicit field-to-variable mapping

INPUT { variable | record.* } [,...]
  [ WITHOUT DEFAULTS ]
  FROM 
  field-list
  [ ATTRIBUTES (
          { display-attribute
          | control-attribute
          } [,...] ) ]
  [ HELP help-number  ]
  [ dialog-control-block
      [...]
END INPUT ]

where dialog-control-block is one of:

{ BEFORE INPUT
| AFTER INPUT
| BEFORE FIELD field-spec [,...] 
| AFTER FIELD field-spec [,...] 
| ON CHANGE field-spec [,...] 
| ON IDLE idle-seconds 
| ON ACTION action-name [INFIELD field-spec] 
| ON KEY ( key-name [,...] )
}
    dialog-statement
    [...]

where dialog-statement is one of:

{ statement
| ACCEPT INPUT
| CONTINUE INPUT
| EXIT INPUT
| NEXT FIELD
   { CURRENT
   | NEXT
   | PREVIOUS
   | field-spec
   }
}

where field-list defines a list of fields with one or more of:

{ field-name
| table-name.*
| table-name.field-name
| screen-array[line].*
| screen-array[line].field-name
| screen-record.*
| screen-record.field-name
} [,...]

where field-spec identifies a unique field with one of:

{ field-name
| table-name.field-name
| screen-array.field-name
| screen-record.field-name
}

where display-attribute is:

{ BLACK | BLUE | CYAN | GREEN
| MAGENTA | RED | WHITE | YELLOW
| BOLD | DIM | INVISIBLE | NORMAL
| REVERSE | BLINK | UNDERLINE
}

where control-attribute is:

{ ACCEPT [ = boolean ]
| CANCEL [ = boolean ]
| FIELD ORDER FORM
| HELP = help-number
| NAME = "dialog-name"
| UNBUFFERED [ = boolean ]
| WITHOUT DEFAULTS [ = boolean ]
}

variable is a program variable that will be filled by the INPUT statement.
record.* is a record variable that will be filled by the INPUT statement.
help-number is an integer that allows you to associate a help message number with the instruction.
field-name is the identifier of a field of the current form.
table-name is the identifier of a database table of the current form.
screen-record is the identifier of a screen record of the current form.
screen-array is the screen array that will be used in the form.
line is a screen array line in the form.
key-name is a hot-key identifier (like F11 or Control-z).
dialog-name is the identifier of the dialog.
idle-seconds is an integer literal or variable that defines a number of seconds.
action-name identifies an action that can be executed by the user.
statement is any instruction supported by the language.
boolean is a boolean expression evaluated when the dialog starts.