Mandato mqsideploy

Plataformas soportadas

  • Windows 2000, Windows XP

Finalidad

Utilice el mandato mqsideploy para efectuar una petición de difusión al gestor de configuración. Esto permite realizar los distintos tipos de peticiones de difusión desde un script de mandato por lotes, sin necesidad de interacciones manuales.

La situación por omisión es una difusión delta o incremental. Seleccione -completo para alterar temporalmente la operación por omisión.

El código de retorno de mqsideploy es cero si el mandato se ejecuta correctamente. Si el mandato no se ejecuta correctamente, el código de retorno es el número de mensaje BIP que describe el error, menos 1.000 para mensajes en formato BIP1xxx, o menos 8.000 en mensajes con el formato BIP8xxx. Por ejemplo, si el mandato falla con el mensaje BIP1034, el código de retorno será 34.

Sintaxis

Parámetros

-b NombreIntermediario
(Necesario) El nombre del intermediario para el que se va a hacer la difusión. Si se ha especificado alguno de los distintivos -temas, -topología o -cancelar, la opción -b se ignora. Esto se debe a que cuando se difunden temas o topologías, o cuando se cancela una difusión que está realizándose, esto afecta a todos los intermediarios del dominio. Sin los distintivos -e y -bar, se inicia una difusión de configuración de intermediario.
-e NombreEG
(Opcional) El nombre del grupo de ejecución para el que se desea hacer la difusión. Con esta opción, también han de especificarse las opciones -b y -bar.
-bar ArchivoBAR
(Opcional) El nombre de archivo BAR (Broker Archive, archivo de intermediario) que ha de utilizarse para la difusión de un flujo de mensajes o un conjunto de mensajes. Con esta opción también han de especificarse las opciones -b y -e.
-temas
(Opcional) Difundir toda la información de configuración de los temas. La información se difunde a todos los intermediarios del dominio.
-topología
(Opcional) Este distintivo especifica que la configuración de Topología ha de difundirse. La información se difunde a todos los intermediarios del dominio si también se ha establecido el distintivo -completo, de lo contrario, la información se difunde únicamente para los intermediarios cuya configuración de topología haya cambiado.
-cancelar
(Opcional) Cancelar todas las difusiones pendientes, es decir, los Intermediarios que no hayan contestado a las peticiones de difusión anteriores (cancelar difusión). Cuando se utiliza esta opción, los demás distintivos, excepto -w y -r, se ignoran.
-r
(Opcional) Leer y visualizar registros de anotaciones asociados a la petición de difusión anterior. Utilícelo junto con la opción -w para esperar un tiempo especificado. Una vez se ha leído un registro de anotaciones, la difusión se considera completa y el o los registros de anotaciones asociados a la misma se suprimen.
-w ValorTiempoEspera
(Opcional) El tiempo en segundos que el programa de utilidad espera a que el intermediario responda, antes de devolver el control a las línea de mandatos. El mandato mqsideploy sondea los registros de anotaciones del gestor de configuración buscando los resultados de la petición de difusión que acaba de enviarse. Los registros de anotaciones pertinentes contienen información que indica si la difusión se ha efectuado correctamente. El ValorTiempoEspera es el número de segundos que se espera antes de que se exceda dicho tiempo. Es un valor de 1 a 999.999. Si no se proporciona ningún ValorTiempoEspera, o se especifica un valor menor que 1 o mayor que 999.999, se recibirá un error.
- conexión ArchivoParámetrosConexión
(Opcional) El nombre de un archivo .configmgr que describe los parámetros de conexión para el gestor de configuración. El archivo está en XML, utilizando el formato .configmgr guardado por la GUI de Eclipse. Por ejemplo:
<?xml version="1.0" encoding="UTF-8"?>
<configmgr host="localhost" listenerPort="1414" queueManager="LUCAS"
           securityExit="test.myExit"/>
Si omite la opción -conexión, el mandato obtiene la información de configuración de un archivo del directorio del programa de utilidad, llamado mqsicfgutil.ini. Este archivo tiene el formato:
hostname = localhost
queueManager = QMNAME
port = 1414
securityExit = test.myExit

Si se especifica la opción -conexión, el archivo mqsicfgutil.ini se ignora.

Estos archivos han de estar en el directorio desde el que se está ejecutando el mandato. No es necesariamente el mismo directorio del archivo mqsideploy.bat.

-Nombre FlujoMensrm
(Opcional) Elimina el flujo de mensajes nombrado del grupo de ejecución suministrado. Este cambio se difunde inmediatamente al intermediario.
-Nombre ConjMensrm
(Opcional) Elimina el conjunto de mensajes nombrado del grupo de ejecución suministrado. Este cambio se difunde inmediatamente al intermediario.
-completo
(Opcional) Difundir información completa:
  • Para una difusión de archivo BAR, -completo elimina del grupo de ejecución todos los flujos de mensajes y conjuntos de mensajes difundidos actualmente como parte de la difusión. Si no se ha establecido -completo, el contenido del archivo BAR se difunde además de lo que ya se ha difundido en el grupo de ejecución. En este caso, todos los objetos difundidos que tengan el mismo nombre que un elemento que esté dentro del BAR se sustituyen por la versión que hay dentro del BAR.
  • Para una difusión de configuración de topología, -completo difunde a todos los intermediarios la información de configuración entre intermediarios completa. Si no se ha establecido -completo, sólo se difunde la información entre intermediarios cambiada a los intermediarios cuya configuración entre intermediarios haya cambiado.
  • Para una difusión de intermediario, -completo difunde al intermediario especificado todos los atributos de configuración disponibles, por ejemplo, parámetros de multidifusión. Si no se ha establecido -completo, sólo se difunden los atributos de configuración cambiados.
  • Para una difusión de árbol de temas, -completo difunde todo el árbol de temas a todos los intermediarios. Si no se ha establecido -completo, sólo los cambios en el árbol de temas se difunden a todos los intermediarios.
  • Para una operación de eliminación de un flujo de mensajes o eliminación de un conjunto de mensajes, el distintivo se ignora.

Ejemplos

Realice una difusión al intermediario <nombre_intermediario> y espere una respuesta durante cinco minutos:

mqsideploy -b <broker_name> -w 300

Lee y contesta (mensajes de anotaciones) recibidos de intermediarios que se han difundido previamente a:

mqsideploy -r

Conceptos relacionados
Entorno de ejecución

Tareas relacionadas
Difusión de aplicaciones de flujos de mensajes

Referencia relacionada
Preferencia de sintaxis