Utilize o comando mqsiapplybaroverride para substituir os valores configuráveis no descritor de implementação do BAR (broker archive) com novos valores especificados em um arquivo de propriedades.
Use o comando mqsireadbar para ver quais propriedades é possível configurar usando o comando mqsiapplybaroverride.
Grave scripts para criar arquivos BAR e aplique diferentes valores de substituição no archive do descritor de implementação do broker usando o comando mqsiapplybaroverride, juntamente com o comando mqsicreatebar. Para obter uma lista de propriedades do nó do fluxo de mensagens e das propriedades correspondentes do comando mqsiapplybaroverride, consulte Propriedades Configuráveis. As propriedades do comando mqsiapplybaroverride também estão listadas nas tabelas de propriedades no tópico de referência para cada nó afetado.
>>-mqsiapplybaroverride-- -b --BarFile--------------------------> >--+-----------------------+--+-----------------------+---------> '- -k --applicationName-' '- -m --manualOverrides-' >--+------------------+--+---------------------+----------------> '- -o --outputFile-' '- -p --overridesFile-' >--+---------------------+--+--------------------+------------->< '- -v --traceFileName-' '- --y --libraryName-'
É possível usar esse parâmetro com os parâmetros –p (arquivo de substituições) e –m (substituições manuais) para substituições de destino em um aplicativo específico no arquivo BAR. Se o arquivo de substituições especificado pelo parâmetro –p for um arquivo BAR e você configurar o parâmetro –k, os descritores de implementação do aplicativo e todas suas bibliotecas serão atualizados a partir do arquivo BAR de origem. Se o arquivo de substituições especificado pelo parâmetro –p for um descritor de implementação e você configurar o parâmetro –k, apenas o descritor de implementação do aplicativo será atualizado. Se você configurar os parâmetros –m e –k, as substituições manuais se aplicarão ao aplicativo nomeado.
Para aplicar substituições a uma biblioteca específica em um aplicativo, é possível usar o parâmetro –k com o parâmetro –y (nome da biblioteca).
Se você não configurar o parâmetro –k e o arquivo especificado pelo parâmetro –p for um arquivo BAR que contenha aplicativos, se os mesmos aplicativos forem localizados no arquivo BAR de destino, o descritor de implementação do arquivo BAR de destino será atualizado a partir do arquivo BAR de origem.
<?xml version="1.0" encoding="UTF-8" ?>
para<?xml version="1.0"?>
Se o arquivo especificado pelo parâmetro –p for um arquivo BAR que contenha aplicativos ou bibliotecas e você não configurar os parâmetros –k ou -y, se os mesmos aplicativos ou bibliotecas forem localizados no arquivo BAR de destino, o descritor de implementação do arquivo BAR de destino será atualizado a partir do arquivo BAR de origem.
É possível usar esse parâmetro com os parâmetros –p (arquivo de substituições) e –m (substituições manuais) para substituições de destino em uma biblioteca específica no arquivo BAR. Se o arquivo de substituições especificado pelo parâmetro –p for um arquivo BAR e você configurar o parâmetro –y, os descritores de implementação da biblioteca serão atualizados a partir do arquivo BAR de origem. Se o arquivo de substituições especificado pelo parâmetro –p for um descritor de implementação e você configurar o parâmetro –y, apenas o descritor de implementação da biblioteca será atualizado. Se você configurar os parâmetros –m e –y, as substituições manuais se aplicarão à biblioteca nomeada.
Para aplicar substituições a uma biblioteca específica em um aplicativo, é possível usar o parâmetro –y com o parâmetro –k (nome do aplicativo).
Se você não configurar o parâmetro –y e o arquivo especificado pelo parâmetro –p for um arquivo BAR que contenha bibliotecas, se as mesmas bibliotecas forem localizadas no arquivo BAR de destino, o descritor de implementação do arquivo BAR de destino será atualizado a partir do arquivo BAR de origem.
Em todos os casos, qualquer descritor de implementação existente no arquivo BAR será renomeado para META-INF\broker.xml.old, substituindo qualquer arquivo existentes com esse nome.
BIP1138I: Substituindo Arquivo BAR utilizando o tempo de execução mqsiapplybaroverride
Se o comando não for executado a partir de um ambiente privilegiado, será pedido para você confirmar que deseja continuar. Ao clicar em OK, um novo console de comando privilegiado será criado e o comando concluído, porém todas as respostas serão gravadas ao ambiente privilegiado e perdidas quando este console fechar, na conclusão do comando.
Em todos os sistemas operacionais, o ID do usuário utilizado para invocar este comando deve ter autoridade de gravação para o arquivo BAR no sistema local.
Esse comando é fornecido como um arquivo em lote. Se você executar o comando em um sistema de automação ou a partir de um script, utilize o comando CALL do
Windows para assegurar que o ERRORLEVEL correto seja retornado:...
CALL mqsiapplybaroverride
...
mqsiapplybaroverride -b myflow.bar -p mychanges.properties
mqsiapplybaroverride -b myflow.bar -p myOriginalBarFile.bar
mqsiapplybaroverride -b myflow.bar -k application1 -p myOriginalBarFile.bar
mqsiapplybaroverride -b myflow.bar -k application1 -y library1 -p myOtherBroker.xml
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
Para obter um exemplo dos detalhes que estão contidos em um arquivo de propriedades, consulte Editando Propriedades Configuráveis.