Reenter Statement

Format

reenter ʃfield_nameʅ;

Description

The reenter statement is used to force the entry operator to reenter the contents of the current field or of a field that was entered earlier. The optional field_name is either the name of a field or is a string variable specifying the name of the field. If the field_name is not specified, the current field is reentered. The field to be reentered must be earlier on the data path than the current variable. If it is not, an error message will be displayed during data entry. If you do not know whether the field is earlier in the data path, use the move statement.

When a reenter statement is executed, the preproc of the reentered field will not be executed. The postproc of the field will be executed normally after the field has been reentered. If the field is on a different form than the current field, that form will be displayed automatically.

Example 1

PROC RELATIONSHIP

if curocc() = 1 and RELATIONSHIP <> 1 then
errmsg("The head of household must be entered on the first row.");
reenter;
endif;

Example 2

PROC DOB_YEAR

if DOB_YEAR = CensusYear and DOB_MONTH > CensusMonth then
errmsg("The date of birth cannot be after the census date. Reenter the month and year.");
reenter DOB_MONTH;
endif;