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

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

Sintaxe

Comando z/OS - BIPLIST

Ler diagrama de sintaxeManter visual do diagrama de sintaxe
>>-mqsilist--+---------------------------------+---------------->
             '-| 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------'         

Comando do Console do z/OS

Sinônimo: l

Ler diagrama de sintaxeManter visual do diagrama de sintaxe
>>-+-list-+--+-----------+--+--------+--+----------------+-----><
   '-l----'  '- e=egName-'  '- r=sim-'  '- d=detailLevel-'   

Se você especificar este comando sem parâmetros, uma lista dos grupos de execução será exibida.

Parâmetros

brokerSpec
Você deve especificar pelo menos um parâmetro para identificar o broker de destino para este comando, em um dos seguintes formatos:
brokerName
Este parâmetro identifica o nome de um broker definido localmente.
-n brokerFileName
Este parâmetro identifica o nome de um arquivo que contém os detalhes da conexão para um broker local.

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.

-i ipAddress, -p port, -q qMgr
Estes parâmetros identificam os detalhes de conexão do broker. Se você especificar um gerenciador de filas, ele deverá ser definido no computador local.

Se você escolher esta opção, deverá especificar pelo menos um destes três parâmetros: a ordem na qual eles são especificados é irrelevante. 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
(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.

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.

Exemplos

Use o comando de console para solicitar um resumo dos grupos de execução para o broker. (O parâmetro d= não está especificado e portanto possui o valor padrão de 1).
F MQP1BRK,list 
As seguintes respostas são geradas:
BIP1286I: Grupo de execução 'ello' no broker 'MQP1BRK' está em
execução.

BIP8071I: Conclusão do comando bem-sucedido.
Use o comando de console para listar os fluxos de mensagens no grupo de execução especificado:
F MQP1BRK,list e='exgrp1'		
As respostas geradas estão no seguinte formato:
BIP1288I: Fluxo de mensagens 'simpleflow' no grupo de execução
'ello' está em execução.

BIP8071I: Conclusão do comando com êxito
Use o comando de console para listar objetos implementados que estão configurados para a biblioteca myEGLibrary, contida no aplicativo myApplication, no grupo de execução padrão:
F MB8BROKER,list e='default' k='myApplication' y='myEGLibrary'

Para obter exemplos de como executar o comando usando BIPLIST, e as respostas que são geradas, consulte Comando mqsilist - Sistemas Windows, Linux e UNIX.

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 | an28320_