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 - z/OS

Use o comando mqsichangeflowmonitoring em z/OS para ativar o monitoramento dos fluxos de mensagens.

Sintaxe

Comando do Console do z/OS

Sinônimo: cm

Read syntax diagramSkip visual syntax diagram
>>-+-changeflowmonitoring-+---- BrokerName --------------------->
   '-cm-------------------'                     

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

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

>--+-------------------+--+---------------+--------------------><
   '-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.

Esse parâmetro é incluído na forma de console do comando.

c=Control
(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
e=ExecutionGroupName
(Necessário) Especifique o nome do grupo de execução no qual os fluxos de mensagens que você deseja monitorar são implementados.

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

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.

Exemplo

Ative o monitoramento em todos os fluxos de mensagens em todos os grupos de execução:
F MI10BRK,cm c=active,g=yes,j=yes 
Ative o monitoramento de todos os fluxos de mensagens no aplicativo application1 no grupo de execução default:
F MB8BROKER,cm c=active,e=default,k=application1,j=yes 
Ative o monitoramento do fluxo de mensagens myflow1 na biblioteca library1, referenciada pelo aplicativo application1, no grupo de execução default:
F MB8BROKER,cm c=active,e=default,y=library1,k=application1,f=myflow1
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 | ac37890_