Uso de CA AppLogic® › Guía del desarrollador de dispositivos › Instalaciones de OS › Instalación de Windows › Componentes de Windows comunes › vme: generador de eventos

vme: generador de eventos

VME es una utilidad de modo de usuario para generar eventos específicos de CA AppLogic® durante el proceso de arranque del dispositivo y en tiempo de ejecución.

Si se gestiona un dispositivo, este debe utilizar vme durante su proceso de arranque para indicarle a CA AppLogic® si el dispositivo se ha iniciado correctamente. Si el dispositivo no puede iniciarse debido a un error, como valores de configuración de propiedad no válidos o insuficiente memoria disponible, el dispositivo puede utilizar vme para producir un error de inicio de dispositivo y registrar un mensaje de error en el registro del sistema del controlador del grid.

Se accede al registro del sistema mediante el comando de registro de listas de grids. vme se puede utilizar también en tiempo de ejecución del dispositivo para registrar los mensajes de error graves en el cuadro de mandos del grid.

De forma predeterminada, cuando el APK se instala en un dispositivo, vme siempre envía el dispositivo un evento Se ha iniciado correctamente. Los scripts específicos del dispositivo que se ejecutan durante el proceso de arranque del dispositivo pueden sobrescribir este evento.

Uso

vme id=<evento> [msg=<mensaje>] [severity=<gravedad>] [progress=<progreso>] [cnt_name=<nombre del contador> cnt_value=<valor del contador>]

Ejemplos

vme id=started_ok

vme id=start_failed msg="Falta dirección de servidor DNS"

vme id=maintenance msg="Recuperación de la base de datos" progress=30

vme id=log msg="El certificado SSL se cargó correctamente" severity=info

vme id=alert msg="Se detectó un archivo de la base de datos dañado" severity=fatal

vme id=alert cnt_name=n_db_xact_per_min cnt_value=46 severity=fatal

Notas:

• <evento> es uno de los siguientes:
  • started_ok: el dispositivo se inició correctamente
  • start_failed: el dispositivo no se pudo iniciar, el mensaje es el motivo.
• mantenimiento: el dispositivo está en modo de mantenimiento (es decir, recuperación de la base de datos). Los dispositivos en modo de mantenimiento deben comunicar su progreso periódicamente (frecuencia mínima, cada 30 segundos).
• log: registra un evento en nombre del dispositivo.
• alerta: el dispositivo ha detectado un evento grave o error. Esto se utiliza también para comunicar un cambio en un valor de contador.
• <nombre del contador> y <valor del contador> solamente se utilizan para alertas.
• Si se proporciona un mensaje con una alerta, el mensaje se registra en el cuadro de mandos del grid.
• <mensaje> es un texto libre; deberá incluir caracteres de escape si se necesitan espacios u otros caracteres especiales.
• <severity> es uno de los siguientes:
  • debug: información de depuración
  • info: evento informativo
  • warn: evento de advertencia
  • error: evento de error
  • fatal: error irrecuperable fatal
• <progreso> se comunica en porcentaje; los valores válidos son del 1 al 100.