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.
Início da mudança-k applicationNameFim da mudança
Início da mudança(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.

Fim da mudança
-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 contendo o descritor de implementação usado para aplicar substituições ao arquivo BAR.
    É possível usar o XML para o arquivo do descritor de implementação. Se você usar um arquivo de propriedade XML gravado no EBCDIC em z/OS, certifique-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.
Início da mudançaSe o arquivo especificado pelo parâmetro -p for um arquivo BAR que contenha aplicativos ou bibliotecas, por padrão, o descritor de implementação do arquivo BAR de origem será aplicado apenas 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.
Fim da mudança
Início da mudança -r Fim da mudança
Início da mudança(Opcional) Especifica que todos os arquivos descritores de implementação são atualizados recursivamente, incluindo aqueles em aplicativos (arquivos .appzip) e bibliotecas (arquivos .libzip) aninhados.

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

Fim da mudança
-v traceFileName
(Opcional) Especifica que o rastreio interno deve ser enviado para o arquivo denominado.
Início da mudança-y libraryNameFim da mudança
Início da mudança(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).

Fim da mudança

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 .cmf (por exemplo, Flow1).
    • NodeName é o nome opcional do nó cuja propriedade foi substituída (por exemplo, InputNode).
    • PropertyName é o nome da propriedade que está sendo 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.
  • Início da mudançaapplicationPropertyName=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.Fim da mudança
Nota: As variáveis e os comentários não são permitidos nos arquivos de propriedades.
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 de usuário usado para executar esse comando deve estar executando 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 platform 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
...

Exemplos

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
Início da mudançaAtualize 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
Fim da mudança
Início da mudançaAtualize 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
Fim da mudança
Início da mudançaAtualize o modo de início do aplicativo application1:
mqsiapplybaroverride -b myApp.bar -k application1 -m startMode=automatic -o myAppManual.bar
Fim da mudança
Substitua o descritor de implementação em c:\test.bar utilizando os pares key=value especificados em c:\my.properties:
mqsiapplybaroverride -b c:\test.bar -p c:\my.properties 
Substitua o descritor de implementação em c:\test.bar utilizando 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 utilizando 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  
Início da mudançaSubstitua 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
Fim da mudança

Para obter um exemplo 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, 2012Copyright IBM Corporation 1999, 2012.

        
        Última atualização
        
        Última atualização : 2012-07-17 10:04:27


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