Utilice la actividad Obtener mensaje MQ para recuperar mensajes de una cola MQ durante el tiempo de ejecución.
Tras completar las tareas Configurar, lleve a cabo las tareas Correlacionar entradas y Correlación de salidas de la actividad.
Campo | Descripción |
---|---|
Nombre de cola * | Especifica el nombre de la cola MQ de donde intenta recuperar el mensaje el Dispositivo de integración. |
Tiempo de espera | El número de segundos para que se produzca un exceso del tiempo de espera entre la solicitud de la actividad Obtener mensaje MQ para
recuperar un mensaje de la cola y el tiempo que tarda el mensaje en devolverse.
Si este tiempo de espera se agota y la cola no devuelve ningún mensaje,
el Dispositivo de integración espera el intervalo de tiempo especificado antes de
volver a intentar recuperar un mensaje. Para obtener una explicación detallada de los tiempos de espera y las opciones de reintento, consulte Opciones de tiempo de espera y de reintento. Para especificar el número de segundos que el Dispositivo de integración debe esperar antes de emitir un aviso de tiempo de espera excedido, seleccione la opción Después y especifique el número de segundos en el campo Segundos. De forma predeterminada, se encuentra seleccionada la opción Nunca; esta opción especifica que el Dispositivo de integración espera de forma indefinida a recuperar el mensaje de la cola; no hay ningún periodo de tiempo de espera. |
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 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.
|
Campo | Descripción |
---|---|
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.
|
Donde los mensajes tienen ID exclusivos | Especifica si los mensajes en la cola tienen ID exclusivos. |
Configure las opciones de reintento para obtener un mensaje de la cola MQ, como se describe en la siguiente tabla:
Opciones de reintento | Descripción |
---|---|
1) Esperar ___ segundos entre cada reintento. | El número de segundos que el Dispositivo de integración espera antes de intentar recuperar un mensaje de la cola. Para obtener más información sobre cómo se relaciona esta opción con el campo Tiempo de espera en el panel Configurar o el parámetro de entrada timeout, consulte Opciones de tiempo de espera y de reintento. |
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 un mensaje de la cola antes
de emitir un error y detener el proceso del trabajo de orquestación actual. Si se despliega una orquestación que contiene una actividad Obtener mensaje MQ y el Dispositivo de integración no puede conectarse con el servidor MQ especificado, o no puede obtener un mensaje de la cola, el Dispositivo registra los errores de conexión como avisos en los registros del sistema y la orquestación hasta que se alcanza el total de reintentos. Cuando se alcanza el recuento de reintentos, el Dispositivo de integración registra un error en el sistema y en los registros de orquestación y detiene el proceso del trabajo de orquestación actual. 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 como un error y detiene el proceso del trabajo de orquestación actual. Para obtener más información sobre cómo se relaciona esta opción con el campo Tiempo de espera en el panel Configurar o el parámetro de entrada timeout, consulte Opciones de tiempo de espera y de reintento. |
Los parámetros de entrada de la actividad se mostrarán en el panel A actividad.
Durante el tiempo de ejecución, la actividad se repite de manera secuencial a través de los mensajes en la cola. Si no se establece ninguna correlación con estos nodos, no hay ninguna limitación; por lo tanto, la actividad Obtener mensaje MQ devuelve el primer mensaje en la cola y se procesa la siguiente actividad en la orquestación.
Si se establece una correlación para alguno de estos nodos, durante el tiempo de ejecución la actividad Obtener mensaje MQ se repite a través de cada mensaje en la cola hasta que encuentra el primer mensaje que coincide con los valores de tiempo de ejecución de todos los nodos correlacionados. La actividad Obtener mensaje MQ devuelve el primer mensaje coincidente y se procesa la siguiente actividad en la orquestación.
También puede, opcionalmente, sustituir los valores que ha especificado para el Nombre de cola y el Tiempo de espera en la tarea Configurar de la Lista de comprobación dinámicamente durante el tiempo de ejecución, utilizando los parámetros de entrada definidos en la siguiente tabla.
Por ejemplo, el nombre de la cola MQ se puede establecer en la tarea Configurar como poqueue. Durante el tiempo de ejecución, el nombre de la cola MQ newqueue puede pasarse a la actividad utilizando el parámetro de entrada queuename. El nombre de cola especificado dinámicamente durante el tiempo de ejecución sustituye a la configuración original especificada en el panel Configurar. En este ejemplo, el Dispositivo de integración busca mensajes en la cola MQ denominada newqueue.
Nombre de parámetro de entrada/nodo | Descripción | ¿Sustituye la configuración en la tarea? |
---|---|---|
timeout | Especifica el intervalo de tiempo que el Dispositivo de integración
espera tras solicitar recuperar un mensaje de la cola antes de volver a
intentarlo. Especifique un número negativo para no especificar ningún tiempo de espera; el Dispositivo de integración esperará indefinidamente para obtener un mensaje de la cola. La especificación de un número negativo equivale a establecer la opción Nunca en la tarea Configurar. |
El parámetro de entrada timeout sustituye el campo Tiempo de espera de la tarea Configurar. |
queuename | Especifica el nombre de la cola MQ donde el Dispositivo de integración busca mensajes. | El parámetro de entrada queuename sustituye la codificación especificada en el campo Nombre de cola de la tarea Configurar. |
Consulte Crear una correlación para obtener instrucciones generales sobre las correlaciones.
No es obligatorio correlacionar los parámetros de salida de esta actividad. Consulte Crear una correlación para obtener instrucciones generales sobre las correlaciones.
El tiempo de espera especificado en el campo Tiempo de espera de la tarea Configurar o el parámetro de entrada timeout especifica el número de segundos para que se produzca un exceso del tiempo de espera entre la solicitud de la actividad Obtener mensaje MQ para recuperar un mensaje de la cola y el tiempo que tarda el mensaje en devolverse. Si este tiempo de espera se agota y la cola no devuelve ningún mensaje, el Dispositivo de integración espera el intervalo de tiempo especificado en la opción 1) Esperar __ segundo(s) entre cada reintento antes de volver a intentar recuperar un mensaje. El Dispositivo de integración intenta obtener el mensaje hasta que se alcanza el total de reintentos especificado. El total de reintentos se especifica en la opción 2) Intentar conectar __ veces antes de generar un error. Las opciones 1) Esperar __ segundo(s) entre cada reintento y 2) Intentar conectar __ veces antes de generar un error se especifican en la tarea Opciones de reintento.