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 mqsicreatebar

Use o comando mqsicreatebar para criar arquivos bar implementáveis contendo fluxos de mensagens e dicionários.

Plataformas Suportadas

  • Windows
  • Linux em x86

Finalidade

Se você usar um repositório para armazenar seus fluxos de mensagens e dicionários, poderá gravar scripts que usam o comando mqsicreatebar e as ferramentas de linha de comandos do repositório para implementar seus aplicativos de fluxo de mensagens.

Sintaxe

Ler diagrama de sintaxeManter visual do diagrama de sintaxe
>>-mqsicreatebar-- -data--WorkSpace--+--------------+----------->
                                     '- -b -BarName-'   

>--+--------------+--+--------------------------+--------------->
   '- -cleanBuild-'  '- -version -VersionString-'   

>--+----------+--+--------------------------+------------------->
   '- -Esql21-'  |      .-----------------. |   
                 |      V                 | |   
                 '- -p------ProjectName---+-'   

>--+----------------------+--+------------------+--------------->
   '- -a -ApplicationName-'  '- -deployAsSource-'   

>--+---------------+--+------------------+---------------------->
   '- -compileOnly-'  '- -l -LibraryName-'   

>--+----------------------------+--+---------------+------------>
   '- -d -ApplicationDomainName-'  '- -o -FilePath-'   

>--+--------------------+--+-----------------------------+-----><
   '- -skipWSErrorCheck-'  '- -trace - -v -traceFilePath-'   

Parâmetros

-data WorkSpace
(Obrigatório) O caminho do espaço de trabalho onde seus projetos serão criados.

O local do espaço de trabalho também é o local padrão para projetos. Caminhos relativos são interpretados como sendo relativos ao diretório a partir do qual o comando foi iniciado.

-b BarName
(Opcional) O nome do archive BAR (formato de arquivo compactado) no qual o resultado é armazenado. O arquivo BAR é substituído se já existir e o arquivo META-INF/broker.xml é criado.

Este parâmetro será necessário se o parâmetro -compileOnly não for usado.

-cleanBuild
(Opcional) Atualiza os projetos na área de trabalho e, em seguida, chama uma construção limpa antes de novos itens serem incluídos no arquivo BAR.
Use o parâmetro -cleanBuild para atualizar todos os projetos no arquivo BAR e executar uma construção limpa, se tiverem sido feitas correções nos recursos do arquivo BAR usando ferramentas externas.
-version VersionString
(Opcional) Anexa o caractere _ (sublinhado) e o valor de VersionString aos nomes das versões compiladas dos arquivos (.cmf) dos fluxos de mensagens incluídos no arquivo BAR, antes da extensão do arquivo.
-Esql21
(Opcional) Compile ESQL para brokers na Versão 2.1 do produto.
-p ProjectName
(Opcional) Projetos contendo arquivos para incluir no arquivo BAR em uma nova área de trabalho. Uma nova área de trabalho é uma pasta do sistema sem a pasta .metadata.

Os projetos definidos já devem existir na pasta definida no parâmetro -data e devem incluir todos os projetos e seus projetos de referência que um recurso implementável, definido no parâmetro -o, precisa.

O parâmetro -p é opcional com uma área de trabalho existente, mas você deve usar -p, juntamente com uma nova área de trabalho, em um ambiente de construção.

Se um projeto especificado fizer parte do seu espaço de trabalho, mas atualmente estiver fechado, o comando abre e constrói o projeto, para que os arquivos do projeto possam ser incluídos no arquivo BAR.

-a ApplicationName
(Opcional) O nome de um aplicativo a ser incluído no arquivo BAR.

É possível incluir mais de um aplicativo usando o seguinte formato: -a ApplicationName1 ApplicationName2 .... ApplicationName'n'

-deployAsSource
(Opcional) Inclua esse parâmetro para implementar arquivos de recursos aplicáveis sem compilá-los.

Ao usar o comando mqsicreatebar, recursos como arquivos .esql são compilados nos arquivos .cmf do fluxo de mensagens e não são incluídos no arquivo BAR como arquivos de origem individuais. Se este parâmetro for incluído, ele criará ESQL sequencial em vez do ESQL implementável padrão.

Quando o parâmetro -deployAsSource é usado, os recursos aplicáveis são incluídos no arquivo BAR como arquivos de origem e não são compilados nos arquivos .cmf do fluxo de mensagens.

Não é possível incluir as versões compilada (.cmf) e de origem (.msgflow) de um fluxo de mensagens em um arquivo BAR.

-compileOnly
(Opcional) Inclua esse parâmetro para compilar conjuntos de mensagens e código Java™ antes de executar o comando mqsipackagebar. Todos os arquivos relevantes na área de trabalho que foi especificada pelo parâmetro -data estão compilados. Para obter informações adicionais sobre o comando mqsipackagebar, consulte Comando mqsipackagebar.

Se este parâmetro for especificado com o parâmetro -b e um ou mais dos parâmetros -a, -l, -d ou -o, o comando gerará os recursos compilados e o arquivo BAR especificado.

-l LibraryName
(Opcional) O nome de uma biblioteca a ser incluída no arquivo BAR.

É possível incluir mais de uma biblioteca usando o seguinte formato: -l LibraryName1 LibraryName2 .... LibraryName'n'

-d ApplicationDomainName
(Opcional) O nome de um domínio de aplicativo .NET a ser incluído no arquivo BAR.

É possível incluir mais de um domínio de aplicativo usando o formato a seguir: -d ApplicationDomainName1 ApplicationDomainName2 .... ApplicationDomainName1'n'

-o FilePath
(Opcional) O caminho relativo da área de trabalho (incluindo o projeto) de um arquivo implementável a ser incluído no arquivo BAR; por exemplo, um arquivo msgflow, subflow ou messageSet.mset.

É possível incluir mais de um arquivo implementável nesse comando utilizando o seguinte formato: -o FilePath1 FilePath2 .... FilePath'n'

-skipWSErrorCheck
(Opcional) Esse parâmetro força a execução do processo de compilação do arquivo BAR, mesmo que existam erros na área de trabalho.
-trace
(Opcional) Esse parâmetro exibe informações de rastreio para compilação do arquivo BAR.

O parâmetro -trace grava informações de rastreio no fluxo de saída do sistema, no idioma especificado no código de idioma do sistema. Ao incluir um ou mais aplicativos ou bibliotecas no arquivo BAR, o aplicativo ou a biblioteca especificada e todos os projetos referenciados são abertos na área de trabalho. A função de rastreio registra estas informações para que você possa ver se qualquer projeto referido está ausente.

-v traceFilePath
(Opcional) Esse parâmetro especifica o nome de arquivo do log de saída para o qual as informações de rastreio são enviadas.

Se você especificar o nome do arquivo ou o caminho relativo, o arquivo será criado no diretório ativo padrão. Para usar esse parâmetro, você também deve configurar o parâmetro -trace. Não é possível especificar o parâmetro -v sozinho.

Autorização

Nos sistemas Windows XP e Windows Server 2003, o ID do usuário utilizado para executar este comando deve ser membro do grupo Administrators no sistema local.

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.

No Linux em x86, o ID do usuário deve ter acesso de gravação para os diretórios -data (espaço de trabalho) e -b (local do arquivo BAR).

Respostas

Esse comando retorna as seguintes respostas:
  • BIP0956 Impossível iniciar mqsicreatebar
  • BIP0957 Argumentos incorretos fornecidos para mqsicreatebar
  • BIP0958 Nada a fazer em mqsicreatebar
  • BIP0959 Argumentos incorretos fornecidos para mqsicreatebar (Nome do projeto)
  • BIP0960 Argumentos incorretos fornecidos para mqsicreatebar (Diretório do projeto)
  • BIP0961 Erro ao abrir o espaço de trabalho em mqsicreatebar (O projeto não pôde ser criado)
  • BIP0962 Erro ao abrir o espaço de trabalho em mqsicreatebar (O projeto não pôde ser aberto)
  • BIP0963 Erro ao salvar arquivo em mqsicreatebar
  • BIP0964 Argumento "-o" incorreto fornecido para mqsicreatebar
  • BIP0965 Erro ao compilar arquivos em mqsicreatebar

Exemplos

Você pode executar o comando mqsicreatebar a partir de uma janela aberta em qualquer local na estrutura de arquivos, contanto que a variável de ambiente PATH especifique o caminho correto para o diretório WMB toolkit.
  • Nas edições do Windows de 32 bits, o local padrão do diretório WMB toolkit é C:\Program Files\IBM\WMBT800
  • Nas edições do Windows de 64 bits, o padrão é C:\Program Files (x86)\IBM\WMBT800 e
  • No Linux em x86, o padrão é /opt/IBM/WMBT800.
Sua instalação pode ser diferente do padrão.

O parâmetro -b especifica o nome do arquivo BAR e um caminho alternativo opcional para a geração do arquivo BAR. Quando um caminho não estiver especificado como parte do parâmetro -b, o local na estrutura de arquivos em que o comando mqsicreatebar é executado especifica onde o arquivo BAR é criado. Por exemplo, se você estiver atualmente em C:\> e executar o comando mqsicreatebar, o arquivo BAR será criado em C:\. Entretanto, se você executar o mqsicreatebar com -b c:\myfiles\myflow.bar especificado, o arquivo BAR será criado no diretório myfiles.

O exemplo a seguir cria um arquivo BAR denominado myflow.bar no diretório no qual o comando é emitido. O fluxo de mensagens Test.msgflow a partir de TestFlowProject é incluído no arquivo BAR como um arquivo de fluxo de mensagens compilado (.cmf).
mqsicreatebar -data C:\Workspace -b myflow.bar -p TestFlowProject -o TestFlowProject\TestFlow\Test.msgflow
O exemplo a seguir cria um arquivo BAR chamado myflow.bar no diretório myfiles. O fluxo de mensagens Test.msgflow do TestFlowProject é incluído no arquivo BAR e os arquivos de recursos aplicáveis são incluídos no arquivo BAR sem ser compilado.
mqsicreatebar -data C:\Workspace -b C:\myfiles\myflow.bar -p TestFlowProject -o TestFlowProject\TestFlow\Test.msgflow -deployAsSource
O exemplo a seguir cria um arquivo BAR denominado mySet.bar. O conjunto de mensagens messageSet.mset do TestSetProject é incluído no arquivo BAR.
mqsicreatebar -data C:\Workspace -b mySet.bar -o TestSetProject\TestSet\messageSet.mset
O exemplo a seguir cria um arquivo BAR denominado mySet.bar. O conjunto de mensagens messageSet.mset do TestSetProject e o fluxo de mensagens Test.msgflow do TestFlowProject são incluídos no arquivo BAR. O fluxo de mensagens é incluído como um arquivo de fluxo de mensagens compilado (.cmf).
mqsicreatebar -data C:\Workspace -b mySet.bar -o TestFlowProject\TestFlow\Test.msgflow
TestSetProject\TestSet\messageSet.mset 
O exemplo a seguir cria um arquivo BAR denominado myflow.bar. O aplicativo Application1 é incluído no arquivo BAR e a função de rastreio é ativada.
mqsicreatebar -data C:\Workspace -b myflow.bar -a Application1 -trace
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 | an19540_