Comando mqsilist (Listar Recursos)

Plataformas Suportadas

  • Plataformas Windows 2000, Windows XP
  • UNIX
  • z/OS

Finalidade

Em plataformas Windows e UNIX, utilize o comando mqsilist para listar todos os componentes instalados no sistema, todos os grupos de execução definidos em um intermediário específico ou todos os fluxos de mensagens contidos em um grupo de execução nomeado em um intermediário específico.

Em plataformas Windows e UNIX a saída é direcionada para stdout.

A partir de um console do z/OS, utilize o comando list para listar todos os grupos de execução definidos para um intermediário específico ou todos os fluxos de mensagens contidos em um grupo de execução nomeado em um intermediário específico.

Sintaxe

Plataformas Windows e plataformas UNIX

Se você não especificar nenhum parâmetro quando emitir este comando, uma lista de componentes e nomes de gerenciadores de fila será exibida para cada componente criado neste sistema, no formato:
BIP8099I: brokername - queuemanagernameBIP8099I: ConfigMgr - queuemanagernameBIP8099I: UserNameServer - queuemanagernameBIP8071I: Conclusão do comando com êxito

z/OS

Sinônimo: l

Ler diagrama de sintaxeManter visual do diagrama de sintaxe
>>-+-list-+--+-----------+-------------------------------------><
   '-l----'  '- e=egroup-'

Se você não especificar nenhum parâmetro quando emitir esse comando, será exibida uma lista dos grupos de execução.

Você emite o comando list apenas em relação a um nome de tarefa do intermediário. Por exemplo:
F MQP1BRK,list
A saída é a lista de grupos de execução e IDs de processos no formato:
BIP8130I: Grupo de Execução: <nome> -<ID_do_ processo> 
BIP8071I: Conclusão do comando com êxito
Se você especificar um grupo de execução, por exemplo:
F MQP1BRK, list e='exgrp1'		
a saída será uma lista de fluxos de mensagens no formato:
BIP8131I: Messageflow: <Nome_do_Fluxo_de_Mensagens>
BIP8071I: Conclusão do comando com êxito

Parâmetros

Plataformas Windows e plataformas UNIX

brokername
(Opcional) O nome do intermediário para o qual você deseja listar os recursos. Esse precisa ser um intermediário implementado. Uma lista dos grupos de execução configurados nesse intermediário e o ID do processo (PID) de cada um são exibidos.

Todas as Plataformas

-e egroup
(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 intermediário especificado deve estar ativo para que sejam retornadas informações sobre fluxo de mensagens.

Autorização

Em plataformas UNIX, o ID do usuário deve ser membro do grupo mqbrkrs.

Em plataformas Windows, se você tiver especificado um nome de intermediário e o sinalizador -e, o ID do usuário utilizado para chamar esse comando deve ser membro do grupo mqbrkrs.

Respostas

  • BIP8013 O componente não existe
  • BIP8020 Incapaz de acessar o banco de dados
  • BIP8029 Intermediário não configurado
  • BIP8038 Opção de comando não suportada
  • BIP8039 Grupo de execução não disponível
  • BIP8040 Impossível conectar ao banco de dados
  • BIP8158 Formato inválido para o comando (somente z/OS)
  • BIP8159 Parâmetro desconhecido "..." (somente z/OS)

Exemplos

Plataformas Windows e Plataformas UNIX:

mqsilist WBRK_BROKER -e DefaultEG
z/OS
F MQP1BRK,list e='exgrp1'

Tarefas relacionadas
Verificando Componentes

Referências relacionadas
Preferência de Sintaxe