validationFailed()

The system function ConverseLib.validationFailed is used in either of two ways:
  • If invoked in a field-validation function in a text application, ConverseLib.validationFailed causes the re-presentation of the received text form after all validation functions are processed. The last-invoked ConverseLib.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, ConverseLib.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 ConverseLib.displayMsgNum.

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

  ConverseLib.validationFailed([msgNumber INT in])
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.

Feedback
(C) Copyright IBM Corporation 2000, 2005. All Rights Reserved.