WebSphere Message Broker, Versión 8.0.0.5 Sistemas operativos: AIX, HP-Itanium, Linux, Solaris, Windows, z/OS

Consulte la información sobre la última versión del producto en IBM Integration Bus, Versión 9.0

Mandato mqsilist - z/OS

Utilice el mandato mqsilist para listar información sobre los intermediarios y los recursos desplegados en los mismos.

Sintaxis

Mandato z/OS - BIPLIST

Leer el esquema de sintaxisOmitir el esquema de sintaxis visual
>>-mqsilist--+-----------------------------------+-------------->
             '-| brokerSpec |--+---------------+-'   
                               '- -e--NombreGe-'     

>--+--------------------+--+------------------------+----------->
   '- -d --nivelDetalle-'  '- -k --nombreAplicación-'   

>--+------+--+----------------------------+--------------------->
   '- -r -'  '- -v --nombreArchivoRastreo-'   

>--+----------------------+--+------------------------+--------><
   '- -w -tiempoEsperaSeg-'  '- -y --nombreBiblioteca-'   

brokerSpec

|--+- nombreIntermediario ------------+-------------------------|
   +- -n --nombreArchivoIntermediario-+   
   | .---------------------------.    |   
   | V                           |    |   
   '-----+- -i --direcciónIP-+---+----'   
         +- -p --puerto------+            
         '- -q --GestorC-----'            

Mandato de consola z/OS

Sinónimo: l

Leer el esquema de sintaxisOmitir el esquema de sintaxis visual
>>-+-list-+--+-------------+--+-------+--+-----------------+---><
   '-l----'  '- e=NombreGe-'  '- r=sí-'  '- d=nivelDetalle-'   

Si especifica este mandato sin parámetros, se muestra una lista de los grupos de ejecución.

Parámetros

brokerSpec
Debe especificar un parámetro, como mínimo, para identificar el intermediario de destino para este mandato, en una de las siguientes formas:
nombreIntermediario
Este parámetro identifica el nombre de un intermediario definido localmente.
-n nombreArchivoIntermediario
Este parámetro identifica el nombre de un archivo que contiene los detalles de conexión para un intermediario local.

Utilice esta opción si varios usuarios quieren conectarse al mismo intermediario, o si utiliza parámetros de conexión avanzada como, por ejemplo, SSL.

Para crear este archivo,pulse el botón derecho del ratón en WebSphere Message Broker Explorer y seleccione Exportar archivo *.broker. Cuando se le solicite, vaya a la ubicación en la que desea guardar el archivo y escriba el nombre del mismo; la extensión .broker se añade automáticamente cuando se pulsa Guardar. Incluya la ubicación (vía de acceso) y el nombre de archivo cuando especifique este parámetro. Debe asegurarse de poder acceder a la ubicación cuando ejecute este mandato.

-i direcciónIP, -p puerto, -q GestorC
Estos parámetros identificar los detalles de la conexión del intermediario. Si especifica un gestor de colas, debe definirse en el sistema local.

Si elige esta opción, debe especificar como mínimo uno de estos tres parámetros; el orden en que los especifique es irrelevante. No se puede especificar un parámetro más de una vez.

En los parámetros que se omiten, se presupone que se deben utilizar los valores predeterminados:

  • -i direcciónIP: El nombre de host o la dirección IP del sistema en el que se ejecuta el intermediario. Si no especifica este parámetro, se utiliza un valor que representa el sistema local.
  • -p puerto: El puerto TCP en el que escucha el gestor de colas del intermediario. Si no especifica este parámetro, se utiliza el valor 1414.
  • -q GestorC: El nombre del gestor de colas del intermediario. Si no especifica este parámetro, se utiliza un valor que representa el gestor de colas predeterminado del sistema local.
No se puede conectar con un gestor de colas remoto en z/OS; consulte Notas de uso.
-d nivelDetalle
(Opcional) Especifique el nivel de detalle a devolver; el valor predeterminado es 1.
  • 0 devuelve sólo el nombre del intermediario y los nombres de los gestores de colas asociados (esta información es la misma que la información detallada que se ofrecía en versiones anteriores).

    No olvide que mientras se están iniciando, los grupos de ejecución pueden notificar un PID de 0.

  • 1 devuelve un resumen de una línea de cada recurso.
  • 2 devuelve información detallada sobre cada recurso.
-e nombreGe
(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.

-k nombreAplicaciónOServicio
(Opcional) Este parámetro lista los objetos desplegados que se configuran para una aplicación o un servicio. Cuando utilice este parámetro, debe especificar también un grupo de ejecución con el parámetro -e.
-r
(Opcional) Ejecutar el mandato de forma recurrente: mostrar información sobre subcomponentes.
-v nombreArchRastreo
(Opcional) Este parámetro envía la información de rastreo de depuración interna al archivo especificado.
-w tiempoEsperaSeg
(Opcional) Este parámetro especifica el tiempo, en segundos, que el programa de utilidad espera para asegurarse de que el mandato se ha completado; el valor predeterminado es 60.
-y nombreBiblioteca
(Opcional) Este parámetro lista los objetos desplegados que se configuran para una biblioteca. Cuando utilice este parámetro, debe especificar también un grupo de ejecución con el parámetro -e. También puede utilizar el parámetro -k con este parámetro para listar el contenido de una biblioteca específica en la aplicación especificada por el parámetro -k.

Notas de uso

Si intenta conectarse a un intermediario remoto especificando los parámetros i, p yq, o utilizando un archivo de parámetros de conexión (.broker), el mandato intenta utilizar el código de cliente WebSphere MQ Java™. Esta opción no está soportada en z/OS, y devuelve el siguiente error:

BIP1046E: No se puede conectar al intermediario (nombre)

El código de razón notificado es MQRC_ENVIRONMENT_ERROR. Debe especificar un gestor de colas local.

Ejemplos

Utilice el mandato de consola para solicitar un resumen de los grupos de ejecución del intermediario. (El parámetro d= no se ha especificado y por consiguiente, tiene el valor predeterminado de 1.)
F MQP1BRK,list 
Se generan las siguientes respuestas:
BIP1286I: El grupo de ejecución 'ello' en el intermediario 'MQP1BRK' se está ejecutando.

BIP8071I: El mandato ha finalizado correctamente.
Utilice el mandato de consola para listar los flujos de mensajes del grupo de ejecución especificado:
F MQP1BRK,list e='exgrp1'		
Las respuestas generadas son como las siguientes:
BIP1288I: El flujo de mensajes 'simpleflow' en el grupo de ejecución 'ello' se está ejecutando.

BIP8071I: El mandato ha finalizado correctamente
Utilice el mandato de consola para listar los objetos desplegados que están configurados para la biblioteca myEGLibrary, que está contenida en la aplicación myApplication, en el grupo de ejecución default:
F MB8BROKER,list e='default' k='myApplication' y='myEGLibrary'

Para ver ejemplos de cómo ejecutar el mandato utilizando BIPLIST, y de les respuestas generadas, consulte Mandato mqsilist - sistemas Windows, Linux y UNIX.

Avisos | Marcas registradas | Descargas | Biblioteca | Soporte | Comentarios

Copyright IBM Corporation 1999, 2014Copyright IBM Corporation 1999, 2014.

        
        Última actualización:
        
        Última actualización: 2015-02-28 17:00:12


Tema de referenciaTema de referencia | Versión 8.0.0.5 | an28320_