WebSphere Message Broker, Versión 8.0.0.5 Sistemas operativos: AIX, HP-Itanium, Linux, Solaris, Windows, z/OS

Consulte la información sobre la última versión del producto en IBM Integration Bus, Versión 9.0

Mandato mqsiapplybaroverride

Utilice el mandato mqsiapplybaroverride para sustituir los valores configurables en el descriptor de despliegue del archivador de intermediario (BAR) por nuevos valores que especifique en un archivo de propiedades.

Sistemas operativos soportados

  • Windows
  • Sistemas Linux y UNIX
  • z/OS. Ejecute este mandato personalizando y sometiendo BIPOBAR.

Finalidad

Utilice el mandato mqsireadbar para ver qué propiedades puede configurar utilizando el mandato mqsiapplybaroverride.

Escriba scripts para crear archivos BAR y aplique distintos valores de modificación en el archivo archivador del descriptor de despliegue de intermediario utilizando el mandato mqsiapplybaroverride junto con el mandato mqsicreatebar. Para obtener una lista de las propiedades de los nodos de flujos de mensajes y las propiedades correspondientes del mandato mqsiapplybaroverride, consulte Propiedades configurables. Las propiedades del mandato mqsiapplybaroverride también aparecen listadas en las tablas de propiedades del tema de referencia para cada nodo afectado.

Sintaxis

Leer el esquema de sintaxisOmitir el esquema de sintaxis visual
>>-mqsiapplybaroverride-- -b --ArchivoBar----------------------->

>--+------------------------+--+----------------------------+--->
   '- -k --nombreAplicación-'  '- -m --alteracionesManuales-'   

>--+---------------------+--+---------------------------+------->
   '- -o --archivoSalida-'  '- -p --archivoAlteraciones-'   

>--+------+--+----------------------------+--------------------->
   '- -r -'  '- -v --nombreArchivoRastreo-'   

>--+------------------------+----------------------------------><
   '- -y --nombreBiblioteca-'   

Parámetros

-b ArchivoBar
(Necesario) Vía de acceso al archivo BAR (en formato comprimido) al que se aplican los valores de alteración temporal. La vía de acceso puede ser absoluta o relativa al mandato ejecutable.
-k nombreAplicación
(Opcional) Nombre de la aplicación en el archivo BAR a la que se aplican alteraciones temporales.

Puede utilizar este parámetro con los parámetros –p (archivo de alteraciones temporales) y –m (alteraciones temporales manuales) para dirigir alteraciones temporales a una aplicación específica del archivo BAR. Si el archivo de alteraciones temporales especificado por el parámetro –p es un archivo BAR y se establece el parámetro –k, el archivo .appzip de la aplicación está ubicado en los archivos BAR de origen y destino. Si el archivo .appzip se encuentra en ambas ubicaciones, el descriptor de despliegue de la aplicación se actualiza desde el archivo BAR de origen. De forma similar, si el archivo de alteraciones temporales especificado por el parámetro –p es un descriptor de despliegue y se establece el parámetro –k, se actualiza el descriptor de despliegue para la aplicación. Si establece los parámetros –m y –k, las alteraciones temporales manuales se aplicarán a la aplicación designada.

Para aplicar alteraciones temporales a una biblioteca específica de una aplicación, puede utilizar el parámetro –k con el parámetro –y (nombre de biblioteca).

Para aplicar las alteraciones temporales en los descriptores de despliegue para una aplicación y todas las bibliotecas anidadas en dicha aplicación, utilice el parámetro -k con el parámetro -r.

-m alteracionesManuales
(Opcional) Lista de parejas nombre-propiedad=alteración, parejas valor-propiedad-actual=alteración, o una combinación de ambas, que se deben aplicar en el archivo BAR. Las parejas de la lista se separan con comas (,). En Windows, la lista se debe escribir entre comillas (" "). Si se utiliza junto con el parámetro overridesFile ( –p), las alteraciones temporales especificadas por el parámetro manualOverrides (–m) se realizan después de que se hayan efectuado las alteraciones temporales especificadas por el parámetro –p.
-o archivoSalida
(Opcional) Nombre del archivo BAR de salida en el que se deben realizar los cambios de archivo BAR. Si no se especifica un archivo de salida, se graba encima del archivo de entrada.
-p archivoAlteraciones
(Opcional) Vía de acceso a uno de los siguientes recursos:
  • Un archivo BAR que contiene el descriptor de despliegue que se utiliza para aplicar alteraciones temporales al archivo BAR.
    Puede utilizar XML para el archivo de descriptor de despliegue. Si utiliza un archivo de propiedades XML que está escrito en EBCDIC en z/OS, asegúrese de eliminar encoding="UTF-8" de la cabecera XML; por ejemplo, cambie:
    <?xml version="1.0" encoding="UTF-8"?>
    por
    <?xml version="1.0"?>
  • Un archivo de propiedades en el que cada línea contiene una pareja nombre-propiedad=alteración o valor-propiedad-actual=valor-propiedad-nuevo.
  • Un descriptor de despliegue que se utiliza para aplicar alteraciones en el archivo BAR.
Si el archivo especificado por el parámetro -p es un archivo BAR que contiene aplicaciones o bibliotecas, de forma predeterminada sólo se aplica el descriptor de despliegue del archivo BAR de origen al archivo BAR de destino. Para copiar descriptores de despliegue para aplicaciones y bibliotecas que se encuentran en los archivos BAR de origen y destino, puede utilizar los parámetros -k, -y y -r.
  • Puede utilizar el parámetro recursivo (-r) para copiar en el archivo BAR de origen todos los descriptores de despliegue que también están presentes en el archivo BAR de destino.
  • Puede utilizar los parámetros de aplicación (-k) y biblioteca (-y) para iniciar la copia desde un punto de partida diferente.
  • Si utiliza los parámetros -k o -y sin el parámetro recursivo (-r), sólo se copia ese descriptor de despliegue de aplicación o biblioteca.
  • Si utiliza el parámetro -k con el parámetro recursivo, se tienen en cuenta para la copia la aplicación y todos los descriptores de despliegue de biblioteca.
  • Si utiliza los parámetros de aplicación (-k) o de biblioteca (-y), no se copian descriptores de despliegue fuera del ámbito de la aplicación o biblioteca mencionadas. Por ejemplo, el descriptor de despliegue de archivo BAR no se transferirá al archivo BAR de destino.
-r
(Opcional) Especifica si todos los archivos de descriptor de despliegue se actualizan de forma recursiva, incluidos los que se encuentran en aplicaciones (archivos .appzip) y bibliotecas (archivos .libzip anidadas).

Puede establecer el punto de partida para el parámetro -r en el archivo BAR o una aplicación. Si establece los parámetros -r y -k (nombre de aplicación), los descriptores de despliegue se actualizan para esa aplicación y todas las bibliotecas anidadas en dicha aplicación. Si establece los parámetros -r e -y (nombre de biblioteca), el parámetro -r no tiene ningún efecto porque una biblioteca no tiene aplicaciones o bibliotecas anidadas. Por lo tanto, el descriptor de despliegue se actualiza sólo para esa biblioteca. Si no establece los parámetros -k o -y, el parámetro -r especifica que los descriptores de despliegue en todas las aplicaciones y bibliotecas del archivo BAR se actualicen.

-v nombreArchivoRastreo
(Opcional) Especifica que el rastreo interno se debe enviar al archivo mencionado.
-y nombreBiblioteca
(Opcional) Nombre de la biblioteca en el archivo BAR a la que se aplican alteraciones temporales.

Puede utilizar este parámetro con los parámetros –p (archivo de alteraciones temporales) y –m (alteraciones temporales manuales) para dirigir alteraciones temporales a una biblioteca específica del archivo BAR. Si el archivo de alteraciones temporales especificado por el parámetro –p es un archivo BAR y se establece el parámetro –y, el archivo .libzip de la biblioteca está ubicado en los archivos BAR de origen y destino. Si el archivo .libzip se encuentra en ambas ubicaciones, el descriptor de despliegue para la biblioteca se actualiza desde el archivo BAR de origen. De forma similar, si el archivo de alteraciones temporales especificado por el parámetro –p es un descriptor de despliegue y se establece el parámetro –y, se actualiza el descriptor de despliegue para la biblioteca. Si establece los parámetros –m y –y, las alteraciones temporales manuales se aplicarán a la biblioteca designada.

Para aplicar alteraciones temporales a una biblioteca específica de una aplicación, puede utilizar el parámetro –y con el parámetro –k (nombre de aplicación).

En todos los casos, cualquier descriptor de despliegue existente en el archivo BAR se redenomina como META-INF\broker.xml.old, sustituyendo el archivo existente de dicho nombre.

Cada alteración temporal que se especifica en un archivo de alteraciones temporales –p o una lista de alteraciones temporales –m debe ajustarse a una de las sintaxis siguientes:
  • FlowName#NodeName.PropertyName=NewPropertyValue (o FlowName#PropertyName=NewPropertyValue para propiedades de flujo de mensajes) donde:
    • FlowName es el nombre del flujo de mensajes sin la extensión .msgflow o .msgflow o .cmf (por ejemplo, Flow1).
    • NodeName es el nombre opcional del nodo cuya propiedad se altera temporalmente (por ejemplo InputNode).
    • PropertyName es el nombre de la propiedad que se va a alterar temporalmente (por ejemplo, queueName).
    • NewPropertyValue es el valor a asignar a dicha propiedad (por ejemplo PRODUCTION_QUEUE_NAME).
  • OldPropertyValue=NewPropertyValue. Esta sintaxis realiza una búsqueda y una sustitución globales en el valor de propiedad OldPropertyValue. Altera temporalmente los campos de valor de OldPropertyValue en el descriptor de despliegue con NewPropertyValue.
  • FlowName#NodeName.PropertyName (o FlowName#PropertyName para propiedades de flujo de mensajes). Esta sintaxis elimina cualquier alteración que se aplica a la propiedad del nombre proporcionado.
  • applicationPropertyName=propertyValue. Las propiedades configurables de las aplicaciones no se califican mediante un nombre de aplicación de la misma manera que las propiedades configurables de flujo de mensajes se califican mediante flowName y nodeName. Para alterar temporalmente las propiedades de aplicación, utilice esta sintaxis y utilice el parámetro -k para nombrar la aplicación que se debe actualizar.

No se permiten variables ni comentarios en los archivos de propiedades.

Nota: Cuando un archivo BAR contiene aplicaciones y bibliotecas, utilice los parámetros -k, -y o -r ara definir el ámbito de las alteraciones temporales que se aplican. Si no se especifican estos parámetros, no se realizan actualizaciones a las propiedades configurables en las aplicaciones o bibliotecas. Sólo se actualizan las propiedades configurables para recursos que no están contenidos en aplicaciones o bibliotecas y si no existen estos recursos, no se realizan actualizaciones.
Cuando el mandato mqsiapplybaroverride se ejecuta, muestra la versión del mandato que se está utilizando (entorno de ejecución o WebSphere Message Broker Toolkit) antes de realizar cualquier otra acción. Por ejemplo:
BIP1138I: Se está alterando temporalmente el archivo BAR utilizando
el mandato mqsiapplybaroverride de tiempo de ejecución

Autorización

En sistemas Windows 7 y Windows Server 2008, el ID de usuario utilizado para ejecutar este mandato debe ejecutarse con privilegios elevados en el sistema local:
  • El ID de usuario debe ser miembro del grupo Administradores.
  • El mandato debe iniciarse desde un entorno que tenga la autorización Ejecutar como administrador.

Si no ejecuta el mandato desde un entorno con privilegios, se le solicitará que confirme si desea continuar. Cuando pulse Aceptar, se creará una nueva consola de mandatos con privilegios y se completará el mandato, aunque todas las respuestas escritas en el entorno de privilegio se perderán cuando la consola se cierre al finalizar el mandato.

En todos los sistemas operativos, el ID de usuario utilizado para invocar este mandato debe tener autorización de grabación en el archivo BAR del sistema local.

Respuestas

Este mandato devuelve las siguientes respuestas:
0
El mandato se ha completado correctamente.
99
Uno o más de los parámetros que ha especificado no es válido.
Windows platformEste mandato se proporciona como archivo de proceso por lotes. Si ejecuta el mandato en un sistema de automatización o desde un script, utilice el mandato CALL de Windows, para asegurar que se devuelve el ERRORLEVEL correcto:
...
CALL mqsiapplybaroverride
...

Ejemplos

Para los ejemplos que no especifican parámetros -k, -y o -r, las actualizaciones de la propiedad configurable sólo se efectúan en el descriptor de despliegue para recursos que no son aplicaciones o bibliotecas. En estos casos, no se realizan actualizaciones a recursos contenidos en aplicaciones o bibliotecas.

Abrir el archivo BAR myflow.bar y sustituir los valores configurables en el descriptor de despliegue (normalmente broker.xml) por los valores especificados en el archivo de propiedades mychanges.properties:
mqsiapplybaroverride  -b myflow.bar -p mychanges.properties 
Alterar temporalmente los valores del archivo BAR myflow.bar con los valores del archivo BAR myOriginalBarFile.bar:
mqsiapplybaroverride -b myflow.bar -p myOriginalBarFile.bar
Actualizar los descriptores de despliegue para la aplicación application1 y las bibliotecas de referencia desde el archivo BAR myOriginalBarFile.bar:
mqsiapplybaroverride -b myflow.bar -k application1 -p myOriginalBarFile.bar -r
Actualizar los descriptores de despliegue para la biblioteca library1 que se encuentra en la aplicación application1:
mqsiapplybaroverride -b myflow.bar -k application1 -y library1 -p myOtherBroker.xml
Actualizar la modalidad de inicio de la aplicación application1:
mqsiapplybaroverride -b myApp.bar -k application1 -m startMode=automatic -o myAppManual.bar
Alterar temporalmente el descriptor de despliegue en c:\test.bar utilizando los pares clave=valor especificados en c:\my.properties:
mqsiapplybaroverride -b c:\test.bar -p c:\my.properties 
Alterar temporalmente el descriptor de despliegue en c:\test.bar utilizando el descriptor de despliegue que está contenido en c:\previous.bar:
mqsiapplybaroverride –b c:\test.bar –p c:\previous.bar  
Alterar temporalmente el descriptor de despliegue en c:\test.bar utilizando el descriptor de despliegue que está contenido en c:\broker.xml:
mqsiapplybaroverride –b c:\test.bar –p c:\broker.xml  
Alterar temporalmente las propiedades con valores establecidos en OLDA y OLDB en c:\test.bar con los valores NEWA y NEWB:
mqsiapplybaroverride –b c:\test.bar –m OLDA=NEWA,OLDB=NEWB  
Alterar temporalmente el valor del nombre de propiedad sampleFlow#MQInput.queueName a NEWC:
mqsiapplybaroverride –b c:\test.bar –m sampleFlow#MQInput.queueName=NEWC  
Alterar temporalmente el valor de la propiedad sampleFlow#MQInput.queueName en NEWC y las propiedades con valores establecidos anteriormente en OLDA y OLDB, en NEWA y NEWB utilizando un archivo de propiedades:
mqsiapplybaroverride –b c:\test.bar –p c:\mynew.properties
donde el archivo mynew.properties contiene las líneas siguientes:
sampleFlow#MQInput.queueName=NEWC
OLDA=NEWA
OLDB=NEWB
En el ejemplo siguiente, el archivo BAR test.bar contiene el archivo de flujo de mensajes sampleFlow.msgflow. Este flujo de mensajes contiene el subflujo sampleSubflow1.subflow y el subflujo sampleSubflow1.subflow contiene el subflujo sampleSubflow2.subflow. Altere temporalmente las propiedades siguientes utilizando el archivo de propiedades:
  • En el flujo de mensajes sampleFlow.msgflow, altere temporalmente la cola de entrada en el nodo MQ Input a NEW_INPUT_QUEUE.
  • En el flujo de mensajes sampleFlow.msgflow borre el valor de la propiedad promocionada queueName establecida en el nodo de subflujo que representa sampleSubflow1.subflow.
  • En el subflujo sampleSubflow1.subflow, borre el valor de la propiedad promocionada de nivel de flujo queueName.
  • En todos los flujos y subflujos de mensajes, altere temporalmente a NEWSUBOUT las propiedades que tengan valores establecidos anteriormente en SUBOUT.
mqsiapplybaroverride –b c:\test.bar –p c:\override.properties
donde el archivo override.properties contiene las líneas siguientes:
sampleFlow#MQ Input.queueName=NEW_INPUT_QUEUE
sampleFlow#sampleSubflow1.queueName
sampleSubflow1#queueName
SUBOUT=NEW_SUBOUT

Para ver un ejemplo de los detalles que están contenidos en un archivo de propiedades, consulte Edición de propiedades configurables.

Avisos | Marcas registradas | Descargas | Biblioteca | Soporte | Comentarios

Copyright IBM Corporation 1999, 2014Copyright IBM Corporation 1999, 2014.

        
        Última actualización:
        
        Última actualización: 2015-02-28 17:00:08


Tema de referenciaTema de referencia | Versión 8.0.0.5 | an19545_