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

Comando mqsichangeflowmonitoring - sistemas Windows Linux e UNIX

Use o comando mqsichangeflowmonitoring em sistemas Windows Linux e UNIX para ativar o monitoramento dos fluxos de mensagens.

Sintaxe

Read syntax diagramSkip visual syntax diagram
>>-mqsichangeflowmonitoring---- BrokerName --------------------->

>--+-+----------------+--+-----------------------------+-+------>
   | '- -c --Controle-'  '- -m --MonitoringProfileName-' |   
   |                         .-,------------------.      |   
   |                         V                    |      |   
   '- -i --EventState-- -s ----EventSourceAddress-+------'   

                                                       (1)   
>--+- -e --ExecutionGroupName--+- -f --MessageFlow-+-+---------->
   |                           '- -j --------------' |       
   '- -g -- -j --------------------------------------'       

>--+-----------------------+--+-------------------+------------><
   '- -k --applicationName-'  '- -y --libraryName-'   

Notes:
  1. Consulte as descrições do parâmetro para obter informações sobre combinações válidas dos parâmetros e,f, g e j .

Parâmetros

BrokerName
(Necessário) Especifique o rótulo do broker no qual os fluxos de mensagens que você deseja monitorar são implementados.
-c Controle
(Opcional) Especifique o valor de cadeia que controla o monitoramento para os fluxos de mensagens especificados. Os valores possíveis são:
  • active - ativa o monitoramento
  • inactive - desativa o monitoramento
-f MessageFlow
(Necessário) Especifique o rótulo para o fluxo de mensagens para o qual as opções de monitoramento devem ser ativadas ou atualizadas.

Você deve especificar -f ou -j. Se você não especificar um destes argumentos, receberá uma mensagem de erro.

-g
(Obrigatório) Especifica que o comando se aplica a todos os grupos de execução que pertencem ao intermediário.

Você deve especificar -e ou -g. Se você não especificar um destes argumentos, receberá uma mensagem de erro.

-i EventState
(Opcional) Especifique o valor da cadeia que controla o monitoramento para a fonte de eventos especificada. Válido apenas quando for utilizado com os parâmetros -e e -f. Os valores possíveis são:
  • enable - ativa o monitoramento para as fontes de eventos especificadas.
  • disable - desativa o monitoramento para as fontes de eventos especificadas.
-j
(Obrigatório) Especifica que o comando se aplica a todos os fluxos de mensagens que pertencem ao grupo de execução.

Você deve especificar -f ou -j. Se você não especificar um destes argumentos, receberá uma mensagem de erro.

Note: Se você definir a opção -g para todos os grupos de execução, precisará utilizar -j em vez de -f .
-k applicationName
(Opcional) Esse parâmetro especifica o nome do aplicativo que contém o fluxo de mensagens a ser monitorado.

Ao configurar esse parâmetro, você também deve configurar o parâmetro -f (fluxo de mensagens) ou o parâmetro -j (todos os fluxos de mensagens). Para permitir o monitoramento de um fluxo de mensagens nomeado em um aplicativo específico, configure os parâmetros -k e -f. Para permitir o monitoramento de todos os fluxos de mensagens em um aplicativo, configure os parâmetros -k e -j.

É possível usar esse parâmetro com o parâmetro -y (nome da biblioteca) para especificar que o fluxo de mensagens está contido em uma biblioteca referenciada pelo aplicativo.

-m MonitoringProfileName
(Opcional) Especifique o nome do perfil de monitoramento que os fluxos de mensagens especificados devem utilizar.

Se não houver nenhum perfil de monitoramento com o nome especificado no intermediário especificado, isto indica que o comando foi concluído com êxito e os fluxos de mensagens tentarão utilizar o perfil de monitoramento especificado. Cada fluxo de mensagens registra um aviso no Rastreio do Usuário para indicar que foi instruído para utilizar um perfil de monitoramento inexistente. Não é criada nenhuma mensagem do evento. Se um perfil de monitoramento com o nome especificado for implementado posteriormente no intermediário, os fluxos de mensagens não começarão a utilizá-lo imediatamente. Uma atualização do estado de monitoramento pode ser acionada emitindo o comando novamente com a opção –c para ativar ou reativar o monitoramento.

-s EventSourceAddress
(Opcional) Lista separada por vírgula das fontes de eventos que devem ser ativadas ou desativadas. Válido apenas quando for utilizado com os parâmetros -e e -f. Este valor toma a forma de <node name>.<event source>, em que <event source> é um dos valores a seguir:
  • 'terminal.<nome do terminal>'
  • 'transaction.Start'
  • 'transaction.End'
  • 'transaction.Rollback'

Se um fluxo de mensagens contém dois ou mais nós com nomes idênticos, as fontes de eventos nesses nós não poderão ser endereçadas com exatidão. Caso haja essa tentativa, o comportamento será indefinido.

<nome do nó> é o rótulo do nó como ele é conhecido pelos componentes de tempo de execução do intermediário. Se o nó estiver em um subfluxo, a etiqueta refletirá isto. Por exemplo, o fluxo A contém uma instância do fluxo B como um subfluxo que está rotulado como 'myB'. Fluxo B contém uma instância de um nó Compute que está rotulado como 'myCompute'. O <nome do nó> para o nó Compute é 'myB.myCompute'.

Se você emitir este comando com uma lista separada por vírgulas para ativar ou desativar origens de eventos individuais e ainda não tiver emitido o comando com o parâmetro -c, o monitoramento não será ativado para essas origens de eventos. Para ativar o monitoramento, reemita o comando com o parâmetro -c configurado como active.

-y libraryName
(Opcional) Esse parâmetro especifica o nome da biblioteca que contém o fluxo de mensagens a ser monitorado.

Ao configurar esse parâmetro, você também deve configurar o parâmetro -f (fluxo de mensagens) ou o parâmetro -j (todos os fluxos de mensagens). Para permitir o monitoramento de um fluxo de mensagens nomeado em uma biblioteca específica, configure os parâmetros -k e -f. Para ativar o monitoramento de todos os fluxos de mensagens em uma biblioteca, configure os parâmetros -k e -j.

Exemplos

Designe monitoringProfile1 a messageFlow1 no grupo de execução default:
mqsichangeflowmonitoring WBRK_BROKER -e default 
     -f messageFlow1 -m monitoringProfile1
Ativa o monitoramento para todos os fluxos de mensagens em todos os grupos de execução:
mqsichangeflowmonitoring WBRK_BROKER -c active -g -j
Ative o monitoramento de todos os fluxos de mensagens no aplicativo application1 no grupo de execução default:
mqsichangeflowmonitoring MB8BROKER -c active -e default -k application1 -j 
Ative o monitoramento do fluxo de mensagens myflow1 na biblioteca library1, referenciada pelo aplicativo application1, no grupo de execução default:
mqsichangeflowmonitoring MB8BROKER -c active -e default -y library1 -k application1 -f myflow1
Ativa fontes de eventos individuais:
mqsichangeflowmonitoring WBRK_BROKER 
     padrão -e 
     -f myMessageFlow 
     -s "SOAP Input1.terminal.out,MQOutput1.terminal.in" 
     -i enable
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:41


Tópico de ReferênciaTópico de Referência | Versão 8.0.0.5 | ac37870_