Actividad Sondear cola MQ

Utilice la actividad Sondear cola MQ para comprobar de forma periódica si existen en la cola MQ mensajes en base a un intervalo de reintento especificado durante el tiempo de ejecución.

Nota: Para poder configurar la actividad, debe haber creado antes un punto final para la actividad MQ.
La tarea Configurar tiene tres secciones:
  • Detalles de mensaje y cola: donde puede especificar las propiedades de la cola y los detalles del mensaje.
  • Reglas de entrega: donde puede especificar cómo desea que se entreguen los mensajes.
  • Opciones de reintento: donde puede especificar cuánto tiempo debe esperarse entre las entradas y el número de reintentos antes de considerar la actividad como fallida.

Tras completar las tareas Configurar, lleve a cabo la tarea Correlación de salidas de la actividad.

Nota: El tamaño máximo del mensaje es 100 MBytes.

Detalles de mensaje y cola

Especifique los detalles de mensaje y cola de los campos de la tabla que figura más abajo. Los campos obligatorios están marcados con un asterisco.
Campo Descripción
Nombre de cola * Especifica el nombre de la cola que se sondea en busca de mensajes.
Tipo de datos de carga útil Especifica el tipo de datos de la carga útil del mensaje: binario o serie.
Fragmento de esquema para cabecera MQRFH2 Especifica si una cabecera MQRFH2 está incluida en el mensaje. Si el mensaje es un mensaje XML e incluye una cabecera MQRFH2, seleccione esta casilla de verificación y pulse [...]. En el recuadro de diálogo Buscar elemento de tipo de esquema, localice el esquema XML que define la cabecera, seleccione el elemento NameValueData en ese esquema XML, y pulse Aceptar. El fragmento de esquema es el elemento NameValueData y todos sus elementos hijo.
Nota: Para poder seleccionar el esquema XML, tendrá que crearlo y cargarlo antes en el proyecto. Para obtener más información, consulte Definir y cargar un esquema XML para una cabecera MQRFH2.

Reglas de entrega

Campo Descripción
Sondear cambios Especifica la frecuencia con la que el Dispositivo de integración debe sondear la cola en busca de cambios. Para obtener más información, consulte Comportamiento de intervalo de sondeo.
Donde los mensajes tienen ID exclusivos Especifica si los mensajes en la cola tienen ID exclusivos.
Mensajes de entrega Las opciones disponibles aquí dependen de si se ha seleccionado o no la casilla de verificación ID exclusivos. Si se ha seleccionado, las tres opciones estarán disponibles. En caso contrario, sólo se mostrará Una vez como mínimo.
  • Una vez como mínimo: especifica que el mensaje se entrega como mínimo una vez, pero se puede entregar más veces. Los errores en las conexiones o en el Dispositivo de integración pueden hacer que los mensajes se entreguen y procesen varias veces. Esta opción de entrega se utiliza normalmente cuando el sistema receptor puede detectar o tolerar mensajes duplicados.
  • Una vez como máximo: especifica que el mensaje se entrega solo una vez o ninguna. Los errores en las conexiones o en el Dispositivo de integración pueden hacer que los mensajes se pierdan. Esta opción de entrega se utiliza normalmente cuando el sistema receptor no puede tolerar mensajes duplicados,. pero sí mensajes perdidos.
  • Exactamente una vez: especifica que el mensaje se entrega una vez y solo una vez. Los errores en las conexiones o en el Dispositivo de integración no afectan a la entrega con esta opción. El Dispositivo de integración utiliza los ID de mensajes MQ para asegurarse de que todos los mensajes se recuperan y se procesan solo una vez.
    Nota: Si selecciona la opción Exactamente una vez, deberá habilitar la persistencia. Para obtener más información, consulte Habilitar la persistencia.

Opciones de reintento

Configure las opciones de reintento de la actividad Sondear mensaje MQ, como se define en la siguiente tabla:

Opciones de reintento Descripción
1) Esperar __ segundo(s) entre cada reintento. El número de segundos que el Dispositivo de integración espera antes de volver a intentar recuperar mensajes del servidor MQ.
2) Intentar conectar __ veces antes de generar un error. Especifica el número máximo de veces que el Dispositivo de integración intenta recuperar mensajes del servidor MQ antes de producir un error.

Si se despliega una orquestación que comienza con una actividad Sondear cola MQ y el Dispositivo de integración no puede conectarse con el servidor MQ especificado o no puede recuperar mensajes de la cola, el Dispositivo registra los errores de conexión como avisos en el registro del sistema hasta que se alcanza el total de reintentos. Cuando se alcanza el total de reintentos, el Dispositivo de integración registra un error en el registro del sistema, restablece el recuento de reintentos actual a cero y continúa intentando establecer una conexión con el servidor MQ.

Por ejemplo, el usuario establece el recuento de reintentos en 3. El primer, el segundo y el tercer error aparecen en el registro del sistema como avisos. El Dispositivo de integración registra el cuarto error de conexión como un error y restablece el recuento de reintentos actual a cero. Por lo tanto, el quinto error de conexión generará un aviso en el registro del sistema. El Dispositivo de integración continuará intentando recuperar mensajes de la cola.

Correlación de salidas

No es obligatorio correlacionar parámetros de salida para esta actividad. Sin embargo, si correlaciona alguno de estos parámetros, tenga en cuenta los siguientes aspectos:
Parámetros:
  • Los parámetros payload y mqmdheader se obtienen del mensaje que se recibe de la cola.
  • El parámetro rfh2header se obtiene si el esquema de cabecera RFH2 está especificado en la tarea Configurar.