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 MQHeader

Utilice el nodo MQHeader para añadir, modificar o suprimir cabeceras MQMD (MQ Message Descriptor)y MQDLH (MQ Dead Letter Header).

Este tema contiene las siguientes secciones:

Finalidad

Puede añadir o suprimir toda la cabecera o puede cambiar únicamente los campos de una cabecera. Puede establecer estos campos en un valor fijo o en un valor especificado mediante una expresión XPath para acceder a un valor en uno de los árboles de mensajes. 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.

El nodo MQHeader 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 de control de tiempo de espera

Utilización de este nodo en un flujo de mensajes

Observe 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. Las propiedades del nodo se visualizan en la vista Propiedades. Este nodo no tiene propiedades obligatorias.

Los terminales del nodo MQHeader 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.
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 MQHeader se describen en la siguiente tabla:
Propiedad O C Valor predeterminado Descripción
Nombre de nodo No No MQHeader El nombre del nodo.
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.
Las propiedades del descriptor de mensaje MQ se describen en la siguiente tabla; consulte las publicaciones WebSphere MQ Application Programming Reference y WebSphere MQ Application Programming Guide para obtener información detallada acerca de cada una de las propiedades MQ y sus valores soportados.
Propiedad O C Valor predeterminado Descripción Propiedad de mandato mqsiapplybaroverride
Opciones de cabecera MQMD No No Transferir cabecera Opciones para controlar la MQMD 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.
 
Identificador del juego de caracteres codificado No No MQCCSI_Q_MGR El identificador del juego de caracteres de los datos de caracteres del mensaje. A continuación se presenta un conjunto de literales personalizados de ejemplo para EBCIDIC y para otros valores Unicode comunes:

MQCCSI_INTL_EBCIDIC    : 500
MQCCSI_US_EBCIDIC      : 037
MQCCSI_UNICODE_1200    : 1200
MQCCSI_UNICODE_1208    : 1208  
MQCCSI_UNICODE_13488   : 13488
MQCCSI_UNICODE_17584   : 17584

Consulte las publicaciones WebSphere MQ Application Programming Reference y WebSphere MQ Application Programming Guide para obtener información detallada.
 
Formato No No MQFMT_NONE Un nombre que puede utilizar el emisor del mensaje para indicar al receptor la naturaleza de los datos contenidos en el mensaje.    
Número de versión No No MQMD_VERSION_1 El ID de versión del mensaje MQMD.  
Tipo de mensaje No No MQMT_DATAGRAM El tipo del mensaje.    
Caducidad del mensaje No No MQEI_UNLIMITED Un período de tiempo expresado en décimas de segundo, que establece la aplicación que coloca el mensaje. El mensaje se debe poder seleccionar para descartarlo si no se ha suprimido de la cola de destino antes de que transcurra este período de tiempo.    
Información de retorno o Código de razón No No MQFB_NONE Se utiliza con un mensaje de tipo MQMT_REPORT para indicar la naturaleza del informe y sólo tiene un significado con ese tipo de mensaje.    
Prioridad del mensaje No No MQPRI_PRIORITY_AS_Q_DEF La prioridad del mensaje. 0 es el valor más bajo y 9 es el valor más alto. Los siguientes son literales de visualización personalizados:

MQPRI_PRIORITY_HIGH    : 9
MQPRI_PRIORITY_8       : 8
MQPRI_PRIORITY_7       : 7
MQPRI_PRIORITY_6       : 6
MQPRI_PRIORITY_5       : 5
MQPRI_PRIORITY_MEDIUM  : 4
MQPRI_PRIORITY_3       : 3
MQPRI_PRIORITY_2       : 2
MQPRI_PRIORITY_1       : 1
MQPRI_PRIORITY_LOW     : 0

 
Persistencia del mensaje No No MQPER_PERSISTENCE_AS_Q_DEF Indica si el mensaje persiste a las anomalías del sitema y a los reinicios del gestor de colas.  
Identificador de mensaje No No MQMI_NONE Una serie que se utiliza para diferenciar un mensaje de otro.  
Identificador de correlación No No MQCI_NONE Una serie que puede utilizar la aplicación para relacionar un mensaje con otro o para relacionar el mensaje con otro trabajo que está realizando la aplicación.  
Cola de respuestas No <No hay ningún valor predeterminado> La cola de mensajes a la que la aplicación que ha emitido la petición de obtención del mensaje debe enviar los mensajes de respuesta y de informe. mqmdReplyToQ
Gestor de cola de respuestas No <No hay ningún valor predeterminado> El gestor de colas al que debe enviarse el mensaje de respuesta o el mensaje de informe. mqmdReplyToQMgr
En la tabla siguiente se describen las propiedades del informe:
Propiedad O C Valor predeterminado Descripción
Heredar de cabecera No No Seleccionado Esta propiedad sólo está habilitada cuando se ha seleccionado la opción Modificar cabecera. Seleccione este campo para heredar cualquier valor de la propiedad del informe MQMD que está presente en un mensaje de entrada.
Excepción No No No hay ningún valor predeterminado Un tipo del mensaje de informe MQ. Se genera un mensaje de informe de excepción.
Caducidad No No No hay ningún valor predeterminado Un tipo del mensaje de informe MQ. Se genera un mensaje de informe de caducidad.
Confirmar al llegar No No No hay ningún valor predeterminado Un tipo del mensaje de informe MQ. Se genera un mensaje de informe de confirmar al llegar.
Confirmar al entregar No No No hay ningún valor predeterminado Un tipo del mensaje de informe MQ. Se genera un mensaje de informe de confirmar al entregar.
Notificación No No No hay ningún valor predeterminado Un tipo de mensaje de informe MQ. Se genera un mensaje de informe de notificación de acción.
En la tabla siguiente se describen las propiedades de la cabecera MQDLH:
Propiedad O C Valor predeterminado Descripción Propiedad de mandato mqsiapplybaroverride
Opciones de cabecera MQDLH No No Transferir cabecera Opciones para controlar la MQMD 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.
 
Identificador del juego de caracteres codificado No No MQCCSI_UNDEFINED El identificador del juego de caracteres de los datos de caracteres del mensaje.    
Formato No No MQFMT_NONE Un nombre que puede utilizar el emisor del mensaje para indicar al receptor la naturaleza de los datos contenidos en el mensaje.  
Razón No No MQRC_NONE Un código que indica por qué se enviado el mensaje a la cola de mensajes no entregados (DLQ).    
Nombre de la cola de destino No No hay ningún valor predeterminado El nombre de la cola de destino. mqdlhDestQName
Nombre del gestor de colas de destino No No hay ningún valor predeterminado El nombre del gestor de colas de destino. mqdlhDestQMgrName
Guardar cola de mensajes no entregados No No Seleccionado Si selecciona, el nombre de la cola de mensajes no entregados se guarda en el entorno local.  
Guardar cola de origen No No Seleccionado Si selecciona, el nombre de la cola de origen original se guarda en el entorno local.  
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:51


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