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 o colas 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, o en los destinos identificados en el entorno local (también denominado Lista de destinos) asociados al mensaje.
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 entorno de trabajo con el siguiente icono:
Consulte los ejemplos siguientes para ver cómo puede utilizar este nodo:
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 configura un nodo Compute para crear un nuevo mensaje de salida siempre que cambia el valor de una acción particular y transmite estos a un nodo MQOutput para registrar todos los cambios de precio de esta acción.
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.
Si desea ver más información detallada, consulte los apartados Validar mensajes y Propiedades de validación para mensajes del dominio MRM.
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 procesar adicionalmente el mensaje, procesar errores o enviar el mensaje a un destino adicional.
Si conecta uno de estos terminales de salida a otro nodo en el flujo de mensajes, el entorno local asociado al mensaje se amplía con la siguiente información para cada destino en el que este nodo ha colocado el mensaje:
Estos valores se escriben en WrittenDestination dentro de la estructura de árbol del entorno local.
Si no conecta ninguno de estos dos terminales, el árbol del entorno local no se modifica.
Si utiliza agregación en los flujos de mensajes, debe utilizar los terminales de salida.
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 sincronización 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 hay 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 Lista de destinos, Cola de respuestas y Nombre de cola. |
Modalidad de transacción | Sí | No | Automática | Define si el mensaje se transfiere transaccionalmente. Los valores válidos son Automática, Sí y No. |
Modalidad de persistencia | Sí | No | Automática | Define si el mensaje se transfiere de forma persistente. Los valores válidos son Automática, 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. |
En la tabla siguiente se describen las propiedades de Validación del nodo MQOutput.
Consulte el apartado Propiedades de validación para mensajes del dominio MRM para obtener una descripción completa de estas propiedades.
Propiedad | O | C | Valor por omisión | Descripción |
---|---|---|---|---|
Validar | Sí | Sí | Heredar | Determina si se realiza la validación. Los valores válidos son Ninguno, Contenido y valor, Contenido y Heredar. |
Acción para anomalía | Sí | No | Excepción | Determina qué sucede si falla la validación. Sólo puede establecer esta propiedad si establece Validar en Contenido o Contenido y valor. Los valores válidos son Rastreo de usuario, Anotaciones de error locales, Excepción y Lista de excepciones. |
Incluir todas las limitaciones de valor | Sí | No | Seleccionado | Esta propiedad no se puede editar. La acción por omisión, indicada por el recuadro de selección marcado, es que se incluyan comprobaciones de restricción de valor básicas en la validación de Contenido y valor. |
Arreglo | Sí | No | Ninguno | Esta propiedad no se puede editar. |
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. |