Comando mqsichangeflowuserexits

Utilize o comando mqsichangeflowuserexits para configurar a lista de saídas de usuário ativas ou inativas. Há uma lista de saídas de usuário ativas e uma de inativas para cada grupo de execução e fluxo de mensagens. O estado efetivo de saídas do usuário para um determinado fluxo é decidido quando o fluxo é iniciado.

Sistemas Operacionais Suportados

  • Windows
  • Sistemas Linux e UNIX
  • z/OS. Execute esse comando de uma de duas maneiras - como um comando do console ou customizando e enviando BIPCHUE; consulte Conteúdo do PDSE do Intermediário

Propósito

A ordem de precedência é o fluxo de mensagens, o grupo de execução e, em seguida, o padrão do intermediário. A lista ativa tem precedência sobre a lista inativa nas configurações do fluxo de mensagens e do grupo de execução.

Se o estado para uma determinada saída de usuário não for configurado para o fluxo de mensagens, seu estado será extraído da configuração do grupo de execução. Se seu estado não for configurado para o fluxo de mensagens ou o grupo de execução, ele assumirá o estado padrão que é implicitamente inativo ou pode ser explicitamente definido como ativo pela propriedade do intermediário activeUserExits, através do comando mqsichangebroker.

Se um determinado nome de saída de usuário estiver presente nas listas ativas e inativas para um fluxo de mensagens ou um grupo de execução, a lista ativa terá precedência e a saída de usuário estará ativa para esse nível. Portanto, se você deseja alterar uma saída de usuário de ativa para inativa, deve especificá-la como parte da lista inativa, utilizando o sinalizador -i e também removê-la da lista ativa, especificando novamente a nova lista ativa, utilizando o sinalizador -a.

Quando as várias saídas estiverem ativas para um determinado fluxo, elas serão chamadas em uma ordem definida. Essas saídas na lista ativa do fluxo de mensagens são chamadas primeiro na ordem em que foram especificadas no sinalizador -a.

Depois que forem chamadas, as saídas na lista ativa do grupo de execução (que não estavam na lista ativa nem inativa do fluxo de mensagens) serão chamadas. Estas saídas são chamadas na ordem em que foram especificas no sinalizador -a.

Todas as saídas do usuário que não forem mencionadas na lista ativa ou inativa do grupo de execução ou do fluxo de mensagem, mas que forem mencionadas na lista ativa do intermediário, serão chamadas na ordem em que foram especificadas quando a propriedade do intermediário activeUserExits foi configurada.

Se alguma das saídas do usuário especificadas na lista ativa ou inativa não estiverem registradas para o grupo de execução de destino, o comando falhará com um erro BIP8858.

Após uma conclusão bem-sucedida do comando, se alguma saída do usuário ficar inválida, dependendo da lista na qual a saída do usuário apareceu, será adotada a seguinte ação:
  • Se a saída do usuário foi especificada na lista ativa ou inativa do fluxo de mensagens, o fluxo falhará ao ser iniciado e uma mensagem BIP2315 será gravada no log do sistema.
  • Se a saída do usuário foi especificada na lista ativa ou inativa do grupo de execução, o grupo de execução falhará ao ser iniciado e uma mensagem BIP2314 será gravada para no log do sistema.
Uma saída de usuário pode se tornar inválida por uma das seguintes razões:
  • O intermediário ou o grupo de execução é reiniciado depois que você altera a variável MQSI_USER_EXIT_PATH, removendo o diretório que contém a biblioteca de saída de usuário.
  • O intermediário ou o grupo de execução é reiniciado depois que você altera a propriedade userExitPath removendo o diretório que contém a biblioteca de saída de usuário.
  • A biblioteca de saída de usuário (ou uma de suas dependências) é removida ou o intermediário não consegue carregá-la.
Selecione o link apropriado para obter detalhes desse comando na plataforma, ou plataformas, que a sua empresa utiliza:

Autorização

Nos sistemas Windows, Linux e UNIX, o ID do usuário utilizado para executar este comando deve ser membro do grupo mqbrkrs.

Conceitos relacionados
Saídas de usuário
Referências relacionadas
Comando mqsireportflowuserexits
Avisos | Marcas Registradas | Downloads | Biblioteca | Suporte | Feedback

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

an35900_