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

Plataformas Windows, y sistemas Linux y UNIX

Mandato de consola z/OS

Sinónimo: dp

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 direcciónIP
(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 gestC
(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 despliegue de flujo de mensajes o de conjunto de mensajes. Con esta opción también deben especificarse las opciones -b y -e.

En z/OS el archivo de datos antiguos de intermediario (BAR) debe estar en el sistema de archivos. El archivo de datos antiguos de intermediario (BAR) puede estar en cualquier sitio siempre y cuando el ID de usuario de la persona o el Gestor de configuración que ejecutan el mandato puedan acceder al archivo y leerlo.

-t
(Opcional) Despliega toda la información de configuración de los temas. La información se despliega a todos los intermediarios del dominio.
-l
(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
(Opcional) Indica al Gestor de configuración que se detenga, para esperar las respuestas a las peticiones de despliegue sometidas anteriormente. Si se utiliza con la opción -b, el Gestor de configuración se detiene y espera las respuestas de despliegue pendientes del intermediario especificado; sin la opción -b, el Gestor de configuración se detiene y espera 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 han de eliminar del grupo de ejecución. Se pueden especificar múltiples archivos desplegados, separados por el carácter ":".

Pueden especificarse objetos de todos los tipos, con la siguiente limitación por la que, 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 configuración de intermediario este indicador no es válido.
  • 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 autorización suficiente 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

Despliegue intermediarios contiguos de Publicación/Suscripción utilizando un archivo de conexión cuyos parámetros están descritos en el archivo cm1.configmgr, espere 10 minutos a que el intermediario responda y despliegue información de configuración entre intermediarios completa:
mqsideploy -n cm1.configmgr -m -w 600 
Despliegue intermediarios contiguos de Publicación/Suscripción mediante los parámetros i, p y q para conectar con el Gestor de configuración, espere 10 minutos a que responda el intermediario y despliegue información de configuración entre intermediarios completa:
mqsideploy -i localhost -p 1414 -q QMNAME -m -w 600 

Observe que en los ejemplos siguientes puede utilizar los parámetros i, p y q en vez del parámetro -n.

Despliegue una jerarquía de temas utilizando un archivo de conexión cuyos parámetros están descritos en el archivo cm1.configmgr, espere 10 minutos a que el intermediario responda y despliegue información de configuración entre intermediarios completa:
mqsideploy -n cm1.configmgr -t -m -w 600 
Despliegue un archivo de datos antiguos de intermediario (bar) utilizando un archivo de conexión cuyos parámetros están descritos en el archivo cm1.configmgr, espere 10 minutos a que el intermediario responda y elimine del grupo de ejecución todos los flujos de mensajes y conjuntos de mensajes desplegados actualmente como parte del despliegue:
mqsideploy -n cm1.configmgr -b broker1 -e default -a mybar.bar -m -w 600 
Despliegue una configuración de intermediario utilizando un archivo de conexión cuyos parámetros están descritos en el archivo cm1.configmgr, al intermediario especificado y espere 15 minutos a que el intermediario responda:
mqsideploy -n cm1.configmgr -b broker1 -w 900 

Intente eliminar el flujo de mensajes top y el diccionario bar del grupo de ejecución default del intermediario b1, utilizando un archivo de conexión cuyos parámetros están descritos en el archivo cm1.configmgr.

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
Cancele un despliegue utilizando un archivo de conexión cuyos parámetros están descritos en el archivo cm1.configmgr y espere 15 minutos a que el intermediario responda. En este ejemplo, el Gestor de configuración se detiene y espera todas las solicitudes de despliegue pendientes del dominio. Para especificar un intermediario determinado en el que cancelar un despliegue, utilice el parámetro -b:
mqsideploy -n cm1.configmgr -c -w 900 
Conceptos relacionados
Entorno de ejecución
Tareas relacionadas
Despliegue
Avisos | Marcas registradas | Descargas | Biblioteca | Soporte | Su opinión
Copyright IBM Corporation 1999, 2006 Última actualización: 22/08/2006
an09020_