Nodo MQGet

Utilice el nodo MQGet para recibir mensajes de clientes que se conecten al intermediario utilizando la WebSphere MQ Enterprise Transport y las interfaces de programación de aplicaciones MQI y AMI.

También puede utilizar el nodo MQGet para recuperar mensajes que se hayan colocado anteriormente en una cola de mensajes WebSphere MQ definida para el gestor de colas del intermediario.

Este tema contiene las secciones siguientes:

En este tema se utilizan los términos siguientes:
mensajes de entrada
Un mensaje que entra en el terminal de entrada del nodo MQGet.
mensaje de cola
Un mensaje que el terminal MQGet lee de la cola.

Finalidad

El nodo MQGet lee un mensaje de una cola especificada y establece 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.

Puede utilizar un nodo MQGet en cualquier parte de un flujo de mensajes, a diferencia de un nodo MQInput, que sólo se puede utilizar como el primer nodo de un flujo de mensajes. El árbol de mensajes de salida de un nodo MQGet se construye combinando el árbol de entrada con el árbol de resultados de la llamada MQGET. Puede establecer las propiedades del nodo MQGet para controlar la forma en que se reciben los mensajes; por ejemplo, puede indicar que un mensaje se debe procesar bajo el control de transacción o puede solicitar que, cuando se esté creando el árbol de resultados, se realice la conversión de datos al recibir cada mensaje de entrada.

El nodo MQGet maneja los mensajes en los siguientes dominios de mensaje:
  • MRM
  • XML
  • XMLNS
  • XMLNSC
  • JMSMap
  • JMSStream
  • MIME
  • BLOB
  • IDOC

El nodo MQGet se encuentra en la bandeja de WebSphere MQ de la paleta y está representado en el entorno de trabajo con el siguiente icono:

Icono de nodo MQGet

Utilización del nodo MQGet en un flujo de mensajes

Consulte los temas siguientes para saber cómo se utiliza el nodo MQGet en un flujo de mensajes:

Configuración del nodo MQGet

Una vez ha puesto una instancia del nodo MQGet en un flujo de mensajes, puede configurarlo; para obtener más información, consulte Configurar un nodo de flujo de mensajes. Las propiedades del nodo se visualizan en la vista Propiedades, Para visualizar las propiedades del nodo en el diálogo Propiedades, 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 MQGet.

  1. Opcional: en el separador Descripción, entre una Descripción corta, una Descripción larga o ambas cosas. En este separador también puede redenominar el nodo.
  2. En el separador Básicas, especifique en Nombre de cola el nombre de la cola de la que se debe obtener el mensaje. Debe predefinir esta cola de WebSphere MQ en el gestor de colas que contiene el intermediario en el que se despliega el flujo de mensajes. Si esta cola no es una cola válida, el nodo genera una excepción y el mensaje de entrada se propaga al terminal Failure (de anomalías).
  3. En el separador Análisis de mensajes de entrada, establezca valores para las propiedades que describen el dominio de mensajes, conjunto de mensajes, tipo de mensaje y formato del mensaje que utiliza el nodo para determinar cómo analizar el mensaje de cola y el tema predeterminado asociado al mensaje.
    • Si el mensaje de cola tiene una cabecera MQRFH2, no necesita establecer valores para las propiedades de Análisis de mensaje de entrada, ya que los valores pueden obtenerse de la carpeta <mcd> en 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 de la cabecera MQRFH2, los valores de la cabecera MQRFH2 tienen prioridad.

    • En Dominio de mensajes, seleccione en la lista el nombre del analizador que desee. Puede elegir entre las siguientes opciones:
      • MRM
      • XML
      • XMLNS
      • XMLNSC
      • JMSMap
      • JMSStream
      • MIME
      • BLOB
      • IDOC
    • Si está utilizando el analizador MRM o IDOC, seleccione el Conjunto de mensajes que desea utilizar.

      Deje Conjunto de mensajes en blanco para analizadores XML, XMLNS, XMLNSC, JMS, MIME y BLOB.

    • Si está utilizando el analizador MRM, seleccione el mensaje correcto en la lista de Tipo de mensaje. Esta lista se llena con los mensajes definidos en el Conjunto de mensajes que se ha seleccionado.

      Deje en blanco Tipo de mensaje para los analizadores XML, XMLNS, XMLNSC, JMS, IDOC, MIME y BLOB.

    • Si está utilizando el analizador MRM o IDOC, seleccione el formato del mensaje en la lista de Formato del mensaje. Esta lista incluye todos los formatos físicos que se han definido para este Conjunto de mensajes.

      Deje en blanco Formato del mensaje para los analizadores XML, XMLNS, XMLNSC, JMS, MIME y BLOB.

  4. En el subseparador Opciones de análisis:
    1. 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.

      Si cambia este valor por Inmediato, el análisis parcial se altera temporalmente y se analizan y validan todos los elementos de mensaje, excepto los tipos complejos con una composición de Elección o Mensaje que no se pueden resolver en ese momento. Si cambia este valor a Completo, el análisis parcial se altera temporalmente y se analiza y valida todo lo contenido en el mensaje; los tipos complejos con una composición de Elección o Mensaje que no se pueden resolver en ese momento producen una anomalía de validación.

    2. Seleccione Utilizar analizador compacto MQRFH2C para la cabecera MQRFH2 si desea que se utilice el analizador MQRFH2C. Por omisión, este recuadro no está seleccionado, lo que significa que no se utiliza el analizador compacto.
    3. Si está usando el analizador XMLNSC, establezca valores para las propiedades que determinan el funcionamiento del analizador XMLNSC. Para obtener más información, consulte Manipular mensajes en el dominio XMLNSC.
  5. En el separador Avanzadas, establezca valores para las propiedades avanzadas.
    • Seleccione un valor para Modalidad de transacción en la lista para definir las características transaccionales de cómo se maneja este mensaje:
      • Si selecciona Automática, el mensaje de cola se recibe bajo punto de sincronismo si está marcado como persistente. Si el mensaje no está marcado como persistente, no se recibe bajo punto de sincronismo. La persistencia o no persistencia del mensaje de entrada determina la transaccionalidad de los mensajes derivados propagados posteriormente por un nodo de salida, a menos que el nodo de salida o cualquier otro nodo subsiguiente del flujo de mensajes altere temporalmente la transaccionalidad de forma explícita.
      • Si selecciona , el mensaje de cola se recibe bajo punto de sincronismo. Todos los mensajes derivados que sean propagados posteriormente por un nodo de salida en la misma instancia del flujo de mensajes se envían de forma transaccional, a menos que el nodo de salida o cualquier otro nodo subsiguiente del flujo de mensajes altere temporalmente la transaccionalidad de forma explícita.
      • Si selecciona No, la mensaje de cola no se recibe bajo punto de sincronismo. Todos los mensajes derivados que sean propagados posteriormente por un nodo de salida en la misma instancia del flujo de mensajes se envían de forma no transaccional, a menos que el nodo de salida o cualquier otro nodo subsiguiente del flujo de mensajes haya especificado que los mensajes se deben poner bajo punto de sincronismo.
    • Seleccione un valor para Modalidad de generación en la lista para definir qué componentes del mensaje de salida se generan en el nodo MQGet y qué componentes se toman del mensajes de entrada.
      • Si selecciona Ninguno, todos los componentes del mensaje del árbol de entrada se propagan sin cambios.
      • Si selecciona Mensaje (el valor predeterminado), el nodo crea un nuevo componente Mensaje, pero los componentes Entorno local, Entorno y Lista de excepciones del árbol de entrada se propagan sin cambios.
      • Si selecciona Entorno local, el nodo crea un nuevo componente Entorno local, pero los componentes Mensaje, Entorno y Lista de excepciones del árbol de entrada se propagan sin cambios.
      • Si selecciona Mensaje y entorno local, el nodo crea nuevos componentes Mensaje y Entorno local, pero los componentes Entorno y Lista de excepciones del árbol de entrada se propagan sin cambios.
    • Si ha elegido que la Modalidad de generación sea Mensaje o Mensaje y entorno local, seleccione un valor para Copiar mensaje en la lista para definir qué partes del mensaje se generan en el nodo MQGet y qué partes se toman del mensajes de entrada.
      • Si selecciona Ninguno (el valor predeterminado), no se propaga ninguna parte del mensaje de entrada del árbol de entrada.
      • Si selecciona Copiar cabeceras, las cabeceras del mensaje de entrada del árbol de entrada se copian en el mensaje de salida.
      • Si selecciona Copiar mensaje completo, el mensaje de entrada entero del árbol de entrada se copia en el mensaje de salida.
    • Si ha elegido que Modalidad de generación sea Entorno local o Mensaje y entorno local, seleccione un valor para Copiar entorno local en la lista para definir qué partes del entorno local se generan en el nodo MQGet y qué partes se toman del mensaje de entrada.
      • Si selecciona Copiar entorno local completo (el valor predeterminado), en cada nodo en el flujo de mensajes, se crea una nueva copia del entorno local en el árbol y se llena con el contenido del entorno local del nodo precedente. Por tanto, si un nodo cambia el entorno local, los nodos en sentido ascendente no verán estos cambios porque tienen sus propias copias. Este comportamiento puede ser un problema si utiliza un nodo FlowOrder, o bien si utiliza el mandato propagate en un nodo Compute. el entorno local completo que está definido en el mensaje de entrada se copia en el mensaje de salida.
      • Si selecciona Ninguno, cada nodo genera su propia copia del entorno local, pero utiliza el entorno local que pasa a éste mediante el nodo anterior. Por lo tanto, si un nodo cambia el entorno local, esos cambios los verán los nodos en sentido ascendente.
    • Proporcione un valor para la propiedad Intervalo de espera (ms) para especificar cuántos milisegundos se debe esperar para recibir un mensaje de la llamada MQGET. Si no proporciona ningún valor, se utilizará el valor predeterminado de 1000 milésimas de segundo.
    • Proporcione un valor para la propiedad Tamaño mínimo del almacenamiento intermedio de mensajes (KB) para especificar el tamaño, en KB, del almacenamiento intermedio inicial para la llamada MQGET. El almacenamiento intermedio se expande automáticamente para aceptar un mensaje de cualquier tamaño, pero si se espera que todos los mensajes sean grandes, especifique un valor adecuado para reducir la frecuencia con la que el almacenamiento intermedio tenga que ajustar su tamaño. Si no se proporciona ningún valor, el valor del almacenamiento intermedio es de 4 KB.
  6. En el separador Petición, establezca valores para las propiedades que determinan cómo se construyen los parámetros de petición.
    • Si el MQMD que se debe utilizar para la llamada MQGET no es la ubicación predeterminada InputRoot.MQMD, especifique en Ubicación del MQMD de entrada la ubicación del MQMD.
    • Si la ubicación de los parámetros para la llamada MQGET (por ejemplo alteraciones temporales de MQGMO) no es la ubicación predeterminada InputLocalEnvironment.MQ.GET, especifique la ubicación en Ubicación de parámetros MQ de entrada.
    • Si selecciona Obtener por ID de correlación, el campo CorrelId del mensaje que se debe recuperar debe coincidir con el campo CorrelId de la Ubicación del MQMD de entrada. Por omisión, este recuadro de selección está borrado.
    • Si selecciona Obtener por ID de mensaje, el campo MsgId del mensaje que se debe recuperar debe coincidir con el campo MsgId de la Ubicación del MQMD de entrada. Por omisión, este recuadro de selección está borrado.
    • Si selecciona Utilizar MQMD de entrada completo, se utilizarán todos los campos del MQMD de Ubicación de MQMD de entrada para recuperar el mensaje. Si existe una corriente de bits del MQMD en la Ubicación de MQMD de entrada, se utilizarán todos los campos de la corriente de bits. Asegúrese de que el MQMD del mensaje que se ha de recuperar coincide con esos campos. Por omisión, este recuadro de selección está borrado.
  7. En el separador Resultado, establezca los valores para las propiedades que determinan el manejo de los resultados de la llamada MQGET.
    • En Ubicación de datos de salida, especifique la ubicación de inicio dentro del árbol de mensaje de salida en la que se almacenan los elementos analizados de la serie de bits del mensaje de cola; el valor predeterminado es OutputRoot. Todos los elementos de esta ubicación se suprimen el comportamiento predeterminado es sustituir el mensaje del árbol de entrada por mensaje de cola.

      Puede entrar cualquier referencia de campo ESQL válida (esta referencia puede incluir expresiones), incluyendo referencias de campo nuevas para crear un nodo nuevo dentro del árbol de mensaje para insertar la respuesta en el mensaje que se propaga desde el árbol de entrada. Por ejemplo, OutputRoot.XMLNS.ABC.DEF y Environment.GotReply son referencias de campo válidas. Para obtener información más detallada, consulte Escenario de petición-respuesta utilizando un nodo MQGet.

      Cuando se analiza mensaje de cola para crear el contenido del árbol de mensaje, se utilizan las propiedades de mensaje que ha especificado como propiedades de Análisis de mensaje de entrada del nodo.

    • Establezca un valor en Ubicación de datos de resultado para controlar que subárbol del mensaje de cola se coloca en el mensaje de salida. El valor predeterminado es ResultRoot, que significa que el mensaje de cola completo se coloca en el mensaje de salida. Si, por ejemplo, desea que únicamente el MQMD del mensaje de cola, utilice ResultRoot.MQMD; después, este subárbol se coloca en la ubicación especificada por Ubicación de datos de salida.
    • Establezca un valor en Ubicación de parámetros MQ de salida para controlar dónde se colocan en el árbol de salida el CC (código de terminación), el RC (código de razón), y cualquier otro parámetro de WebSphere MQ (por ejemplo el MQMD usado por la llamada MQGET). El valor predeterminado es OutputLocalEnvironment.MQ.GET.
    • Establezca un valor en Ubicación de datos de aviso para controlar la colocación del mensaje de cola cuando la llamada MQGET devuelve un código de aviso. El valor predeterminado es OutputRoot.

      Puede entrar cualquier referencia de campo ESQL válida (consulte la descripción de la propiedad Ubicación de datos de salida). Los datos que se ponen en esta ubicación son siempre el árbol de resultado completo, con el cuerpo como elemento BLOB. Ubicación de datos de resultado no se utiliza para los datos de aviso.

  8. En el separador Validación, establezca las propiedades de validación si desea que el analizador valide el texto de cada mensaje de cola con el Conjunto de mensajes. (Si un mensaje se propaga al terminal de anomalías del nodo, no se valida.)

    Si desea ver información más detallada, consulte los apartados Validar mensajes y Propiedades de validación.

Inicio del cambio

Alteración temporal de las propiedades del nodo durante el proceso de mensajes

Cuando incluya y configure un nodo MQGet en un flujo de mensajes, es posible desee alterar temporalmente sus propiedades en determinadas condiciones. Por ejemplo, es posible que necesite leer de una cola que esté identificada en otra parte del mensaje, o que se haya recuperado de un registro de una base de datos.

Para alterar temporalmente los valores establecidos para las propiedades del nodo MQGet a fin de conseguir una forma más dinámica de procesar mensajes, incluya un nodo Compute o JavaCompute en el flujo de mensajes antes del nodo MQGet. Configure este nodo para crear un nuevo mensaje de salida y añada campos al árbol de entorno local para definir nuevos valores para las propiedades que desee modificar.

Por ejemplo, incluyendo la siguiente sentencia ESQL añada un nodo Compute al flujo y defina un nuevo nombre de cola para que el nodo MQGet efectúe una lectura para buscar mensajes:

SET LocalEnvironment.MQ.GET.QueueName = 'new_queue';

Utilice LocalEnvironment.MQ.GET. como nombre de correlación para todos los campos relacionados con el nodo MQGet.

Fin del cambio

Configuración de transacciones coordinadas

Cuando se incluye un nodo MQGet 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 (el valor predeterminado), el mensaje de cola se recibe bajo punto de sincronismo (es decir, dentro de una unidad de trabajo de WebSphere MQ). Todos los mensajes que un nodo de salida en la misma instancia del flujo de mensajes envíe posteriormente se ponen bajo punto de sincronismo, a menos que el nodo de salida, o cualquier otro nodo subsiguiente, altere temporalmente este valor de forma explícita.
  • Si establece la propiedad en Automática, el mensaje de cola se recibe bajo punto de sincronismo en el caso de que el mensaje de entrada esté marcado como persistente. De lo contrario, no se recibirá bajo punto de sincronismo. Cualquier mensaje enviado posteriormente por un nodo de salida se pone bajo punto de sincronismo, como determina la propiedad de persistencia de entrada, a menos que el nodo de salida, o cualquier otro nodo subsiguiente, altere temporalmente este valor de forma explícita.
  • Si establece la propiedad en No, el mensaje de cola no se recibe bajo punto de sincronismo. Cualquier mensaje enviado posteriormente por un nodo de salida del flujo de mensajes no se pone bajo punto de sincronismo, a menos que un nodo de salida determinado, o cualquier nodo subsiguiente, especifique que el mensaje debe ponerse bajo punto de sincronismo.

Conexión de los terminales

Conecte los terminales Out (de salida), Warning (de aviso), Failure (de anomalías) y No Message (sin mensaje) de este nodo a otro nodo del flujo de mensajes, para procesar el mensaje adicionalmente, procesar errores o enviar el mensaje a un destino adicional.

El código de terminación (CC) que genera la llamada MQGET controla lo que se propaga a cada uno de los terminales de salida.
  • Si la llamada MQGET se realiza satisfactoriamente, el nodo MQGet direcciona cada mensaje de salida analizado al terminal Out (de salida).
  • Si la llamada MQGET falla, pero con un CC que indica un aviso, se propaga un mensaje de salida sin analizar al terminal Warning (de aviso).
  • Si la llamada MQGET falla, con un CC más grave que un aviso, el mensaje de entrada se propaga al terminal Failure (de anomalías).
  • Si la llamada MQGET falla con un código de razón MQRC_NO_MSG_AVAILABLE, el mensaje de salida se propaga (sin un cuerpo de resultado) al terminal No Message (sin mensaje). El mensaje de salida que se propaga al terminal No Message se construye a partir del mensaje de entrada únicamente, según los valores de las propiedades Modalidad de generación, Copiar mensaje y Copiar entorno local.
  • Si no conecta los terminales Out, Warning o No Message a otro nodo del flujo de mensajes, se descartará cualquier mensaje que se propague a dichos terminales.
  • Si no conecta el terminal Failure a otro nodo del flujo de mensajes, el intermediario genera una excepción cuando se propaga un mensaje a dicho terminal.

Para obtener más información, consulte Conectar terminales de anomalías.

Terminales y propiedades

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

Terminal Descripción
Entrada Terminal de entrada que acepta el mensaje que está siendo procesado el flujo de mensajes.
Aviso Terminal de salida al que se propaga el árbol de salida si se produce un error (con un CC que indica un aviso) en el nodo mientras se intenta obtener un mensaje de la cola. La parte MQMD del mensaje se analiza, pero el resto del mensaje es un elemento BLOB no analizado. El aviso se descarta si el terminal no está conectado y no se produce ninguna propagación de salida del nodo en absoluto.
De anomalías Terminal de salida al que se direcciona el mensaje de entrada si se produce un error (con un CC que indica un error que es más grave que un aviso) en el nodo mientras se intenta obtener un mensaje de la cola.
De salida El terminal de salida al que se direcciona el mensaje si se recupera satisfactoriamente de la cola de WebSphere MQ.
Sin mensaje Terminal de salida al que se direcciona el mensaje de entrada si no hay ningún mensaje disponible en la cola. El mensaje de salida que se propaga al terminal No Message se construye a partir del mensaje de entrada únicamente, según los valores de las propiedades Modalidad de generación, Copiar mensaje y Copiar entorno local.

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); 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 MQGet.

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

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

Propiedad O C Valor predeterminado Descripción
Nombre de cola Ninguno Nombre de la cola de mensajes de WebSphere MQ de la que este nodo recupera mensajes.

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

Propiedad O C Valor predeterminado Descripción
Dominio de mensajes No No Ninguno Dominio que se utiliza para analizar el mensaje de cola.
Conjunto de mensajes No No Ninguno Nombre o identificador del conjunto de mensajes en el que se define el mensaje de cola.
Tipo de mensaje No No Ninguno El nombre del mensaje de cola.
Formato del mensaje No No Ninguno El nombre del formato físico del mensaje de cola.

Las propiedades de análisis del nodo MQGet se describen en la siguiente tabla.

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

Si desea ver una descripción completa de esta propiedad, consulte Análisis a petición.

Utilizar analizador compacto MQRFH2C para dominio MQRFH2 No No No seleccionado Esta propiedad controla si el analizador compacto MQRFH2C se utiliza para las cabeceras MQRFH2 en vez del analizador MQRFH2.
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 se establece esta propiedad, los datos del mensaje aparecen bajo XMLNSC en nodos que estén conectados al terminal de salida cuando la cabecera MQRFH2 de entrada o el Dominio de mensajes de las propiedades de Análisis de mensaje de entrada sea XMLNS.
Retener el contenido mixto No No No seleccionado Esta propiedad controla si el analizador XMLNSC crea elementos en el árbol de mensaje cuando encuentra texto mixto en el mensaje de cola. 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 mensaje cuando encuentra comentarios en el mensaje de cola. 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 mensaje cuando encuentra instrucciones de proceso en el mensaje de cola. 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.

En la tabla siguiente se describen las propiedades Avanzadas del nodo MQGet.

Propiedad O C Valor predeterminado Descripción
Modalidad de transacción No No Esta propiedad controla si el mensaje de entrada se recibe bajo punto de sincronismo. Los valores válidos son Automática, y No.
Modalidad de generación No No Mensaje Esta propiedad controla qué partes del mensaje del árbol de entrada se copian. Los valores válidos son Mensaje, Entorno local, Mensaje y entorno local y Ninguna.
Copiar mensaje No No Ninguna Esta propiedad controla qué partes del mensaje del árbol de entrada se copian. Los valores válidos son Ninguna, Copiar cabeceras y Copiar mensaje completo.
Copiar entorno local No No Copiar entorno local completo Esta propiedad controla cómo se copia el entorno local en el mensaje de salida. Si lo establece en Copiar entorno local completo, en cada nodo en el flujo de mensajes, se crea una nueva copia del entorno local en el árbol y se llena con el contenido del entorno local del nodo precedente. Por tanto, si un nodo cambia el entorno local, los nodos en sentido ascendente no verán estos cambios porque tienen sus propias copias. Este comportamiento puede ser un problema si utiliza un nodo FlowOrder, o bien si utiliza el mandato propagate en un nodo Compute.

Si establece esta propiedad en Ninguna, cada nodo genera su propia copia del entorno local, pero utiliza el entorno local que pasa a éste mediante el nodo anterior. Por lo tanto, si un nodo cambia el entorno local, esos cambios los verán los nodos en sentido ascendente.

Intervalo de espera (ms) No 1000 Tiempo máximo, en milésimas de segundo, que se espera para la obtención del mensaje de cola de la cola de mensajes.
Tamaño mínimo del almacenamiento intermedio de mensajes (KB) No 4 Tamaño mínimo, en KB, del almacenamiento intermedio de obtención. El valor mínimo de esta propiedad es 1.

Las propiedades de petición del nodo MQGet están descritas en la tabla siguiente.

Propiedad O C Valor predeterminado Descripción
Ubicación del MQMD de entrada No No   La ubicación en el mensaje ensamblado de entrada donde se encuentra el MQMD que va a utilizarse para la MQGET. La ubicación predeterminada es InputRoot.MQMD.
Ubicación de parámetros MQ de entrada No No   La ubicación en el mensaje ensamblado de entrada donde se pueden encontrar los parámetros de WebSphere MQ (por ejemplo, el tamaño inicial del almacenamiento intermedio y las alteraciones temporales de MQGMO). La ubicación predeterminada es InputLocalEnvironment.MQ.GET.
Obtener por ID de correlación No No No seleccionado Si selecciona este recuadro, sólo se recuperan los mensajes que tienen el ID de correlación especificado.
Obtener por ID de mensaje No No No seleccionado Si selecciona este recuadro, sólo se recuperan los mensajes que tienen el ID de mensaje especificado.
Utilizar MQMD de entrada completo No No No seleccionado Si selecciona este recuadro de selección, se utilizarán todos los campos del MQMD proporcionados; de lo contrario, se utilizarán únicamente el ID del mensaje y el ID de correlación.

Las propiedades de resultado del nodo MQGet se describen en la siguiente tabla.

Propiedad O C Valor predeterminado Descripción
Ubicación de datos de salida No No OutputRoot Esta propiedad especifica dónde se ponen los datos de salida. Si deja el campo en blanco, se utiliza OutputRoot como valor predeterminado.
Ubicación de datos de resultado No No ResultRoot Esta propiedad especifica qué subárbol (del mensaje de cola) ha de usarse. Si deja este campo en blanco, se utiliza ResultRoot como valor predeterminado y se emplea el mensaje de cola completo. Por ejemplo, si se especifica ResultRoot.MQMD.ReplyToQ, sólo se utiliza ese subárbol.
Ubicación de parámetros MQ de salida No No   Esta propiedad especifica dónde están ubicados los parámetros de WebSphere MQ de salida. Si deja este campo en blanco, se utiliza OutputLocalEnvironment.MQ.GET como valor predeterminado. Establezca Modalidad de generación para que incluya Entorno local para asegurarse de que los valores actualizados son visibles en los nodos en sentido descendente. La ubicación predeterminada es OutputLocalEnvironment.MQ.GET.
Ubicación de datos de aviso No No OutputRoot Esta propiedad especifica dónde se colocan los datos de salida si MQGET devuelve un código de aviso. Si deja este campo en blanco, se utiliza OutputRoot como valor predeterminado.

Las propiedades de validación del nodo MQGet se describen en la siguiente tabla.

Para ver una descripción completa de estas propiedades, consulte Propiedades de validación.
Propiedad O C Valor predeterminado Descripción
Validar No Ninguna Esta propiedad controla si tiene lugar la validación. Los valores válidos son Ninguna, Contenido, Contenido y valor 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 No No True (verdadero) Esta propiedad no se puede editar. Las comprobaciones de restricción de valor básicas se incluyen en la validación de Contenido y valor.
Arreglo No No Ninguna Esta propiedad no se puede editar.
Avisos | Marcas registradas | Descargas | Biblioteca | Soporte | Su opinión

Copyright IBM Corporation 1999, 2009Copyright IBM Corporation 1999, 2009.
Última actualización : 2009-02-16 13:54:02

ac20806_