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

Seqüência

Use o nó Seqüência para incluir um número de sequência para um ou mais grupos de mensagens de entrada.

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

Propósito

O nó Seqüência possibilita que você receba grupos de mensagens de uma origem de entrada e preserve a ordem em que as mensagens em cada grupo chegaram.

Use um nó Seqüência para gerar um número de sequência monotonamente crescente para cada grupo de sequências. Conforme cada mensagem no grupo chegar no nó Seqüência, o número de sequência para o grupo será incrementado e armazenado com a mensagem em um local especificado pela propriedade do nó Caminho para armazenar número de sequência (por exemplo, LocalEnvironment, cabeçalho MQRFH2, corpo da mensagem).

O sequenciamento se aplica apenas a mensagens dentro do mesmo grupo de sequências. É possível usar as propriedades no nó Seqüência para organizar mensagens em grupos de acordo com uma condição especificada; por exemplo, agrupando todas as mensagens com o mesmo valor em um campo de número do cliente na mensagem. Se nenhum grupo de sequências for especificado, um único grupo padrão será usado para todas as mensagens.

Um nó Seqüência pode receber entrada de múltiplos nós de entrada no fluxo de mensagens ou de nós de entrada que possuem instâncias adicionais. O nó Seqüência pode processar múltiplos grupos de sequências em paralelo, mas ele processa apenas um pedido por vez para números de sequência do mesmo grupo de sequências.

O nó Seqüência aloca um número de sequência para cada mensagem em um grupo de sequências e o próximo número de sequência no grupo não é alocado até que a mensagem atual no grupo tenha concluído o processamento (sendo confirmada ou retrocedida). Apenas um encadeamento por vez pode processar mensagens no mesmo recebimento de dados de grupo de sequências do nó Seqüência, que assegura que o sequenciamento seja mantido para o grupo quando houver múltiplos encadeamentos no fluxo de mensagens.

Quando o nó Seqüência receber mensagens de múltiplos encadeamentos, a ordem na qual as mensagens alcançam o nó Seqüência é preservada. Entretanto, a ordem na qual as mensagens chegam no nó Seqüência pode ser diferente da ordem na qual elas são obtidas do transporte pelo nó de entrada. Esta situação pode ocorrer porque mensagens em um encadeamento podem ser alcançadas por mensagens em outros encadeamentos entre o nó de entrada e o nó Seqüência.

Cada grupo de sequências pode ser associado a apenas um nó Seqüência. Múltiplos nós Seqüência podem ter um grupo de sequências com o mesmo nome, mas cada um desses grupos de sequências é tratado como um grupo separado. A combinação do nome do grupo de execução, nome do fluxo de mensagens, nome do nó e nome do grupo de sequências é usada para diferenciar entre os grupos de sequências.

Por exemplo, você pode ter um fluxo de mensagens chamado flow1 contendo um nó Seqüência chamado node1, que é implementado em um grupo de execução chamado eg1. Uma mensagem é enviada para ele usando um grupo de sequências chamado group1. O resultado é eg1/flow1/node1/group1. Exatamente o mesmo fluxo de mensagens em um grupo de execução diferente, por exemplo eg2, resultará em eg2/flow1/node1/group1.

O nó Seqüência está contido no repositório Roteamento da paleta e é representado no WebSphere® Message Broker Toolkit pelo seguinte ícone:

Ícone do nó Sequence

Utilizando o Nó Seqüência em um Fluxo de Mensagens

Examine a amostra a seguir para saber como utilizar o nó Seqüência:

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.

Configurando o Nó Seqüência

Quando tiver colocado uma instância do nó Seqüência em um fluxo de mensagens, você poderá configurá-lo; consulte Configurando um Nó do Fluxo de Mensagens. As propriedades do nó são exibidas na visualização Propriedades.

Todas as propriedades obrigatórias que não tiverem um valor padrão definido serão marcadas com um asterisco.

Configure o nó Seqüência:

  1. Opcional: Na guia Descrição , digite uma Descrição curta, uma Descrição longa, ou ambas. Você também pode renomear o nó nessa guia.
  2. Na guia Básico, configure as propriedades que determinam como a sequência de mensagens é controlada.
    • Use a propriedade Caminho para armazenar número de sequência para especificar o local no qual salvar o número de sequência da mensagem. O local é especificado como uma expressão XPath.
    • Use a propriedade Caminho para o Identificador do Grupo de Sequências para especificar o local do identificador do grupo de sequências. O local é especificado como uma expressão XPath. As mensagens que possuem o mesmo identificador de grupo são consideradas como parte do mesmo grupo de sequências.
    • Use a propriedade Início de Definição de Sequência para especificar o primeiro número de sequência em cada grupo. No campo Literal, especifique qualquer valor numérico positivo ou negativo como o primeiro número de sequência no grupo. O valor padrão é 0.

      Quando a primeira mensagem de um grupo de sequências específico for propagada pelo nó Seqüência, o número de sequência inicial especificado será usado para designar o primeiro número de sequência; as mensagens sucessivas contêm números de sequência aumentados de maneira invariável. Este valor é substituído pela variável LocalEnvironment.Sequence.StartOfSequenceNumber.

    • Use a propriedade Fim de Definição de Sequência para especificar quando cada grupo de sequências foi concluído.
      • Selecione Literal para especificar um número de sequência literal. Este valor pode ser qualquer valor numérico positivo ou negativo que seja maior que o valor da propriedade Início da Definição de Sequência. Quando a mensagem com o número de sequência especificado chega, o grupo de sequências é fechado.
      • Selecione Predicado para especificar uma expressão XPath que é avaliada como True ou False, indicando se a mensagem é a última na sequência. Quando a primeira mensagem na sequência tiver sido determinada, mensagens para esse grupo de sequências continuarão tendo números de sequência designados a elas até o final do predicado da sequência ser avaliado como True.

        Se a expressão XPath for válida mas não estiver presente na mensagem, ela será avaliada como False e a próxima mensagem no grupo de sequências receberá um número de sequência. Quando o predicado for avaliado como True, a mensagem se tornará a última na sequência e nenhuma mensagem adicional será designada à sequência para esse grupo de sequências.

        Se a expressão XPath for inválida, ela falhará e a mensagem será revertida

      • Selecione Automático para especificar o período de tempo limite para o nó. Esta opção especifica quanto tempo (em segundos) o nó aguarda até que as mensagens cheguem a uma fila vazia, antes de fechar o grupo de sequências. Esta opção é útil para aplicativos que não podem determinar o número final na sequência. O cronômetro é iniciado quando não há mensagens na fila aguardando para serem propagadas. Se novas mensagens chegarem antes de o período de tempo limite ser atingido, o cronômetro será cancelado. Se nenhuma nova mensagem chegar antes do final do tempo especificado, o grupo de sequências será fechado e quaisquer mensagens adicionais para o grupo serão consideradas como parte de um novo grupo.
  3. Na guia Avançado:
    • Use a propriedade Modo de Persistência para especificar se deve armazenar o estado do grupo de sequências de maneira persistente. O valor-padrão é Não-persistente.

Terminais e Propriedades

Os terminais do nó Seqüência são descritos na tabela a seguir.

Terminal Descrição
In O terminal de entrada através do qual a montagem da mensagem recebida chega ao nó.
Falha O terminal de saída para o qual a mensagem é encaminhada se ocorrer um erro. Este valor inclui falhas causadas por processamento de repetições.
Saída O terminal de saída para o qual a mensagem de saída é propagada por padrão.

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 se você precisar inserir um valor quando nenhum padrão for definido); a coluna com cabeçalho C indica se a propriedade é configurável (é possível alterar o valor quando você incluir o fluxo de mensagens no arquivo BAR para implementação).

As propriedades Descrição do nó Seqüência são descritas na tabela a seguir.

Propriedade M P Default Descrição
Nome do Nó Não Não Seqüência O nome do nó.
Descrição curta 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 Básicas do nó Seqüência são descritas na tabela a seguir.

Propriedade M P Default Descrição
Caminho para número de sequência de armazenamento Não Não
$OutputLocalEnvironment/
Sequência/Número
Uma expressão XPath que especifica o local no qual salvar o número de sequência da mensagem.
Caminho para o Identificador do Grupo de Sequências Não Não Não configurado Uma expressão XPath que aponta para o local do identificador do grupo de sequências. As mensagens que possuem o mesmo identificador de grupo são consideradas como parte do mesmo grupo de sequências. Esta propriedade funciona da mesma maneira que a propriedade Caminho de Correlação no nó Collector.
Início de Definição de Sequência Sim Não 0 Especifica o primeiro número de sequência em cada grupo. Os valores válidos são números inteiros positivos ou negativos. O valor padrão é 0.
Fim de Definição de Sequência Sim Não Automático Especifica quando cada grupo de sequências foi concluído. Os valores válidos são:
  • Literal e número
  • Predicado e XPath
  • Automático e tempo em segundos
O padrão é Automático.

As propriedades Avançadas do nó Seqüência são descritas na tabela a seguir.

Propriedade M P Default Descrição
Modo de Persistência Sim Não Não-persistente Especifica se deve armazenar o estado do grupo de sequências de maneira persistente. As opções válidas são:
  • Não-persistente
  • Persistente
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:30:54


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