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 mqsipackagebar

Use o comando mqsipackagebar para criar arquivos broker archive (BAR) implementáveis. Você pode usar este comando para criar arquivos BAR nas máquinas que não possuem o WebSphere Message Broker Toolkit instalado.

Plataformas Suportadas

Para configurar seu ambiente para que seja possível executar o comando mqsipackagebar em máquinas que não possuem o WebSphere Message Broker instalado, consulte Configurando Ambientes sem o componente Broker Instalado.

Propósito

Se você usar um repositório para armazenar seus fluxos de mensagens e dicionários, poderá gravar scripts que usam o comando mqsipackagebar e as ferramentas de linha de comandos que estão disponíveis no repositório para implementar seus aplicativos de fluxo de mensagens.

Os recursos que você inclui em um arquivo BAR usando o comando mqsipackagebar não são compilados quando eles são incluídos. Para implementar um arquivo BAR criado usando esse comando, você deve incluir recursos implementáveis no arquivo BAR. Por exemplo, se desejar incluir código ou conjuntos de mensagens Java™ em seu arquivo BAR, você deverá primeiro compilar esses arquivos antes de usar o comando mqsipackagebar para incluí-los em seu arquivo BAR. Para compilar esses recursos, consulte Compilando Recursos para o Comando mqsipackagebar. Não é possível incluir as versões compilada (.cmf) e de origem (.msgflow) de um fluxo de mensagens em um arquivo BAR.

Não use os seguintes caracteres nos nomes de recursos que deseja incluir em seu arquivo BAR:
  • (espaço) ! ( ) + - : ; < = > ? [ ] ’ } {

Sintaxe

Ler diagrama de sintaxeManter visual do diagrama de sintaxe
>>-mqsipackagebar-- -a --BarName--+--------------------+-------->
                                  '- -w --RootLocation-'   

   .---------------------------------------------.             
   |           .--------------.                  |             
   V           V              |                  |             
>------+- -o ------FilePath---+--------------+---+--+------+---->
       |       .---------------------.       |      +- -u -+   
       |       V                     |       |      '- -d -'   
       +- -k ------ApplicationName---+-------+                 
       |       .-----------------.           |                 
       |       V                 |           |                 
       +- -y ------LibraryName---+-----------+                 
       |       .---------------------------. |                 
       |       V                           | |                 
       '- -n ------ApplicationDomainName---+-'                 

>--+------+--+---------------------+---------------------------><
   '- -i -'  '- -v --traceFilePath-'   

Parâmetros

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

-w RootLocation
(Opcional) O local padrão para projetos que você deseja incluir em seu arquivo BAR. Caminhos relativos são interpretados como sendo relativos ao RootLocation. Se você não definir RootLocation, os caminhos relativos serão interpretados como sendo relativos ao diretório a partir do qual o comando foi iniciado.

-o FilePath
(Opcional) O caminho (incluindo o projeto) de um arquivo implementável a ser incluído no arquivo BAR; por exemplo, arquivos .msgflow, .subflow ou messageSet.dictionary. Caminhos relativos são interpretados como sendo relativos ao caminho que você definiu para RootLocation. Se você não definir RootLocation, os caminhos relativos serão interpretados como sendo relativos ao diretório a partir do qual o comando foi iniciado.

Usadas juntas, a opção -o especifica o caminho para arquivos implementáveis e a opção -w especifica o caminho para o diretório do projeto. Por exemplo, mqsipackagebar -w c:/MyProject -a MyBar.bar -o Flow/a.msgflow Subflow/b.subflow especifica um RootLocation do diretório MyProject com o FilePath que especifica os arquivos implementáveis a e b nos diretórios Flow e Subflow.

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

Por padrão, apenas os arquivos com as extensões a seguir são incluídos no arquivo BAR: .xsdzip, .tblxmi, .xsd, .wsdl, .dictionary, .xsl, .xslt, .xml, .jar, .inadapter, .outadapter, .insca, .outsca, .descriptor, .php, .idl, .map, .esql, .msgflow e .subflow. É possível especificar a opção -i para incluir arquivos com qualquer extensão.

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

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

Por padrão, apenas os arquivos com as extensões a seguir são incluídos no arquivo BAR: .xsdzip, .tblxmi, .xsd, .wsdl, .dictionary, .xsl, .xslt, .xml, .jar, .inadapter, .outadapter, .insca, .outsca, .descriptor, .php, .idl, .map, .esql, .msgflow e .subflow. É possível especificar a opção -i para incluir arquivos com qualquer extensão.

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

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

Por padrão, apenas os arquivos com as extensões a seguir são incluídos no arquivo BAR: .xsdzip, .tblxmi, .xsd, .wsdl, .dictionary, .xsl, .xslt, .xml, .jar, .inadapter, .outadapter, .insca, .outsca, .descriptor, .php, .idl, .map, .esql, .msgflow e .subflow. É possível especificar a opção -i para incluir arquivos com qualquer extensão.

-n 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: -n ApplicationDomainName1 ApplicationDomainName2 .... ApplicationDomainName'n'

Todos os arquivos no domínio de aplicativo especificado são incluídos no arquivo BAR.

-u
(Opcional) Inclua esta opção para atualizar os recursos em um arquivo BAR existente.

Especifique os recursos que você deseja atualizar usando as opções -o, -k, -y e -n. Se o arquivo BAR não existir, um novo arquivo será criado.

-d
(Opcional) Inclua esta opção para excluir os recursos de um arquivo BAR existente.

Especifique os recursos que você deseja excluir usando as opções -o, -k, -y e -n.

-i
(Opcional) Inclua essa opção para incluir recursos implementáveis e não implementáveis em seu arquivo BAR.

Se você usar essa opção, todos os arquivos especificados pelas opções -o, -k, -y e -n serão incluídos em seu arquivo BAR. Se você não usar essa opção, apenas os arquivos implementáveis nos locais especificados serão incluídos no arquivo BAR.

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

Autorização

Para obter informações sobre autorizações específicas da plataforma, consulte os tópicos a seguir: Se você tiver ativado a segurança de administração do broker, também deverá configurar a autoridade detalhada em Tarefas e Autorizações para Segurança de Administração.

Respostas

Esse comando retorna as seguintes respostas:
  • BIP1838I Empacote um arquivo bar a partir da origem.
  • BIP1839S 'Option' não especificada.
  • BIP1840S Nenhum recurso válido localizado a ser incluído no arquivo BAR. Verifique se rootLocation está correto e especifique pelo menos um recurso usando uma ou mais das opções -k, -y, -n ou -o.
  • BIP1841S 'traceFilePath' não é um traceFilePath válido.
  • BIP1842S Não é possível abrir o arquivo de rastreio 'traceFilePath'. Erro: 'error'.
  • BIP1843S O arquivo de rastreio 'traceFilePath' é somente leitura.
  • BIP1844S Fim inesperado de argumento atingido.
  • BIP1845I Comando concluído com êxito.
  • BIP1846S A opção de atualização (-u) e a opção de exclusão (-d) não podem ser usadas simultaneamente.
  • BIP1847S O arquivo bar 'BAR_file' não existe.
  • BIP1848S O arquivo 'Message_flow_file' contém um modo não suportado: 'Node_name'.
  • BIP1849W O aplicativo 'Application' faz referência ao projeto 'Library' que não existe.
  • BIP1862W Ignorando recurso inválido ou ausente: 'Resource'
  • BIP1863W Comando concluído com avisos.
  • BIP1864W O arquivo bar gerado não contém nenhum arquivo implementável do Message Broker.
  • BIP1865W 'Container_resource' não é incluído no arquivo BAR, pois ele não contém recursos implementáveis. Para criar recursos implementáveis para código Java ou conjuntos de mensagens, use o comando mqsicreatebar -compileOnly.
  • BIP1866W O projeto referido 'Referenced_project' não contém recursos implementáveis. Para criar recursos implementáveis para código Java ou conjuntos de mensagens, use o comando mqsicreatebar -compileOnly.
  • BIP1867W Não é possível incluir 'Message_flow_file' no arquivo BAR, porque esse fluxo já está no arquivo BAR como um arquivo compilado (.cmf). Exclua 'Compiled_message_flow_file' do arquivo BAR usando a opção -d e tente novamente.
  • BIP1868W: Ignorando 'Resource_name', que está no aplicativo 'Application'. Use a opção -k para incluir o aplicativo.
  • BIP1869W: Ignorando 'Resource_name', que está na biblioteca 'Library'. Use a opção -y para incluir a biblioteca.
  • BIP1870W: Ignorando 'Resource_name', que está no projeto de domínio do aplicativo .NET 'Application_domain'. Use a opção -n para incluir o projeto de domínio de aplicativo.

Exemplos

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 é incluído no arquivo BAR sem ser compilado.
mqsipackagebar -w C:\Workspace -a myflow.bar -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 aplicativo Application1 é incluído no arquivo BAR. A função de rastreio é ativada e as informações de rastreio são gravadas no arquivo tracefile.
mqsipackagebar -w C:\Workspace -a myflow.bar -k Application1 -v tracefile
É possível executar mqsipackagebar a partir de um script Ant, por exemplo, se você desejar criar arquivos BAR em uma máquina de construção. No seguinte exemplo, MQSI_JARPATH é o local dos seus arquivos ConfigManagerProxy e .jar dependentes do Broker:
<target name="run_mqsipackagebar" description="--> runs mqsipackagbar from an ant task">
   <java classname="com.ibm.broker.config.appdev.FlowRendererBAR"
      failonerror="true"
      fork="true">
         <arg line="-a MyBAR.bar"/>
         <arg line="-k MyApplication"/>
         <classpath>
            <fileset dir="${MQSI_JARPATH}">
                <include name="*.jar"/>
            </fileset>
         </classpath>
   </java>
</target>
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:31:01


Tópico de ReferênciaTópico de Referência | Versão 8.0.0.5 | bc31720_