Implementando uma Saída de Usuário

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

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 intermediário procura nos seguintes locais pelas bibliotecas que contenham as saídas do usuário:
    • Início da mudançaA propriedade do intermediário UserExitPath define uma lista de diretórios separados por dois pontos (pontos e vírgulas no Windows). Utilize o sinalizador -x no comando mqsicreatebroker ou mqsichangebroker para configurar esta propriedade para grupos de execução de 32 bits para cada intermediário.

      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 intermediário 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 intermediário são procurados na ordem em que aparecem na propriedade.

      Fim da mudança
    • Início da mudançaPara extensões de 64 bits, não é possível utilizar o parâmetro -x para modificar o caminho de saída. Anexe o diretório contendo o diretório que possui os arquivos de extensão à variável de ambiente MQSI_USER_EXIT_PATH64. Fim da mudança
  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 intermediário, 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 intermediário. Você também pode alterar o estado padrão para um conjunto de saídas de usuário para ativo em uma base por intermediário utilizando o comando mqsichangebroker; neste caso, não é necessário reiniciar o intermediário.

    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 intermediário 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 intermediário, 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 estiverem ativas para um determinado fluxo, o intermediário as iniciará na ordem definida pelo comando mqsichangeflowuserexits.

Conceitos relacionados
Saídas de usuário
Avisos | Marcas Registradas | Downloads | Biblioteca | Suporte | Feedback

Copyright IBM Corporation 1999, 2009Copyright IBM Corporation 1999, 2009.
Última atualização : 2009-02-13 16:11:38

ac02160_