sysLib.validationFailed

The system function sysLib.validationFailed is used in either of two ways:

• If invoked in a field-validation function in a text application, sysLib.validationFailed causes the re-presentation of the received text form after all validation functions are processed. The last-invoked sysLib.validationFailed determines what message is displayed.

  If possible, the message presentation is on the form itself, in the field to which the form property msgField refers. If the form property msgField has no value, the message is displayed previous to the display of the form, on a separate, modal screen.

• If invoked outside a validation function, sysLib.validationFailed presents the specified message the next time that a form is presented by a converse, display, print, or show statement. The behavior in this case is like that of sysLib.displayMsgNum.

In any case, the value assigned to sysLib.validationFailed is stored in the system variable sysVar.validationMsgNum.

msgNumber

The number of the message to display. The argument must be an integer literal or an item of primitive type SMALLINT or INT or the BIN equivalent. This number is compared against each cell in the first column of the program's message table, which is the data table to which the program's msgTablePrefix property refers. The retrieved message is in the second column of the same row.

The message number is 9999 by default.

Related reference
sysLib.displayMsgNum
sysVar.validationMsgNum
System words in alphabetical order