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

JMSHeader

Utilize o nó JMSHeader para modificar o conteúdo das propriedades JMS Header_Values e Application para que você possa controlar a saída do nó sem programação.

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

Finalidade

Utilize o nó para controlar a saída de um nó JMSOutput. Um subconjunto de valores comuns pode ser alterado no Cabeçalho JMS e as propriedades escolhidas pelo usuário podem ser incluídas, alteradas ou excluídas para as propriedades do Aplicativo.

Para propriedades JMS Header_Values, o nó fornece um conjunto de campos que podem ser modificados utilizando valores predefinidos, valores definidos pelo usuário ou expressões XPath. 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.

Para propriedades do Aplicativo JMS, o nó fornece uma maneira de incluir, modificar e excluir pares nome-valor de propriedades do aplicativo.

O nó JMSHeader está contido no repositório JMS da paleta 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. Este nó não possui propriedades obrigatórias.

Os terminais do nó JMSHeader são descritos na tabela a seguir:
Terminal Descrição
Entrada O terminal de entrada que aceita a mensagem para processamento pelo nó.
Defeito O terminal de saída para o qual a mensagem de entrada será roteada se for detectado um defeito durante a extração.
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ó JMSHeader são descritas na tabela a seguir:
Propriedade M P Padrão Descrição
Nome do Nó Não Não JMSHeader 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 opções do cabeçalho de transporte JMS do nó JMSHeader estão descritas na tabela a seguir:
Propriedade M P Padrão Descrição
Opções do Cabeçalho JMS Não SIM Transportar Cabeçalho Opções para controlar o cabeçalho JMSTransport 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.
As propriedades JMSHeader_Value do nó JMSHeader estão descritas na tabela a seguir:
Propriedade M A Padrão Descrição Propriedade do Comando mqsiapplybaroverride
Modo de Entrega JMS Não Sim  Non _Persistent Filtre mensagens por modo de entrega de mensagem:
  • Non_Persistent
  • Persistente
 
Expiração da Mensagem JMS (ms) Não Sim 0 Solicite que o provedor JMS mantenha a mensagem JMS de saída por um período especificado. Os valores estão em milissegundos; o valor padrão 0 significa que a mensagem não deve expirar.    
Prioridade de Mensagem JMS Não Sim 4 Designe importância relativa à mensagem. Um aplicativo cliente JMS de recebimento ou um nó JMSOutput pode utilizar este valor. JMS define um valor de prioridade de nível dez, com 0 como a prioridade mais baixa e 9 como a mais alta.  
Identificador de Correlação JMS Não Sim Nenhum valor padrão Um cliente pode utilizar o campo do cabeçalho Identificador de Correlação JMS para vincular uma mensagem a outra. Uma utilização típica é vincular uma mensagem de resposta à sua mensagem de pedido.    
Resposta JMS Para Não Sim Nenhum valor padrão O campo do cabeçalho Resposta JMS Para contém um destino fornecido por um cliente quando uma mensagem é enviada. É o destino para o qual uma mensagem de resposta deve ser enviada. jmsReplyTo
As propriedades de aplicação do nó JMSHeader são descritas na tabela a seguir:
Propriedade M A Padrão Descrição
Propriedades do Aplicativo Não Sim   Esta tela será ativada apenas se você escolher Incluir Cabeçalho ou Modificar Cabeçalho para o cabeçalho de Transporte JMS. A tela não possui propriedades predefinidas; você a utiliza para criar propriedades customizadas e valores. Utilize a tabela de propriedades para incluir novas propriedades ou modificar ou excluir propriedades existentes para o cabeçalho. Não há nenhum limite para o número de propriedades. Cada propriedade deve ter um nome e um qualificador de tipo. O qualificador de tipo pode ser Valor, XPath ou Excluir.
Valor
Digite um novo valor válido para a propriedade selecionada. Um valor nulo ou cadeia vazia também é considerada um valor válido.
XPath
Especifique uma expressão XPath válida. O WebSphere Message Broker suporta definições de XPath que começam com uma variável XPath, como $Root ou $LocalEnvironment. Apenas a primeira ocorrência é retornada se houver vários valores para a expressão XPath. (Os exemplos de expressões XPath válidas são: $LocalEnvironment/Host e $Root/HTTPRequest/Content-Type).
Exclusão
Especifique a propriedade a ser excluída da mensagem que chega. O valor associado à propriedade selecionada também é excluído.
Limpar Valores de Entrada Não Sim Não selecionada Esta opção, que é ativada apenas se você escolher Modificar Cabeçalho, remove todos os nomes da propriedade e valores associados da mensagem que chega, se presente.
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 | ac60290_