Parando um monitor de recursos MFT

A partir de IBM® MQ 9.3.0, é possível parar monitores de recursos sem precisar parar ou reiniciar um agente usando o comando fteStopMonitor .

Antes de Começar

Se o gerenciamento de autoridade do usuário tiver sido ativado configurando o atributo authorityChecking para true no arquivo agent.properties , você deve ter autoridade Monitor ou Monitor para parar um monitor de recursos. Para obter mais informações sobre o gerenciamento de autoridade do usuário, consulte Restringindo as autoridades do usuário em MFT ações do agente.

Sobre esta tarefa

Você pode executar o comando fteStopMonitor a partir de qualquer sistema onde o componente Managed File Transfer comandos esteja instalado, o que significa que você pode parar um monitor de recursos de qualquer lugar, e não se restringe ao sistema em que o agente que possui o monitor de recursos está em execução. Para obter informações sobre os parâmetros obrigatórios e opcionais desse comando, consulte fteStopMonitor (parar um monitor de recursos MFT ).

Quando um monitor de recursos é interrompido, ele grava uma mensagem para o log de eventos do monitor de recursos do agente, resmoneventnumber.log. Se o monitor de recurso for interrompido com o comando fteStopMonitor, a mensagem incluirá o nome do usuário que emitiu a solicitação de parada:
Monitor de recursos parado pelo usuário '<mquser_id>'

Um monitor de recurso é iniciado automaticamente se o seu agente é reiniciado, mesmo se o monitor de recurso foi interrompido anteriormente usando o comando fteStopMonitor.

Os agentes processam as solicitações de parada do monitor de forma seriada em vez de em paralelo, portanto, por exemplo, se um agente recebe uma solicitação para parar o monitor M1 e, em seguida, outra solicitação para parar o monitor M2 em rápida sucessão, ele para o M1 primeiro antes de tentar parar o M2.

Procedimento

  • Para descobrir o estado de um agente antes ou depois de executar o comando fteStopMonitor , use o comando fteListMonitors com o parâmetro -v como mostrado no exemplo a seguir:
    fteListMonitors -ma monitoring_agent_name -v
  • Para parar um monitor de recursos em um agente em execução na mesma máquina, digite o comando fteStopMonitor da seguinte forma:
    fteStopMonitor -mn monitor_name -ma agent_name
  • Para parar um monitor de recursos em um agente em execução em uma máquina diferente, digite o comando fteStopMonitor da seguinte forma:
    fteStopMonitor -mn monitor_name -ma agent_name -mm AgentQueueManager

    Se o gerenciador de filas de comando também for o gerenciador de filas do agente para o agente de monitoramento, o parâmetro -mm será opcional, caso contrário, deve-se especificar o gerenciador de filas do agente com o parâmetro -mm.

Resultados

Se o agente estiver em execução, o monitor de recurso será interrompido se ele foi iniciado atualmente. O comando gera as mensagens a seguir e registra um evento no output0.logdo agente:
BFGCL0813I: uma solicitação para parar o monitor de recurso 'MNTR' do agente 'SOURCE' foi emitida. 
BFGCL0251I: O pedido foi concluído com êxito.

Para obter informações sobre as mensagens que o comando emite se não puder interromper o monitor de recursos, consulte fteStopMonitor (interromper um MFT monitor de recursos)