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 mqsireportresourcestats

Use o comando mqsireportresourcestats para exibir estatísticas atuais reunindo opções para recursos no broker.

Plataformas Suportadas

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

Propósito

Use esse comando para visualizar o status da 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.

Sintaxe

Read syntax diagramSkip visual syntax diagram
>>-mqsireportresourcestats--| brokerSpec |---------------------->

>--+--------------------------+--+-------------------+---------->
   '- -e --executionGroupName-'  '- -d --detailLevel-'   

>--+-------------------+--+---------------------+--------------><
   '- -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.
-d detailLevel
O detailLevel especificado controla quantas informações exibir. Os valores válidos são:
0
Exiba informações combinadas. Essa opção é idêntica às versões anteriores de mqsireportresourcestats.
1
Exiba um resumo das definições configuráveis por grupo de execução. Essa opção é padrão.
2
Exiba informações detalhadas, incluindo definições não configuráveis.
-e executionGroupName
(Opcional) O nome do grupo de execução para o qual o status de coleta de estatísticas do recurso é relatado.

Se você não especificar -e, o status das estatísticas do recurso é relatado 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.

Se o comando for concluído com sucesso, uma mensagem de relatório por tipo de recurso será retornada para cada grupo de execução especificado pelo comando. Cada mensagem possui o formato geral:

BIP8940I As configurações de estatísticas para o tipo de recurso type no grupo de execução execution_group_name é state. [measurement]

em que:

  • type é o tipo de recurso. Para obter mais informações sobre os tipos de recursos para os quais as estatísticas podem ser solicitadas, consulte Estatísticas do Recurso.
  • state pode ser ativo ou inativo
  • measurement é um campo de repetição que depende do tipo de recurso; por exemplo, TotalSocketsOpened é retornado para o tipo de recurso Soquetes. Os detalhes de todas as medidas relatadas são fornecidos no Dados de Estatística do Recurso.

Exemplos

Solicite um relatório para o grupo de execução padrão no broker BrokerA para coleta de estatísticas para todos os recursos:

mqsireportresourcestats BrokerA -e default

Solicite um relatório para todos os grupos de execução no broker BrokerA para a coleta de estatísticas para todos os recursos:

mqsireportresourcestats BrokerA
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 | bn43210_