The inputForm property
specifies the name of
a form that is presented to the user before the program logic runs.
This property
is valid only for main Text UI programs.
Two scenarios are possible:
- If the program is the target of a show form returning
to target statement from an
EGL-generated
program, the sending program presents a form to the user, and that
form must
be identical to the input form of the target program. The target program
is
invoked only after the user submits the form. After the user submits
the form,
the target program starts and EGL validates the data entered on the
form.
If there are errors, EGL converses the form again so that the user
can correct
the input. When the form input is valid, EGL gives control to the
first statement
in the program's main function.
- If the program is the target
of a transfer to transaction statement
from a program (EGL or non-EGL) or if the program is invoked by the
user or
by an operating-system command, the receiving program converses the
input
form. (In this case, input fields on that form are initialized before
display.)
After the user submits the form, EGL validates the data entered on
the form.
If there are errors, EGL converses the form again so that the user
can correct
the input. When the form input is valid, EGL gives control to the
first statement
in the program's main function.
The input form must
be in the form group that you specified in the program's
use statement.