Este tema contiene los apartados siguientes:
Utilice el nodo MQeInput para recibir mensajes de clientes que se conectan al intermediario utilizando el protocolo WebSphere MQ Mobile Transport.
El nodo MQeInput recibe mensajes que se han transferido a un flujo de mensajes de una cola puente especificada a un gestor de colas WebSphere MQ Everyplace del intermediario. El nodo también establece el entorno de proceso para los mensajes. Debe crear y configurar el flujo de mensajes WebSphere MQ Everyplace antes de difundir un flujo de mensajes que contenga este nodo.
Los flujos de mensajes que manejan mensajes recibidos a través de conexiones WebSphere MQ Everyplace siempre se deben iniciar con un nodo MQeInput. Puede establecer las propiedades del nodo MQeInput para controlar el modo en el que se reciben los mensajes, por ejemplo, puede indicar que un mensaje se debe procesar bajo control de transacción.
Cuando difunde flujos de mensajes que contienen nodos WebSphere MQ Everyplace a un intermediario, debe difundirlos a un único grupo de ejecución, sin tener en cuenta el número de flujos de mensajes. Todos los nodos WebSphere MQ Everyplace de los flujos deben especificar el mismo nombre de gestor de colas WebSphere MQ Everyplace. Si no se cumple esta restricción, se emite un error durante la difusión.
Si incluye un nodo de salida en un flujo de mensajes que se inicia con un nodo MQeInput, puede ser cualquiera de los nodos de salida para los que se ofrece soporte : no es necesario que incluya el nodo MQeOutput. Puede crear un flujo de mensajes que reciba mensajes de clientes WebSphere MQ Everyplace 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.
WebSphere Business Integration Event Broker utiliza WebSphere MQ Everyplace Versión 1.2.6, siendo compatible con versiones posteriores de WebSphere MQ Everyplace. Los clientes que utilizan versiones posteriores de WebSphere MQ Everyplace, por ejemplo, la Versión 2.0, funcionan correctamente cuando se conectan a este nodo, aunque las funciones adicionales para las que no se ofrece soporte en la Versión 1.2.6 (por ejemplo, soporte JMS) no funcionan.
Los gestores de colas no se pueden intercambiar entre versiones diferentes de WebSphere MQ Everyplace. Los nodos deben utilizar un gestor de colas que se haya creado utilizando la Versión 1.2.6. Del mismo modo, el cliente debe utilizar su nivel de código al crear un gestor de colas.
No puede utilizar nodos MQeInput en flujos de mensajes que se van a difundir a sistemas z/OS.
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 MQeInput se representa en el área de trabajo mediante el icono siguiente:
Como ejemplo sobre cómo se puede utilizar este nodo, suponga que un agricultor inspecciona sus campos para comprobar si se riegan correctamente. Lleva consigo un dispositivo PDA con WebSphere MQ Everyplace instalado. Observa que un área del campo precisa agua, de modo que, utilizando el PDA y un enlace de navegación global por satélite (Global Satellite Navigation), envía un mensaje a un nodo MQeInput. mensaje de modo que el dispositivo SCADA remoto pueda recoger el mensaje y activar los aspersores de riego. El agricultor puede ver cómo se riega el campo minutos después de enviar el mensaje.
Puede obtener información detallada sobre WebSphere MQ Everyplace y las propiedades del nodo, en la documentación de WebSphere MQ Everyplace que se facilita en la página Web de WebSphere MQ.
Se puede configurar al transferir una instancia del nodo MQeInput 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. Las propiedades por omisión del nodo se muestran en el diálogo de propiedades.
Todas las propiedades obligatorias para las que debe entrar un valor (las que no tienen un valor por omisión definido) se muestran marcadas con un asterisco en el diálogo de propiedades.
Configure el nodo MQeInput tal como se indica a continuación:
Si establece el nivel de rastreo en Depurar o Completo, puede afectar al rendimiento de WebSphere MQ Everyplace, además de generar archivos de rastreo de gran tamaño. Utilice estas opciones sólo durante períodos breves de tiempo.
Si selecciona el recuadro de selección, la definición de todas las propiedades se extrae del archivo que se identifica en Nombre archivo config. (descrito más abajo) excepto en los casos siguientes:
Sólo se ofrece soporte para un gestor de colas de WebSphere MQ Everyplace. Sólo un grupo de ejecución puede contener nodos MQeInput o MQeOutput. Por consiguiente, esta propiedad se debe establecer en el mismo valor en cada uno de los nodos MQeInput incluidos en todos los flujos de mensajes que se difunden al mismo intermediario.
Puesto que los canales son entidades lógicas permanentes cuya duración es superior a la de una sola petición del gestor de colas, y pueden perdurar a interrupciones de la red, es posible que sea necesario que se exceda el tiempo de espera de los canales que han estado inactivos durante un período de tiempo determinado.
Pulse el botón en Cancelar para cerrar el diálogo y descartar todos los cambios que ha realizado en las propiedades.
MQeInput 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 MQeInput en un flujo de mensajes, el valor que se establece para la propiedad 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).
Los terminales del nodo MQeInput 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. |
Terminal de salida | Terminal de salida al que se direcciona un mensaje si se recupera correctamente de la cola de WebSphere MQ Everyplace. |
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 generales del nodo MQeInput se describen en la tabla siguiente:
Propiedad | M | C | Valor por omisión | Descripción |
---|---|---|---|---|
Nombre de cola | Sí | Sí | Nombre de la cola puente de WebSphere MQ Everyplace desde la que el nodo recupera mensajes para que los procese el flujo de mensajes. | |
Rastreo | Sí | No | Ninguno | Nivel de rastreo que se necesita para este nodo. Los valores válidos son Ninguno, Estándar, Depurar y Completo. |
Nombre archivo rastreo | Sí | Sí | \MQeTraceFile.trc | Nombre del archivo en el que se escriben los registros de rastreo. |
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. |
Utilizar archivo config. | Sí | No | Deseleccionado | Utilizar un archivo de configuración para este nodo. Si selecciona el recuadro de selección, se realiza esta acción. |
Nombre archivo config. | Sí | Sí | \MQeconfig.ini | Nombre del archivo de configuración que se debe utilizar si se selecciona el recuadro de selección Utilizar archivo config.. |
Nombre del gestor de colas | Sí | Sí | ServerQM1 | Nombre del gestor de colas de WebSphere MQ Everyplace. |
Las propiedades de canal del nodo MQeInput se describen en la tabla siguiente:
Propiedad | M | C | Valor por omisión | Descripción |
---|---|---|---|---|
Máximo de canales | Sí | No | 0 | Número máximo de canales para los que ofrece soporte el gestor de colas de WebSphere MQ Everyplace. |
Las propiedades de registro del nodo MQeInput se describen en la tabla siguiente:
Propiedad | M | C | Valor por omisión | Descripción |
---|---|---|---|---|
Tipo | Sí | Sí | Registro de archivo | Tipo de información de registro que se va a utilizar. Los valores válidos son Registro de archivo y Registro privado. |
Directorio | Sí | Sí | \ServerQM1\registry | Directorio en el se encuentra el archivo de registro (válido sólo si se ha seleccionado Registro de archivo). |
PIN | Sí | Sí | PIN asociado al gestor de colas de WebSphere MQ Everyplace (válido sólo si se ha seleccionado Registro privado). | |
PIN de petición de certificado | Sí | Sí | PIN que se utiliza para solicitar autentificación (válido sólo si se ha seleccionado Registro privado). | |
Contraseña del archivo de claves | Sí | Sí | Contraseña que se utiliza para ver claves criptográficas (válido sólo si se ha seleccionado Registro privado). | |
Sistema principal de certificados | Sí | Sí | Nombre del servidor de certificados (válido sólo si se ha seleccionado Registro privado). | |
Puerta de certificados | Sí | Sí | Puerta del servidor de certificados (válido sólo si se ha seleccionado Registro privado). |
Las propiedades de escucha del nodo MQeInput se describen en la tabla siguiente:
Propiedad | M | C | Valor por omisión | Descripción |
---|---|---|---|---|
Tipo | Sí | Sí | Http | Tipo de adaptador para el escucha. Los valores válidos son Http, Longitud, y Historia. |
Nombre del sistema principal | Sí | Sí | 127.0.0.1 | Nombre del sistema principal del servidor. |
Puerta | Sí | Sí | 8081 | Puerta en la que WebSphere MQ Everyplace está a la escucha. |
Intervalo de tiempo | Sí | Sí | 300 | Intervalo de sondeo de WebSphere MQ Everyplace, especificado en segundos. |
Las propiedades de descripción del nodo MQeInput 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
Flujos de mensajes
WebSphere MQ Mobile Transport
Difusión de aplicaciones de flujos de mensajes
Tareas relacionadas
Trabajo con casos de WebSphere MQ Everyplace de ejemplo
Cómo decidir los nodos que utilizar
Utilización de más de un nodo de entrada
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)
Manejo de errores en flujos de mensajes
Edición de propiedades configurables
Referencia relacionada
WebSphere MQ Mobile Transport
Nodo MQInput
Nodo SCADAInput
Nodo Input
Nodo Real-timeInput
Nodo MQeOutput
Avisos |
Marcas registradas |
Descargas |
Biblioteca |
Soporte |
Información de retorno (feedback)
![]() ![]() |
ac04600_ |