validationMsgNum

The converseVar.validationMsgNum system variable contains the value assigned by converseLib.validationFailed in a Text UI program, so you can determine if a validation function reported an error. The value is reset to zero in each of the following cases:
  • The program initializes
  • The program issues a converse, display, or print statement
  • The program reissues a converse statement to display a text form as the result of a validation error

You can use converseVar.validationMsgNum in these ways:

  • As the source or target of an assignment or move statement (also allowed in a move...for count statement)
  • As the variable in a logical expression
  • As the argument in a return or exit statement
converseVar.validationMsgNum has the following characteristics:
Primitive type
INT
Value saved across segmented converse?
No

Example

In the following example, the program retains the first message number that was set during validation routines:

if (converseVar.validationMsgNum > 0)
    converseLib.validationFailed(10);
end