Comando mqsilist (Listar Recursos)

Plataformas Suportadas

Finalidade

Em plataformas Windows e sistemas Linux e UNIX, utilize o comando mqsilist para listar todos os componentes instalados no sistema, 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.

Em plataformas Windows e sistemas Linux 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, Sistemas Linux e 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: Broker: brokername - queuemanagername
BIP8099I: ConfigMgr: configmgrname - queuemanagername
BIP8099I: UserNameServer: UserNameServer - queuemanagername
BIP8071I: Conclusão do comando com êxito

z/OS

Sinônimo: l

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: <MessageFlowName>
BIP8071I: Conclusão do comando com êxito

Parâmetros

Plataformas Windows, Sistemas Linux e UNIX

-a
(Opcional) Liste todos os componentes instalados no sistema.
Se você utilizar essa opção nos intermediários de um release anterior do produto, você obtém a seguinte mensagem:
BIP8221I: <Component>: <ComponentName> (<Version>) - <Queue Manager>  
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 sistemas Linux e UNIX, o ID do usuário deve ser um 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 sistemas Linux e UNIX:
mqsilist WBRK_BROKER -e DefaultEG
mqsilist DatabaseInstanceMgr
z/OS
F MQP1BRK,list e='exgrp1'
Tarefas relacionadas
Verificando Componentes
Referências relacionadas
Diagramas de Sintaxe: Tipos Disponíveis
Avisos | Marcas Registradas | Downloads | Biblioteca | Suporte | Feedback
Direitos Autorais IBM Corporation 1999, 2006 Última Atualização: 1 Sep 2006
an07250_