Mandato mqsimode

Utilice el mandato mqsimode para configurar y recuperar información de modalidad de operación.

Plataformas soportadas

Finalidad

Utilice el mandato mqsimode para cambiar la modalidad de operación de un intermediario o para recuperar información sobre la modalidad en la que el intermediario está trabajando actualmente.

Sintaxis

Leer el esquema de sintaxisOmitir el esquema de sintaxis visual
>>-mqsimode--| brokerSpec |--+--------------------------+------->
                             '- -o --modalidadOperación-'   

>--+----------------------+--+----------------------------+----->
   '- -w -tiempoEsperaSeg-'  '- -v --nombreArchivoRastreo-'   

>--+----------------------------+------------------------------><
   '- -x --ExtensionesModalidad-'   

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.
-o modalidadOperación
(Opcional) Este parámetro establece la modalidad del intermediario de destino. Los valores válidos son: advanced (edición completa), standard (Standard Edition), express (Express Edition) y adapter (Remote Adapter Deployment modalidad). Si no especifica el parámetro -o, el mandato visualiza la modalidad en la que se ejecuta el intermediario.
-x ExtensionesModalidad
(Opcional) Este parámetro utiliza una lista separada por comas para especificar las extensiones de modalidad a las que tiene derecho el intermediario. También puede utilizar el parámetro -x para desactivar todas las extensiones de modalidad (consulte Ejemplos). Tenga en cuenta que esta funcionalidad no está disponible en WebSphere Message Broker Versión 7.0.0.2.
-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.

Autorización

En todas las plataformas soportadas, en los intermediarios para los que ha habilitado seguridad de administración, debe otorgar autorización de lectura sobre la cola de seguridad SYSTEM.BROKER.AUTH para el ID de usuario que ejecuta este mandato para consultar la modalidad.

En todas las plataformas soportadas, debe otorgar autorización tanto de lectura como de grabación sobre la cola de seguridad SYSTEM.BROKER.AUTH para el ID de usuario que ejecuta este mandato para cambiar la modalidad.

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

Ejecución del mandato mqsimode especificando el parámetro -o

Cuando se ejecuta el mandato mqsimode del intermediario BROKER1 y especifica el parámetro -o, la modalidad se actualiza y recibe un informe con todos los errores. Por ejemplo, si ejecuta el siguiente mandato mqsimode para cambiar el intermediario a la modalidad Remote Adapter Deployment y el intermediario está en el siguiente estado:
  • Nombre_intermediario1 es el nombre del intermediario.
  • Flujo_mensajes es el nombre del flujo de mensajes.
  • Grupo_ejecución es el nombre del grupo de ejecución.
  • El mandato cambia Nombre_intermediario1 a la modalidadRemote Adapter Deployment, pero contiene un nodo Tipo_nodo que no es válido en esta modalidad.
mqsimode BROKER1 –o adapter
Recibirá los mensajes siguientes:
BIP1044: Conectando con el gestor de colas del intermediario...
BIP1045: Conectando con el intermediario...
BIP1805: La modalidad para el intermediario 'Nombre_intermediario1'
ha cambiado a 'adapter'.
BIP1823: AVISO: El intermediario 'Nombre_intermediario1' tiene un
flujo de mensajes denominado 'Flujo_mensajes' 
 en el grupo de
ejecución 'Grupo_ejecución', que contiene uno o varios
nodos que no son 
 válidos en esta modalidad: Tipo_nodo.
BIP8229: El mandato se ha completado con el siguiente número de avisos: 1.

Ejecución del mandato mqsimode sin el parámetro -o

Cuando se ejecuta el mandato mqsimode sin el parámetro -o, recibe un informe sobre la modalidad que el intermediario utiliza, un informe sobre todas las violaciones de la modalidad y un informe para todas las extensiones de modalidad que se precisan y no se han cumplido. Por ejemplo, si ejecuta el siguiente mandato mqsimode y el intermediario está en el siguiente estado:
  • Nombre_intermediario es el nombre del intermediario.
  • El intermediario está en modalidad Standard Edition.
  • El intermediario no tiene ninguna violación.
mqsimode nombre_intermediario
Recibirá los mensajes siguientes:
BIP1044: Conectando con el gestor de colas del intermediario...
BIP1807: Descubriendo información de modalidad del intermediario 'Nombre_intermediario'...
BIP1802: El intermediario 'Nombre_intermediario' está en modalidad
'standard'.
BIP8071: El mandato ha finalizado satisfactoriamente.

Desactivación de todas las extensiones de modalidad

Para desactivar todas las extensiones de modalidad, ejecute el mandato mqsimode con el parámetro -x. Tenga en cuenta que esta funcionalidad no está disponible en WebSphere Message Broker Versión 7.0.0.2:
mqsimode Nombre_intermediario –x 
donde Nombre_intermediario es el nombre del intermediario.

Ejecución del mandato mqsimode especificando el parámetro -o en un intermediario que ejecuta una versión anterior a la V6.1

Cuando se ejecuta el parámetro -o en un intermediario que ejecuta una versión anterior a la V6.1, se recibe un informe con un mensaje apropiado. Por ejemplo, donde Nombre_intermediario es el nombre del intermediario:
BIP1044: Conectando con el gestor de colas del intermediario...
BIP1045: Conectando con el intermediario...
BIP1808: El intermediario 'Nombre_intermediario' no está en el nivel de
software necesario para
 cambiar la modalidad de operación.
 BIP8229: El mandato se ha completado con el siguiente número de avisos: 1.
Avisos | Marcas registradas | Descargas | Biblioteca | Soporte | Comentarios

Copyright IBM Corporation 1999, 2012Copyright IBM Corporation 1999, 2012.

        
        Última actualización
        
        Última actualización : 2012-07-13 19:55:50


Tema de referenciaTema de referencia | Versión 8.0.0.1 | an67710_