Establecimiento del origen de los datos estadísticos y de contabilidad del flujo de mensajes

Datos estadísticos y de contabilidad asociados con un origen de contabilidad.

Antes de comenzar:

Para realizar esta tarea, debe haber completado la tarea siguiente:

Cuando solicita soporte del origen de contabilidad para recopilar datos estadísticos y de contabilidad del flujo de mensajes mediante el mandato mqsichangeflowstats, también debe configurar los flujos de mensajes de modo que proporcionen los valores de identificación correctos que indican con qué están asociados los datos. Puede establecer un valor diferente para cada flujo de mensajes para el que la recopilación de datos esté activa, o el mismo valor para un grupo de flujos de mensajes (por ejemplo, los de un solo grupo de ejecución o los asociados con un cliente, departamento o suite de aplicaciones determinado).

El valor de origen de contabilidad no se utiliza hasta que se despliega el flujo o los flujos de mensajes a los intermediarios en los que se han de ejecutar. Puede activar la recopilación de datos o modificarla de modo que solicite el soporte de origen de contabilidad, antes o después de desplegar el flujo de mensajes. No tiene que detener la recopilación de datos cuando despliegue un flujo de mensajes que cambie el origen de contabilidad.

Para configurar un flujo de mensajes que especifique un origen de contabilidad determinado:

  1. Vaya a la perspectiva Desarrollo de aplicaciones de intermediario.
  2. Abra el flujo de mensajes con el que desee trabajar.
  3. Pulse Selección arriba de la paleta de nodos.
  4. Pulse con el botón derecho un nodo Compute, Database o Filter en la vista del editor y pulse Abrir ESQL. Se abre el archivo ESQL asociado en el editor de vistas y el cursor se sitúa al principio del módulo correcto. Puede incluir el ESQL necesario en cualquiera de estos nodos, por lo tanto, decida qué nodo de cada flujo de mensajes es el más adecuado para esta acción.

    Si desea beneficiarse del soporte del origen de contabilidad, debe incluir uno de estos nodos en cada flujo de mensajes para los que desea establecer un origen específico. Si no ha configurado uno de estos tres nodos del flujo de mensajes, debe añadir uno en un punto adecuado (por ejemplo, inmediatamente después del nodo de entrada) y conectarlo a otros nodos del flujo.

    Para obtener más información acerca de estos nodos y cómo configurarlos, consulte Nodo Compute, Nodo Database o Nodo Filter. Los temas del nodo también describen el módulo ESQL asociado, el archivo ESQL en el que existe el módulo y la acción que lleva a cabo el nodo si el módulo, el archivo o ambas cosas no existen.

  5. Actualice el ESQL en el módulo del nodo para establecer un origen de contabilidad. El intermediario utiliza el identificador del origen que se establece en el árbol Entorno. Debe establecer un valor en el campo cuyo nombre de correlación es Environment.Broker.Accounting.Origin. Este campo no se crea automáticamente en el árbol Entorno cuando se recibe por primera vez el mensaje en el intermediario. Se crea solamente cuando lo establece en un módulo ESQL asociado a un nodo del flujo de mensajes.

    Si no establece un valor en el flujo de mensajes, se utiliza el valor por omisión Anónimo para toda la salida. Si establece un valor en más de un lugar en el flujo de mensajes, el valor que establezca inmediatamente antes del flujo de mensajes finaliza si se utiliza en los datos de salida.

    El código que necesita añadir tiene el formato:

    SET Environment.Broker.Accounting.Origin = "value";

    Puede establecer el identificador en un valor fijo si lo decide (como se ha mostrado anteriormente) o puede determinar su valor basándose en un valor dinámico que solo se conoce durante la ejecución. Por ejemplo, puede establecer el valor en el contenido de un campo determinado del mensaje que se está procesando (si está codificando ESQL para un nodo Compute, debe utilizar el nombre de correlación InputBody en lugar de Body en el ejemplo siguiente):

    IF Body.DepartmentName <> NULL THEN
       SET Environment.Broker.Accounting.Origin = Body.DepartmentName;
    END IF;

    El valor deben ser datos de caracteres y puede tener un máximo de 32 bytes.

  6. Cuando haya realizado los cambios necesarios en el módulo ESQL, guárdelo y compruebe que no haya introducido ningún error.
  7. Guarde el flujo de mensajes y vuelva a comprobar si hay errores.
Ahora estará listo para desplegar el flujo de mensajes actualizado. Los datos estadísticos y de contabilidad que se recopilen después de desplegar el flujo de mensajes incluirán el identificador de origen que haya establecido.

Conceptos relacionados
Flujos de mensajes
Datos estadísticos y de contabilidad del flujo de mensajes

Tareas relacionadas
Desarrollo de aplicaciones de flujos de mensajes
Difusión de aplicaciones de flujos de mensajes
Modificar los parámetros de recopilación de datos estadísticos y de contabilidad del flujo de mensajes
Configuración de ESQL dentro de nodos

Referencia relacionada
Mandato mqsichangeflowstats
Nodo Compute
Nodo Database
Nodo Filter
Datos estadísticos y de contabilidad del flujo de mensajes