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.
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.
>>-mqsiapplybaroverride-- -b --ArchivoBar-----------------------> >--+------------------------+--+----------------------------+---> '- -k --nombreAplicación-' '- -m --alteracionesManuales-' >--+---------------------+--+---------------------------+-------> '- -o --archivoSalida-' '- -p --archivoAlteraciones-' >--+------+--+----------------------------+---------------------> '- -r -' '- -v --nombreArchivoRastreo-' >--+------------------------+---------------------------------->< '- -y --nombreBiblioteca-'
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.
<?xml version="1.0" encoding="UTF-8"?>
por<?xml version="1.0"?>
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.
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.
No se permiten variables ni comentarios en los archivos de propiedades.
BIP1138I: Se está alterando temporalmente el archivo BAR utilizando
el mandato mqsiapplybaroverride de tiempo de ejecución
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.
...
CALL mqsiapplybaroverride
...
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.
mqsiapplybaroverride -b myflow.bar -p mychanges.properties
mqsiapplybaroverride -b myflow.bar -p myOriginalBarFile.bar
mqsiapplybaroverride -b myflow.bar -k application1 -p myOriginalBarFile.bar -r
mqsiapplybaroverride -b myflow.bar -k application1 -y library1 -p myOtherBroker.xml
mqsiapplybaroverride -b myApp.bar -k application1 -m startMode=automatic -o myAppManual.bar
mqsiapplybaroverride -b c:\test.bar -p c:\my.properties
mqsiapplybaroverride –b c:\test.bar –p c:\previous.bar
mqsiapplybaroverride –b c:\test.bar –p c:\broker.xml
mqsiapplybaroverride –b c:\test.bar –m OLDA=NEWA,OLDB=NEWB
mqsiapplybaroverride –b c:\test.bar –m sampleFlow#MQInput.queueName=NEWC
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
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.