The
converseLib.validationFailed() system
function
is used in either of two ways:
- If called in a field-validation
function in a Text UI program, converseLib.validationFailed() causes
the redisplay of the received text form after all validation functions
are
processed. The last-called converseLib.validationFailed() function
determines the message that is displayed.
If possible, the message
presentation
is on the form itself, in the field to which the msgField form
property refers. If the msgField has no
value form
property, 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 converseVar.validationMsgNum system
variable.
converseLib.validationFailed([msgNumber INT in])
- msgNumber
- The
number of the message to display. The argument must be an integer
literal or a variable 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.