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 mqsilist - Sistemas Windows, Linux e UNIX

Use o comando mqsilist para listar informações sobre um ou mais brokers e seus recursos implementados.

Sintaxe

Ler diagrama de sintaxeManter visual do diagrama de sintaxe
>>-mqsilist--+----------------------------------+--------------->
             +- -a -----------------------------+   
             '-| brokerSpec |--+--------------+-'   
                               '- -e --egName-'     

>--+-------------------+--+-----------------------+--+------+--->
   '- -d --detailLevel-'  '- -k --applicationName-'  '- -r -'   

>--+---------------------+--+-------------------+--------------->
   '- -v --traceFileName-'  '- -w --timeoutSecs-'   

>--+-------------------+---------------------------------------><
   '- -y --libraryName-'   

brokerSpec

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

Se você especificar este comando sem parâmetros, um resumo será retornado para o broker que você criou na instalação atual neste computador.

A instalação atual está associada ao console do comando que você abriu (no Windows) ou ao mqsiprofile que está ativo (nos sistemas Linux e UNIX).

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.
-a
(Opcional) Liste todos os brokers instalados no computador local, em todas as instalações.

Se você especificar esta opção em um computador no qual instalou versões anteriores a Versão 7.0, apenas os brokers serão listados para essas versões, se eles existirem; o nível de detalhe corresponde a -d 0 para estes brokers anteriores, mesmo se você especificou (ou permitiu como padrão) um nível diferente de detalhe neste comando. Se desejar visualizar informações sobre outros componentes que você criou nas versões anteriores, você deverá usar a versão correspondente do comando mqsilist.

Não é possível usar esta opção para listar informações sobre brokers remotos e seus recursos.

-d detailLevel
(Opcional) Especifique o nível de detalhe a ser retornado; o valor-padrão é 1.
  • 0 retorna apenas o nome do broker e os nomes de seus gerenciadores de filas associados (estas informações são as mesmas que os detalhes fornecidos nas versões anteriores).

    Observe que enquanto eles estiverem iniciando os grupos de execução poderão relatar um PID de 0.

  • 1 retorna um resumo de linha de cada recurso.
  • 2 retorna informações detalhadas sobre cada recurso.
-e egName
(Opcional) Seleciona um grupo de execução em um intermediário. Especifique o rótulo do grupo de execução para o qual você deseja listar fluxos de mensagens. O comando retorna uma lista dos fluxos de mensagens designados ao grupo de execução especificado no intermediário.

O broker especificado deve estar ativo para que informações do fluxo de mensagens sejam retornadas.

-k applicationOrServiceName
(Opcional) Este parâmetro lista os objetos implementados que estão configurados para um aplicativo ou serviço. Ao usar esse parâmetro, você também deve especificar um grupo de execução usando o parâmetro -e.
-r
(Opcional) Execute o comando recursivamente; exiba informações sobre subcomponentes.
-v traceFileName
(Opcional) Esse parâmetro envia informações de rastreio interno de depuração para o arquivo especificado.
-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.
-y libraryName
(Opcional) Esse parâmetro lista os objetos implementados que estão configurados para uma biblioteca. Ao usar esse parâmetro, você também deve especificar um grupo de execução usando o parâmetro -e. É possível também usar o parâmetro -k com esse parâmetro para listar o conteúdo de uma biblioteca específica no aplicativo especificado pelo parâmetro -k.

Exemplos

O seguinte exemplo lista todos os brokers criados na instalação atual:
mqsilist -d0
As seguintes respostas são geradas:
BIP8099I: Broker: MB8BROKER  -  MB8QMGR
BIP8099I: Broker: test  -  testqm

BIP8071I: Conclusão do comando bem-sucedido.
O exemplo a seguir lista os objetos implementados que estão configurados para o aplicativo myApplication no grupo de execução padrão:
mqsilist MB8BROKER -e default -k myApplication
O exemplo a seguir lista os objetos implementados que estão configurados para a biblioteca myEGLibrary, contida no aplicativo myApplication, no grupo de execução padrão:
mqsilist MB8BROKER -e default -k myApplication -y myEGLibrary
O exemplo a seguir retorna informações detalhadas sobre o aplicativo myApplication no grupo de execução padrão:
mqsilist MB8BROKER  -e default -k myApplication -d2
O exemplo a seguir lista todos os objetos implementados configurados no aplicativo myApplication:
mqsilist MB8BROKER  -e default -k myApplication -r
O exemplo a seguir solicita um resumo dos grupos de execução que estão definidos em um broker específico. (O parâmetro -d não está especificado e portanto possui o valor padrão de 1).
mqsilist MB8BROKER 
As seguintes respostas são geradas:
BIP1286I: Grupo de execução 'ello' no broker 'MB8BROKER' está em
execução.

BIP8071I: Conclusão do comando bem-sucedido.
Exibe informações detalhadas sobre todos os recursos para os brokers no computador local:
mqsilist -a -r -d2
As seguintes respostas são geradas:
BIP1280I: The number of runtime installations on this machine is '1'.

 7.0.0.0 : C:\Program Files\IBM\MQSI\7.0

===================================
BIP1284I: Broker 'MB7BROKER' on queue manager 'MB7QMGR' is running.

Broker version: '7000' (build 'S000-L90708')
Platform: 'Microsoft Windows'
Process ID: '3116'
Short description: ''
Long description: ''

-----------------------------------
BIP1286I: Execution group 'ello' on broker 'MB7BROKER' is
running.

Número de fluxos de mensagens que são ativados para execução: '2'.
Número de aplicativos que são ativados para execução: '1'.
Process ID: '4220'
UUID: '45ef67ac-2201-0000-0080-f364270ba85e'
Short description: ''
Long description: ''

--------
BIP1288I: Message flow 'simpleflow' on execution group 'ello' is running.

Additional thread instances: '0'
Deployed: '24/07/09 16:37' in Bar file 'C:\Documents and Settings\Matt\My Documents\BAR Files\test.bar'
Last edited: '08/08/07 17:42'
User-defined property names:
Keywords:
  Author = 'Matt'
  Information = 'This flow simply removes messages from SYSTEM.DEFAULT.LOCAL.QUEUE'
  Usage = 'This usage is buried inside the CMF'
  VERSION = 'v1.1'
--------
BIP1288I: Message flow 'MyApplicationFlow' on execution group 'ello' is running.

Additional thread instances: '0'
Deployed: '27/07/09 20:15' in Bar file 'C:\Documents and Settings\Matt\My Documents\BAR Files\overridden.bar'
Last edited: '12/06/07 17:06'
User-defined property names:
Keywords:

--------
BIP1290I: File 'Swift_2002_MT103.dictionary' is deployed to execution group 'ello'.

Deployed: '27/07/09 16:47' in Bar file 'C:\Documents and Settings\Matt\My Documents\BAR Files\SWIFT.bar'
Last edited: '06/09/05 15:17'.
Keywords:

===================================
BIP1285I: Broker 'test' on queue manager 'testqm' is stopped.

Start the broker for more information.

BIP8071I: Conclusão do comando bem-sucedido.
A seguinte resposta é gerada quando um broker é um broker de várias instâncias em modo de Espera:
BIP1280I: The number of runtime installations on this machine is '1'.

 7.0.0.0 : C:\Program Files\IBM\MQSI\7.0

===================================
BIP1292I: Broker 'MIBROKER1' é um broker de várias instâncias.
A instância do broker está executando em modo de Espera em várias instâncias
Gerenciador de filas 'MIQMGR1'

Mais informações estarão disponíveis quando a instância do broker estiver ativa.

BIP8071I: Conclusão do comando com êxito
A resposta a seguir é gerada quando um broker for de várias instâncias em modo Ativo:
BIP1280I: The number of runtime installations on this machine is '1'.

 7.0.0.0 : C:\Program Files\IBM\MQSI\7.0

===================================
BIP1293I: Broker 'MIBROKER1' é um broker de várias instâncias.
A instância do broker está ativa e executando em várias instâncias
Gerenciador de filas 'MIQMGR1'

-----------------------------------
BIP1286I: O grupod de execução 'padrão' no broker 'MIBROKER1' está executando.

Número de fluxos de mensagens que são ativados para execução: '1'.
Número de aplicativos que são ativados para execução: '1'.
ID do Processo: '4876'
UUID: '45ef7be4-2203-0000-0080-b764270fa96c'
Short description: ''
Long description: ''

--------
BIP1288I: O fluxo de mensagens 'jmsflow' no grupo de execução 'padrão' está executando.

Additional thread instances: '0'
Implementado: '26/09/09 18:21' no arquivo Bar 'C:\Documents and Settings\JDoe\My Documents\
  BAR Files\test.bar'
Editado pela Última Vez: '24/09/09 12:16'
User-defined property names:
Keywords:
  Autor = 'JDoe'
  Informações = 'This flow runs a simple jms scenario'
  Uso = 'Takes JMS input and writes to an MQOutput node'
  VERSÃO = 'v2.3'
--------

BIP8071I: Conclusão do comando bem-sucedido.
A resposta a seguir é gerada quando um broker é um broker com múltiplas instâncias que está sendo iniciado como um serviço do WebSphere MQ:
BIP1296I: Broker 'HABK1' is a multi-instance broker that will be started as a WebSphere MQ service.
Multi-instance queue manager 'HAQM1' is stopped.
BIP1298I: Broker 'BK3' will be started as a WebSphere MQ service. 
Queue manager 'QM3' is stopped.
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:30:11


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