Habilitación de la publicación de sucesos de trabajo por lotes

Mediante la utilización de Java Messaging System (JMS), el servidor por lotes puede publicar sucesos relacionados con trabajos en clientes externos.

Acerca de esta tarea

La capacidad del servidor por lotes de publicar sucesos relacionados con trabajos en clientes externos permite a un supervisor ver los sucesos relacionados con trabajos e informar sobre anomalías. El servidor asignador de lotes puede publicar sucesos para un trabajo en la fase de asignación. El servidor ejecutor de lotes puede publicar sucesos para trabajos cuando se mueve a través de las distintas fases de ejecución. Estos sucesos se publican en un árbol de temas en las estructuras siguientes:

Tabla 1. Estructuras de archivos de árboles de temas para la publicación de sucesos
Estructura Descripción
batch La raíz del árbol de temas.
batch/jobs El árbol de temas para todos los sucesos relacionados con trabajos.
   
batch/jobs/instance El árbol de temas para todos los sucesos que están realizados con una instancia de trabajo.
batch/jobs/instance/submitted Un nodo de árbol de temas. Se publica un mensaje cuando el servidor por lotes crea una instancia de trabajo para el envío de un nuevo trabajo.
batch/jobs/instance/jms_queued Un nodo de árbol de temas. Se publica un mensaje cuando se coloca un envío de trabajo en la cola de envío de trabajo mediante el asignador de JMS por lotes.
batch/jobs/instance/jms_consumed Un nodo de árbol de temas. Se publica un mensaje cuando el ejecutor de lotes recibe el envío del trabajo de la cola de envío de trabajo.
batch/jobs/instance/dispatched Un nodo de árbol de temas. Se publica un mensaje cuando el ejecutor de lotes acepta una instancia de trabajo para la ejecución.
batch/jobs/instance/completed Un nodo de árbol de temas. Se publica un mensaje cuando se completa la instancia de trabajo.
batch/jobs/instance/stopped Un nodo de árbol de temas. Se publica un mensaje cuando se detiene la instancia de trabajo.
batch/jobs/instance/stopping Un nodo de árbol de temas. Se publica un mensaje cuando se está deteniendo una instancia de trabajo.
batch/jobs/instance/failed Un nodo de árbol de temas. Se publica un mensaje cuando ha fallado la instancia de trabajo.
batch/jobs/instance/purged Un nodo de árbol de temas. Se publica un mensaje cuando una instancia de trabajo se ha depurado correctamente.
   
batch/jobs/execution El árbol de temas para todos los sucesos que están relacionados con una ejecución de trabajos.
   
batch/jobs/execution/restarting Un nodo de árbol de temas. Se publica un mensaje cuando el ejecutor de lotes está reiniciando una ejecución.
batch/jobs/execution/starting Un nodo de árbol de temas. Se publica un mensaje cuando se está iniciando una ejecución de trabajos.
   
batch/jobs/execution/completed Un nodo de árbol de temas. Se publica un mensaje cuando una ejecución de trabajos finaliza de forma satisfactoria.
batch/jobs/execution/failed Un nodo de árbol de temas. Se publica un mensaje cuando finaliza una ejecución de trabajos debido a una anomalía.
batch/jobs/execution/stopped Un nodo de árbol de temas. Se publica un mensaje cuando se detiene una ejecución de trabajos.
batch/jobs/execution/jobLogPart Un nodo de árbol de temas. Se publica un mensaje cuando se crea una nueva parte de registro de trabajo, se detiene un trabajo o un trabajo finaliza.
   
batch/jobs/execution/step/started Un nodo de árbol de temas. Se publica un mensaje cuando se inicia la ejecución de un paso.
batch/jobs/execution/step/completed Un nodo de árbol de temas. Se publica un mensaje cuando una ejecución de paso se ha completado correctamente.
batch/jobs/execution/step/failed Un nodo de árbol de temas. Se publica un mensaje cuando falla la ejecución de un paso.
batch/jobs/execution/step/stopped Un nodo de árbol de temas. Se publica un mensaje cuando se detiene la ejecución de un paso.
batch/jobs/execution/step/checkpoint Un nodo de árbol de temas. Se publica un mensaje cuando se toma un punto de comprobación.
   
batch/jobs/execution/partition/started Un nodo de árbol de temas. Se publica un mensaje cuando se inicia una partición.
batch/jobs/execution/partition/completed Un nodo de árbol de temas. Se publica un mensaje cuando una partición se ha completado correctamente.
batch/jobs/execution/partition/failed Un nodo de árbol de temas. Se publica un mensaje cuando falla una partición.
batch/jobs/execution/partition/stopped Un nodo de árbol de temas. Se publica un mensaje cuando se detiene una partición.
   
batch/jobs/execution/split-flow/started Un nodo de árbol de temas. Se publica un mensaje cuando se inicia un flujo de división.
batch/jobs/execution/split-flow/ended Un nodo de árbol de temas. Se publica un mensaje cuando se ha completado un flujo de división.
El mensaje publicado para cada tema es un JMS TextMessage. El contenido de este mensaje es una serie con formato JSON que representa el objeto del tema como, por ejemplo, instancia de trabajo, ejecución de trabajo, ejecución de paso o partición. Además, este mensaje también incluye el conjunto de propiedades de mensaje JMS siguiente:
  • com_ibm_ws_batch_internal_jobInstanceId: el ID de instancia de trabajo, si está disponible.
  • com_ibm_ws_batch_internal_jobExecutionId: el ID de ejecución de trabajo, si está disponible.
  • com_ibm_ws_batch_internal_stepExecutionId: el ID de ejecución de paso de trabajo, si está disponible.

El servidor por lotes debe estar configurado para habilitar la publicación de sucesos relacionados con trabajos. El asignador de lotes y el ejecutor de lotes tienen la misma configuración. Los pasos siguientes permiten la publicación de sucesos relacionados con trabajos para un servidor por lotes.

Procedimiento

  1. Habilite el soporte JMS añadiendo la característica JMS apropiada al gestor de características en el archivo server.xml. Si está utilizando el proveedor de mensajería predeterminado de WebSphere Application Server Liberty, añada la característica wasJmsClient-2.0 y configuraciones JMS relacionadas para el motor de mensajería. Si está utilizando el proveedor de mensajería de WebSphere MQ, añada la característica wmqJmsClient-2.0.
  2. Añada el elemento batchJmsEvents al archivo server.xml.
    <batchJmsEvents connectionFactoryRef="batchConnectionFactory" />
    Nota: Si no especifica el atributo connectionFactoryRef, el valor predeterminado para connectionFactoryRef es batchConnectionFactory. Debe seguir configurando la fábrica de conexiones JMS batchConnectionFactory en el archivo server.xml.
  3. Añada la fábrica de conexiones JMS correspondiente a la configuración del servidor. Esto no es específico de la configuración por lotes.
    El ejemplo siguiente ilustra la configuración de sucesos por lotes y su configuración de JMS utilizando el proveedor de mensajería de WebSphere MQ.
    <!-- wmq resource adapter -->
    <variable name="wmqJmsClient.rar.location" value="${server.config.dir}/wmq.wlp.rar"/>
    <!-- require for BINDING mode -->
    <wmqJmsClient nativeLibraryPath="/mqm/jms/java/lib" />
    
    <batchJmsEvents connectionFactoryRef="batchConnectionFactory"
    />
    
    <jmsConnectionFactory id="batchConnectionFactory" jndiName="jms/batch/connectionFactory">
      <properties.wmq.Jms
        transportType="BINDINGS"
        queueManager="WMQX" />
    </jmsConnectionFactory>
    El ejemplo siguiente ilustra la configuración de sucesos por lotes y su configuración de JMS utilizando el proveedor de mensajería predeterminado de WebSphere Liberty.
    <batchJmsEvents
    connectionFactoryRef="batchConnectionFactory" />
    <jmsConnectionFactory id="batchConnectionFactory"
    jndiName="jms/batch/connectionFactory">
      <properties.wasJms></properties.wasJms>
    </jmsConnectionFactory>

Ejemplo

Los ejemplos siguientes ilustran la secuencia de sucesos para flujos de ejecución básica.
  • Envíe y ejecute un trabajo de un solo paso con puntos de comprobación.
    batch/jobs/instance/submitted
    batch/jobs/instance/jms_queued
    batch/jobs/instance/jms_consumed
    batch/jobs/execution/starting
    batch/jobs/instance/dispatched
    batch/jobs/execution/started
    batch/jobs/execution/step/started
    batch/jobs/execution/step/checkpoint
    batch/jobs/execution/step/checkpoint
    ...
    batch/jobs/execution/step/checkpoint
    batch/jobs/execution/step/completed
    batch/jobs/execution/completed
    batch/jobs/instance/completed
  • Envíe y ejecute un trabajo de un solo paso con partición.
    batch/jobs/instance/submitted
    batch/jobs/instance/jms_queued
    batch/jobs/instance/jms_consumed
    batch/jobs/execution/starting
    batch/jobs/instance/dispatched
    batch/jobs/execution/started
    batch/jobs/execution/step/started
    batch/jobs/execution/partition/started
    batch/jobs/execution/partition/started
    batch/jobs/execution/partition/started
    batch/jobs/execution/partition/completed
    batch/jobs/execution/partition/completed
    batch/jobs/execution/partition/completed
    batch/jobs/execution/step/completed
    batch/jobs/execution/completed
    batch/jobs/instance/completed

Icono que indica el tipo de tema Tema de tarea



Icono de indicación de fecha y hora Última actualización: Tuesday, 6 December 2016
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=twlp_batch_monitoring
Nombre de archivo:twlp_batch_monitoring.html