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:
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:
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.
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:
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.
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
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 |
|
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:
|
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:
|
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. |