変更の始まり

mqsipackagebar コマンド

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

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

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

目的

mqsipackagebar コマンドを使用すると、WebSphere Message Broker がインストールされていないマシン上に BAR ファイルを作成できます。また、メッセージ・フローとディクショナリーを保管するためにリポジトリーを使用する場合、mqsipackagebar コマンド、およびリポジトリーで使用できるコマンド行ツールを使用して、メッセージ・フロー・アプリケーションをデプロイするスクリプトを記述できます。

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

構文

構文図を読む構文図をスキップする
>>-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 FilePath1 FilePath2 .... FilePath'n'

デフォルトでは、次の拡張子を持つファイルのみが、BAR ファイルに組み込まれます。.xsdzip、.tblxmi、.xsd、.wsdl、.dictionary、.xsl、.xslt、.xml、.jar、.inadapter、.outadapter、.insca、.outsca、.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、.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、.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
(オプション) このパラメーターは、トレース情報の送信先となる出力ログのファイル名を指定します。

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

許可

Windows XP および Windows Server 2003 システムでは、このコマンドを実行するユーザー ID は、ローカル・システムの管理者グループのメンバーでなければなりません。

Windows 7および Windows Server 2008 システムでは、このコマンドを実行するためのユーザー ID は、以下のようにローカル・システム上で高位の特権が付与されて実行される必要があります。
  • ユーザー ID は、管理者グループのメンバーでなければなりません。
  • このコマンドは、「管理者として実行」権限がある環境から開始する必要があります。

特権が付与された環境からコマンドを実行しないと、継続するかどうかの確認が表示されます。「OK」をクリックすると、新しく特権を付与されたコマンド・コンソールが作成されてコマンドが完了しますが、この特権が付与された環境にすべての応答が書き込まれ、コマンドが完了してコンソールが閉じるとすべての応答は失われます。

Linux (x86) では、ユーザー ID に、-w (ルートの場所)、-a (BAR ファイルの場所)、および -v (トレース・ファイルの場所) のディレクトリーへの書き込み権限がなければなりません。

応答

このコマンドは、以下の応答を戻します。
  • 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' を削除し、再度試行してください。

例

以下の例は、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, 2012Copyright IBM Corporation 1999, 2012.

        
最終更新

        最終更新 : 2012-07-13 15:45:04


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


変更の終わり