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

Formato del diagrama de sintaxis      Diagrama de vía      Decimal con puntos

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 establece el parámetro –k, los descriptores de despliegue para la aplicación y todas las bibliotecas se actualizan desde el archivo BAR de origen. Si el archivo de alteraciones temporales especificado por el parámetro –p es un descriptor de despliegue y establece el parámetro –k, sólo se utiliza 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).

Si no establece el parámetro -k y el archivo especificado por el parámetro -p es un archivo BAR que contiene aplicaciones, si las mismas aplicaciones se encuentran en el archivo BAR de destino, el descriptor de despliegue del archivo BAR de destino se actualiza desde el archivo BAR de origen.

-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.
-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 las alteraciones en el archivo BAR.
    Puede utilizar XML para el archivo de descriptor de despliegue. Si utiliza un archivo de propiedades XML 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, y no establece los parámetros -k or -y, si las mismas aplicaciones o bibliotecas se encuentran en el archivo BAR de destino, el descriptor de despliegue del archivo BAR de destino se actualiza desde el archivo BAR de origen.

-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.
-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 establece el parámetro –y, los descriptores de despliegue de la biblioteca se actualizan desde el archivo BAR de origen. Si el archivo de alteraciones temporales que especifica el parámetro –p es un descriptor de despliegue y establece el parámetro –y, sólo 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).

Si no establece el parámetro -y y el archivo especificado por el parámetro -p es un archivo BAR que contiene bibliotecas, si las mismas bibliotecas se encuentran en el archivo BAR de destino, el descriptor de despliegue del archivo BAR de destino se actualiza desde el archivo BAR de origen.

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 .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 está alterando 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 temporal aplicada a la propiedad del nombre proporcionado.
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 ampliados 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 platform Este 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

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 application1 y sus bibliotecas referenciadas desde el archivo BAR myOriginalBarFile.bar:
mqsiapplybaroverride -b myflow.bar -k application1 -p myOriginalBarFile.bar
Actualizar los descriptores de despliegue para application1 y library1:
mqsiapplybaroverride -b myflow.bar -k application1 -y library1 -p myOtherBroker.xml
Alterar temporalmente el descriptor de despliegue en c:\test.bar utilizando las parejas clave=valor especificadas 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 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 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  

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 | Este enlace se abre en una nueva ventana Descargas | Este enlace se abre en una nueva ventana Biblioteca | Este enlace se abre en una nueva ventana Soporte | Comentarios

Copyright IBM Corporation 1999, 2011Copyright IBM Corporation 1999, 2011.

        
        Última actualización
        
        Última actualización : 2011-11-07 13:56:17


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