Utilice el nodo MQOutput para enviar mensajes a clientes que se conecten con el intermediario utilizando WebSphere MQ Enterprise Transport y que utilicen las interfaces de programación de aplicaciones MQI y AMI.
Este tema contiene las secciones siguientes:
El nodo MQOutput entrega un mensaje de salida de un flujo de mensajes a una cola WebSphere MQ. El nodo utiliza MQPUT para colocar el mensaje en la cola o colas de destino que especifique.
Si es adecuado, defina 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 vacío el Nombre de gestor de colas.
Puede configurar el nodo MQOutput que transfiera un mensaje a una cola WebSphere MQ específica definida en cualquier gestor de colas al que pueda acceder el gestor de colas del intermediario, o a los destinos identificados en el entorno local (también llamado lista de destinos) asociado al mensaje.
Establezca 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 transacción. 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 podrá utilizar un nodo de salida estándar; utilice una instancia del nodo Output para crear un terminal de salida para el 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, elija otro nodo de salida soportado.
El nodo MQOutput se encuentra en la bandeja de WebSphere MQ de la paleta y está representado en el entorno de trabajo con el siguiente icono:
Consulte los ejemplos siguientes para ver cómo se debe utilizar este nodo:
Los ejemplos sólo pueden verse cuando se utiliza el centro de información que está integrado en el Kit de herramientas de Message Brokers.
Por ejemplo, para utilizar este nodo, suponga que ha escrito una aplicación de publicación para publicar actualizaciones de unas acciones regularmente. 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 múltiples suscriptores a través del un nodo Publication. Por lo tanto, usted configura un nodo Compute para crear un nuevo mensaje de salida cada vez que cambia el valor de una acción determinada y conecta dicho nodo a un nodo MQOutput para registrar todos los cambios de precio de dicha acción.
Cuando haya colocado una instancia del nodo MQOutput en un flujo de mensajes, podrá configurarlo; consulte el apartado Configurar un nodo de flujo de mensajes. Las propiedades del nodo se visualizan en la vista Propiedades. Para visualizar las propiedades del nodo, efectúe una doble pulsación en el nodo o pulse con el botón derecho del ratón sobre el nodo y pulse Propiedades.
Todas las propiedades obligatorias para las que debe especificar un valor (las que no tienen un valor predeterminado definido) están marcadas con un asterisco.
Configure el nodo MQOutput.
Cuando se selecciona esta opción, el nodo MQOutput construye un mensaje de respuesta WebSphere MQ. Consulte Contenido del mensaje de respuesta de WebSphere MQ para obtener más información sobre los valores utilizados por el nodo MQOutput y la carpeta Root.MQMD en esta situación.
Deseleccione el recuadro si no desea generar un nuevo ID. Se generará de todas formas un nuevo ID de mensaje si selecciona Petición en el separador Petición.
Puede ver más información sobre las opciones relacionadas con esta propiedad en la publicación Application Programming Reference de Centro de información en línea de WebSphere MQ Versión 6, o en la publicación de la Versión 5.3 del página web de la biblioteca de WebSphere MQ
Puede ver más información sobre las opciones relacionadas con esta propiedad en la publicación Application Programming Reference de Centro de información en línea de WebSphere MQ Versión 6, o en la publicación de la Versión 5.3 del página web de la biblioteca de WebSphere MQ
Puede ver más información sobre las opciones relacionadas con esta propiedad en la publicación Application Programming Reference de Centro de información en línea de WebSphere MQ Versión 6, o en la publicación de la Versión 5.3 del página web de la biblioteca de WebSphere MQ
Puede ver más información sobre las opciones relacionadas con estas propiedades en la publicación Application Programming Reference de Centro de información en línea de WebSphere MQ Versión 6, o en la publicación de la Versión 5.3 del página web de la biblioteca de WebSphere MQ
Se generará un nuevo identificador de mensaje aunque el recuadro Nuevo ID de mensaje no esté seleccionado en el separador Avanzadas.
Si desea ver información más detallada, consulte los apartados Validar mensajes y Propiedades de validación.
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 para procesar adicionalmente el mensaje, procesar errores o enviar el mensaje a un destino adicional.
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.
MQMD.Report = 0; MQMD.PutApplType = MQAT_BROKER; MQMD.PutDate = Taken from current Timestamp MQMD.PutTime = Taken from current Timestamp MQMD.PutApplName = MsgTree.MQMD.ReplyToQMgr (first 28 chars)
MQMD.Version MQMD.Format MQMD.Priority MQMD.Persistence MQMD.Expiry MQMD.Encoding MQMD.CodedCharSetId MQMD.GroupId MQMD.MsgSeqNumber MQMD.Offset MQMD.MsgFlags MQMD.OriginalLength
IF MsgTree.MQMD.MsgType = MQMT_REQUEST THEN MQMD.MsgType = MQMT_REPLY; IF Nodes Message Context is Default, PassAll or PassIdentity THEN MQMD.UserIdentifer = MsgTree.MQMD.UserIdentifier; IF MsgTree.MQMD.Report contains MQRO_PASS_CORREL_ID THEN MQMD.CorrelId = MsgTree.MQMD.CorrelId; ELSE MQMD.CorrelId = MsgTree.MQMD.MsgId; IF MsgTree.MQMD.Report contains MQRO_PASS_MSG_ID THEN MQMD.MsgId = MsgTree.MQMD.MsgId; ELSE MQMD.MsgId = MQMI_NONE;
Cuando la estructura MQMD de salida se ha construido, el Message Context del nodo MQOutput se omite y el comportamiento es set All.
Los valores que se alteran temporalmente, sólo lo hacen en la estructura MQMD de salida; no se realiza ninguna actualización en la carpeta MQMD del árbol de mensajes.
Los terminales del nodo MQOutput están descritos 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 de nodo. La columna con la cabecera O indica si la propiedad es obligatoria (marcada con un asterisco si tiene que entrar un valor cuando no hay definido ningún valor predeterminado); 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 de descripción del nodo MQOutput están descritas en la siguiente tabla.
Propiedad | O | C | Valor por omisión | Descripción |
---|---|---|---|---|
Nombre de nodo | No | No | El tipo de nodo, MQOutput | El nombre del nodo. |
Descripción corta | No | No | Descripción breve del nodo. | |
Descripción larga | No | No | Texto que describe la finalidad del nodo en el flujo de mensajes. |
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 están descritas 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 | Esta propiedad controla si el mensaje se transfiere transaccionalmente. Los valores válidos son Automática, Sí y No. |
Modalidad de persistencia | Sí | No | Automática | Esta propiedad controla si el mensaje se transfiere persistentemente. 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 | Si selecciona este recuadro, WebSphere MQ genera un nuevo identificador de mensaje para sustituir el contenido del campo MsgId de MQMD. |
Nuevo ID correlación | Sí | No | No seleccionado | Si selecciona este recuadro, WebSphere MQ genera un nuevo identificador de correlación para sustituir el contenido del campo CorrelId de MQMD. |
Segmentación permitida | Sí | No | No seleccionado | Si selecciona este recuadro, WebSphere MQ divide el mensaje en segmentos en el gestor de colas. |
Contexto del mensaje | Sí | No | Pasar todo | Esta propiedad controla cómo se maneja el contexto de origen. Los valores válidos son Pasar todo, Pasar identidad, Definir todo, Definir identidad y Valor predeterminado. |
Autorización de usuario alternativo | Sí | No | No seleccionado | Si selecciona este recuadro, se utiliza la autorización alternativa cuando se transfiere el mensaje de salida. |
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 | Si selecciona el recuadro, cada mensaje de salida se genera como un mensaje de petición. |
Gestor de colas de respuestas | No | Sí | El nombre del gestor de colas de WebSphere MQ para 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 validación del nodo MQOutput se describen en la siguiente tabla.
Para ver la descripción completa de estas propiedades, consulte Propiedades de validación.
Propiedad | O | C | Valor por omisión | Descripción |
---|---|---|---|---|
Validar | No | Sí | Heredar | Esta propiedad controla si tiene lugar la validación. Los valores válidos son Ninguno, Contenido y valor, Contenido y Heredar. |
Acción para anomalía | No | No | Excepción | Esta propiedad controla 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. Si selecciona el recuadro de selección, se incluirán las comprobaciones de restricción de valor básicas en la validación de Contenido y valor. |
Arreglo | Sí | No | Ninguna | Esta propiedad no se puede editar. |