Este tema contiene los apartados siguientes:
Utilice el nodo MQInput para recibir mensajes de clientes que se conectan al intermediario utilizando WebSphere MQ Enterprise Transport y que utilizan las interfaces de programas de aplicación MQI y AMI.
El nodo MQInput recibe la entrada de mensajes de un flujo de mensajes desde una cola de mensajes WebSphere MQ definida en el gestor de colas del intermediario. El nodo utiliza MQGET para leer un mensaje de una cola especificada, y establece el entorno de proceso para el mensaje. Si procede, puede definir la cola de entrada como una cola compartida o en clúster WebSphere MQ.
Los flujos de mensajes que manejan mensajes recibidos a través de conexiones WebSphere MQ siempre se deben iniciar con un nodo MQInput. Puede establecer las propiedades del nodo MQInput para controlar el modo en el que se reciben los mensajes, haciendo que se establezcan las opciones MQGET adecuadas. Por ejemplo, puede indicar que un mensaje se debe procesar bajo el control de transacción. También puede solicitar que se lleve a cabo la conversión de datos en cuanto se reciba cada mensaje de entrada.
El nodo MQInput maneja mensajes en los dominios de mensajes siguientes:
Si incluye un nodo de salida en un flujo de mensajes que se inicia con un nodo MQInput, puede ser cualquiera de los nodos de salida para los que se ofrece soporte (incluidos los nodos de salida definidos por el usuario): no es necesario que incluya un nodo MQOutput. Puede crear un flujo de mensajes que reciba mensajes de clientes WebSphere MQ y genere mensajes para clientes que utilicen todos los transportes para los que se ofrece soporte para conectar al intermediario, puesto que puede configurar el flujo de mensajes de modo que solicite al intermediario que facilite las conversiones necesarias.
Si crea un flujo de mensajes para utilizarlo como un subflujo, no puede utilizar un nodo de entrada estándar; debe utilizar una instancia del nodo Input como primer nodo para crear un terminal de entrada para el subflujo.
Si el flujo de mensajes no recibe mensajes a través de conexiones WebSphere MQ, puede elegir uno de los nodos de entrada que se indican a continuación:
El nodo MQInput se representa en el área de trabajo mediante el icono siguiente:
Consulte los ejemplos siguientes para informarse sobre cómo puede utilizar este nodo:
Como ejemplo sobre cómo utilizar este nodo, suponga que ha escrito una aplicación de publicación que publica actualizaciones de valores con carácter regular. La aplicación envía los mensajes al intermediario de un nodo MQInput, y el flujo de mensajes permite que las publicaciones estén disponibles para varios suscriptores a través del nodo Publication.
Se puede configurar al transferir una instancia del nodo MQInput a un flujo de mensajes. Pulse el botón derecho del ratón en la vista del editor y, a continuación, pulse en Propiedades. En el diálogo de propiedades se muestran las propiedades básicas del nodo.
Todas las propiedades obligatorias para las que no se ha definido ningún valor por omisión se muestran marcadas con un asterisco en el diálogo de propiedades.
Configure el nodo MQInput tal como se indica a continuación:
<mcd><Msd>MRM</Msd><Set>DHM4UO906S001</Set><Type>receiptmsg1</Type> <Fmt>XML</Fmt></mcd>
Si establece valores, y los valores difieren de los de la cabecera MQRFH2, los valores de la cabecera MQRFH2 tienen prioridad.
Deje Conjunto de mensajes en blanco para los analizadores XML, XMLNS, JMS y BLOB.
Deje Tipo de mensaje en blanco para los analizadores XML, XMLNS, JMS y BLOB.
Deje Formato del mensaje en blanco para los analizadores XML, XMLNS, JMS y BLOB.
Si desea ver más información detallada sobre esta opción, consulte el apartado Configuración del nodo para el manejo de grupos de mensajes.
Si deselecciona el recuadro de selección, los mensajes que se envían como parte de un grupo no se reciben en un orden predeterminado. Si un intermediario espera recibir mensajes por grupos y no se ha seleccionado este recuadro de selección, el orden de los mensajes de entrada no es significativo, o bien, se debe designar el flujo de mensajes para que los procese correctamente.
También debe seleccionar el recuadro de selección Confirmar por grupo de mensajes si desea que el proceso de mensajes se confirme únicamente después de recibir y procesar el último mensaje del grupo.
En la publicación WebSphere MQ Application Programming Reference encontrará más información sobre las opciones para las que están disponibles las correlaciones de esta propiedad.
Si desea ver más información detallada sobre esta opción, consulte el apartado Configuración del nodo para el manejo de grupos de mensajes.
En la publicación WebSphere MQ Application Programming Reference encontrará más información sobre las opciones para las que están disponibles las correlaciones de esta propiedad.
Especifique un número par de dígitos hexadecimales (son válidos los caracteres del 0 al 9, de la A a la F y de la a a la f) hasta 48 dígitos, como máximo. Si el ID que especifica tiene una longitud inferior al tamaño del campo IDMsj, se rellena a la derecha con caracteres X'00'. De este modo, se correlaciona con la opción MQMO_MATCH_MSG_ID de MQGMO de la MQI.
Deje esta propiedad en blanco si no desea que el nodo de entrada compruebe si coincide el ID del mensaje.
En la publicación WebSphere MQ Application Programming Reference encontrará más información sobre las opciones para las que están disponibles las correlaciones de esta propiedad.
Especifique un número par de dígitos hexadecimales (son válidos los caracteres del 0 al 9, de la A a la F y de la a a la f) hasta 48 dígitos, como máximo. Si el ID que especifica tiene una longitud inferior al tamaño del campo IDCorrel, se rellena a la derecha con caracteres X'00'. De este modo, se correlaciona con la opción MQMO_MATCH_CORREL_ID de MQGMO de la MQI.
Deje esta propiedad en blanco si no desea que el nodo de entrada compruebe si coincide el ID del mensaje.
En la publicación WebSphere MQ Application Programming Reference encontrará más información sobre las opciones para las que están disponibles las correlaciones de esta propiedad.
WebSphere MQ convierte el mensaje entrante a la codificación y el juego de caracteres codificado especificado en el MQMD que suministra el nodo de entrada en la invocación MQGET para recuperar el mensaje de la cola de entrada. El flujo de mensajes genera todos los mensajes de salida utilizando estos valores y y los transfiere a colas de destino con los valores de Codificación e IDConjCaractCodif establecidos en MQMD.
Esta propiedad se correlaciona con la opción MQGMO_CONVERT de MQGMO de la MQI.
Deseleccione el recuadro de selección si no desea que WebSphere MQ convierta el mensaje.
Si selecciona este recuadro, también debe especificar:
Si no especifica ningún valor, se utiliza el valor del MQMD del mensaje entrante.
Si especifica un valor no válido, no se realiza ninguna conversión.
Si no especifica ningún valor, se utiliza el valor del MQMD del mensaje entrante.
Si especifica un valor no válido, no se realiza ninguna conversión.
Para obtener más información sobre la conversión de datos de WebSphere MQ y la utilización de esta opción, consulte la publicación WebSphere MQ Application Programming Guide. Si desea más información sobre los valores que puede especificar para Convertir codificación y Convertir ID de juego de caracteres codificado, consulte la publicación WebSphere MQ Application Programming Reference.
Esta propiedad sólo es adecuada si se ha seleccionado Orden lógico.
Establezca la propiedad Modalidad de orden en Por orden de cola si los mensajes de un grupo se deben recuperar y procesar en el orden en el que aparecen en la cola.
Los destinos de las anomalías se comportan igual que en el caso de la salida del nodo Trace. Así, si, por ejemplo, selecciona Rastreo de usuario, las entradas de rastreo se escriben sin tener en cuenta el valor del distintivo del rastreo de usuario para el flujo de mensajes.
Pulse el botón en Cancelar para cerrar el diálogo y descartar todos los cambios que ha realizado en las propiedades.
MQInput direcciona cada mensaje que recupera correctamente al terminal de salida. Si no se ejecuta correctamente, se reintenta el mensaje. Si el tiempo de espera de reintento caduca (tal como lo define el atributo BackoutThreshold de la cola de entrada), el mensaje se direcciona al terminal de anomalías; puede conectar nodos a este terminal para manejar esta condición. Si no ha conectado el terminal de anomalías, el mensaje se escribe en la cola de restitución.
Si el nodo capta el mensaje después de emitirse una excepción más adelante en el flujo de mensajes, el mensaje se direcciona al terminal de captación. Si no ha conectado el terminal de captación, el mensaje se repite continuamente en bucle a través del nodo hasta que se resuelve el problema. Debe definir una cola de restitución o una cola de mensajes no entregados (DLQ) a fin de evitar que el mensaje se repita en bucle de forma continuada a través del nodo.
Cuando incluye un nodo MQInput en un flujo de mensajes, el valor que establece para Modalidad de transacción define si los mensajes se deben recibir bajo punto de sincronismo:
(El nodo MQOutput es el único nodo de salida que se puede configurar para alterar temporalmente esta opción).
WebSphere MQ ofrece soporte para grupos de mensajes; puede especificar que un mensaje pertenece a un grupo y que su proceso y el proceso de todos los demás mensajes del grupo se debe manejar como una transacción. Es decir, si el proceso de un mensaje del grupo no se ejecuta correctamente, se restituyen todos los mensajes del grupo. El proceso de mensajes se confirma cuando se procesa correctamente el último mensaje del grupo, sólo si el proceso de todos los mensajes se ha llevado a cabo de forma satisfactoria.
Si incluye mensajes en un grupo, y es importante que todos los mensajes del grupo se lean de la cola y se procesen en el orden en el que se han definido en el grupo, debe llevar a cabo todas las acciones que se indican más abajo:
También debe asegurarse de que ningún otro flujo de mensajes recupere mensajes de la misma cola de entrada. Si fuera así, no existe garantía alguna sobre el orden en el que se procesan los mensajes de un grupo.
Si tiene varios flujos de mensajes, o instancias del mismo flujo de mensajes, que acceden a la misma cola, es posible que observe uno o más de los síntomas siguientes:
Los terminales del nodo MQInput se describen en la tabla siguiente:
Terminal | Descripción |
---|---|
Terminal de anomalías | Terminal de salida al que se direcciona el mensaje si se produce un error. Aunque se haya establecido la propiedad Validación, los mensajes que se propagan a este terminal no se validan. |
Terminal de salida | Terminal de salida al que se direcciona un mensaje si se recupera correctamente de la cola de WebSphere MQ. |
Terminal de captación | Terminal de salida al que se direcciona el mensaje si se emite una excepción en sentido descendente y la captura este nodo. |
En las tablas siguientes se describen las propiedades del nodo; la columna que tiene el encabezamiento M indica si se trata de una propiedad obligatoria (marcada con un asterisco en el diálogo de propiedades si se debe especificar un valor cuando no se ha definido ningún valor por omisión), la columna que tiene el encabezamiento C indica que se trata de una propiedad configurable (se puede cambiar el valor cuando se añade el flujo de mensajes al archivo bar para su difusión).
Las propiedades básicas del nodo MQInput se describen en la tabla siguiente:
Propiedad | M | C | Valor por omisión | Descripción |
---|---|---|---|---|
Nombre de cola | Sí | Sí | Nombre de la cola de entrada de WebSphere MQ desde la que el nodo recupera mensajes (utilizando MQGET) para que los procese el flujo de mensajes. |
Las propiedades por omisión del nodo MQInput se describen en la tabla siguiente:
Propiedad | M | C | Valor por omisión | Descripción |
---|---|---|---|---|
Dominio del mensaje | No | No | Dominio del mensaje entrante. | |
Conjunto de mensajes | No | No | Conjunto de mensajes del mensaje entrante. | |
Tipo de mensaje | No | No | Tipo del mensaje entrante. | |
Formato del mensaje | No | No | Formato del mensaje entrante. | |
Tema | No | Sí | Tema por omisión para el mensaje de entrada. |
Las propiedades avanzadas del nodo MQInput se describen en la tabla siguiente:
Propiedad | M | C | Valor por omisión | Descripción |
---|---|---|---|---|
Modalidad de transacción | Sí | No | Sí | Si el mensaje entrante se recibe bajo punto de sincronismo. Los valores válidos son Automático, Sí y No. |
Modalidad de orden | Sí | No | Valor por omisión | Orden en el que se recuperan los mensajes de la cola de entrada y se procesan. Los valores válidos son Valor por omisión, Por ID de usuario y Por orden de cola. |
Orden lógico | Sí | No | Seleccionado | Si los mensajes se reciben en orden lógico, tal como define WebSphere MQ. Si selecciona el recuadro de selección, se realiza esta acción. |
Todos los mensajes disponibles | Sí | No | Deseleccionado | Si selecciona el recuadro de selección, todos los mensajes de un grupo deben estar disponibles para que se pueda recuperar un mensaje. |
Coincidir con el ID del mensaje | No | No | Un ID de mensaje que debe coincidir con el ID de mensaje de MQMD del mensaje entrante. | |
Coincidir con el ID de correlación | No | No | Un ID de correlación que debe coincidir con el ID de correlación de MQMD del mensaje entrante. | |
Convertir | Sí | No | Deseleccionado | Si WebSphere MQ convierte datos del mensaje que se va a recibir, conforme a los valores de IDConjCaractCodif y Codificación establecidos en MQMD. Si selecciona el recuadro de selección, se realiza esta acción. |
Convertir codificación | No | No | Representación utilizada para valores numéricos en los datos del mensaje, expresada como un valor de entero. Esta propiedad sólo es válida si se ha seleccionado el recuadro de selección Convertir. | |
Convertir ID de juego de caracteres codificado | No | No | Identificador de juego de caracteres codificado de datos de caracteres en los datos del mensaje, expresado como un valor de entero. Esta propiedad sólo es válida si se ha seleccionado el recuadro de selección Convertir. | |
Confirmar por grupo de mensajes | Sí | No | Deseleccionado | Cuando se confirma una transacción al procesar mensajes que forman parte de un grupo de mensajes. Si selecciona el recuadro de selección, la transacción se confirma una vez que se ha procesado el grupo de mensajes. |
Las propiedades de validación del nodo MQInput se describen en la tabla siguiente:
Propiedad | M | C | Valor por omisión | Descripción |
---|---|---|---|---|
Validar | Sí | No | Ninguna | Si debe llevarse a cabo la validación. Los valores válidos son Ninguna y Contenido y valor. |
Acción por anomalía | Sí | No | Excepción | Lo que sucede si la validación da error. Sólo puede establecer esta propiedad si establece Validar en Contenido y valor. Los valores válidos son Rastreo de usuario, Anotaciones de error locales y Excepción. |
Cronometraje | Sí | No | Diferido | Cuando se produce la validación. Sólo puede establecer esta propiedad si establece Validar en Contenido y valor. Los valores válidos son Diferido, Inmediato y Completo. |
Incluir todas las limitaciones de valores | Sí | No | Seleccionado | Esta propiedad no se puede editar. La acción por omisión, indicada si el recuadro de selección está seleccionado, es que se incluyan todas las limitaciones de valores en la validación. |
Arreglo | Sí | No | Ninguno | Esta propiedad no se puede editar. Se proporciona el arreglo mínimo. |
Las propiedades de descripción del nodo MQInput se describen en la tabla siguiente:
Propiedad | M | 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 la finalidad del nodo en el flujo de mensajes. |
Conceptos relacionados
WebSphere MQ Enterprise Transport
Flujos de mensajes
Extensiones definidas por el usuario
Tipos
Difusión de aplicaciones de flujos de mensajes
Tareas relacionadas
Cómo decidir los nodos que utilizar
Utilización de más de un nodo de entrada
Configuración de flujos de mensajes coordinados
Manejo de errores en flujos de mensajes
Utilización de colas de clúster WebSphere MQ para entrada y salida
Utilización de colas compartidas de WebSphere MQ para entrada y salida (z/OS)
Validación de mensajes
Definición de las limitaciones de valores
Edición de propiedades configurables
Referencia relacionada
WebSphere MQ Enterprise Transport
Nodo HTTPInput
Nodo HTTPReply
Nodo Input
Nodo MQeInput
Nodo MQeOutput
Nodo MQOutput
Nodo MQReply
Nodo Real-timeInput
Nodo Real-timeOptimizedFlow
Nodo SCADAInput
Nodo SCADAOutput
Avisos |
Marcas registradas |
Descargas |
Biblioteca |
Soporte |
Información de retorno (feedback)
![]() ![]() |
ac04560_ |