WebSphere Message Broker, Versão 8.0.0.5 Sistemas operacionais: AIX, HP-Itanium, Linux, Solaris, Windows, z/OS

Consulte as informações sobre a versão mais recente do produto em IBM Integration Bus, Versão 9.0

Comando mqsiapplybaroverride

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.

Sistemas Operacionais Suportados

  • Windows
  • Sistemas Linux e UNIX
  • z/OS. Execute este comando customizando e enviando BIPOBAR.

Finalidade

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.

Sintaxe

Ler diagrama de sintaxeManter visual do diagrama de sintaxe
>>-mqsiapplybaroverride-- -b --BarFile-------------------------->

>--+-----------------------+--+-----------------------+--------->
   '- -k --applicationName-'  '- -m --manualOverrides-'   

>--+------------------+--+---------------------+--+------+------>
   '- -o --outputFile-'  '- -p --overridesFile-'  '- -r -'   

>--+---------------------+--+-------------------+--------------><
   '- -v --traceFileName-'  '- -y --libraryName-'   

Parâmetros

-b BarFile
(Necessário) O caminho para o arquivo BAR (no formato compactado) ao qual os valores de substituição se aplicam. O caminho pode ser absoluto ou relativo para o comando executável.
-k applicationName
(Opcional) O nome de um aplicativo no arquivo BAR ao qual aplicar substituições.

É 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.

-m manualOverrides
(Opcional) Uma lista dos pares property-name=override, dos pares current-property-value=override, ou uma combinação deles, a ser aplicada ao arquivo BAR. Os pares na lista são separados por vírgulas (,). No Windows, é necessário colocar a lista entre aspas (" "). Se usadas com o parâmetro overridesFile ( –p), as substituições especificadas pelo parâmetro manualOverrides (–m) serão executadas após as substituições especificadas pelo parâmetro –p terem sido feitas.
-o outputFile
(Opcional) O nome do arquivo BAR de saída no qual as alterações do arquivo BAR devem ser feitas. Se não for especificado um arquivo de saída, o arquivo de entrada será sobrescrito.
-p overridesFile
(Opcional) O caminho para um dos seguintes recursos:
  • Um arquivo BAR que contém o descritor de implementação que é usado para aplicar substituições no arquivo BAR.
    É possível usar o XML para o arquivo do descritor de implementação. Se você usar um arquivo de propriedades XML gravado em EBCDIC no z/OS, assegure-se de remover qualquer encoding="UTF-8" do cabeçalho XML; por exemplo, altere:
    <?xml version="1.0" encoding="UTF-8" ?>
    para
    <?xml version="1.0"?>
  • Um arquivo de propriedades no qual cada linha contém um par property-name=override ou current-property-value=new-property-value.
  • Um descritor de implementação utilizado para aplicar substituições ao arquivo BAR.
Se o arquivo especificado pelo parâmetro -p for um arquivo BAR que contém aplicativos ou bibliotecas, por padrão apenas o descritor de implementação do arquivo BAR de origem será aplicado ao arquivo BAR de destino. Para copiar descritores de implementação para aplicativos e bibliotecas localizados nos arquivos BAR de origem e destino, é possível usar os parâmetros -k, -y e -r.
  • É possível usar o parâmetro recursivo (-r) para copiar todos os descritores de implementação no arquivo BAR de origem que também estão presentes no arquivo BAR de destino.
  • É possível usar os parâmetros de aplicativo (-k) e biblioteca (-y) para iniciar a cópia de um ponto de início diferente.
  • Se você usar os parâmetros -k ou -y sem o parâmetro recursivo (-r), apenas esse descritor de implementação de aplicativo ou biblioteca será copiado.
  • Se você usar o parâmetro -k com o parâmetro recursivo, o aplicativo e todos os seus descritores de implementação de biblioteca serão considerados para cópia.
  • Se você usar os parâmetros de aplicativo (-k) ou biblioteca (-y), nenhum descritor de implementação será copiado fora do escopo do aplicativo ou biblioteca nomeada. Por exemplo, o descritor de implementação do arquivo BAR não seria transferido para o arquivo BAR de destino.
-r
(Opcional) Especifica que todos os arquivos do descritor de implementação são atualizados recursivamente, incluindo todos nos aplicativos aninhados (arquivos .appzip) e bibliotecas (arquivos .libzip).

É 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.

-v traceFileName
(Opcional) Especifica que o rastreio interno deve ser enviado para o arquivo denominado.
-y libraryName
(Opcional) O nome de uma biblioteca no arquivo BAR à qual aplicar substituições.

É 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.

Cada substituição especificada em um arquivo de substituições –p ou em uma lista de substituições –m deve estar em conformidade com uma das seguintes sintaxes:
  • FlowName#NodeName.PropertyName=NewPropertyValue (ou FlowName#PropertyName=NewPropertyValue para propriedades do fluxo de mensagens), em que:
    • FlowName é o nome do fluxo de mensagens sem a extensão .msgflow ou .cmf (por exemplo, Flow1).
    • NodeName é o nome opcional do nó cuja propriedade foi substituída (por exemplo, InputNode).
    • PropertyName é o nome da propriedade a ser substituída (por exemplo, queueName).
    • NewPropertyValue é o valor a ser designado a essa propriedade (por exemplo, PRODUCTION_QUEUE_NAME).
  • OldPropertyValue=NewPropertyValue. Esta sintaxe faz uma procura global e substituição no valor da propriedade OldPropertyValue. Ele substitui os campos de valores de OldPropertyValue no descritor de implementação por NewPropertyValue.
  • FlowName#NodeName.PropertyName (ou FlowName#PropertyName para propriedades do fluxo de mensagens). Esta sintaxe remove qualquer substituição aplicada à propriedade do nome fornecido.
  • applicationPropertyName=propertyValue. As propriedades configuráveis de aplicativos não são qualificadas por um nome de aplicativo da mesma maneira que as propriedades configuráveis do fluxo de mensagens são qualificadas por flowName e nodeName. Para substituir as propriedades do aplicativo, use essa sintaxe e use o parâmetro -k para nomear o aplicativo que será atualizado.

As variáveis e os comentários não são permitidos nos arquivos de propriedades.

Nota: Quando um arquivo BAR contiver aplicativos e bibliotecas, use os parâmetros -k, -y ou -r para definir o escopo das substituições que são aplicadas. Se esses parâmetros não forem especificados, nenhuma atualização será feita nas propriedades configuráveis em nenhum aplicativo ou biblioteca. Apenas as propriedades configuráveis para recursos que não estão contidos nos aplicativos ou bibliotecas são atualizadas e, se não existirem esses recursos, nenhuma atualização será feita.
Quando o comando mqsiapplybaroverride é executado, ele exibe a versão do comando que está sendo usado (o ambiente de tempo de execução ou WebSphere Message Broker Toolkit) antes de fazer qualquer outra coisa. Por exemplo:
BIP1138I: Substituindo Arquivo BAR utilizando o tempo de execução mqsiapplybaroverride

Autorização

Nos sistemas Windows 7 e Windows Server 2008, o ID do usuário usado para executar esse comando deve estar em execução com privilégios elevados no sistema local:
  • O ID do usuário deve ser membro do grupo Administrators.
  • O comando deve ser iniciado a partir de um ambiente que tenha autoridade Executar como Administrador.

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.

Respostas

Esse comando retorna as seguintes respostas:
0
O comando foi concluído com sucesso.
99
Um ou mais dos parâmetros especificados são inválidos.
Windows platformEsse 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
...

Exemplos

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.

Abra o arquivo BAR myflow.bar, e substitua valores configuráveis em seu descritor de implementação (geralmente broker.xml) pelos valores especificados no arquivo de propriedades mychanges.properties:
mqsiapplybaroverride  -b myflow.bar -p mychanges.properties 
Substitua os valores no arquivo BAR myflow.bar pelos valores no arquivo BAR myOriginalBarFile.bar:
mqsiapplybaroverride -b myflow.bar -p myOriginalBarFile.bar
Atualize os descritores de implementação para o aplicativo application1 e suas bibliotecas referenciadas a partir do arquivo BAR myOriginalBarFile.bar:
mqsiapplybaroverride -b myflow.bar -k application1 -p myOriginalBarFile.bar -r
Atualize os descritores de implementação para a biblioteca library1 que está localizada no aplicativo application1:
mqsiapplybaroverride -b myflow.bar -k application1 -y library1 -p myOtherBroker.xml
Atualize o modo de início do aplicativo application1:
mqsiapplybaroverride -b myApp.bar -k application1 -m startMode=automatic -o myAppManual.bar
Substitua o descritor de implementação em c:\test.bar usando os pares chave=valor especificados em c:\my.properties:
mqsiapplybaroverride -b c:\test.bar -p c:\my.properties 
Substitua o descritor de implementação em c:\test.bar usando o descritor de implementação contido em c:\previous.bar:
mqsiapplybaroverride –b c:\test.bar –p c:\previous.bar  
Substitua o descritor de implementação em c:\test.bar usando o descritor de implementação contido em c:\broker.xml:
mqsiapplybaroverride –b c:\test.bar –p c:\broker.xml  
Substitua as propriedades por valores configurados como OLDA e OLDB em c:\test.bar pelos valores NEWA e NEWB:
mqsiapplybaroverride –b c:\test.bar –m OLDA=NEWA,OLDB=NEWB  
Substitua o valor do nome da propriedade sampleFlow#MQInput.queueName para NEWC:
mqsiapplybaroverride –b c:\test.bar –m sampleFlow#MQInput.queueName=NEWC  
Substitua o valor da propriedade sampleFlow#MQInput.queueName para NEWC e quaisquer propriedades com valores configurados anteriormente como OLDA e OLDB para NEWA e NEWB usando um arquivo de propriedades:
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
No exemplo a seguir, o arquivo BAR test.bar contém o arquivo de fluxo de mensagens sampleFlow.msgflow. Este fluxo de mensagens contém o subfluxo sampleSubflow1.subflow e o subfluxo sampleSubflow1.subflow contém o subfluxo sampleSubflow2.subflow. Substitua as seguintes propriedades usando um arquivo de propriedades:
  • No fluxo de mensagens sampleFlow.msgflow, substitua a fila de entrada no nó MQ Input, para NEW_INPUT_QUEUE.
  • No fluxo de mensagens sampleFlow.msgflow, limpe o valor da propriedade promovida queueName que está configurado no nó do subfluxo que representa sampleSubflow1.subflow.
  • No subfluxo sampleSubflow1.subflow, limpe o valor da propriedade promovida de nível de fluxo queueName.
  • Em todos os fluxos e subfluxos de mensagens, substitua qualquer propriedade pelos valores anteriormente configurados para SUBOUT para NEWSUBOUT.
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.

Avisos | Marcas Registradas | Downloads | Biblioteca | Suporte | Feedback

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

        
        Última atualização:
        
        Última atualização: 2015-02-28 18:30:07


Tópico de ReferênciaTópico de Referência | Versão 8.0.0.5 | an19545_