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-' '- -r -' >--+---------------------+--+-------------------+-------------->< '- -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, o arquivo .appzip do aplicativo estará localizado nos arquivos BAR de origem e destino. Se o arquivo .appzip estiver localizado em ambos os locais, o descritor de implementação para o aplicativo será atualizado a partir do arquivo BAR de origem. De modo semelhante, se o arquivo de substituições especificado pelo parâmetro –p for um descritor de implementação e você configurar o parâmetro –k, o descritor de implementação para o 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).
Para aplicar substituições aos descritores de implementação para um aplicativo e para todas as bibliotecas aninhadas nesse aplicativo, use o parâmetro –k com o parâmetro –r.
<?xml version="1.0" encoding="UTF-8" ?>
para<?xml version="1.0"?>
É possível configurar o ponto de início do parâmetro -r para o arquivo BAR ou um aplicativo. Se você configurar os parâmetros -r e -k (nome do aplicativo), os descritores de implementação serão atualizados para esse aplicativo e todas as bibliotecas aninhadas nesse aplicativo. Se você configurar os parâmetros -r e -y (nome da biblioteca), o parâmetro -r não terá efeito porque uma biblioteca não possui aplicativos ou bibliotecas aninhadas. Portanto, o descritor de implementação é atualizado apenas para essa biblioteca. Se você não configurar os parâmetros -k ou -y, o parâmetro -r especificará que os descritores de implementação em todos os aplicativos e bibliotecas no arquivo BAR serão atualizados.
É 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, o arquivo .libzip da biblioteca estará localizado nos arquivos BAR de origem e destino. Se o arquivo .libzip estiver localizado em ambos os locais, o descritor de implementação para a biblioteca será atualizado a partir do arquivo BAR de origem. De modo semelhante, se o arquivo de substituições especificado pelo parâmetro –p for um descritor de implementação e você configurar o parâmetro –y, o descritor de implementação para a 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).
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.
As variáveis e os comentários não são permitidos nos arquivos de propriedades.
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.
...
CALL mqsiapplybaroverride
...
Para os exemplos que não especificam os parâmetros -k, -y ou -r, as atualizações da propriedade configurável são feitas apenas para o descritor de implementação para recursos que não são aplicativos ou bibliotecas. Nesses casos, nenhuma atualização é feita para os recursos contidos nos aplicativos ou 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
em que o arquivo mynew.properties contém as linhas a seguir:sampleFlow#MQInput.queueName=NEWC
OLDA=NEWA
OLDB=NEWB
mqsiapplybaroverride –b c:\test.bar –p c:\override.properties
em que o arquivo override.properties contém as seguintes linhas:sampleFlow#MQ Input.queueName=NEW_INPUT_QUEUE
sampleFlow#sampleSubflow1.queueName
sampleSubflow1#queueName
SUBOUT=NEW_SUBOUT
Para obter exemplos dos detalhes que estão contidos em um arquivo de propriedades, consulte Editando Propriedades Configuráveis.