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

Implementando uma Saída de Usuário

Implementar a saída de usuário no broker.

Antes de começar:

  • Grave e compile o código de saída de usuário. Consulte o Desenvolvendo uma Saída de Usuário.
  • Verifique se a saída:
    1. Está em uma biblioteca que tem a extensão .lel
    2. Exporta as funções bipInitializeUserExits e bipTerminateUserExits

Você pode definir o estado da saída de usuário dinamicamente como ativo ou inativo, com base no fluxo por mensagem, sem reiniciar o intermediário.

Para implementar a saída do usuário:

  1. Instale o código de saída de usuário em um intermediário.

    A biblioteca que contém o código de saída de usuário deve ser instalado em um sistema de arquivos que possa ser acessado pelo intermediário. Por exemplo, o arquivo deve ter acesso de leitura e execução para o ID do usuário sob o qual o intermediário é executado. O broker consulta os seguintes locais para bibliotecas que contêm saídas de usuário:

    • A propriedade do broker UserExitPath define uma lista de diretórios separados por dois pontos (ponto-e-vírgula no Windows). Use o sinalizador –x no comando mqsicreatebroker ou mqsichangebroker para configurar esta propriedade para grupos de execução para cada broker.
    • Como alternativa, você pode anexar o diretório contendo o diretório que possui os arquivos de extensão à variável de ambiente MQSI_USER_EXIT_PATH associada ao ambiente no qual o broker está em execução.
    Se ambos forem configurados, a variável de ambiente terá precedência. Todos os diretórios na variável de ambiente são procurados na ordem em que aparecem na variável, em seguida, todos os diretórios na propriedade do broker são procurados na ordem em que aparecem na propriedade.
  2. Carregue a biblioteca de saída de usuário nos processos do intermediário.
    Quando a biblioteca de saídas de usuário tiver sido instalada no broker, será necessário carregá-la de uma das seguintes maneiras:
    • Pare e inicie novamente o intermediário.
    • Execute o comando mqsireload para reiniciar os processos do grupo de execução.
  3. Ative a saída de usuário.

    As saídas de usuário podem estar ativas ou inativas e, por padrão, ficam inativas. Você pode alterar o estado de uma saída de usuário dinamicamente utilizando o comando mqsichangeflowuserexits em uma base por fluxo, sem precisar reiniciar o broker. Também é possível alterar o estado padrão para um conjunto de saídas de usuário para ativo em uma base por broker, usando o comando mqsichangebroker; neste caso, é necessário reiniciar o broker.

    Para configurar o estado de saída padrão do usuário para um intermediário:

    1. Pare o intermediário.
    2. Configure a propriedade activeUserExits do broker utilizando o comando mqsichangebroker.
    3. Inicie o intermediário e verifique o registro do sistema para certificar-se de que todos os grupos de execução foram iniciados sem erro. Se quaisquer nomes de saídas de usuário inválidos forem especificados, (ou seja, a saída de usuário não é fornecida por nenhuma biblioteca carregada pelo grupo de execução), uma mensagem BIP2314 será gravada no log do sistema e todos os fluxos nos grupos de execução falharão ao iniciar, a menos que você execute uma das seguintes ações:
      • Forneça uma biblioteca no caminho da saída de usuário que implementa a saída; ao executar o comando mqsireload ou reiniciar o broker, para carregar uma saída a partir da biblioteca.
      • Execute o comando mqsichangeflowuserexits para remover a saída das listas ativa e inativa.

    Você também pode substituir o estado de saída de usuário padrão para um intermediário. É possível utilizar o comando mqsichangeflowuserexits para ativar ou desativar saídas de usuário em uma base por grupo de execução ou por fluxo de mensagens, com a ordem de precedência sendo o fluxo de mensagens, em seguida, o grupo de execução. Quando várias saídas estão ativas para um fluxo, o broker as inicia na ordem em que está definida pelo comando mqsichangeflowuserexits.

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


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