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 mqsichangeresourcestats

Use o comando mqsichangeresourcestats para controlar a reunião de estatísticas para recursos no broker.

Plataformas Suportadas

  • Sistemas Windows
  • Sistemas Linux e UNIX
  • z/OS®. Execute esse comando customizando e enviando o BIPCHRS; consulte Conteúdo do PDSE do Broker

Propósito

Use esse comando para iniciar ou parar a coleção de estatísticas para os tipos de recursos listados em Dados de Estatística do Recurso.

É possível executar este comando apenas se o broker estiver executando. Se você iniciar a coleta de estatísticas, então pare e reinicie o broker, não é necessário reexecutar este comando; o status ativo é mantido quando o broker é iniciado novamente.

Se você iniciar a coleta de estatísticas para todos os grupos de execução de um broker, será possível parar a coleta em todos os grupos de execução ou em grupos de execução individuais. Se você iniciar a coleta de estatísticas para grupos de execução individuais, será possível parar a coleta para esses grupos de execução específicos ou para todos os grupos de execução.

Sintaxe

Read syntax diagramSkip visual syntax diagram
>>-mqsichangeresourcestats--| brokerSpec |-- -c --Controle------>

>--+--------------------------+--+-------------------+---------->
   '- -e --executionGroupName-'  '- -w --timeoutSecs-'   

>--+---------------------+-------------------------------------><
   '- -v --traceFileName-'   

brokerSpec

|--+- brokerName ----------------+------------------------------|
   +- -n --brokerFileName--------+   
   | .-------------------------. |   
   | V                         | |   
   '-----+- -i --ipAddress-+---+-'   
         +- -p --port------+         
         '- -q --qMgr------'         

Parâmetros

brokerSpec
(Necessário) Você deve especificar pelo menos um parâmetro para identificar o broker de destino para esse comando, de uma das seguintes formas:
brokerName
Este parâmetro identifica o nome de um broker definido localmente. Você não poderá usar esta opção se o broker estiver em um computador remoto.
-n brokerFileName
Este parâmetro identifica o nome de um arquivo que contém os detalhes da conexão para um broker local ou remoto.

Use esta opção se múltiplos usuários desejarem se conectar ao mesmo broker ou se você estiver usando parâmetros de conexão avançada, como SSL.

Para criar este arquivo, clique com o botão direito do mouse no broker no WebSphere® Message Broker Explorer e selecione Exportar Arquivo *.broker. Quando solicitado, navegue para o local no qual você deseja salvar o arquivo e insira o nome do arquivo; a extensão .broker é anexada automaticamente ao clicar em Salvar. Inclua o local (caminho) e o nome do arquivo quando especificar este parâmetro. Você deverá assegurar que o local seja acessível quando executar este comando.

Para executar um comando que use SSL para administrar um broker remoto através de um canal seguro, você deve especificar a senha de keystore e de truststore da conexão usando a variável de ambiente IBM_JAVA_OPTIONS. Consulte Resolvendo Problemas ao Executar Comandos para obter informações adicionais.

-i ipAddress, -p port, -q qMgr
Estes parâmetros identificam os detalhes de conexão do broker.

Use esta opção para conexões com brokers remotos que não requerem parâmetros de conexão avançada.

Se você escolher esta opção, deverá especificar pelo menos um destes três parâmetros; a ordem na qual eles são especificados é insignificante. Não é possível especificar cada parâmetro mais de uma vez.

Os parâmetros que forem omitidos assumirão valores-padrão:

  • -i ipAddress: O nome do host ou o endereço IP do computador no qual o broker está em execução. Se você não especificar este parâmetro, um valor que representa o computador local será usado.
  • -p port: A porta TCP na qual o gerenciador de filas do broker está atendendo. Se você não especificar este parâmetro, o valor 1414 será usado.
  • -q qMgr: O nome do gerenciador de filas do broker. Se você não especificar este parâmetro, um valor que representa o gerenciador de filas padrão no computador local será usado.
Não é possível conectar-se a um gerenciador de filas remotas no z/OS; consulte Nota sobre o Uso.
-c Controle
(Necessário) O valor para definir a ação a ser aplicada para a coleta de estatísticas do recurso:
  • Especifique ativo para iniciar a coleta de estatísticas do recurso
  • Especifique inativo para parar a coleta de estatísticas do recurso
-e executionGroupName
(Opcional) O nome do grupo de execução para o qual a coleta de estatísticas do recurso é iniciada ou parada.

Se você não especificar -e, a coleta de estatísticas do recurso é iniciada ou parada para todos os grupos de execução no broker.

-w timeoutSecs
(Opcional) Este parâmetro especifica o tempo, em segundos, que o utilitário espera para assegurar que o comando foi concluído; o valor-padrão é 60.
-v traceFileName
(Opcional) Esse parâmetro envia informações de rastreio interno de depuração para o arquivo especificado.

Nota sobre o Uso

Se você tentar se conectar a um broker remoto especificando os parâmetros i, p e q ou usando um arquivo de parâmetro de conexão (.broker), o comando tentará usar o código do cliente WebSphere MQ Java™. Esta opção não é suportada no z/OS e retorna o seguinte erro:

BIP1046E: Não é possível se conectar ao broker (name)

O código de razão relatado é MQRC_ENVIRONMENT_ERROR. É necessário especificar um gerenciador de filas locais.

Autorização

Para obter informações sobre autorizações específicas da plataforma, consulte os tópicos a seguir: Se você tiver ativado a segurança de administração do broker, também deverá configurar a autoridade detalhada em Tarefas e Autorizações para Segurança de Administração.

Respostas

Esse comando retorna as seguintes respostas:
0
O comando foi concluído com sucesso.
2
(Falha) O broker recebeu o pedido de implementação mas não conseguiu processá-lo com êxito. Consulte as mensagens emitidas a partir do utilitário (ou do Log de administração) para obter informações adicionais.
9
(Falha) O pedido foi enviado para o broker, mas não foi recebida nenhuma resposta antes da expiração do tempo limite.
10
(Falha) Outro usuário ou aplicativo cancelou a operação de pedido antes de ser processada pelo broker.
98
O broker não está em execução.
99
Um ou mais dos parâmetros especificados são inválidos.

Exemplos

Inicie a coleta de estatísticas do recurso para todos os grupos de execução no BrokerA:

mqsichangeresourcestats BrokerA -c active

Pare a coleta de estatísticas do recurso para o grupo de execução padrão no broker BrokerA:

mqsichangeresourcestats BrokerA -c inactive -e default
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:31:39


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