Mandato mqsilist (listar recursos)

Plataformas soportadas

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

Finalidad

En plataformas Windows y plataformas UNIX, utilice el mandato mqsilist para listar todos los componentes instalados en el sistema, todos los grupos de ejecución definidos para un intermediario específico o todos los flujos de mensajes contenidos en un grupo de ejecución nombrado de un intermediario específico.

En plataformas Windows y en plataformas UNIX, la salida se dirige a stdout.

Desde una consola de z/OS, utilice el mandato list para listar todos los grupos de ejecución definidos para un intermediario específico o todos los flujos de mensajes contenidos en un grupo de ejecución nombrado de un intermediario específico.

Sintaxis

Plataformas Windows y plataformas UNIX

Si no especifica ningún parámetro cuando emite este mandato, se visualizará una lista de componentes y de nombres de gestores de colas para cada componente creado en este sistema, con el formato:
BIP8099I: brokername - queuemanagername
BIP8099I: ConfigMgr - queuemanagername
BIP8099I: UserNameServer - queuemanagername
BIP8071I: Successful command completion

z/OS

Sinónimo: l

Si no especifica ningún parámetro cuando emita este mandato, se visualizará una lista de grupos de ejecución.

El mandato list se emite únicamente para un nombre de tarea de intermediario. Por ejemplo:
F MQP1BRK,list
La salida es la lista de grupos de ejecución e ID de proceso con el formato:
BIP8130I: Execution Group: <name> -<process ID> 
BIP8071I: Successful command completion
Si especifica un grupo de ejecución, por ejemplo:
F MQP1BRK, list e='exgrp1'		
la salida es una lista de flujos de mensajes con el formato:
BIP8131I: Messageflow: <MessageFlowName>
BIP8071I: Successful command completion

Parámetros

Plataformas Windows y plataformas UNIX

brokername
(Opcional) El nombre del intermediario para el que desea listar recursos. Ha de ser un intermediario difundido. Se visualiza una lista de los grupos de ejecución configurados en el intermediario y el ID de proceso (pid) de cada uno de ellos.

Todas las plataformas

-e grupoejecución
(Opcional) Selecciona un grupo de ejecución dentro del intermediario. Especifique la etiqueta del grupo de ejecución para el que desea listar los flujos de mensajes. El mandato devuelve una lista de flujos de mensajes asignados al grupo de ejecución especificado del intermediario.

El intermediario especificado ha de estar activo para que se devuelva cualquier información del flujo de mensajes.

Autorización

En plataformas UNIX, el ID de usuario ha de ser miembro del grupo mqbrkrs.

En plataformas Windows, si ha especificado un nombre de intermediario y el distintivo -e, el ID de usuario utilizado para invocar este mandato ha de ser miembro del grupo mqbrkrs.

Respuestas

  • BIP8013 El componente no existe
  • BIP8020 No se ha podido acceder a la base de datos
  • BIP8029 Intermediario no configurado
  • BIP8038 Opción de mandato no soportada
  • BIP8039 Grupo de ejecución no disponible
  • BIP8040 No se ha podido conectar con la base de datos
  • BIP8158 Formato no válido para el mandato (sólo z/OS)
  • BIP8159 Parámetro desconocido "..." (sólo z/OS)

Ejemplos

Plataformas Windows y plataformas UNIX:

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

Tareas relacionadas
Verificación de componentes

Referencia relacionada
Preferencia de sintaxis