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

Formato do diagrama de sintaxe      Diagrama de trilha      Decimal com pontos

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

-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.
-p overridesFile
(Opcional) O caminho para um dos seguintes recursos:
  • Um BAR contendo o descritor de implementação 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 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.

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.

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

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.
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
Atualize os descritores de implementação de application1 e suas bibliotecas referenciadas a partir do arquivo BAR myOriginalBarFile.bar:
mqsiapplybaroverride -b myflow.bar -k application1 -p myOriginalBarFile.bar
Atualize os descritores de implementação de application1 e library1:
mqsiapplybaroverride -b myflow.bar -k application1 -y library1 -p myOtherBroker.xml
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  

Para obter um exemplo dos detalhes que estão contidos em um arquivo de propriedades, consulte Editando Propriedades Configuráveis.

Avisos | Marcas | Este link é aberto em uma nova janela Downloads | Este link é aberto em uma nova janela Biblioteca | Este link é aberto em uma nova janela Suporte | Feedback

Copyright IBM Corporation 1999, 2011Copyright IBM Corporation 1999, 2011.

        
        Última atualização
        
        Última atualização : 2011-11-09 14:39:51


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