WebSphere Message Broker, Versión 8.0.0.5 Sistemas operativos: AIX, HP-Itanium, Linux, Solaris, Windows, z/OS

Consulte la información sobre la última versión del producto en IBM Integration Bus, Versión 9.0

Nodo MQInput

Utilice el nodo MQInput para recibir mensajes de clientes que se conecten al 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:

Finalidad

El nodo MQInput recibe un mensaje de una cola de mensajes WebSphere MQ definida en el gestor de colas del intermediario. El nodo utiliza MQGET para leer un mensaje de la cola especificada y establecer el entorno de proceso para el mensaje. Si es adecuado, puede definir la cola de entrada como una cola compartida o una cola de clúster de WebSphere MQ.

Los flujos de mensajes que manejan los mensajes que se reciben a través de conexiones WebSphere MQ han de empezar siempre con un nodo MQInput. Puede establecer las propiedades del nodo MQInput para controlar el modo en que se reciben los mensajes, haciendo que se establezcan las opciones MQGET apropiadas. Por ejemplo, puede indicar que un mensaje debe procesarse bajo control de transacciones. También puede solicitar que se realice la conversión de datos al recibir cada mensaje de entrada.

El nodo MQInput maneja mensajes en los siguientes dominios de mensajes:
  • DFDL
  • XMLNSC
  • DataObject
  • JSON
  • BLOB
  • MIME
  • MRM
  • JMSMap
  • JMSStream
  • XMLNS

Si incluye un nodo de salida en un flujo de mensajes que empieza con un nodo MQInput, el nodo de salida podrá ser cualquiera de los nodos de salida soportados, incluidos los nodos de salida definidos por el usuario; no es necesario incluir un nodo MQOutput. Puede crear un flujo de mensajes que reciba mensajes de clientes WebSphere MQ y genere mensajes para clientes que utilizan cualquiera de los transportes soportados para conectarse al intermediario, porque puede configurar el flujo de mensajes para solicitar que el intermediario proporcione la conversión que sea necesaria.

Si crea un flujo de mensajes para utilizarlo como subflujo, no puede utilizar un nodo de entrada estándar; debe utilizar un nodo Input como el primer nodo, para crear un terminal de entrada para el subflujo.

Si el flujo de mensajes no recibe mensajes a través de conexiones de WebSphere MQ, puede elegir uno de los nodos de entrada soportados.

El nodo MQInput se encuentra en la bandeja de WebSphere MQ de la paleta y está representado en el WebSphere Message Broker Toolkit con el siguiente icono:

Icono de nodo MQInput

Utilización del nodo MQInput en un flujo de mensajes

Puede ver información sobre los ejemplos sólo cuando utilice el Information Center que está integrado en WebSphere Message Broker Toolkit o el Information Center en línea. Puede ejecutar ejemplos sólo cuando utilice el Information Center que está integrado en WebSphere Message Broker Toolkit.

Conexión de los terminales

El nodo MQInput direcciona al terminal de salida (Out) todos los mensajes que recupera satisfactoriamente. Si falla esta acción, se vuelve a intentar el mensaje. Si se excede la cuenta de restituciones (según lo definido mediante el atributo BackoutThreshold de la cola de entrada), el mensaje se direcciona al terminal de anomalías (Failure); 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 este nodo capta este mensaje después de que se genere 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 entra en un bucle continuo 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) para evitar el bucle continuo del mensaje a través del nodo.

Configuración para transacciones coordinadas

Cuando se incluye un nodo MQInput en un flujo de mensajes, el valor que se establece para la Modalidad de transacción indica si los mensajes se reciben bajo punto de sincronismo.
  • Si establece la propiedad en Automática, el mensaje se recibe bajo el punto de sincronismo en el caso de que el mensaje de entrada esté marcado como persistente; de lo contrario, no se recibe bajo el punto de sincronismo. Cualquier mensaje enviado posteriormente por un nodo de salida se coloca bajo punto de sincronismo, según lo determinado por la propiedad de persistencia entrante, a menos que el nodo de salida haya modificado explícitamente esta propiedad.
  • Si establece la propiedad en (el valor predeterminado), el mensaje se recibe bajo el punto de sincronismo; es decir, dentro de una unidad de trabajo de WebSphere MQ). Todos los mensajes enviados posteriormente por un nodo de salida en la misma instancia del flujo de mensajes se colocan bajo punto de sincronismo, a menos que el nodo de salida haya modificado esto explícitamente.
  • Si establece la propiedad en No, el mensaje no se recibe bajo el punto de sincronismo. Todos los mensajes enviados posteriormente por un nodo de salida en el flujo de mensajes no se ponen bajo punto de sincronismo, a menos que un nodo de salida determinado haya especificado que el mensaje debe ponerse bajo punto de sincronismo.
El nodo MQOutput es el único nodo de salida que se puede configurar para alterar temporalmente esta opción.

Si ha establecido la propiedad Sólo examinar, se ignorará el valor establecido para la propiedad Modalidad de transacción puesto que un mensaje no se puede examinar bajo un punto de sincronismo. No obstante, cualquier mensaje derivado que se propague más adelante por un nodo de salida en la misma instancia del flujo de mensajes seguirá el comportamiento descrito anteriormente según lo especificado por el valor de Modalidad de transacción.

Tamaño del almacenamiento intermedio de MQGET

El tamaño del almacenamiento intermedio de MQGET lo implementa internamente el intermediario y no se puede cambiar. La siguiente descripción se proporciona únicamente a título informativo. No debe tenerla en cuenta al desarrollar los flujos de mensajes porque la implementación interna podría cambiar.

Cuando el nodo MQInput se inicializa, establece el tamaño del almacenamiento intermedio predeterminado para la primera MQGET en 4 KB. El nodo MQInput supervisa el tamaño de los mensajes y aumenta o reduce el tamaño del almacenamiento intermedio:

  1. Si una MQGET falla porque el mensaje es mayor que el tamaño del almacenamiento intermedio, el nodo aumenta inmediatamente el tamaño del almacenamiento intermedio para dar cabida al mensaje, emite de nuevo la MQGET, y pone a cero una cuenta de mensajes.
  2. Cuando se han contado 10 mensajes desde el aumento del tamaño del almacenamiento intermedio, el nodo compara el tamaño del mayor de los 10 mensajes con el tamaño del almacenamiento intermedio. Si el tamaño del mensaje más grande es inferior al 75% del tamaño del almacenamiento intermedio, el almacenamiento intermedio se reduce al tamaño del mayor de los 10 mensajes. Si una MQGET falla durante los 10 mensajes porque el mensaje es mayor que el tamaño del almacenamiento intermedio, el nodo realiza la acción 1.

Por ejemplo, si el primer mensaje que el nodo recibe tiene 20 MB, y los 10 mensajes siguientes tienen 14 MB cada uno, el tamaño del almacenamiento intermedio se aumenta de 4 KB a 20 MB y permanece en 20 MB durante 10 mensajes. Sin embargo, después del décimo mensaje el tamaño del almacenamiento intermedio se reduce a 14 MB.

Terminales y propiedades

Cuando haya colocado un nodo MQInput en un flujo de mensajes, puede utilizar la vista Propiedades para configurar el nodo; consulte Configurar un nodo de flujo de mensajes. Las propiedades del nodo se visualizan en la vista Propiedades. Todas las propiedades obligatorias que no tienen un valor predeterminado aparecen con un asterisco.

Los terminales del nodo MQInput se describen en la tabla siguiente.

Terminal Descripción
Failure (de anomalías) El terminal de salida al que se direcciona el mensaje si se produce un error. Aunque esté establecida la propiedad Validación, los mensajes propagados a este terminal no se validan.
Out (de salida) El terminal de salida al que se direcciona el mensaje si se recupera satisfactoriamente de la cola de WebSphere MQ.
Catch (de captación) El terminal de salida al que se direcciona un mensaje si se genera una excepción en sentido descendente y después este nodo la capta.

Las tablas siguientes describen las propiedades del 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).

En la tabla siguiente se describen las propiedades de descripción del nodo MQInput.

Propiedad O C Valor predeterminado Descripción
Nombre de nodo No No El tipo de nodo, MQInput El nombre del nodo.
Descripción corta No No   Una descripción breve del nodo.
Descripción larga No No   Texto que describe la finalidad del nodo en el flujo de mensajes.

En la tabla siguiente se describen las propiedades básicas del nodo MQInput.

Propiedad O C Valor predeterminado Descripción Propiedad de mandato mqsiapplybaroverride
Nombre de cola   El nombre de la cola de entrada de WebSphere MQ de la que este nodo recupera mensajes (utilizando MQGET) para que los procese este flujo de mensajes. Debe predefinir esta cola de WebSphere MQ al gestor de colas que contiene el intermediario en el que se despliega el flujo de mensajes. queueName

En la tabla siguiente se describen las propiedades de Análisis de mensajes de entrada del nodo MQInput.

Si el mensaje de entrada tiene una cabecera MQRFH2, no es necesario establecer valores para las propiedades de Análisis de mensajes de entrada, porque los valores se obtienen en la carpeta <mcd> de la cabecera MQRFH2; por ejemplo:
<mcd><Msd>MRM</Msd><Set>DHM4UO906S001</Set><Type>receiptmsg1</Type>
<Fmt>XML</Fmt></mcd>
Si establece valores, y esos valores difieren de los valores de la cabecera MQRFH2, y el elemento <Msd> es un dominio válido, los valores de la cabecera MQRFH2 tienen prioridad.
Propiedad O C Valor predeterminado Descripción
Dominio de mensajes No No BLOB Dominio que se utiliza para analizar el mensaje. Si el campo está en blanco, el valor predeterminado es BLOB.
Modelo de mensaje No No Deseleccionado Nombre o ubicación del archivo de esquemas de modelos de mensaje en el que se define el mensaje. Esta lista se llena con todos los archivos de esquemas de modelos de mensajes disponibles para el Dominio de mensajes que ha seleccionado.
Mensaje No No Deseleccionado Nombre o ubicación de la raíz de mensaje dentro del archivo de esquemas de modelos de mensaje. Esta lista se llena con todos los mensajes disponibles que se han definido en el Modelo de mensaje que ha seleccionado.
Formato físico No No Deseleccionado Nombre del formato físico del mensaje. Si está utilizando el analizador MRM o IDOC, seleccione el formato físico del mensaje de entrada de la lista. Esta lista incluye todos los formatos físicos que ha definido para este modelo de mensaje seleccionado. Si establece la propiedad Dominio de mensajes en DataObject, puede establecer esta propiedad en XML o IDoc ALE de SAP. Establezca esta propiedad en IDoc ALE de SAP cuando tenga que analizar una corriente de bits desde un origen externo y generar un árbol de mensajes.

En la tabla siguiente se describen las propiedades de las Opciones de análisis para el nodo MQInput.

Propiedad O C Valor predeterminado Descripción
Temporización del análisis No No A petición Esta propiedad controla cuándo se analiza un mensaje de entrada. Los valores válidos son A petición, Inmediato y Completo.

De forma predeterminada, Temporización de análisis está establecido en A petición con lo cual el análisis del mensaje se retrasa. Para hacer que el mensaje se analice inmediatamente, consulte Análisis a petición.

Utilizar analizador compacto MQRFH2C para cabecera MQRFH2 No No No seleccionado Esta propiedad controla si se utiliza el analizador compacto MQRFH2C, en lugar del analizador MQRFH2, para las cabeceras MQRFH2.
Crear árbol utilizando los tipos de datos de esquema XML No No No seleccionado Esta propiedad controla si el analizador XMLNSC crea elementos de sintaxis en el árbol de mensajes con tipos tipos de datos tomados del esquema XML. Esta propiedad sólo se puede seleccionar si se establece la propiedad Validar del separador Validación en Contenido o Contenido y valor.
Utilizar analizador compacto XMLNSC para dominio XMLNS No No No seleccionado Esta propiedad controla si el analizador compacto XMLNSC se utiliza para mensajes en el dominio XMLNS. Si establece esta propiedad, los datos del mensaje se visualizarán bajo XMLNSC en los nodos que estén conectados al terminal de salida cuando la cabecera MQRFH2 de entrada o la propiedad de Análisis de mensaje de entrada, Dominio de mensajes, sea XMLNS. Para obtener más información, consulte Manipular mensajes en el dominio XMLNSC.
Retener el contenido mixto No No No seleccionado Esta propiedad controla si el analizador XMLNSC crea elementos en el árbol de mensajes cuando encuentra texto mixto en un mensaje de entrada. Si selecciona el recuadro, se crean elementos para el texto mixto. Si deselecciona el recuadro, el texto mixto se ignora y no se crea ningún elemento.
Retener los comentarios No No No seleccionado Esta propiedad controla si el analizador XMLNSC crea elementos en el árbol de mensajes cuando encuentra comentarios en un mensaje de entrada. Si selecciona el recuadro, se crean elementos para los comentarios. Si deselecciona el recuadro, los comentarios se ignoran y no se crea ningún elemento.
Retener las instrucciones de proceso No No No seleccionado Esta propiedad controla si el analizador XMLNSC crea elementos en el árbol de mensajes cuando encuentra instrucciones de proceso en un mensaje de entrada. Si selecciona el recuadro, se crean elementos para las instrucciones de proceso. Si deselecciona el recuadro, las instrucciones de proceso se ignoran y no se crea ningún elemento.
Elementos opacos No No Espacio en blanco Esta propiedad se utiliza para especificar una lista de elementos del mensaje de entrada que el analizador XMLNSC deba analizar de forma opaca. El análisis opaco sólo se realiza si la validación no está habilitada (es decir, si Validar tiene el valor Ninguno); las entradas que se especifiquen en Elementos opacos se omiten si la validación está habilitada.

En la tabla siguiente se describen las propiedades Avanzadas del nodo MQInput. Establezca estas propiedades para determinar cómo se ha procesado el mensaje, como por ejemplo, las características transaccionales. Muchas de estas propiedades corresponden a opciones de la llamada MQGET.

Propiedad O C Valor predeterminado Descripción Propiedad de mandato mqsiapplybaroverride
Modalidad de transacción No Esta propiedad controla si el mensaje de entrada se recibe bajo punto de sincronismo. Los valores válidos son Automática, y No.
  • Si selecciona Automática, el mensaje de entrada se recibe bajo el punto de sincronismo si se ha marcado como persistente, de lo contrario, no se recibirá bajo el punto de sincronismo. La transaccionalidad de cualquier mensaje derivado enviado posteriormente por un nodo de salida viene determinada por la propiedad de persistencia entrante, a menos que el nodo de salida haya modificado explícitamente la transaccionalidad.
  • Si selecciona el valor , el mensaje entrante se recibe bajo punto de sincronismo. Cualquier mensaje derivado enviado posteriormente por un nodo de salida en la misma instancia del flujo de mensajes se envía transaccionalmente, a menos que el nodo de salida haya modificado explícitamente la transaccionalidad.
  • Si selecciona No, el mensaje de entrada no se recibe bajo punto de sincronismo. Cualquier mensaje derivado enviado posteriormente por un nodo de salida en el flujo de mensajes se envía de forma no transaccional, a menos que el nodo de salida haya especificado que los mensajes deben ponerse bajo punto de sincronismo.
 
Modalidad de orden No Predeterminada El orden en que los mensajes se recuperan de la cola de entrada y se procesan.

Los mensajes que lleguen pueden procesarse en orden, o cualquier hebra puede procesar cualquier mensaje cuando esté listo. Cuando el orden es impuesto, una hebra procesa un mensaje sólo si es el primer mensaje no procesado disponible con un valor de orden exclusivo.

Los valores válidos son Predeterminada, Por ID de usuario, Por orden de cola y Definida por el usuario. Esta propiedad sólo tiene efecto si la propiedad de flujo de mensajes Instancias adicionales del separador Instancias, se ha establecido en un valor mayor que cero; es decir, si varias hebras leen la cola de entrada. Los valores válidos son:
  • Predeterminada. Los mensajes se recuperan en el orden definido por los atributos de cola, pero este orden no está garantizado puesto que pedidlos mensajes los procesa el flujo de mensajes.
  • Por ID de usuario. Los mensajes que tienen el mismo valor de ID de usuario (UserIdentifier) en el MQMD se recuperan y procesan en el orden definido por los atributos de cola; se garantiza que se mantendrá este orden al procesar los mensajes. Un mensaje asociado a un ID de usuario específico que esté siendo procesado por una hebra, se procesará totalmente antes de que dicha hebra, u otra hebra, pueda empezar a procesar otro mensaje con el mismo ID de usuario. Asegúrese que cada mensaje tiene un ID de mensaje único en el mensaje de entrada. No puede garantizarse que se mantenga ningún otro tipo de orden.
  • Por orden de cola. Este nodo recupera y procesa los mensajes en el orden definido por los atributos de cola; se garantiza que se mantendrá este orden al procesar los mensajes. Este comportamiento es idéntico al que se observa si la propiedad de flujo de mensajes Instancias adicionales está establecida en cero. Sin embargo, si establece la Modalidad de orden en Por orden de cola y luego vuelve a desplegar el flujo de mensajes, las instancias adicionales que ya se estén ejecutando no se liberarán. Por lo tanto, cuando establezca la Modalidad de orden en Por orden de cola, detenga y reinicie el flujo de mensajes o ejecute el mandato mqsireload para el grupo de ejecución después de volver a desplegar el flujo.
  • Definida por el usuario. Puede especificar un elemento de mensaje utilizando la propiedad Ubicación del campo orden.

Para obtener más información sobre la utilización de esta opción, consulte Optimizar el rendimiento del flujo de mensajes y Recepción de mensajes en un grupo de mensajes WebSphere MQ.

 
Ubicación del campo orden N N "" Una propiedad de expresión XPath o ESQL para controlar qué parte del mensaje se utiliza para imponer la ordenación en los mensajes entrantes cuando la Modalidad de orden es Definida por el usuario.

Si el campo falta, se genera una excepción y el mensaje se restituye. Los valores NULL y vacíos se procesan por separado, en paralelo.

 
Orden lógico No Seleccionado Si selecciona este recuadro, los mensajes se reciben en orden lógico, según lo definido por WebSphere MQ. Esta opción se corresponde con la opción MQGMO_LOGICAL_ORDER de la estructura MQGMO de la MQI.

Si deselecciona el recuadro, los mensajes que se envían como parte de un grupo no se recibirán en un orden predeterminado. Si un intermediario espera recibir mensajes en grupos y no se ha seleccionado este recuadro de selección, o bien el orden de los mensajes de entrada no es significativo o bien el flujo de mensajes debe diseñarse para que los procese de forma adecuada.

También debe seleccionar Confirmar por grupo de mensajes si desea que el proceso de mensaje no se confirme hasta que se haya recibido y procesado el último mensaje del grupo.

Puede obtener más información sobre las opciones con las que está correlacionada esta propiedad en la sección Application Programming Reference de Centro de información en línea de WebSphere MQ Versión 7.

Si desea ver información más detallada sobre esta opción, consulte el apartado Recepción de mensajes en un grupo de mensajes WebSphere MQ.

 
Todos los mensajes disponibles No No seleccionado Seleccione Todos los mensajes disponibles si desea que la recuperación y el proceso de mensajes sólo se lleven a cabo cuando estén disponibles todos los mensajes del mismo grupo. Esta propiedad se corresponde con la opción MQGMO_ALL_MSGS_AVAILABLE de la estructura MQGMO de la MQI. Deseleccione este recuadro de selección si la recuperación de mensajes no depende de que todos los mensajes de un grupo estén disponibles antes de que el proceso se inicie.

Puede obtener más información sobre las opciones con las que está correlacionada esta propiedad en la sección Application Programming Reference de Centro de información en línea de WebSphere MQ Versión 7.

 
Coincidir con el ID del mensaje No No   Un ID de mensajes debe coincidir con el ID de mensaje en el MQMD del mensaje de entrada. Entre un identificador de mensajes si desea que el nodo de entrada reciba sólo mensajes que contengan un valor de identificador de mensajes que coincida con el campo MsgId de MQMD.

Especifique un número par de dígitos hexadecimales (los caracteres válidos son: del 0 al 9, de la A a la F y de la a a la f) de 48 dígitos como máximo. Si el identificador de mensajes asociado que especifica tiene un tamaño inferior al del campo MsgId, Coincidir con el ID del mensaje se rellena por la derecha con caracteres X'00'. Esta propiedad se corresponde con la opción MQMO_MATCH_MSG_ID de la estructura MQGMO de la MQI.

Deje esta propiedad en blanco si no quiere que el nodo de entrada compruebe que el ID del mensaje coincida.

Puede obtener más información sobre las opciones con las que está correlacionada esta propiedad en la sección Application Programming Reference de Centro de información en línea de WebSphere MQ Versión 7.

 
Coincidir con el ID de correlación No No   Un ID de correlación debe coincidir con el ID de correlación en el MQMD del mensaje de entrada. Entre un identificador de mensajes si desea que el nodo de entrada reciba sólo mensajes que contengan un valor identificador de correlaciones coincidentes en el campo CorrelId de MQMD.

Especifique un número par de dígitos hexadecimales (los caracteres válidos son: del 0 al 9, de la A a la F y de la a a la f) de 48 dígitos como máximo. Si al especificar el ID sobran espacios en el campo CorrelId, se rellena por la derecha con caracteres X'00'. Esta propiedad se corresponde con la opción MQMO_MATCH_CORREL_ID de la estructura MQGMO de la MQI.

Deje esta propiedad en blanco si no desea que el nodo de entrada compruebe si el CorrelID coincide.

Puede obtener más información sobre las opciones con las que está correlacionada esta propiedad en la sección Application Programming Reference de Centro de información en línea de WebSphere MQ Versión 7.

 
Convertir No No seleccionado Si selecciona este recuadro, WebSphere MQ convierte datos en el mensaje que va a recibirse, de acuerdo con los valores de CodedCharSetId y Encoding definidos en el MQMD. Seleccione Convertir si desea que WebSphere MQ realice la conversión de datos en el mensaje cuando éste se recupera de la cola. Esta opción es útil si está manejando mensajes en el dominio BLOB, o está utilizando un analizador definido por el usuario. No seleccione esta opción si va a analizar mensajes con los dominios XML o MRM porque el analizador realiza la conversión.

WebSphere MQ convierte el mensaje de entrada a la codificación y juego de caracteres codificado especificado en el MQMD que el nodo de entrada proporciona en la llamada MQGET para recuperar el mensaje de la cola de entrada. El intermediario utiliza la opción MQGMO_CONVERT en la llamada MQGET; se aplican las normas comunes para la conversión WebSphere MQ. Los valores que especifique en las opciones Convertir codificación y Convertir ID de juego de caracteres codificado se utilizan en los campos Codificación MsgDesc y CCSID de la llamada MQGET. WebSphere MQ puede convertir el mensaje entrante sólo si el campo Formato del MQMD es un valor WebSphere MQ incorporado que identifica datos de tipo carácter, o si existe una salida de conversión de datos en WebSphere MQ.

Esta propiedad se corresponde con la opción MQGMO_CONVERT de la estructura MQGMO de la MQI.

Quite la marca de selección del recuadro si no desea que WebSphere MQ realice la conversión del mensaje.

Si marca este cuadro de selección, también puede especificar valores para las propiedades Convertir codificación y Convertir ID de juego de caracteres codificado.

Para obtener más información sobre la conversión de datos de WebSphere MQ y para saber por qué debería elegir esta opción, consulte la sección Application Programming Guide de Centro de información en línea de WebSphere MQ Versión 7.

 
Convertir codificación No No  

La representación utilizada para valores numéricos en los datos del mensaje, expresada como un valor entero. Esta propiedad sólo es válida si ha seleccionado Convertir.

Entre el número que representa la codificación a la que desea convertir los datos numéricos del cuerpo del mensaje. Los valores válidos incluyen:
  • Linux platformWindows platform546 para DOS, todos los sistemas Windows y Linux en x86
  • Linux platformUNIX platform273 para Linux enLinux en POWER, Linux en System z y todos los sistemas UNIX.
  • z/OS platform785 para mensajes z/OS que utilizan decimales empaquetados en binario y 273 para mensajes que utilizan números de punto flotante IEEE
La codificación se utiliza solamente en las siguientes circunstancias:
  • Si una salida de conversión de datos de WebSphere MQ definida por el usuario utiliza la codificación.
  • Si la salida de conversión de WebSphere MQ incorporada utiliza la codificación para convertir mensajes en cualquiera de los formatos WebSphere MQ predefinidos.
Si especifica un valor incorrecto no se llevará a cabo ninguna conversión.

Para obtener más información sobre los valores que puede especificar para Convert encoding, consulte la sección Conversión de datos and the Application Programming Reference de Centro de información en línea de WebSphere MQ Versión 7.

 
Convertir ID de juego de caracteres codificado No No  

El identificador del juego de caracteres codificado de los datos de tipo carácter del mensaje, expresado como un valor entero. Esta propiedad sólo es válida si ha seleccionado Convertir.

Entre el valor que representa el identificador del juego de caracteres al que desea convertir los datos de tipo carácter del cuerpo del mensaje. Si especifica un valor incorrecto no se llevará a cabo ninguna conversión.

Para obtener más información sobre los valores que puede especificar para Convertir ID de juego de caracteres codificado, consulte la sección Application Programming Reference de Centro de información en línea de WebSphere MQ Versión 7.

 
Confirmar por grupo de mensajes No No seleccionado Esta propiedad controla cuándo se confirma una transacción al procesar mensajes que formen parte de un grupo de mensajes. Si selecciona el recuadro, la transacción se confirma cuando se ha procesado el grupo de mensajes. Si no selecciona este recuadro, se efectuará una confirmación para cada mensaje una vez haya sido propagado completamente a través del flujo de mensajes.

Esta propiedad sólo es relevante si ha seleccionado Orden lógico.

Establezca la propiedad Modalidad de orden en Por orden de cola si los mensajes de un grupo deben recuperarse y procesarse en el orden en que se visualizan en la cola.

 
Señal de serialización de z/OS No No   Solamente en z/OS: señal definida por el usuario para el soporte de aplicación serializado. El valor especificado se debe ajustar a las normas para un ConnTag válido en la estructura MQCNO de WebSphere MQ. Entre una señal de serialización si desea utilizar el acceso serializado a recursos compartidos proporcionado por WebSphere MQ.

El valor que proporcione para la señal de serialización debe ajustarse a las normas descritas en la sección Application Programming Reference de Centro de información en línea de WebSphere MQ Versión 7.

Para obtener más información sobre la serialización y el compartimiento de colas en z/OS, consulte la sección Concepts and Planning Guide de Centro de información en línea de WebSphere MQ Versión 7.

serializationToken
Tema No   El tema predeterminado del mensaje de entrada. Puede asociar un mensaje con un tema de publicación/suscripción utilizando esta propiedad. Como nombre del tema puede entrar cualquier número de caracteres. Cuando los mensajes pasan a través del nodo MQInput adoptan el nombre del tema que se ha especificado. (Si está utilizando publicación/suscripción, puede suscribirse a un tema y ver todos los mensajes que han pasado a través del nodo MQInput y se han publicado con dicho nombre de tema.) Si el mensaje de entrada tiene una cabecera MQRFH2, no es necesario establecer un valor para la propiedad Topic porque el valor puede obtenerse de la carpeta <psc> en la cabecera MQRFH2; por ejemplo:
<psc><Topic>stockquote</Topic></psc>
Si establece un valor para la propiedad Topic y este valor es distinto del valor de <Topic> en la cabecera MQRFH2, tiene prioridad el valor de la cabecera MQRFH2.
topicProperty
Sólo examinar No No No seleccionado Esta propiedad controla si un mensaje se elimina de la cola una vez leído. Si selecciona este recuadro de selección, el mensaje no se elimina de la cola una vez leído. Si selecciona esta opción, OutputLocalEnvironment.MQ.GET.Browsed se establece en verdadero cuando se propaga un mensaje al terminal de salida del nodo MQInput.  
Restablecer tiempo de espera de examen (ms) -1 El tiempo, en milésimas de segundo, que se debe esperar entre el último mensaje elegible que se examina en la cola de entrada y el restablecimiento del examen al principio de la cola. El valor predeterminado, -1, indica que el examen no se restablece.  

En la tabla siguiente se describen las propiedades de validación del nodo MQInput. Establezca estas propiedades para que el analizador valide el cuerpo de mensajes para el Conjunto de mensajes. (Si un mensaje se propaga al terminal de anomalías del nodo, no se valida.)

Para obtener más detalles, consulte Validar mensajes y Propiedades de validación.

Propiedad O C Valor predeterminado Descripción Propiedad de mandato mqsiapplybaroverride
Validar No Ninguna Esta propiedad controla si tiene lugar la validación. Los valores válidos son Ninguno, Contenido y Contenido y valor. validateMaster
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.  

En la tabla siguiente se describen las propiedades de seguridad del nodo MQInput. Establezca los valores para estas propiedades con el fin de controlar la extracción de una identidad de un mensaje (cuando un perfil de seguridad se asocia al nodo). Para obtener más información sobre estas propiedades, consulte Identidad, Configuración de la extracción de una identidad o una señal de seguridad, Visión general de la seguridad de flujo de mensajes y Configuración de la seguridad de flujo de mensajes.

Propiedad O C Valor predeterminado Descripción
Tipo de señal de identidad No No Ninguna Esta propiedad especifica el tipo de señal de identidad existente en el mensaje de entrada. Los valores válidos son:
  • Valor predeterminado de transporte
  • Nombre de usuario
  • NombreUsuario + Contraseña
  • Aserción SAML
  • Certificado X.509
Si esta propiedad no se especifica, la identidad se recupera de las cabeceras de transporte y el tipo se establece en Username.
Ubicación de señal de identidad No No Ninguna Esta propiedad indica en qué parte del mensaje se puede encontrar la identidad. La ubicación se especifica como referencia de campo ESQL, una expresión XPath o un literal de serie. Si utiliza un literal de serie, debe especificarlo entre comillas simples y no debe contener ningún punto (.). Si esta propiedad no se especifica, la identidad se recupera de la cabecera de transporte MQMD.UserIdentifier.
Ubicación de contraseña de identidad No No Ninguna Esta propiedad indica en qué parte del mensaje se puede encontrar la contraseña. La ubicación se especifica como referencia de campo ESQL, una expresión XPath o un literal de serie. Si utiliza un literal de serie, debe especificarlo entre comillas simples y no debe contener ningún punto (.). Si no se especifica, la contraseña no se establece. Esta propiedad se puede establecer solamente si se ha establecido Tipo de señal de identidad en Username + Password.
Ubicación de emisor de identidad No No Ninguna Esta propiedad especifica una expresión de serie o vía de acceso que describe el emisor de la identidad. La ubicación se especifica como referencia de campo ESQL, una expresión XPath o un literal de serie. Si utiliza un literal de serie, debe especificarlo entre comillas simples y no debe contener ningún punto (.). El valor especifica el Emisor que se ha pasado a un proveedor de STS WS-Trust v1.3. Si esta propiedad no se especifica, se utilizará el valor MQMD.PutApplName. Si deja en blanco el campo Ubicación de emisor de identidad y MQMD.PutApplName también está en blanco, se utilizará la serie MQ.
Tratar las excepciones de seguridad como excepciones normales No No False Esta propiedad especifica si van a tratarse las excepciones de seguridad (como por ejemplo "Acceso denegado") como excepciones normales y a propagarse por el termina de anomalías (si está conectado). De forma predeterminada, esta propiedad está desactivada con lo que se asegura la restitución del mensaje incluso si el terminal de anomalías está conectado.
En la tabla siguiente se describen las propiedades de instancias del nodo MQInput. Establezca los valores para estas propiedades de modo que controlen las instancias adicionales que están disponibles para un nodo. Para ver la descripción completa de estas propiedades, consulte Propiedades configurables del flujo de mensajes.
Propiedad O C Valor predeterminado Descripción Propiedad de mandato mqsiapplybaroverride
Agrupación de instancias adicionales No Utilizar agrupación asociada al flujo de mensajes La agrupación de la que se obtienen instancias adicionales.
  • Si selecciona Utilizar agrupación asociada al flujo de mensajes, las instancias adicionales se obtendrán del valor del flujo de mensajes.
  • Si selecciona Utilizar agrupación asociada al nodo, se asignan instancias adicionales desde las instancias adicionales del nodo, basándose en el número especificado en la propiedad Instancias adicionales.
componentLevel
Instancias adicionales No 0 El número de instancias adicionales que el nodo puede iniciar si la propiedad Agrupación de instancias adicionales está establecida en Utilizar agrupación asociada al nodo. De forma predeterminada, no se proporcionan instancias adicionales al nodo. additionalInstances
Las propiedades de supervisión del nodo se describen en la siguiente tabla.
Propiedad O C Valor predeterminado Descripción
Sucesos No No Ninguno Los sucesos que se han definido para el nodo se visualizan en este separador. De forma predeterminada, no se define ningún suceso de supervisión en ningún nodo en un flujo de mensajes. Utilice Añadir, Editar y Suprimir para crear, cambiar o suprimir sucesos de supervisión para el nodo; consulte Configuración de orígenes de sucesos de supervisión utilizando propiedades de supervisión para obtener detalles.

Puede habilitar e inhabilitar sucesos que se muestran aquí seleccionando o deseleccionando el recuadro Habilitado.

Avisos | Marcas registradas | Descargas | Biblioteca | Soporte | Comentarios

Copyright IBM Corporation 1999, 2014Copyright IBM Corporation 1999, 2014.

        
        Última actualización:
        
        Última actualización: 2015-02-28 16:58:18


Tema de referenciaTema de referencia | Versión 8.0.0.5 | ac04560_