Actividad Poner mensaje MQ

Utilice la actividad Poner mensaje MQ para enviar un mensaje a la cola especificada 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 Correlacionar entradas 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 usando 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 donde se ponen los mensajes.
Tipo de datos de carga útil Especifica el tipo de datos de la carga útil del mensaje: binario o serie.
Tipo de mensaje Datagrama: seleccione esta opción si se debe enviar el mensaje y no se necesita ninguna respuesta.

Solicitud: seleccione esta opción si el mensaje debe tener una respuesta. Asegúrese de establecer la propiedad Responder a cola para los mensajes de solicitud.

Respuesta: seleccione si el mensaje es una respuesta a una solicitud anterior.

Responder a cola Especifica la cola a la que se debe enviar la respuesta para los mensajes de solicitud.
Responder a gestor de colas Especifica el nombre del gestor de colas al que pertenece la cola (especificado en el campo Responder a cola.
Persistente
  • True: los mensajes se restauran en las colas si se queda colgado el gestor de colas.
  • False: pueden perderse los mensajes de la cola si se cuelga el gestor de colas.
  • Predeterminado: los mensajes usan la configuración de persistencia de la cola (este es el valor predeterminado).
Prioridad Especifica la prioridad del mensaje.  La prioridad de mensaje adopta de forma predeterminada la prioridad predeterminada de la cola. Si la cola utiliza prioridades para ordenar mensajes y este mensaje debe tener una prioridad establecida, seleccione Especificar e indique la prioridad. Las prioridades van del 1 (la más baja) al 9 (la más alta).
Nota: La prioridad no debe superar la prioridad máxima establecida para la cola MQ. Consulte a su administrador del sistema MQ esta información.
Caducidad del mensaje El número de segundos que se conservan los mensajes en la cola antes de caducar. El valor predeterminado es Nunca, lo que garantiza que se entregará el mensaje y esperará en la cola hasta que se recupere, independientemente del tiempo que lleve.

Si los mensajes de esta cola deben caducar y descartarse transcurrido un cierto periodo de tiempo, seleccione Especificar e indique el número máximo de segundos que debe mantenerse el mensaje en la cola.

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
Mensajes de entrega Estas son las opciones disponibles:
  • 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.

Opciones de reintento

Configure las opciones de reintento para conectarse a un servidor MQ. En la siguiente tabla se describen las opciones de reintento para conectarse a un servidor MQ:

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 ponerse en contacto con el gestor de colas para enviar un mensaje al 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 ponerse en contacto con el gestor de colas para enviar un mensaje al servidor MQ 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 Poner mensaje MQ y el Dispositivo de integración no puede conectarse con el gestor de colas del servidor MQ especificado, el Dispositivo registra los errores 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 de conexión 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.

Correlacionar entradas

No es obligatorio correlacionar parámetros de entrada para esta actividad. El siguiente parámetro es necesario y debe correlacionarse para que la configuración esté completa. Los demás parámetros son opcionales. Consulte Crear una correlación para obtener más información.
Parámetros de entrada necesarios:
payload

Para ver los parámetros de entrada opcionales en el panel A actividad del panel Correlacionar entradas, seleccione Correlación > Mostrar parámetros opcionales en el menú de la barra de herramientas o pulse con el botón derecho del ratón en el panel A actividad y seleccione la opción Mostrar parámetros opcionales. Si no se puede seleccionar la opción Correlación > Mostrar parámetros opcionales en el menú de la barra de herramientas, pulse sobre un nodo del panel Correlacionar entradas para activar esta opción.