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 mqsichangeresourcestats

Utilice el mandato mqsichangeresourcestats para controlar la recopilación de estadísticas para recursos del intermediario.

Plataformas soportadas

Finalidad

Utilice este mandato para iniciar o detener la recopilación de estadísticas para los tipos de recursos listados en Datos de estadísticas de recursos.

Puede ejecutar este mandato solamente si el intermediario está en ejecución. Si inicia la recopilación de estadísticas y, a continuación, detiene y reinicia el intermediario, no es necesario que vuelva a ejecutar este mandato; el estado activo se mantiene cuando se vuelve a iniciar el intermediario.

Si inicia la recopilación de estadísticas para todos los grupos de ejecución de un intermediario, puede detener la recopilación en todos los grupos o en grupos de ejecución individuales. Si inicia la recopilación de estadísticas para grupos de ejecución individuales, puede detener la recopilación para grupos de ejecución específicos o para todos los grupos de ejecución.

Sintaxis

Leer el esquema de sintaxisOmitir el esquema de sintaxis visual
>>-mqsichangeresourcestats--| brokerSpec |-- -c --Control------->

>--+----------------------------+--+----------------------+----->
   '- -e --nombreGrupoEjecución-'  '- -w -tiempoEsperaSeg-'   

>--+----------------------------+------------------------------><
   '- -v --nombreArchivoRastreo-'   

brokerSpec

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

Parámetros

brokerSpec
(Obligatorio) 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. No puede utilizar esta opción si el intermediario está en un sistema remoto.
-n nombreArchivoIntermediario
Este parámetro identifica el nombre de un archivo que contiene los detalles de conexión para un intermediario local o remoto.

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.

Si desea ejecutar un mandato que utiliza SSL para administrar un intermediario remoto por un canal seguro, debe especificar la contraseña de almacén de claves y del almacén de confianza para la conexión que utiliza la variable de entorno IBM_JAVA_OPTIONS. Consulte Resolución de problemas al ejecutar mandatos para obtener más información.

-i direcciónIP, -p puerto, -q GestorC
Estos parámetros identificar los detalles de la conexión del intermediario.

Utilice esta opción para conexiones remotas a los intermediarios que no requieran parámetros de conexión avanzada.

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.
-c Control
(Obligatorio) El valor para definir la acción que se debe aplicar a la recopilación de estadísticas de recursos:
  • Especifique activo para iniciar la recopilación de estadísticas de recursos
  • Especifique inactivo para detener la recopilación de estadísticas de recursos
-e nombreGrupoEjecución
(Opcional) El nombre del grupo de ejecución del que se han recopilado estadísticas de recursos se ha iniciado o detenido.

Si no especifica -e, se iniciará o se detendrá la recopilación de estadísticas de mensajes para todos los grupos de ejecución del intermediario.

-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.
-v nombreArchRastreo
(Opcional) Este parámetro envía la información de rastreo de depuración interna al archivo especificado.

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.

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.

Respuestas

Este mandato devuelve las siguientes respuestas:
0
El mandato se ha completado correctamente.
2
(Anomalía) El intermediario ha recibido la solicitud de despliegue pero no ha podido procesarla correctamente. Consulte los mensajes emitidos desde el programa de utilidad (o el Registro de administración) para obtener más información.
9
(Anomalía) Se ha sometido la solicitud al intermediario, pero no se ha recibido ninguna respuesta antes de superar el tiempo de espera.
10
(Anomalía) Otro usuario u otra aplicación ha cancelado la operación de solicitud antes de que el intermediario pudiera procesarla.
98
No está ejecutando el intermediario.
99
Uno o más de los parámetros que ha especificado no es válido.

Ejemplos

Inicie la recopilación de estadísticas de recursos para todos los grupos de ejecución en IntermediarioA:

mqsichangeresourcestats IntermediarioA -c active

Detenga la recopilación de estadísticas para el grupo de ejecución default en el intermediario IntermediarioA:

mqsichangeresourcestats IntermediarioA -c inactive -e default
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:35


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