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 JMSHeader

Utilice el nodo JMSHeader para modificar el contenido de las propiedades de Aplicación y Valores_cabecera_JMS de forma que pueda controlar la salida del nodo sin programación.

Este tema contiene las siguientes secciones:

Finalidad

Utilice el nodo para controlar la salida de un nodo JMSOutput. En la cabecera JMS se puede modificar un subconjunto de valores comunes y se pueden añadir, modificar o suprimir las propiedades de la aplicación seleccionadas por el usuario.

Para las propiedades de Valores_cabecera de JMS, el nodo proporciona un conjunto de campos que puede modificar utilizando valores predefinidos, valores definidos por el usuario o expresiones XPath. XPath se utiliza para proporcionar una ubicación válida desde la que se puede copiar un valor para una propiedad. Por ejemplo la ubicación puede ser el cuerpo del mensaje, el árbol del entorno local o una lista de excepciones.

Para las propiedades de las aplicaciones JMS, el nodo proporciona un modo de añadir, modificar y suprimir los pares de nombre y valor de las propiedades de la aplicación.

El nodo JMSHeader se encuentra en la bandeja JMS de la paleta y está representado en el WebSphere Message Broker Toolkit mediante el siguiente icono:

Icono de nodo de control de tiempo de espera

Utilización de este nodo en un flujo de mensajes

Revise el siguiente ejemplo para obtener más detalles acerca de cómo utilizar el nodo:

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.

Terminales y propiedades

Cuando haya colocado una instancia del nodo en un flujo de mensajes, podrá configurarlo. Consulte Configurar un nodo de flujo de mensajes. Este nodo no tiene propiedades obligatorias.

Los terminales del nodo JMSHeader se describen en la tabla siguiente:
Terminal Descripción
Entrada El terminal de entrada que acepta un mensaje para que lo procese el nodo.
Anomalías El terminal de salida al que se direcciona el mensaje de entrada si se detecta una anomalía durante la extracción.
De salida El terminal de salida al que se direcciona el mensaje transformado si el mensaje de entrada se procesa satisfactoriamente.

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

Las propiedades de descripción del nodo JMSHeader se describen en la siguiente tabla:
Propiedad O C Valor predeterminado Descripción
Nombre de nodo No No JMSHeader El nombre del nodo.
Descripción corta No No   Descripción breve del nodo.
Descripción larga No No   Texto que describe el propósito del nodo en el flujo de mensajes.
Las opciones de la cabecera de transporte del nodo JMSHeader están descritas en la tabla siguiente:
Propiedad O C Valor predeterminado Descripción
Opciones de cabecera JMS No Transferir cabecera Opciones para controlar la cabecera JMSTransport en su totalidad.

Seleccione Transferir cabecera para transferir los valores que se incluyen en un mensaje de entrada.

Seleccione Añadir cabecera para añadir una cabecera nueva utilizando los valores de las propiedades especificadas. Si ya existe una cabecera, ésta se modifica utilizando los valores de las propiedades especificadas. Si se selecciona Heredar de cabecera como un valor de propiedad y la cabecera no existe, se utiliza el valor predeterminado de la propiedad.  

Seleccione Modificar cabecera para modificar una cabecera existente utilizando los valores de las propiedades especificadas. Si no existe una cabecera, en primer lugar se añade una cabecera nueva. Si se selecciona Heredar de cabecera como un valor de propiedad y la cabecera no existe, se utiliza el valor predeterminado de la propiedad.

Seleccione Suprimir cabecera para suprimir la cabecera, si existe.

Nota: Las dos opciones Añadir cabecera y Modificar cabecera añaden una cabecera si no existe y modifican una cabecera si existe. No obstante, los valores predeterminados de cada opción son diferentes, por lo tanto, debe utilizar la opción adecuada.
Las propiedades de Valor_cabecera_JMS del nodo JMSHeader están descritas en la tabla siguiente:
Propiedad O C Valor predeterminado Descripción Propiedad de mandato mqsiapplybaroverride
Modalidad de entrega JMS No Non_Persistent Filtrar mensajes por modalidad de entrega de mensajes:
  • Non_Persistent
  • Persistent
 
Caducidad del mensaje JMS (ms) No 0 Solicite al proveedor de JMS que conserve el mensaje JMS de salida durante un período de tiempo especificado. Los valores se indican en milisegundos; el valor predeterminado 0 indica que el mensaje no debe caducar.    
Prioridad del mensaje JMS No 4 Asignar la importancia relativa al mensaje. Una aplicación de cliente JMS de recepción o un nodo JMSOutput pueden utilizar este valor. JMS define un valor de prioridad de nivel diez, siendo 0 la prioridad más baja y 9 la más alta.  
Identificador de correlación JMS No No hay ningún valor predeterminado Un cliente puede utilizar el campo de cabecera de identificador de correlación JMS para enlazar un mensaje con otro. Generalmente se utiliza para enlazar un mensaje de respuesta con su mensaje de petición.    
Respuesta JMS No No hay ningún valor predeterminado El campo de la cabecera Respuesta JMS contiene un destino que proporciona un cliente cuando se envía un mensaje. Es el destino al que debe enviar un mensaje de respuesta. jmsReplyTo
Las propiedades de Aplicación del nodo JMSHeader se describen en la siguiente tabla:
Propiedad O C Valor predeterminado Descripción
Propiedades de aplicación No   Esta pantalla sólo está habilitada si se selecciona Añadir cabecera o Modificar cabecera para la cabecera de transporte JMS. La pantalla no tiene propiedades predefinidas. Se utiliza para crear propiedades y valores personalizados. Utilice la tabla de propiedades para añadir nuevas propiedades o para modificar o suprimir propiedades existentes para la cabecera. No hay ningún límite en el número de propiedades. Cada propiedad debe tener un nombre y un calificador de tipo. El calificador de tipo puede ser Valor, XPath o Suprimir.
Valor
Escriba un valor válido nuevo para la propiedad seleccionada. Un valor nulo o una serie vacía se considerará también como un valor válido.
XPath
Especifique una expresión XPath válida. WebSphere Message Broker da soporte a definiciones XPath que comienzan por una variable XPath como, por ejemplo, $Root o $LocalEnvironment. Sólo se devuelve la primera aparición si hay varios valores para la expresión XPath. Los ejemplos de expresiones XPath válidas son: $LocalEnvironment/Host, y $Root/HTTPRequest/Content-Type.
Suprimir
Especifique la propiedad que se va a suprimir del mensaje de entrada. El valor asociado a la propiedad seleccionada se suprime también.
Borrar valores entrantes No No seleccionado Esta opción, que únicamente está habilitada si selecciona Modificar cabecera, suprime todos los nombres de propiedades y los valores asociados del mensaje de entrada, si está presente.
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:52


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