DtvLong dal_cch_chk_men (par)

Checks whether the current field content corresponds to an entry in the selection menu.

Input Parameters Significance
char *par input-flag: Must be set to NULL or > |< if function is called from another function

Output Parameters Significance
none -

Return Code Significance
0 field content correct
1 field content incorrect

Called as post-field userexit at each field of a mask.

If subsequent menus are defined at the selection menu, the userexit hierarchically checks all item entries in these menus, too.

If the field content is not correct, DataView outputs an error message. The user can only leave the field by specifying a correct or an empty entry.

Attention! The special characters ">" and "|" in the selection text are interpreted as end-of-string characters by DataView. When a selection text is taken into the field, the userexit dal_cch_chk_men will only check the text up to the end-of-string character. With "\>" or "\|" the special characters can be masked. The userexit will then also check selection texts containing special characters.

The userexit does not check an empty field. Only by setting the field to > mandatory < you can prevent that an empty field is entered. If combined with dal_cch_chk_men, the user will have to specify a correct entry to be allowed to leave the field.

When the parameter > |< is passed, the userexit only checks up to the defined field width and without any space-wildcard.