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 para implementar os aplicativos de fluxo de mensagens usando o comando mqsicreatebar e as ferramentas de linha de comandos do repositório.

Sintaxe

Formato do diagrama de sintaxe      Diagrama de trilha      Decimal com pontos

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
(Necessário) O nome do arquivo archive BAR (formato de arquivo compactado) em que o resultado é armazenado. O arquivo BAR é substituído se já existir e o arquivo META-INF/broker.xml é criado.
-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.

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

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

-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'

-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'

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

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.

-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 grava essas informações para que você possa ver se está faltando algum projeto referenciado.

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

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

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ê deve executar esse comando a partir do diretório eclipse. O local padrão do diretório eclipse é C:\Program Files\IBM\WMBT800\eclipse no Windows edições de 32 bits, C:\Program Files (x86)\IBM\WMBT800\eclipse no Windows edições de 64 bits e /opt/IBM/WMBT800/eclipse no Linux em x86.

O exemplo a seguir cria um arquivo BAR denominado myflow.bar no espaço de trabalho em C:\Workspace. O fluxo de mensagens Test.msgflow do TestFlowProject é incluído no arquivo BAR.
mqsicreatebar -data C:\Workspace -b myflow.bar -p TestFlowProject -o TestFlowProject\TestFlow\Test.msgflow
O exemplo a seguir cria um arquivo BAR denominado myflow.bar no espaço de trabalho em C:\Workspace. 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 myflow.bar -p TestFlowProject -o TestFlowProject\TestFlow\Test.msgflow -deployAsSource
O exemplo a seguir cria um arquivo BAR chamado mySet.bar no espaço de trabalho em C:\Workspace. 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 chamado mySet.bar no espaço de trabalho em C:\Workspace. O conjunto de mensagens messageSet.mset do TestSetProject e o fluxo de mensagens Test.msgflow do TestFlowProject são incluídos no arquivo BAR.
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 no espaço de trabalho em C:\Workspace. O aplicativo Application1 é incluído no arquivo BAR. A função de rastreio é ativada.
mqsicreatebar -data C:\Workspace -b myflow.bar -a Application1 -trace
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 | an19540_