SVALFORM C-3

NAME

svalform - set next validation form for data

SYNOPSIS

svalform (formname)

char *formname;

DESCRIPTION

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.

SEE ALSO

form(C-3)

Some user edit routine calls (notably U_BEGINFORM) happen too late for svalform to be effective.