validationFailed()

La función de sistema ConverseLib.validationFailed puede utilizarse de dos formas:
  • Si se invoca en una función de validación de campos de un programa textUI, ConverseLib.validationFailed provoca la re-presentación del formulario de texto recibido una vez procesadas todas las funciones de validación. La última función ConverseLib.validationFailed invocada determina el mensaje que se visualiza.

    Si es posible, la presentación del mensaje se realiza en el propio formulario, en el campo al que hace referencia la propiedad de formulario msgField. Si la propiedad de formulario msgField no indica ningún valor, el mensaje se visualiza antes de la visualización del formulario, en una pantalla modal independiente.

  • Si se invoca fuera de una función de validación, ConverseLib.validationFailed presentará el mensaje especificado la próxima vez que se presente un formulario mediante una sentencia converse, display, print o show. En este caso, el comportamiento es como el de ConverseLib.displayMsgNum.

En cualquier caso, el valor asignado a ConverseLib.validationFailed se almacena en la variable de sistema ConverseVar.validationMsgNum.

  ConverseLib.validationFailed([númeroMsj INT in])
númeroMsj
El número del mensaje que debe visualizarse. El argumento debe ser un literal entero o un elemento de tipo primitivo SMALLINT o INT o el equivalente BIN. Este número se compara con cada casilla de la primera columna de la tabla de mensajes del programa, que es la tabla de datos a la que hace referencia la propiedad msgTablePrefix del programa. El mensaje recuperado se encuentra en la segunda columna de la misma fila.

El número del mensaje es 9999 por omisión.

Comentarios
(C) Copyright IBM Corporation 2000, 2005. Reservados todos los derechos.