mqsicreatebar コマンド

mqsicreatebar コマンドを使用して、メッセージ・フローとディクショナリーを含むデプロイ可能なブローカー・アーカイブ (BAR) ファイルを作成します。

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

  • Windows
  • Linux(x86)

目的

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

構文

構文図の形式      線路図      ドット 10 進数図

パラメーター

-data WorkSpace
(必須) プロジェクトを作成するワークスペースのパス。

ワークスペースの位置は、プロジェクトのデフォルトの位置でもあります。 相対パスは、コマンドが開始されたディレクトリーに対して相対であると解釈されます。

-b BarName
(必須) 結果が保管される BAR (圧縮ファイル形式) アーカイブ・ファイルの名前。 BAR がすでに存在する場合、ファイルは置き換えられ、 META-INF/broker.xml ファイルが作成されます。
-cleanBuild
(オプション) BAR ファイルに新しい項目を追加する前に、ワークスペース中のプロジェクトをリフレッシュしてから、クリーン・ビルドを呼び出します。
外部ツールを使用して BAR ファイル・リソースに対して改訂を行った場合には、-cleanBuild パラメーターを使用して BAR ファイル内のすべてのプロジェクトをリフレッシュし、クリーン・ビルドを実行します。
-version VersionString
(オプション) bar ファイルに追加するメッセージ・フロー (.cmf) ファイルのコンパイルされた バージョンの名前のファイル拡張子の前に _ (下線) 文字と VersionString の値を付加します。
-Esql21
(オプション) ブローカー用の ESQL を製品のバージョン 2.1 でコンパイルします。
-p ProjectName
(オプション) 新しいワークスペース内の BAR ファイルに含めるファイルが入っているプロジェクト。 新しいワークスペースは、.metadata フォルダーのないシステム・フォルダーです。

定義されたプロジェクトは、-data パラメーターで定義されたフォルダーに既に存在する必要があり、-o パラメーターで定義されたデプロイ可能リソースが必要とするプロジェクトおよびその参照プロジェクトをすべて含む必要があります。

-p パラメーターは、既存のワークスペースではオプションですが、 ビルド環境で新規のワークスペースとともに -p を使用する必要があります。

指定したプロジェクトがワークスペースの一部であっても、現在クローズされている場合、このコマンドはプロジェクトをオープンして構築するため、プロジェクト内のファイルを BAR ファイルに含めることができるようになります。

-o FilePath
(オプション) BAR ファイルに追加する msgflow または messageSet.mset ファイルのワークスペース相対パス (プロジェクトを含む)。

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

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

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

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

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

-deployAsSource
(オプション) コンパイルしないでも適用可能なリソース・ファイルをデプロイする場合に、このパラメーターを含めます。

mqsicreatebar コマンドを使用する場合には、.esql ファイルなどのリソースがメッセージ・フロー .cmf ファイルにコンパイルされます。個別のソース・ファイルとして BAR ファイルに追加されることはありません。

-deployAsSource パラメーターを使用すると、適用可能なリソースが BAR ファイルにソース・ファイルとして追加されます。メッセージ・フローの .cmf ファイルにコンパイルされることはありません。

-trace
(オプション) このパラメーターは、BAR ファイルのコンパイルのトレース情報を表示します。

-trace パラメーターは、システムのロケールで指定された言語で、トレース情報をシステム出力ストリームに書き込みます。1 つ以上のアプリケーションまたはライブラリーを BAR ファイルに追加すると、指定されたアプリケーションまたはライブラリー、および参照されるプロジェクトがすべてワークスペースで開かれます。トレース機能は、参照されるプロジェクトのいずれかが欠落しているかどうかが分かるように、この情報を記録します。

-skipWSErrorCheck
(オプション) このパラメーターは、ワークスペース内にエラーがあっても、BAR ファイルのコンパイル・プロセスの実行を強制します。

許可

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

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

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

Linux(x86) では、ユーザー ID に -data (ワークスペース) と -b (BAR ファイルの場所) ディレクトリーへの書き込み権限がなければなりません。

応答

このコマンドは、以下の応答を戻します。
  • BIP0956 mqsicreatebar を開始できません
  • BIP0957 mqsicreatebar に指定されている引数が正しくありません
  • BIP0958 mqsicreatebar の実行内容が指定されていません
  • BIP0959 mqsicreatebar (プロジェクト名) に指定されている引数が正しくありません
  • BIP0960 mqsicreatebar (プロジェクト・ディレクトリー) に指定されている引数が正しくありません
  • BIP0961 mqsicreatebar でワークスペースをオープンするときにエラーが発生しました (プロジェクトを作成できませんでした)
  • BIP0962 mqsicreatebar でワークスペースをオープンするときにエラーが発生しました (プロジェクトをオープンできませんでした)
  • BIP0963 mqsicreatebar でファイルを保管するときにエラーが発生しました
  • BIP0964 mqsicreatebar に指定されている "-o" 引数が正しくありません
  • BIP0965 mqsicreatebar でファイルをコンパイルするときにエラーが発生しました

例

このコマンドは、eclipse ディレクトリーから実行しなければなりません。eclipse ディレクトリーのデフォルト場所は、C:¥Program Files¥IBM¥WMBT800¥eclipse (Windows 32 ビット版の場合)、C:¥Program Files (x86)¥IBM¥WMBT800¥eclipse (Windows 64 ビット版の場合)、および /opt/IBM/WMBT800/eclipse (Linux(x86) の場合) です。

以下の例は、C:¥Workspace のワークスペースに、myflow.bar という BAR ファイルを作成します。 Test.msgflow メッセージ・フローが TestFlowProject からこの BAR ファイルに追加されます。
mqsicreatebar -data C:¥Workspace -b myflow.bar -p TestFlowProject -o TestFlowProject¥TestFlow¥Test.msgflow
以下の例は、C:¥Workspace のワークスペースに、myflow.bar という BAR ファイルを作成します。 Test.msgflow メッセージ・フローが TestFlowProject からこの BAR ファイルに追加されます。適用可能なリソース・ファイルが、コンパイルなしで BAR ファイルに追加されます。
mqsicreatebar -data C:\Workspace -b myflow.bar -p TestFlowProject -o TestFlowProject\TestFlow\Test.msgflow -deployAsSource
以下の例は、C:¥Workspace のワークスペースに、mySet.bar という BAR ファイルを作成します。messageSet.mset メッセージ・セットが TestSetProject からこの BAR ファイルに追加されます。
mqsicreatebar -data C:¥Workspace -b mySet.bar -o TestSetProject¥TestSet¥messageSet.mset
以下の例は、C:¥Workspace のワークスペースに、mySet.bar という BAR ファイルを作成します。messageSet.msetメッセージ・セットが TestSetProject から、そして Test.msgflow メッセージ・フローが TestFlowProject からこの BAR ファイルに追加されます。
mqsicreatebar -data C:¥Workspace -b mySet.bar -o TestFlowProject¥TestFlow¥Test.msgflow
TestSetProject¥TestSet¥messageSet.mset 
以下の例は、C:¥Workspace のワークスペースに、myflow.bar という BAR ファイルを作成します。 アプリケーション Application1 が BAR ファイルに追加されます。トレース機能がオンになります。
mqsicreatebar -data C:¥Workspace -b myflow.bar -a Application1 -trace
特記事項 | 商標 | このリンクは新しいウィンドウに開きます ダウンロード | このリンクは新しいウィンドウに開きます ライブラリー | このリンクは新しいウィンドウに開きます サポート | フィードバック

Copyright IBM Corporation 1999, 2011Copyright IBM Corporation 1999, 2011.

        
最終更新

        最終更新 : 2011-11-04 05:55:38


参照トピック参照トピック | バージョン 8.0.0.0 | an19540_