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:
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:
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.
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).
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. |
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 |
|
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 |
|
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 | Sí | <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 | Sí | <No hay ningún valor predeterminado> | El gestor de colas al que debe enviarse el mensaje de respuesta o el mensaje de informe. | mqmdReplyToQMgr |
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. |
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 | Sí | No hay ningún valor predeterminado | El nombre de la cola de destino. | mqdlhDestQName |
Nombre del gestor de colas de destino | No | Sí | 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. |
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. |