Funciones

De WikiDgp21
Saltar a: navegación, buscar

g_mens

  • Permite mostrar un mensaje por pantalla para el usuario.
  • Esta función se llama con 4 parámetros, que son:
    • 1: La pantalla que se quiere utilizar para mostrar el error, hasta 10 dígitos alfanuméricos.
      Por ejemplo: msg0001, msg0002, msg0003... msg0008.
    • 2: El código del error que quiere mostrarse, definido previamente en la tabla dgmens. Podemos definir nuevos mensajes accediendo a Gestión de mensajes de programación. También podemos especificar un identificador de control con la notación #nnn, desde donde se tomará el código de error.
    • 3: Una referencia identificadora del error, 6 dígitos alfanuméricos (Opcional).
    • 4: Un campo de la pantalla cuyo contenido quiera mostrarse como información adicional en el mensaje, 3 dígitos numéricos (Opcional).
  • La pantalla que aparece con el mensaje siempre contendrá uno o dos botones (un “Aceptar” y un “Cancelar”). Si se clicka el primero la función devolverá un 0 en el campo 1 (estado), mientras que si se clicka el segundo devolverá un 1.
  • Aunque no especifiquemos los carácteres opcionales, debemos mantener las comas separadoras de los mismos.

Ejemplos.

msg0001,msg_err,001,053
msg0001,msg_err,,053
msg0001,#066,,067

  Las pantallas con las que se muestran los errores se pueden crear o cogerlas ya predeterminadas:

msg0001
msg0002
msg0003
msg0010
msg0007
msg4 01
msg5 01
msg0006
msg7 01
msg9 01