Mandato mqsideploy - z/OS

BIPDPLY se utiliza para ejecutar mqsideploy, y en z/OS el mandato hace esto desde enlaces JAVA; vea las Notas de uso.

Sintaxis

Mandato z/OS - BIPDPLY

Mandato de consola z/OS

Sinónimo: dp

Parámetros

-n NombreArchParámetrosCfg
(Opcional) Este parámetro especifica el nombre de un archivo .configmgr que describe los parámetros de conexión para el Gestor de configuración.
Elimine la sentencia encoding="UTF-8" de la primera línea del archivo .configmgr y elimine el valor del atributo host, de forma que la sentencia quede así:
<?xml version="1.0"?>
<configmgr crlNameList="" domainName="" host="" listenerPort="2206" 
queueManager="mq06" securityExit="" securityExitJar="" sslCipherSuite="NONE" 
sslDistinguishedNames="" sslKeyStore="" sslTrustStore="" svrconn="SYSTEM.BKR.CONFIG"/>
-i DirecciónIP
(Opcional) Este parámetro especifica el nombre de host o la dirección IP del Gestor de configuración.

Para conectar con el host local, establezca el valor en un espacio en blanco (" ").

-p Puerto
(Opcional) Este parámetro es el número de puerto del Gestor de configuración.
-q GstC
(Opcional) Este parámetro especifica 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
(Opcional) Este parámetro especifica el nombre del intermediario en el que realizar el despliegue. Si especifica el parámetro -t o -l, se hace caso omiso del parámetro -b porque el despliegue de temas o topologías afecta a todos los intermediarios del dominio. Sin los parámetros -e y -a, se inicia un despliegue de configuración de intermediario. Si no especifica el parámetro -b, el mandato se aplica a todos los intermediarios del dominio.
Especifique el parámetro -c para cancelar el despliegue en un intermediario específico.
-e NombreGe
(Opcional) Este parámetro especifica el nombre del grupo de ejecución en el que realizar el despliegue. Con este parámetro, debe especificar -b y -a.
-aNombreArchBAR
(Opcional) Este parámetro especifica el nombre del archivo bar (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 debe especificar los parámetros -b y -e.

El archivo BAR debe estar en el sistema de archivos. El archivo BAR puede estar en cualquier parte del sistema de archivos, siempre y cuando el ID de usuario de la persona o el Gestor de configuración que ejecuta el mandato pueda acceder al archivo y leerlo.

-t
(Opcional) Este parámetro especifica el despliegue de la información de configuración de todos los temas.
  • Cuando se utiliza junto con el parámetro -m, el parámetro -t hace que la jerarquía entera de temas se despliegue a todos los intermediarios del dominio.
  • Cuando se utiliza sin el parámetro -m, el parámetro -t hace que sólo los cambios en la jerarquía de temas (realizados desde el último despliegue de temas satisfactorio) se desplieguen a todos los intermediarios del dominio.
-l
(Opcional) Este parámetro especifica que debe desplegarse la configuración de topología. La información se despliega a todos los intermediarios del dominio si el parámetro -m también está establecido; de lo contrario, la información sólo se despliega a los intermediarios que tienen una configuración de topología cambiada.
-c
(Opcional) Este parámetro indica al Gestor de configuración que deje de esperar respuestas a peticiones de despliegue sometidas anteriormente. Si se utiliza con el parámetro -b, el Gestor de configuración deja de esperar respuestas de despliegue pendientes del intermediario especificado; sin el parámetro -b, el Gestor de configuración deja de esperar respuestas a todas las peticiones de despliegue pendientes del dominio.

Especifique el parámetro -c con precaución ya que tiene el efecto de cancelar las peticiones de despliegue. Utilice esta opción únicamente si los intermediarios afectados responderán a las solicitudes pendientes. Si un intermediario procesa posteriormente una petición de despliegue que se ha cancelado, el Gestor de configuración hace caso omiso de la respuesta y, por tanto, deja de estar sincronizado con el intermediario.

-w ValorTiempoEspera
(Opcional) Este parámetro especifica el tiempo, en segundos, que el mandato espera a que el intermediario responda antes de devolver el control a la línea de mandatos. El mandato mqsideploy sondea los registros de anotaciones del Gestor de configuración en busca de los resultados de la petición de despliegue que acaba de enviarse. Los registros de anotaciones relevantes contienen información que indica si el despliegue se ha realizado satisfactoriamente. Ele valorTiempoEspera es el número de segundos que el mandato espera antes de que caduque el tiempo de espera.

Puede establecer este parámetro a un valor en el rango 1 - 2 145 336 164. Si no se proporciona ningún valorTiempoEspera o establece un valor inferior a 1 o superior a 2 145 336 164, se devuelve un error.

Inicio del cambioEstablezca este parámetro en un valor superior a la suma de los tiempos de espera excedidos que ha especificado para el intermediario, los parámetros ConfigurationChangeTimeout y InternalConfigurationTimeout si desea asegurarse de que se ha recibido una respuesta dentro del periodo de valorTiempoEspera. Si establece un valor inferior, la respuesta devuelta puede indicar que el estado de la petición de despliegue es desconocido.Fin del cambio

-d ObjetosDesplegados
(Opcional) Este parámetro describe el conjunto de objetos que desea eliminar del grupo de ejecución. Puede especificar varios archivos a desplegar, separando los nombres de archivo con dos puntos (:).

Puede especificar objetos de todos los tipos, pero si especifica un nombre de objeto ambiguo (por ejemplo "top", cuando tanto "top.dictionary" como "top.cmf" se despliegan al mismo grupo de ejecución), el mandato entero falla con el mensaje BIP1089. En estos casos, debe especificar el nombre totalmente calificado de los objetos a eliminar, por ejemplo "top.dictionary:top.cmf".

-v NombreArchRastreo
(Opcional) Este parámetro envía el rastreo interno del Proxy del Gestor de configuración al archivo especificado.
-m
(Opcional) Este parámetro especifica el despliegue de la información completa:
  • Para un despliegue de archivo BAR, -m elimina todos los conjuntos de mensajes y flujos de mensajes desplegados actualmente del grupo de ejecución, como parte del despliegue. 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. Todos los objetos desplegados que tengan el mismo nombre que un elemento dentro del archivo BAR se sustituyen por la versión existente dentro del archivo 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 parámetro no es válido.
  • Para un despliegue de árbol 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, se hace caso omiso del parámetro -m.

Notas de uso

Si entra:
mqsideploy -i nombre_gc -p puerto -q gc_gc -l -m 
el mandato intenta ejecutar el mandato mqsideploy utilizando el código cliente Java de WebSphere MQ, que no está soportado en z/OS. Conectar con el Gestor de configuración local con los parámetros -i y -p fuerza el mandato en modalidad local, y se produce el error siguiente:
BIP1046E: No se ha podido conectar
al gestor de colas del Gestor de configuración
Dependiendo de la versión de WebSphere MQ que utilice, los códigos de razón notificados difieren:
  • En WebSphere MQ V5.3.1, recibe:
    2012 0x000007dc MQRC_ENVIRONMENT_ERROR
  • En WebSphere MQ V6.0, recibe:
    2298 0x000008fa MQRC_FUNCTION_NOT_SUPPORTED

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 BAR utilizando un archivo de conexión cuyos parámetros están descritos en el archivo cm1.configmgr, en el intermediario especificado, 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. (Si no hay otros objetos denominados top ni bar desplegados en el grupo de ejecución, puede reducir el valor del parámetro -d 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.
  mqsideploy -n cm1.configmgr -c -w 900 
Avisos | Marcas registradas | Descargas | Biblioteca | Soporte | Su opinión

Copyright IBM Corporation 1999, 2009Copyright IBM Corporation 1999, 2009.
Última actualización : 2009-02-16 13:55:53

an28530_