WebSphere Message Broker バージョン 8.0.0.5 オペレーティング・システム: AIX、HP-Itanium、Linux、Solaris、Windows、z/OS

製品の最新バージョンについては、IBM Integration Bus バージョン 9.0 をご覧ください。

mqsipackagebar コマンド

mqsipackagebar コマンドを使用して、デプロイ可能なブローカー・アーカイブ (BAR) ファイルを作成します。 このコマンドを使用すると、WebSphere® Message Broker Toolkit がインストールされていないマシン上に BAR ファイルを作成できます。

サポートされるプラットフォーム

  • Windows
  • Linux および UNIX システム
  • z/OS®. BIPPACK をカスタマイズおよび発行して、このコマンドを実行します。ブローカー PDSE の内容を参照してください。
WebSphere Message Broker がインストールされていないマシンで mqsipackagebar コマンドを実行できるように、ご使用の環境を構成するには、ブローカー・コンポーネントがインストールされていない環境の構成を参照してください。

目的

メッセージ・フローやディクショナリーを保管するためにリポジトリーを使用する場合、mqsipackagebar コマンドおよびリポジトリーで使用可能なコマンド行ツールを使用するスクリプトを作成して、メッセージ・フロー・アプリケーションをデプロイできます。

mqsipackagebar コマンドを使用して BAR ファイルに追加するリソースは、追加時にコンパイルされません。 このコマンドを使用して作成する BAR ファイルをデプロイするには、デプロイ可能なリソースを BAR ファイルに追加する必要があります。 例えば、Java™ コードまたはメッセージ・セットを BAR ファイルに組み込むには、まずこれらのファイルをコンパイルしてから、mqsipackagebar コマンドを使用して BAR ファイルに追加する必要があります。 これらのリソースをコンパイルするには、mqsipackagebar コマンドのためのリソースのコンパイルを参照してください。 BAR ファイルには、メッセージ・フローのコンパイル済みバージョン (.cmf) とソース・バージョン (.msgflow) の両方を組み込むことはできません。

BAR ファイルに組み込むリソースの名前には、次の文字を使用しないでください。
  • (スペース) ! ( ) + - : ; < = > ? [ ] ’ } {

構文

構文図を読む構文図をスキップする
>>-mqsipackagebar-- -a --BarName--+--------------------+-------->
                                  '- -w --RootLocation-'   

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

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

パラメーター

-a BarName

(必須) 結果が保管される BAR (圧縮ファイル形式) アーカイブ・ファイルの名前。 BAR がすでに存在する場合、ファイルは置き換えられ、 META-INF/broker.xml ファイルが作成されます。

-w RootLocation
(オプション) BAR ファイルに組み込むプロジェクトのデフォルトの場所。 相対パスは、RootLocation に対して相対であると解釈されます。 RootLocation を定義していない場合、相対パスはコマンドが開始されたディレクトリーに対して相対であると解釈されます。

-o FilePath
(オプション) BAR ファイルに追加する .msgflow.subflowまたは messageSet.dictionary ファイルなどのデプロイ可能なファイルのパス (プロジェクトを含む)。 相対パスは、RootLocation に対して定義したパスに相対であると解釈されます。 RootLocation を定義していない場合、相対パスはコマンドが開始されたディレクトリーに対して相対であると解釈されます。

一緒に使用する場合、-o オプションでデプロイ可能なファイルへのパスを指定し、-w オプションでプロジェクト・ディレクトリーへのパスを指定します。 例えば、mqsipackagebar -w c:/MyProject -a MyBar.bar -o Flow/a.msgflow Subflow/b.subflow と指定すると、RootLocation はディレクトリー MyProject になり、FilePath は Flow ディレクトリーと Subflow ディレクトリーにあるデプロイ可能ファイル ab に指定されます。

次の形式を使用すると、このコマンドに複数のデプロイ可能なファイルを追加できます。 -o FilePath1 FilePath2 .... FilePath'n'

デフォルトでは、次の拡張子を持つファイルのみが、BAR ファイルに組み込まれます。.xsdzip.tblxmi.xsd.wsdl.dictionary.xsl.xslt.xml.jar.inadapter.outadapter.insca.outsca.descriptor.php.idl.map.esql.msgflow、 および .subflow-i オプションを指定すると、任意の拡張子のファイルを組み込むことができます。

-k ApplicationName
(オプション) BAR ファイルに追加するアプリケーションの名前。

次の形式を使用すると、複数のアプリケーションを追加できます。-k ApplicationName1 ApplicationName2 .... ApplicationName'n'

デフォルトでは、次の拡張子を持つファイルのみが、BAR ファイルに組み込まれます。.xsdzip.tblxmi.xsd.wsdl.dictionary.xsl.xslt.xml.jar.inadapter.outadapter.insca.outsca.descriptor.php.idl.map.esql.msgflow、 および .subflow-i オプションを指定すると、任意の拡張子のファイルを組み込むことができます。

-y LibraryName
(オプション) BAR ファイルに追加するライブラリーの名前。

次の形式を使用すると、複数のライブラリーを追加できます。 -y LibraryName1 LibraryName2 .... LibraryName'n'

デフォルトでは、次の拡張子を持つファイルのみが、BAR ファイルに組み込まれます。.xsdzip.tblxmi.xsd.wsdl.dictionary.xsl.xslt.xml.jar.inadapter.outadapter.insca.outsca.descriptor.php.idl.map.esql.msgflow、 および .subflow-i オプションを指定すると、任意の拡張子のファイルを組み込むことができます。

-n ApplicationDomainName
(オプション) BAR ファイルに追加する .NET アプリケーション・ドメインの名前。

次の形式を使用すると、複数のアプリケーション・ドメインを追加できます。-n ApplicationDomainName1 ApplicationDomainName2 .... ApplicationDomainName'n'

指定したアプリケーション・ドメインに含まれるすべてのファイルが、BAR ファイルに組み込まれます。

-u
(オプション) 既存の BAR ファイル内のリソースを更新するには、このオプションを組み込みます。

-o-k-y、および -n オプションを使用して、更新するリソースを指定します。 BAR ファイルが存在しない場合は、新規ファイルが作成されます。

-d
(オプション) 既存の BAR ファイルからリソースを削除するには、このオプションを組み込みます。

-o-k-y、および -n オプションを使用して、削除するリソースを指定します。

-i
(オプション) BAR ファイルにデプロイ可能リソースとデプロイ不能リソースを追加するには、このオプションを組み込みます。

このオプションを使用すると、-o-k-y、および -n のオプションで指定されたすべてのファイルが BAR ファイルに組み込まれます。 このオプションを使用しない場合、指定された場所にあるデプロイ可能なファイルのみが BAR ファイルに追加されます。

-v traceFilePath
(オプション) このパラメーターは、トレース情報の送信先となる出力ログのファイル名を指定します。

ファイル名または相対パスを指定すると、ファイルはデフォルトの作業ディレクトリーに作成されます。

許可

プラットフォーム固有の許可について詳しくは、以下のトピックを参照してください。 ブローカー管理セキュリティーを有効に設定した場合は、管理セキュリティーのタスクと権限で説明されている権限もセットアップする必要があります。

応答

このコマンドは、以下の応答を戻します。
  • BIP1838I ソースからブローカー・アーカイブ・ファイルをパッケージしてください。
  • BIP1839S 'Option' が指定されていません。
  • BIP1840S BAR ファイルに追加する有効なリソースがありません。 rootLocation が正しいことを確認し、-k、-y、-n、または -o オプションを 1 つ以上使用して、少なくとも 1 つのリソースを指定してください。
  • BIP1841S 'traceFilePath' は有効な traceFilePath ではありません。
  • BIP1842S トレース・ファイル 'traceFilePath' を開くことができません。 エラー: 'error'。
  • BIP1843S トレース・ファイル 'traceFilePath' は読み取り専用です。
  • BIP1844S 引数の終わりに予期せずに達しました。
  • BIP1845I コマンドは正常に完了しました。
  • BIP1846S 更新オプション (-u) と削除オプション (-d) を同時に使用することはできません。
  • BIP1847S ブローカー・アーカイブ・ファイル 'BAR_file' が存在しません。
  • BIP1848S 'Message_flow_file' ファイルに非サポートのノードが含まれています: 'Node_name'。
  • BIP1849W アプリケーション 'Application' が参照しているプロジェクト 'Library' は、存在しません。
  • BIP1862W 無効なまたは欠落したリソース 'Resource' は無視されます。
  • BIP1863W コマンドが警告を出して完了しました。
  • BIP1864W 生成されたブローカー・アーカイブ・ファイルには、Message Broker のデプロイ可能ファイルが含まれていません。
  • BIP1865W 'Container_resource' は、デプロイ可能リソースが含まれていないため、BAR ファイルに追加されません。 Java コードまたはメッセージ・セットのデプロイ可能リソースを作成するには、mqsicreatebar -compileOnly コマンドを使用してください。
  • BIP1866W 参照されたプロジェクト 'Referenced_project' には、デプロイ可能リソースが含まれていません。 Java コードまたはメッセージ・セットのデプロイ可能リソースを作成するには、mqsicreatebar -compileOnly コマンドを使用してください。
  • BIP1867W このフローがコンパイル済み (.cmf) ファイルとして BAR ファイルに既に存在するため、'Message_flow_file' を BAR ファイルに追加できません。 -d オプションを使用して BAR ファイルから 'Compiled_message_flow_file' を削除し、再度試行してください。
  • BIP1868W: アプリケーション 'Application' にある 'Resource_name' を無視しています。 このアプリケーションを含めるには -k オプションを使用してください。
  • BIP1869W: ライブラリー 'Library' にある 'Resource_name' を無視しています。 ライブラリーを含めるには -y オプションを使用してください。
  • BIP1870W: .NET アプリケーション・ドメイン・プロジェクト 'Application_domain' にある 'Resource_name' を無視しています。 アプリケーション・ドメイン・プロジェクトを含めるには -n オプションを使用してください。

以下の例は、C:¥Workspace のワークスペースに、myflow.bar という BAR ファイルを作成します。 Test.msgflow メッセージ・フローが、コンパイルされずに BAR ファイルに追加されます。
mqsipackagebar -w C:\Workspace -a myflow.bar -o TestFlowProject\TestFlow\Test.msgflow
以下の例は、C:¥Workspace のワークスペースに、myflow.bar という BAR ファイルを作成します。 アプリケーション Application1 が BAR ファイルに追加されます。 トレース機能がオンになり、トレース情報が tracefile ファイルに書き込まれます。
mqsipackagebar -w C:\Workspace -a myflow.bar -k Application1 -v tracefile
ビルド・マシンに BAR ファイルを作成する場合などには、Ant スクリプトから mqsipackagebar を実行できます。 以下の例で、MQSI_JARPATH は、ConfigManagerProxy およびブローカーに依存する .jar ファイルの場所です。
<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>
特記事項 | 商標 | ダウンロード | ライブラリー | サポート | フィードバック

Copyright IBM Corporation 1999, 2014Copyright IBM Corporation 1999, 2014.

        
        最終更新:
        
        最終更新: 2015-02-28 17:48:45


参照トピック参照トピック | バージョン 8.0.0.5 | bc31720_