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

Configurando Propriedades do Manipulador de Eventos

Você pode configurar propriedades do manipulador de eventos para cada terminal de entrada dinâmico em um nó Collector. Estas propriedades do manipulador de eventos determinam como as mensagens recebidas por cada terminal são incluídas em coletas de mensagens.

Antes de começar:

É possível usar uma ou mais das propriedades do manipulador de eventos para controlar a maneira como as mensagens são incluídas nas coletas de mensagens para cada terminal de entrada que você incluiu no nó Collector. As coletas de mensagens não concluídas são armazenadas em uma fila do WebSphere MQ. As coletas de mensagens são armazenadas na ordem em que foram geradas no nó Collector (primeiro a entrar, primeiro a sair). Cada coleta de mensagens possui uma instância do manipulador de eventos para cada um dos terminais de entrada. O manipulador de eventos determina se uma mensagem que chega nesse terminal será incluída em uma coleta de mensagens. A instância do manipulador de eventos mantém informações sobre o estado da coleta, o número de mensagens recebidas, o cronômetro e a cadeia de correlação. Quando uma nova mensagem é recebida em um terminal de entrada, ela é oferecida ao manipulador de eventos para cada coleta de mensagens que está aguardando na fila, seqüencialmente. Quando a mensagem for aceita por um dos manipuladores de eventos, ela será incluída na coleta de mensagens. A mensagem aceita não é oferecida a nenhuma outra coleta de mensagens. Se todos os manipuladores de eventos rejeitarem a mensagem, ela será incluída em uma nova coleta de mensagens, que será incluída no final da fila.

A primeira mensagem aceita em uma coleta determina a cadeia de correlação para essa coleta de mensagens, se estiver configurada. As mensagens subseqüentes oferecidas a essa coleta de mensagens serão aceitas apenas se sua cadeia de correlação corresponder à da coleta. A primeira mensagem aceita por cada manipulador de eventos inicia o cronômetro de tempo limite, se ele estiver configurado. Cada mensagem aceita por cada manipulador de eventos aumenta a contagem da quantidade. Um manipulador de eventos se torna atendido quando o número de mensagens aceitas é igual à quantidade configurada, ou quando o valor de tempo limite é atingido. Quando um manipulador de eventos for atendido, ele não mais aceita mensagens adicionais. Uma coleta de mensagens será concluída apenas quando todos os manipuladores de eventos da coleta de mensagens forem atendidos. A coleta de mensagens então estará pronta para propagação.

É possível configurar as propriedades do manipulador de eventos usando a tabela Definição de Coleta, na guia Básico da visualização Propriedades.

Para configurar as propriedades do manipulador de eventos no nó Collector:

  1. Abra o fluxo de mensagens com o nó Collector.
  2. Clique com o botão direito do mouse no nó Collector e selecione Propriedades.
  3. Clique na guia Básico.
  4. Utilize as instruções a seguir para configurar as propriedades do manipulador de eventos que você deseja configurar para cada terminal de entrada:
    • Se desejar incluir um número configurado de mensagens em cada coleta de mensagens a partir de um ou mais dos terminais, será necessário digitar um valor para Quantidade na tabela Definição de Coleta. Este valor é utilizado para especificar o número de mensagens que cada terminal de entrada configurado aceita para concluir uma coleta. Por exemplo, se você tiver configurado Quantidade para esperar 2 mensagens nos três dos terminais de entrada, a coleta de mensagens não estará completa até que 2 mensagens tenham sido recebidas em cada um dos três terminais de entrada. A coleta de mensagens concluída contém 6 mensagens, 2 de cada um dos três terminais. Assim que mais de 2 mensagens forem recebidas em um dos terminais de entrada, a próxima mensagem será incluída em uma nova coleta de mensagens.
      1. Na tabela Definição de Coleta, clique na linha para o terminal de entrada selecionado na coluna Quantidade.
      2. Digite um valor para o número de mensagens de entrada que deseja incluir em uma coleta de mensagens. Se você selecionar Zero ou escolher não configurar esta propriedade, não haverá limite para o número de mensagens aceitas. Neste caso, o valor configurado na propriedade Tempo Limite deverá ser maior do que zero. Se você aceitar o valor-padrão de 1; somente uma mensagem do terminal selecionado será incluída em uma coleta.

      Você deve digitar um valor para Quantidade se Tempo Limite não estiver definido.

    • Se desejar coletar mensagens por um período de tempo configurado antes da propagação da coleta de mensagens, será necessário digitar um valor para Tempo Limite. Este valor é usado para especificar o tempo máximo em segundos pelo qual o terminal de entrada selecionado aceita mensagens antes de concluir uma coleta de mensagens. O intervalo de tempo limite será iniciado quando a primeira mensagem tiver chegado no terminal selecionado. As mensagens subseqüentes serão incluídas na mesma coleta de mensagens. Quando o intervalo de tempo limite for encerrado, não mais serão incluídas mensagens na coleta de mensagens deste terminal. Quando as condições em todos os terminais são satisfeitas, a coleta de mensagens está pronta para propagação. Quando a próxima mensagem chegar ao terminal de entrada selecionado, será criada uma nova coleta de mensagens e o intervalo de tempo limite será iniciado novamente. Se um tempo limite estiver configurado em vários terminais de entrada, cada terminal coletará mensagens para o período de tempo configurado. Durante o tempo limite, mensagens de todos os terminais são incluídas na mesma coleta de mensagens.
      1. Na tabela Definição de Coleta, clique na linha para o terminal de entrada selecionado na coluna Tempo Limite.
      2. Digite um valor para o período de tempo, em segundos, que você deseja aguardar para incluir mensagens em uma coleta de mensagens. Por exemplo, para aguardar para incluir mensagens em uma coleta de mensagens por um hora, digite um valor de 3600. Se você aceitar o valor-padrão Zero, o tempo limite não será ativado e não haverá limite no tempo de espera por mensagens. Neste caso, o valor configurado na propriedade Quantidade deverá ser maior do que zero.

      Você deve digitar um valor para Tempo Limite se Quantidade não estiver definido.

    • Se desejar incluir mensagens em diferentes coletas de mensagens com base no conteúdo da mensagem, será necessário digitar um valor XPath para o Caminho de Correlação. Este valor é utilizado para especificar o caminho na mensagem que chega do qual extrair a cadeia de correlação. A cadeia de correlação é o valor extraído pelo caminho de correlação. Se um padrão de correlação for especificado, a cadeia de correlação será correspondida com relação ao padrão de correlação. As mensagens são aceitas apenas em uma coleta de mensagens com a mesma cadeia de correlação. Se você especificar um asterisco (*) no nome da coleta de mensagens, ele será substituído pela cadeia de correlação.
      1. Na tabela Definição de Coleta, clique na linha para o terminal de entrada selecionado na coluna Caminho de Correlação.
      2. Selecione um caminho de correlação predefinido da lista ou digite seu próprio caminho de correlação utilizando XPath. O caminho de correlação deve ser iniciado com um nome de correlação, que pode ser seguido por zero ou mais campos do caminho. Por exemplo, na mensagem a seguir, a cadeia de correlação será xxx no campo de nome:
        <library>
        	<name>xxx</name>
        	<more>
        		...
        	</more>
        </library>
        Neste exemplo, o caminho de correlação utilizando XPath é $Body/library/name.

        As variáveis $Root, $LocalEnvironment e $Environment estão disponíveis para permitir que o caminho inicie nas raízes da mensagem, do ambiente local, das árvores de ambiente e do corpo da mensagem.

      Se o caminho de correlação for avaliado como uma cadeia vazia, será incluída uma mensagem não correspondente em uma coleta de mensagens não denominada padrão.

      Se você definir um valor para Caminho de Correlação, opcionalmente, poderá configurar um Padrão de Correlação.

    • Se você desejar corresponder uma subcadeia do conteúdo da mensagem do Caminho de Correlação, poderá definir um padrão para corresponder na mensagem usando o Padrão de Correlação. O Padrão de Correlação contém um único caractere curinga e texto opcional. A cadeia de correlação, utilizada para o nome da coleta de mensagens, faz parte da subcadeia correspondente ao curinga. Por exemplo, se o caminho de correlação contiver o nome do arquivo part1.dat em um arquivo de cabeçalho e o padrão de correlação for especificado como *.dat, a cadeia de correlação será part1.

      Se esta propriedade estiver configurada, apenas as mensagens que possuem a mesma cadeia de correlação serão incluídas na mesma coleta de mensagens. A primeira mensagem incluída em uma coleta de mensagens determina a cadeia de correlação que deve corresponder a todas as demais mensagens nessa coleta de mensagens.
      1. Na tabela Definição de Coleta, clique na linha para o terminal de entrada selecionado na coluna Padrão de Correlação.
      2. Digite um valor para o padrão de correlação. O Padrão de Correlação deve conter um único caractere curinga: *. Opcionalmente, este caractere curinga pode ser colocado entre outro texto.

      Se o padrão de correlação falhar ao corresponder o curinga a uma subcadeia, a mensagem não correspondida será incluída em uma coleta de mensagens não denominada padrão.

  5. Repita a etapa 4 para cada um dos terminais de entrada incluídos no nó Collector. Você pode configurar diferentes manipuladores de eventos para diferentes origens de entrada.
Nota: Certifique-se de que as propriedades do manipulador de eventos em diferentes terminais correspondam cuidadosamente à entrega esperada de mensagens para os terminais no nó Collector.
Agora é possível configurar a expiração da coleta, consulte Configurando a Expiração da Coleta.
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:40


Tópico de TarefaTópico de Tarefa | Versão 8.0.0.5 | ac37730_