Este tema contiene las secciones siguientes:
Utilice el nodo MQOutput para enviar mensajes a clientes que se conectan al intermediario utilizando WebSphere MQ Enterprise Transport y que utilizan las interfaces de programación de aplicaciones MQI y AMI.
El nodo MQOutput entrega un mensaje de salida de un flujo de mensajes a una cola de WebSphere MQ. El nodo utiliza MQPUT para colocar el mensaje en la cola de destino que especifique.
Si es adecuado, puede definir la cola como una cola compartida o una cola de clúster de WebSphere MQ. Cuando utilice una cola de clúster de WebSphere MQ, deje el nombre del gestor de colas en blanco.
Puede configurar el nodo MQOutput para que coloque un mensaje en una cola específica de WebSphere MQ definida en cualquier gestor de colas al que pueda acceder el gestor de colas del intermediario.
Puede establecer otras propiedades para controlar la forma en que se envían los mensajes, definiendo las opciones adecuadas de MQPUT. Por ejemplo, puede solicitar que un mensaje se procese bajo control de transacciones. También puede especificar que WebSphere MQ pueda, si es adecuado, dividir el mensaje en segmentos en el gestor de colas.
Si crea un flujo de mensajes para utilizarlo como subflujo, no puede utilizar un nodo de salida estándar, debe utilizar una instancia del nodo Output para crear un terminal de salida del subflujo, a través del cual propagar el mensaje.
Si no desea que el flujo de mensajes envíe mensajes a una cola de WebSphere MQ, puede elegir otro nodo de salida soportado.
El nodo MQOutput se representa en el área de trabajo con el siguiente icono:
Para obtener un ejemplo sobre cómo utilizar este nodo, supongamos que ha escrito una aplicación de publicación que publica actualizaciones de acciones de forma regular. La aplicación envía los mensajes al intermediario en un nodo MQInput y el flujo de mensajes pone las publicaciones a disposición de los diversos suscriptores, a través de un nodo Publication. Luego, usted incluye un nodo MQOutput para enviar el mensaje a una aplicación que registra cada cambio de precio que se produce.
Una vez ha puesto una instancia del nodo MQOutput en un flujo de mensajes, puede configurarlo. Pulse el botón derecho del ratón en el nodo en la vista de editor y pulse Propiedades. Aparecen las propiedades básicas del nodo.
Todas las propiedades obligatorias para las que ha de entrar un valor (las que no tienen definido un valor por omisión) aparecen con un asterisco en el diálogo de propiedades.
Configure el nodo MQOutput de la manera siguiente:
Deseleccione el recuadro si no desea generar un nuevo ID. Tenga en cuenta que se generará de todas formas un nuevo ID de mensajes si selecciona el recuadro de selección Petición en el panel Petición del diálogo de propiedades.
En el manual WebSphere MQApplication Programming Reference encontrará más información sobre las opciones con las que está correlacionada esta propiedad.
En el manual WebSphere MQApplication Programming Reference encontrará más información sobre las opciones con las que está correlacionada esta propiedad.
En el manual WebSphere MQApplication Programming Reference encontrará más información sobre las opciones con las que está correlacionada esta propiedad.
En el manual WebSphere MQApplication Programming Reference encontrará más información sobre las opciones con las que están correlacionadas estas propiedades.
Tenga en cuenta que se generará un nuevo identificador de mensaje aunque no se marque el recuadro de selección Nuevo ID de mensaje en el panel Avanzado del navegador del diálogo de propiedades.
Pulse Cancelar para cerrar el diálogo y descartar todos los cambios que ha efectuado en las propiedades.
Conecte el terminal de entrada al nodo desde el que se direccionan los mensajes de salida.
Conecte el terminal de salida o el terminal de anomalías de este nodo a otro nodo de este flujo de mensajes si desea enviar el mensaje a un destino adicional.
Cuando se define un nodo MQOutput, la opción seleccionada para la propiedad Modalidad de transacción indica si el mensaje se graba bajo punto de sincronismo o no:
Otra propiedad del nodo MQOutput, Modalidad de persistencia, indica si el mensaje de salida se marca como persistente cuando se transfiere a la cola de salida:
Los terminales del nodo MQOutput se describen en la siguiente tabla.
Terminal | Descripción |
---|---|
In (de entrada) | El terminal de entrada que acepta un mensaje para que lo procese el nodo. |
Failure (de anomalías) | El terminal de salida al que se direcciona el mensaje si se detecta una anomalía al transferir el mensaje a la cola de salida. |
Out (de salida) | El terminal de salida al que se direcciona el mensaje si se ha colocado satisfactoriamente en la cola de salida y se requiere proceso adicional dentro del flujo de mensajes. |
Las tablas siguientes describen las propiedades del nodo; la columna con la cabecera O indica si la propiedad es obligatoria (marcada con un asterisco en el diálogo de propiedades si tiene que entrar un valor cuando no está definido ningún valor por omisión), la columna con la cabecera C indica si la propiedad es configurable (puede cambiar el valor cuando añade el flujo de mensajes al archivo bar para desplegarlo).
Las propiedades básicas del nodo MQOutput se describen en la siguiente tabla.
Propiedad | O | C | Valor por omisión | Descripción |
---|---|---|---|---|
Nombre del gestor de colas | No | Sí | El nombre del gestor de colas de WebSphere MQ para el que se define la cola de salida, especificada en Nombre de cola. | |
Nombre de cola | No | Sí | El nombre de la cola de salida de WebSphere MQ en el que este nodo coloca mensajes (utilizando MQPUT). |
Las propiedades avanzadas del nodo MQOutput se describen en la siguiente tabla.
Propiedad | O | C | Valor por omisión | Descripción |
---|---|---|---|---|
Modalidad de destino | Sí | No | Nombre de cola | Las colas a las que se envía el mensaje de salida. Los valores válidos son , Cola de respuestas y Nombre de cola. |
Modalidad de transacción | Sí | No | Automático | Define si el mensaje se transfiere transaccionalmente. Los valores válidos son Automático, Sí y No. |
Modalidad de persistencia | Sí | No | Automático | Define si el mensaje se transfiere de forma persistente. Los valores válidos son Automático, Sí, No y Según lo definido para la cola. |
Nuevo ID de mensaje | Sí | No | No seleccionado | Especifica si WebSphere MQ genera un nuevo identificador de mensaje para sustituir el contenido del campo MsgId de MQMD. Si selecciona el recuadro, se realizará esta acción. |
Nuevo ID correlación | Sí | No | No seleccionado | Especifica si WebSphere MQ genera un nuevo identificador de correlación para sustituir el contenido del campo CorrelId de MQMD. Si selecciona el recuadro, se realizará esta acción. |
Segmentación permitida | Sí | No | No seleccionado | Si resulta adecuado, WebSphere MQ divide el mensaje en segmentos en el gestor de colas. Si selecciona el recuadro, se realizará esta acción. |
Contexto del mensaje | Sí | No | Pasar todo | Indica cómo manejar el contexto de origen. Los valores válidos son Pasar todo, Pasar identidad, Definir todo, Definir identidad y Valor por omisión. |
Autorización de usuario alternativo | Sí | No | No seleccionado | Indica si se utiliza la autorización alternativa cuando se transfiere el mensaje de salida. Si selecciona el recuadro, se realizará esta acción. |
Las propiedades de petición del nodo MQOutput se describen en la siguiente tabla.
Propiedad | O | C | Valor por omisión | Descripción |
---|---|---|---|---|
Petición | Sí | No | No seleccionado | Indica si debe generarse cada mensaje de salida como un mensaje de petición. Si selecciona el recuadro, se realizará esta acción. |
Gestor de colas de respuestas | No | Sí | Nombre del gestor de colas WebSphere MQ en el que se define la cola de salida, especificada en Cola de respuestas. | |
Cola de respuestas | No | Sí | Nombre de la cola de WebSphere MQ en la que se debe poner una respuesta a esta petición. |
Las propiedades de descripción del nodo MQOutput se describen en la siguiente tabla.
Propiedad | O | C | Valor por omisión | Descripción |
---|---|---|---|---|
Descripción corta | No | No | Descripción breve del nodo. | |
Descripción larga | No | No | Texto que describe el propósito del nodo en el flujo de mensajes. |