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 mqsicacheadmin

Utilice el mandato mqsicacheadmin para proporcionar información sobre la memoria caché global y administración básica completa.

Plataformas soportadas

Finalidad

El mandato mqsicacheadmin proporciona información sobre la memoria caché global que está incluida en un intermediario. Por ejemplo, puede averiguar el tamaño de una correlación, listar los hosts que participan en la memoria caché y borrar datos de una correlación.

Este mandato proporciona un subconjunto de los mandatos que están disponibles en el programa de utilidad xscmd que se proporciona con WebSphere eXtreme Scale. Para obtener más información sobre estos mandatos y la información que se devuelve, consulte Informaton Center de WebSphere eXtreme Scale.

Notas de uso

  • Antes de ejecutar el mandato mqsicacheadmin, asegúrese de que el intermediario está en ejecución y que la memoria caché global está disponible. Para proporcionar la información solicitada, el mandato se conecta a los componentes de memoria caché.
  • Antes de ejecutar este mandato, asegúrese de que para todos los grupos de ejecución que contienen componentes de memoria caché de host, el parámetro enableJMX se establece en true. Este parámetro debe estar habilitado para que los grupos de ejecución puedan proporcionar información de administración acerca de la memoria caché global. (Para ver más información, consulte Valores de parámetro para el componente cachemanager.) Cuando se utiliza la topología de memoria caché predeterminada, o un archivo de política XML, este parámetro se establece en true automáticamente.
  • No es necesario reiniciar el intermediario para que este mandato entre en vigor. Por ejemplo, el mandato clearGrid entra en vigor de inmediato y borra todos los datos para la correlación especificada.
  • Si intenta conectarse a un intermediario remoto especificando un archivo de parámetros de conexión (.broker), el mandato intenta utilizar el código de cliente Java™ de WebSphere MQ. 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 versión notificado es MQRC_ENVIRONMENT_ERROR. 
    Debe especificar un gestor de colas local.

Sintaxis

Leer el esquema de sintaxisOmitir el esquema de sintaxis visual
>>-mqsicacheadmin--+---------------------+---------------------->
                   '-NombreIntermediario-'   

>--+----------------------------------+-- -c --mandato---------->
   +- -cep --puntosFinalesConexión----+                  
   '- -n --nombreArchivoIntermediario-'                  

>--+-------------------------+---------------------------------><
   '- -m --nombreCorrelación-'   

Parámetros

NombreIntermediario
(Opcional) Nombre del intermediario local a modificar. Si no especifica este parámetro, debe especificar en su lugar el parámetro puntosFinalesConexión o nombreArchivoIntermediario.

 

-cep puntosFinalesConexión
(Opcional) La detalles de conexión para el servidor de catálogo de memoria caché que se ejecuta en el intermediario. El formato de este parámetro es nombreHost:puertoEscucha. Si no especifica este parámetro, debe especificar en su lugar el parámetro nombreIntermediario o nombreArchivoIntermediario.

 

-n nombreArchivoIntermediario
(Opcional) Archivo que contiene los parámetros de conexión de intermediario remoto (*.broker). Si no especifica este parámetro, debe especificar en su lugar el parámetro nombreIntermediario o puntosFinalesConexión.

 

-c mandato
(Necesario) Mandato a ejecutar para la memoria caché incorporada. Los valores siguientes son válidos para este mandato.
clearGrid
Borra todos los datos de la correlación especificada en la memoria caché incorporada. Este mandato tiene efecto inmediato y no necesita un reinicio de intermediario.
showMapSizes
Muestra los tamaños de todas las correlaciones en la memoria caché incorporada.
placementServiceStatus
Visualiza el estado de la operación de colocación de ObjectGrid.
routetable
Visualiza la tabla de direccionamiento actual para todos los fragmentos y particiones de WebSphere eXtreme Scale en la memoria caché incorporada.
showPlacement
Lista todos los servidores de contenedor y sus fragmentos en la memoria caché incorporada.
listHosts
Lista todos los hosts que participan en la memoria caché incorporada.

 

-m nombreCorrelación
(Opcional) Nombre de la correlación para la que se debe ejecutar el mandato. Este parámetro es necesario si el mandato es clearGrid. Para todos los demás mandatos, este parámetro se ignora.

 

Respuestas

Además de las respuestas de mandatos estándares, este mandato devuelve las respuestas siguientes.
  • BIP7186 Información de uso para el mandato mqsicacheadmin
  • BIP7187 Salida del mandato mqsicacheadmin
  • BIP7188 No se pueden determinar los parámetros de conexión para los servidores de catálogo en la memoria caché global

Autorización

Para obtener información sobre las autorizaciones específicas de cada plataforma, consulte los temas siguientes: Si ha habilitado la seguridad de administración del intermediario, también debe establecer la autorización que se detalla en Tareas y autorizaciones para la seguridad de administración.

Ejemplos

Especifique el mandato en una sola línea; en algunos ejemplos se han añadido saltos de línea simplemente para facilitar la lectura del mandato.

El ejemplo siguiente muestra los tamaños de todas las correlaciones en la memoria caché incorporada:
mqsicacheadmin brokerName -c showMapSizes
El ejemplo siguiente utiliza el parámetro -cep para conectarse a un servidor de catálogo y visualiza la tabla de direccionamiento para cada fragmento de WebSphere eXtreme Scale:
mqsicacheadmin -cep server.company.com:2800 -c routetable
El ejemplo siguiente borra todos los datos de la correlación denominada "myMap":
mqsicacheadmin brokerName -c clearGrid -m myMap
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:01:31


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