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, será possível gravar scripts que usam o comando mqsicreatebar e as ferramentas de linha de comandos do repositório para implementar seus aplicativos de fluxo de mensagem.

Sintaxe

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

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

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

        .--------------.   
        V              |   
>-- -o -----FilePath---+---------------------------------------><

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
(Obrigatório) O nome do arquivo 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
(Necessário) 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 arquivomsgflow ou messageSet.mset.

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

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, Windows Vista, 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

É possível executar o comando mqsicreatebar a partir de uma janela aberta em qualquer lugar 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\WMBT700
  • Nas edições do Windows de 64 bits, o padrão é C:\Program Files (x86)\IBM\WMBT700 e
  • No Linux em x86, o padrão é /opt/IBM/WMBT700.
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 do TestFlowProject é incluído no arquivo BAR como um arquivo (.cmf) de fluxo de mensagens compiladas.
mqsicreatebar -data C:\Workspace -b myflow.bar -p TestFlowProject -o TestFlowProject\TestFlow\Test.msgflow
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 (.cmf) de fluxo de mensagens compiladas.
mqsicreatebar -data C:\Workspace -b mySet.bar -o TestFlowProject\TestFlow\Test.msgflow
TestSetProject\TestSet\messageSet.mset 
Avisos | Marcas Registradas | Downloads | Biblioteca | Suporte | Feedback

Copyright IBM Corporation 1999, 2012Copyright IBM Corporation 1999, 2012.

        
        Última atualização
        
        Última atualização : 2012-08-02 07:48:52


Tópico de ReferênciaTópico de Referência | Versão 7.0.0.5 | an19540_