Mandato mqsilist (listar recursos)

Plataformas soportadas

  • Windows
  • Sistemas Linux y UNIX
  • z/OS

Finalidad

En las plataformas Windows y los sistemas Linux y 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 incluidos en un grupo de ejecución con nombre de un intermediario específico.

En las plataformas Windows y los sistemas Linux y UNIX, la salida se direcciona a stdout.

En una consola 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 incluidos en un grupo de ejecución de un intermediario específico.

Sintaxis

Plataformas Windows, y sistemas Linux y UNIX

Si no se especifica ningún parámetro al emitir este mandato, aparece una lista de componentes y nombres de gestores de colas para cada componente creado en el sistema con el formato:
BIP8099I: Broker: nombreintermediario - nombregstcolas
BIP8099I: GestConfig: NombreGestConfig - nombregstcolas
BIP8099I: ServidorNombresUsuarios: ServidorNombresUsuarios - qnombregstcolas
BIP8071I: El mandato ha finalizado correctamente

z/OS

Sinónimo: l

Si no se especifica ningún parámetro al emitir este mandato, aparece una lista de grupos de ejecución.

Emita el mandato list sólo para un nombre de tarea de intermediario. Por ejemplo:
F MQP1BRK,list
La salida de la lista de grupos de ejecución y los ID de proceso en el formato:
BIP8130I: Grupo de ejecución: <nombre> -<ID de proceso> 
BIP8071I: El mandato ha finalizado correctamente
Por ejemplo, si especifica un grupo de ejecución:
F MQP1BRK, list e='exgrp1'		
la salida es una lista de flujos de mensajes en el formato:
BIP8131I: Flujo de mensajes: <Flujo de mensajes> 
BIP8071I: El mandato ha finalizado correctamente

Parámetros

Plataformas Windows, y sistemas Linux y UNIX

nombreintermediario
(Opcional) El nombre del intermediario para el que desea listar recursos. Debe ser un intermediario desplegado. Aparece una lista de grupos de ejecución configurados en este intermediario y el ID de proceso (pid) de cada uno.
nombrecomponente
(Opcional) (Opcional) El nombre del componente para el cual quiere listar recursos.

Todas las plataformas

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

El intermediario especificado debe estar activo para que se pueda devolver información de flujo de mensajes.

Autorización

En sistemas Linux y UNIX, el ID de usuario debe ser un miembro del grupo mqbrkrs.

En plataformas Windows, si ha especificado un nombre de intermediario y el indicador -e, el ID de usuario utilizado para invocar este mandato debe pertenecer al grupo mqbrkrs.

Respuestas

  • BIP8013 Este componente no existe
  • BIP8020 No se ha podido acceder a la base de datos
  • BIP8029 El intermediario no está configurado
  • BIP8038 Opción de mandato no soportada
  • BIP8039 El grupo de ejecución no está disponible
  • BIP8040 No se ha podido efectuar la conexión con la base de datos
  • BIP8158 Formato no válido para el mandato (sólo z/OS)
  • BIP8159 El nombre del parámetro "..." es desconocido (sólo z/OS)

Ejemplos

Plataformas Windows, y sistemas Linux y UNIX:
mqsilist WBRK_BROKER -e DefaultEG
mqsilistGestInstanciaBasedatos
z/OS
F MQP1BRK,list e='exgrp1'
Tareas relacionadas
Avisos | Marcas registradas | Descargas | Biblioteca | Soporte | Su opinión
Copyright IBM Corporation 1999, 2005 Última actualización: 11/11/2005
an07250_