svalform - set next validation form for data
svalform (formname)
char *formname;
Svalform specifies the data entry form to be used as a validation
form. Normally, you specify the validation form when you create
the data entry form. Svalform changes the validation form to the
first form in the formfile with a form name equal to the formname
parameter.
Svalform does not change to the new form at the time of call, but
instead saves which form is to be used as the next validation
form. When the operator presses the VALIDATE key, the specified
form is used as the validation form. If formname is NULL or an
empty string,then svalform sets the validation form back to the
original validation form. This can be used to undo the effect of
a previous svalform call.
Svalform returns a value of zero if the form name cannot be
found.
form(C-3)
Chapter 3, Form Programming Guide
Svalform is only available in user edit routines.
Some user edit routine calls (notably U_BEGINFORM) happen too
late for svalform to be effective.