mqsicreatebar コマンドを使用して、メッセージ・フローとディクショナリーを含むデプロイ可能なブローカー・アーカイブ (BAR) ファイルを作成します。
メッセージ・フローやディクショナリーを保管するためにリポジトリーを使用する場合、mqsicreatebar コマンドおよびリポジトリーのコマンド行ツールを使用して、メッセージ・フロー・アプリケーションをデプロイするスクリプトを記述できます。
ワークスペースの位置は、プロジェクトのデフォルトの位置でもあります。 相対パスは、コマンドが開始されたディレクトリーに対して相対であると解釈されます。
定義されたプロジェクトは、-data パラメーターで定義されたフォルダーに既に存在する必要があり、-o パラメーターで定義されたデプロイ可能リソースが必要とするプロジェクトおよびその参照プロジェクトをすべて含む必要があります。
-p パラメーターは、既存のワークスペースではオプションですが、 ビルド環境で新規のワークスペースとともに -p を使用する必要があります。
指定したプロジェクトがワークスペースの一部であっても、現在クローズされている場合、このコマンドはプロジェクトをオープンして構築するため、プロジェクト内のファイルを BAR ファイルに含めることができるようになります。
次の形式を使用すると、このコマンドに複数のデプロイ可能なファイルを追加できます。 -o FilePath1 FilePath2 .... FilePath'n'
次の形式を使用すると、複数のアプリケーションを追加できます。-a ApplicationName1 ApplicationName2 .... ApplicationName'n'
次の形式を使用すると、複数のライブラリーを追加できます。-l LibraryName1 LibraryName2 .... LibraryName'n'
mqsicreatebar コマンドを使用する場合には、.esql ファイルなどのリソースがメッセージ・フロー .cmf ファイルにコンパイルされます。個別のソース・ファイルとして BAR ファイルに追加されることはありません。
-deployAsSource パラメーターを使用すると、適用可能なリソースが BAR ファイルにソース・ファイルとして追加されます。メッセージ・フローの .cmf ファイルにコンパイルされることはありません。
-trace パラメーターは、システムのロケールで指定された言語で、トレース情報をシステム出力ストリームに書き込みます。1 つ以上のアプリケーションまたはライブラリーを BAR ファイルに追加すると、指定されたアプリケーションまたはライブラリー、および参照されるプロジェクトがすべてワークスペースで開かれます。トレース機能は、参照されるプロジェクトのいずれかが欠落しているかどうかが分かるように、この情報を記録します。
Windows XP および Windows Server 2003 システムでは、このコマンドを実行するユーザー ID は、ローカル・システムの管理者グループのメンバーでなければなりません。
特権が付与された環境からコマンドを実行しないと、継続するかどうかの確認が表示されます。「OK」をクリックすると、新しく特権を付与されたコマンド・コンソールが作成されてコマンドが完了しますが、この特権が付与された環境にすべての応答が書き込まれ、コマンドが完了してコンソールが閉じるとすべての応答は失われます。
Linux(x86) では、ユーザー ID に -data (ワークスペース) と -b (BAR ファイルの場所) ディレクトリーへの書き込み権限がなければなりません。
このコマンドは、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) の場合) です。
mqsicreatebar -data C:¥Workspace -b myflow.bar -p TestFlowProject -o TestFlowProject¥TestFlow¥Test.msgflow
mqsicreatebar -data C:\Workspace -b myflow.bar -p TestFlowProject -o TestFlowProject\TestFlow\Test.msgflow -deployAsSource
mqsicreatebar -data C:¥Workspace -b mySet.bar -o TestSetProject¥TestSet¥messageSet.mset
mqsicreatebar -data C:¥Workspace -b mySet.bar -o TestFlowProject¥TestFlow¥Test.msgflow
TestSetProject¥TestSet¥messageSet.mset
mqsicreatebar -data C:¥Workspace -b myflow.bar -a Application1 -trace