Implementar a saída de usuário no broker.
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:
- 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.
- 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.
- 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:
- Pare o intermediário.
- Configure a propriedade activeUserExits do broker
utilizando o comando mqsichangebroker.
- 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.