Mandato mqsideploy

Plataformas soportadas

  • Windows
  • sistemas UNIX y Linux
  • z/OS

Finalidad

Utilice el mandato mqsideploy para realizar una petición de despliegue al Gestor de configuración. Esto le permite realizar las diversas maneras de solicitud de despliegue desde un script de mandatos por lotes, sin necesidad de interacción manual.

La situación por omisión es un despliegue incremental o delta. Seleccione -m para alterar el funcionamiento por omisión.

mqsideploy no necesita un parámetro de nombre del Gestor de configuración porque todos los detalles de conexión necesarios pueden obtenerse de los parámetros -n, -q, -i y -p.

Sintaxis

Nota: Los indicadores de mandato son distintos de los utilizados en versiones anteriores de mqsideploy. En plataformas Windows, para utilizar los mismos indicadores de mandato que en las versiones anteriores, utilice el mandato mqsideploy.bat.

Parámetros

-n nombreArchParámetrosCfg
(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 y utiliza el formato .configmgr que ha guardado la GUI de Eclipse. Por ejemplo:
<?xml version="1.0" encoding="UTF-8"?>
<configmgr host="localhost" listenerPort="1414" queueManager="QNAME"
           securityExit="test.myExit"/>
Si utiliza este archivo en z/OS, debe eliminar la sentencia encoding="UTF-8" de la primera línea, para que la sentencia quede así:
<?xml version="1.0"?>
y eliminar la sentencia del atributo de sistema principal, para que la sentencia quede así:
<configmgr host="" listenerPort="1414" queueManager="QNAME"
           securityExit="test.myExit"/>
Nota: Si no proporciona este parámetro, debe proporcionar los parámetros -i, -p y -q.
-i direccIp
(Opcional) El nombre de sistema principal o la dirección IP del Gestor de configuración.

Si utiliza este archivo en z/OS y desea conectar con el sistema principal local, debe establecer el valor en \"\".

-p Puerto
(Opcional) El número de puerto del Gestor de configuración.
-q Gstc
(Opcional) El nombre del gestor de colas de WebSphere MQ que está utilizando el Gestor de configuración.

Si no proporciona los parámetros -i, -p y -q, debe especificar el parámetro -n.

-b nombreintermediario
(Necesario) El nombre del intermediario al que realizar el despliegue. Si no se especifican los indicadores -t o -l, se ignora la opción -b. Esto se debe a que el despliegue de temas o topologías afecta a todos los intermediarios del dominio. Sin los indicadores -e y -a, se inicia un despliegue de la configuración del intermediario.

Con la opción -c, se cancela el despliegue en el intermediario específico.

-e NombreGE
(Opcional) El nombre del grupo de ejecución al que realizar el despliegue. Con esta opción también deben especificarse las opciones -b y -a.
-anombreArchBAR
(Opcional) El nombre del archivo BAR (archivo archivador de intermediario) que se va a utilizar para un desplieguede un flujo de mensajes o un conjunto de mensajes. Con esta opción también deben especificarse las opciones -b y -e.
-t-temas
(Opcional) Despliega toda la información de configuración de los temas. La información se despliega a todos los intermediarios del dominio.
-l-topología
(Opcional) Este indicador especifica que debe desplegarse la configuración de topología. La información se despliega a todos los intermediarios del dominio si también se establece el indicador -m; de lo contrario, la información sólo se despliega a los intermediarios que tienen una configuración de topología cambiada.
-c-cancel
(Opcional) Indica al Gestor de configuración que deje de esperar las respuestas a las peticiones de despliegue sometidas anteriormente. Si se utiliza con la opción -b, el Gestor de configuración deja de esperar las respuestas de despliegue pendientes del intermediario especificado; sin la opción -b, el Gestor de configuración deja de esperar las respuestas de todas las peticiones de despliegue pendientes en el dominio.

La opción -c debe especificarse con precaución. Utilícela solamente si no hay posibilidad de que los intermediarios afectados respondan a la petición de despliegue; si, posteriormente, un intermediario procesa una petición de despliegue que se ha cancelado, el Gestor de configuración hará caso omiso de la respuesta y, por tanto, dejará de estar sincronizado con el intermediario.

-w ValorTiempoEspera
(Opcional) El intervalo en segundos que el programa de utilidad espera a que el intermediario responda antes de devolver el control a la línea de mandatos. El mandato mqsideploy hace un sondeo de los registros de anotaciones del Gestor de configuración y busca los resultados de la petición de despliegue que acaba de enviarse. Los registros de anotaciones relevantes contienen información indicando si el despliegue se ha llevado a cabo correctamente. ValorTiempoEspera es el número de segundos que debe esperar antes de la interrupción, en el rango 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 devuelve un error.
-d objetosDesplegados
(Opcional) Describe el conjunto de objetos que se deben eliminar del grupo de ejecución. Pueden especificarse varios archivos desplegados, separados por el carácter ":".
Pueden especificarse objetos de todos los tipos, con las siguientes limitaciones:
  1. Los flujos de mensajes y los conjuntos de mensajes sólo pueden especificarse si el Gestor de configuración al que está conectado el mandato no es de la Versión 6.
  2. Si, por ejemplo, se intenta eliminar un archivo XSL cuando está conectado a un Gestor de configuración de la Versión 6.0, el resultado será un error del tipo "objeto no encontrado".
  3. Si se especifica un nombre de objeto ambiguo (por ejemplo "top", cuando tanto "top.dictionary" como "top.cmf" están desplegados en el mismo grupo de ejecución) el mandato entero falla con el mensaje BIP1089. En estas circunstancias, debe especificarse el nombre totalmente calificado de los objetos a eliminar, por ejemplo "top.dictionary:top.cmf".
-v nombreArchRastreo
(Opcional) Envía el rastreo de depuración del Proxy de Gestor de configuración interno al archivo especificado.
-m -complete
(Opcional) Despliega información completa:
  • Para un despliegue de archivo BAR, como parte del despliegue -m elimina del grupo de ejecución todos los conjuntos de mensajes y flujos de mensajes desplegados actualmente. Si no se establece -m, se despliega el contenido del archivo BAR además de lo que ya se ha desplegado en el grupo de ejecución. En este caso, todos los objetos desplegados con el mismo nombre como un elemento dentro del BAR se sustituyen por la versión existente dentro del BAR.
  • Para un despliegue de configuración de topología, -m despliega información de configuración entre intermediarios completa a todos los intermediarios. Si no se establece -m, sólo se despliega la configuración entre intermediarios modificada a los intermediarios cuya configuración entre intermediarios se ha modificado.
  • Para un despliegue de intermediario, -m despliega todos los atributos de configuración disponibles del intermediario al intermediario especificado, por ejemplo, parámetros de multidifusión. Si no se establece -m, sólo se despliegan los atributos de configuración modificados.
  • Para un despliegue de árboles de temas, -m despliega todo el árbol de temas a todos los intermediarios. Si no se establece -m, sólo se desplegarán a todos los intermediarios los cambios realizados en el árbol de temas.
  • Para una operación de eliminación de flujo de mensajes o de eliminación de conjunto de mensajes, el indicador se ignora.

Autorización

Para realizar un despliegue satisfactorio, el ID de usuario que emite el mandato debe tener suficiente autoridad definida en el Gestor de configuración. Los permisos requeridos son los mismos que se necesitan para efectuar la función equivalente en el Kit de herramientas de Message Brokers. Consulte Permisos de ACL para obtener una lista de permisos que se pueden definir en el Gestor de configuración.

Respuestas

Este mandato devuelve las siguientes respuestas:
0
(Correcto) Indica que el Gestor de configuración emitió la petición de despliegue y que todos los intermediarios pertinentes respondieron correctamente antes de que se excediese el tiempo de espera.
2
(Error) Indica que el Gestor de configuración emitió la petición de despliegue y que un intermediario como mínimo respondió negativamente. Consulte los mensajes de salida del programa de utilidad (o las anotaciones de sucesos del Gestor de configuración) para obtener más información.
3
(Iniciado) Significa que el Gestor de configuración ha contestado, indicando que el despliegue se ha iniciado pero que no se han recibido respuestas de intermediario antes de exceder el tiempo de espera.
5
(Sometido) Indica que el mensaje de despliegue se ha enviado al Gestor de configuración, pero no se ha recibido ninguna respuesta antes de exceder el tiempo de espera.
6
(Correcto hasta ahora) Indica que el Gestor de configuración ha emitido la petición de despliegue y algunos, pero no todos, de los intermediarios pertinentes han respondido satisfactoriamente antes de que pasara el tiempo de espera; ningún intermediario ha respondido negativamente.
98
Indica que no se puede alcanzar el Gestor de configuración.
99
Indica que los argumentos proporcionados al programa de utilidad no son válidos.

Ejemplos

Conectar al Gestor de configuración cuyos parámetros de conexión se describen en el archivo cm1.configmgr e intentar eliminar el flujo de mensajes top y el diccionario bar del grupo de ejecución default en el intermediario b1.

Observe que, si no hay otros objetos denominados top ni bar desplegados en el grupo de ejecución, el valor de la opción -d puede acortarse a top:bar.

   mqsideploy –n cm1.configmgr –b B1 –e default –d top.cmf:bar.dictionary
Conceptos relacionados
Entorno de ejecución
Tareas relacionadas
Despliegue
Avisos | Marcas registradas | Descargas | Biblioteca | Soporte | Su opinión
Copyright IBM Corporation 1999, 2005 Última actualización: 11/11/2005
an09020_