WebSphere Message Broker, Versão 8.0.0.5 Sistemas operacionais: AIX, HP-Itanium, Linux, Solaris, Windows, z/OS

Consulte as informações sobre a versão mais recente do produto em IBM Integration Bus, Versão 9.0

MQHeader

Utilize o nó MQHeader para incluir, modificar ou excluir cabeçalhos MQMD (MQ Message Descriptor) e MQDLH (MQ Dead Letter Header).

Este tópico contém as seguintes seções:

Propósito

É possível incluir ou remover um cabeçalho inteiro ou alterar apenas alguns campos em um cabeçalho. É possível configurar estes campos para um valor fixo ou para um valor especificado por uma expressão XPath para acessar um valor em uma das árvores de mensagens. XPath é utilizado para fornecer um local válido do qual um valor para uma propriedade pode ser copiado. Por exemplo, o local pode ser o corpo da mensagem, a árvore do ambiente local ou uma lista de exceções.

O nó MQHeader está contido no repositório da paleta do WebSphere MQ e é representado no WebSphere® Message Broker Toolkit pelo seguinte ícone:

Ícone de Nó de Controle de Tempo Limite

Utilizando Este Nó em um Fluxo de Mensagens

Consulte a seguinte amostra para obter detalhes adicionais sobre como utilizar o nó:

Você só pode visualizar informações sobre amostras quando usa o centro de informações que está integrado ao WebSphere Message Broker Toolkit ou o centro de informações on-line. Você só poderá executar amostras quando usar o centro de informações que está integrado ao WebSphere Message Broker Toolkit.

Terminais e Propriedades

Quando tiver colocado uma instância do nó em um fluxo de mensagens, poderá configurá-la; consulte Configurando um Nó do Fluxo de Mensagens. As propriedades do nó são exibidas na visualização Propriedades. Este nó não possui propriedades obrigatórias.

Os terminais do nó MQHeader são descritos na tabela a seguir:

Terminal Descrição
In O terminal de entrada que aceita a mensagem para processamento pelo nó.
Failure O terminal de saída para o qual a mensagem de entrada é roteada se for detectada uma falha.
Saída O terminal de saída para o qual a mensagem transformada será roteada se a mensagem de entrada for processada com êxito.

As tabelas a seguir descrevem as propriedades do nó. A coluna com cabeçalho M indica se a propriedade é obrigatória (marcada com um asterisco caso seja necessário digitar um valor quando nenhum padrão for definido); a coluna com cabeçalho C indica se a propriedade é configurável (você poderá alterar o valor quando incluir o fluxo de mensagens ao arquivo BAR para implementá-lo).

As propriedades Descrição do nó MQHeader são descritas na tabela a seguir:
Propriedade M P Padrão Descrição
Nome do Nó Não Não MQHeader O nome do nó.
Short description Não Não   Uma breve descrição do nó.
Descrição Longa Não Não   Texto que descreve a finalidade do nó no fluxo de mensagens.
As propriedades do MQ Message Descriptor são descritas na tabela a seguir: Consulte o Referências de Programação do WebSphere MQ Application e o Guia de Programação do WebSphere MQ Application para detalhes completos de cada propriedade MQ e os valores suportados.
Propriedade M P Padrão Descrição Propriedade do Comando mqsiapplybaroverride
Opções de Cabeçalho MQMD Não Não Transferir cabeçalho Opções para controlar o MQMD como um todo.

Selecione Transportar Cabeçalho para transportar valores que estão presentes em uma mensagem que chega.

Selecione Incluir Cabeçalho para incluir um novo cabeçalho utilizando os valores da propriedade especificados. Se já existir um cabeçalho, ele será modificado utilizando os valores da propriedade especificados. Se Herdar do Cabeçalho for especificado como um valor da propriedade e o cabeçalho não existir, será utilizado o valor padrão para a propriedade.  

Selecione Modificar Cabeçalho para alterar um cabeçalho existente utilizando os valores da propriedade especificados. Se um cabeçalho não existir, um novo cabeçalho será incluído primeiro. Se Herdar do Cabeçalho for especificado como um valor da propriedade e o cabeçalho não existir, será utilizado o valor padrão para a propriedade.    

Selecione Excluir Cabeçalho para excluir o cabeçalho, se ele existir.

Note: As opções Incluir Cabeçalho e Modificar Cabeçalho incluem um cabeçalho, se ele não existir, e altera um cabeçalho, se ele existir. No entanto, os valores padrão oferecidos por cada opção se diferem, portanto, utilize a opção apropriada.
 
Identificador do Conjunto de Caracteres Codificados Não Não MQCCSI_Q_MGR O identificador do conjunto de caracteres de dados de caractere na mensagem.  Um conjunto de amostra de literais customizados para EBCIDIC e outros valores Unicode comuns é fornecido a seguir:

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 o WebSphere MQ Application Programming Reference e o WebSphere MQ Application Programming Guide para obter detalhes completos.
 
Format Não Não MQFMT_NONE Um nome que o remetente da mensagem pode utilizar para indicar ao receptor a natureza dos dados na mensagem.    
Número da Versão Não Não MQMD_VERSION_1 O ID da versão da mensagem MQMD.  
Tipo de Mensagem Não Não MQMT_DATAGRAM O tipo de mensagem.    
Expiração da Mensagem Não Não MQEI_UNLIMITED Um período de tempo expresso em décimos de segundo, configurado pelo aplicativo que coloca a mensagem. A mensagem se torna elegível para ser descartada, se não tiver sido removida da fila de destino antes de decorrer este período de tempo.    
Feedback ou Código de Razão Não Não MQFB_NONE Utilizada com uma mensagem de tipo MQMT_REPORT para indicar a natureza do relatório, e significativa apenas com esse tipo de mensagem.    
Prioridade de Mensagem Não Não MQPRI_PRIORITY_AS_Q_DEF Prioridade de mensagem. 0 é o menor valor e 9 é o maior. Os literais de exibição customizados são os seguintes:

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

 
Persistência de Mensagem Não Não MQPER_PERSISTENCE_AS_Q_DEF Indica se a mensagem permanece após falhas do sistema e reinícios do gerenciador de filas.  
Identificador de Mensagens Não Não MQMI_NONE Uma cadeia utilizada para distinguir uma mensagem de outra.  
Identificador de Correlação Não Não MQCI_NONE Uma cadeia que o aplicativo pode utilizar para relacionar uma mensagem a outra, ou para relacionar uma mensagem a outro trabalho que o aplicativo está desempenhando.  
Responder para a Fila Não Sim <Nenhum Valor Padrão> A fila de mensagens para a qual o aplicativo que emitiu o pedido de obtenção para a mensagem deve enviar mensagens de Resposta e Relatório. mqmdReplyToQ
Responder para o Gerenciador de Filas Não Sim <Nenhum Valor Padrão> O gerenciador de filas para o qual a mensagem de resposta ou de relatório deve ser enviada. mqmdReplyToQMgr
As propriedades do Relatório são descritas na tabela a seguir:
Propriedade M P Padrão Descrição
Herdar do Cabeçalho Não Não Selecionado Esta propriedade é ativada apenas quando a opção Modificar Cabeçalho é selecionada. Selecione este campo para herdar qualquer valor da propriedade de relatório MQMD que esteja presente em uma mensagem que chega.
Exceção Não Não Nenhum valor padrão Um tipo de mensagem de relatório do MQ. É gerada uma mensagem de relatório de exceção.
Expiração Não Não Nenhum valor padrão Um tipo de mensagem de relatório do MQ. É gerada uma mensagem de relatório de expiração.
Confirmar chegada Não Não Nenhum valor padrão Um tipo de mensagem de relatório do MQ. É gerada uma mensagem de relatório confirmar chegada.
Confirmar entrega Não Não Nenhum valor padrão Um tipo de mensagem de relatório do MQ. É gerada uma mensagem de relatório confirmar entrega.
Notificação Não Não Nenhum valor padrão Um tipo de Mensagem de relatório do MQ. É gerada uma mensagem de relatório de notificação de ação.
As propriedades do cabeçalho MQDLH são descritas na tabela a seguir:
Propriedade M P Padrão Descrição Propriedade do Comando mqsiapplybaroverride
Opções de Cabeçalho MQDLH Não Não Transportar o cabeçalho Opções para controlar o MQMD como um todo.

Selecione Transportar Cabeçalho para transportar valores que estão presentes em uma mensagem que chega.

Selecione Incluir Cabeçalho para incluir um novo cabeçalho utilizando os valores da propriedade especificados. Se já existir um cabeçalho, ele será modificado utilizando os valores da propriedade especificados. Se Herdar do Cabeçalho for especificado como um valor da propriedade e o cabeçalho não existir, será utilizado o valor padrão para a propriedade.  

Selecione Modificar Cabeçalho para alterar um cabeçalho existente utilizando os valores da propriedade especificados. Se um cabeçalho não existir, um novo cabeçalho será incluído primeiro. Se Herdar do Cabeçalho for especificado como um valor da propriedade e o cabeçalho não existir, será utilizado o valor padrão para a propriedade.    

Selecione Excluir Cabeçalho para excluir o cabeçalho, se ele existir.

Note: As opções Incluir Cabeçalho e Modificar Cabeçalho incluem um cabeçalho, se ele não existir, e altera um cabeçalho, se ele existir. No entanto, os valores padrão oferecidos por cada opção se diferem, portanto, utilize a opção apropriada.
 
Identificador do Conjunto de Caracteres Codificados Não Não MQCCSI_UNDEFINED O identificador do conjunto de caracteres de dados de caractere na mensagem.    
Format Não Não MQFMT_NONE Um nome que o remetente da mensagem pode utilizar para indicar ao receptor a natureza dos dados na mensagem.  
Razão Não Não MQRC_NONE Um código que indica por que a mensagem foi enviada para a DLQ (Fila de Devoluções).    
Nome da Fila de Destino Não Sim Nenhum valor padrão O nome da fila de destino. mqdlhDestQName
Nome do Gerenciador de Filas de Destino Não Sim Nenhum valor padrão O nome do gerenciador de filas de destino. mqdlhDestQMgrName
Salvar Fila de Devoluções Não Não Selecionado Se selecionado, o nome da fila de devoluções será armazenado no ambiente local.  
Salvar Fila de Origem Não Não Selecionado Se selecionado, o nome da fila de origem original será armazenado no ambiente local.  
As propriedades Monitoramento do nó são descritas na tabela a seguir.
Propriedade M P Default Descrição
Eventos Não Não Nenhum Eventos definidos para o nó são exibidos nesta guia. Por padrão, nenhum evento de monitoramento é definido em um nó do fluxo de mensagens. Utilize Incluir, Editar, e Excluir para criar, alterar ou excluir eventos de monitoração no nó; consulte Configurando fontes de eventos de monitoramento utilizando propriedades de monitoramento para detalhes.

É possível ativar e desativar eventos mostrados aqui selecionando ou desmarcando a caixa de opções Ativado.

Avisos | Marcas Registradas | Downloads | Biblioteca | Suporte | Feedback

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

        
        Última atualização:
        
        Última atualização: 2015-02-28 18:28:50


Tópico de ReferênciaTópico de Referência | Versão 8.0.0.5 | ac60270_