mqsicreatebar コマンド

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

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

  • Windows
  • Linux (x86)

目的

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

構文

構文図を読む構文図をスキップする
>>-mqsicreatebar-- -data -WorkSpace-- -b -BarName--------------->

>--+--------------+--+--------------------------+--------------->
   '- -cleanBuild-'  '- -version -VersionString-'   

                 .----------------------.   
                 V                      |   
>--+----------+----+------------------+-+----------------------->
   '- -Esql21-'    '- -p -ProjectName-'     

        .--------------.   
        V              |   
>-- -o------FilePath---+---------------------------------------><

パラメーター

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

許可

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

Windows 7、Windows Vista、および 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 でファイルをコンパイルするときにエラーが発生しました

例

mqsicreatebar コマンドは、PATH 環境変数が WMB toolkit ディレクトリーへのパスを正しく指定している限り、ファイル構造内の任意の場所で開かれるウィンドウから実行できます。
  • Windows 32 ビット版では、WMB toolkit ディレクトリーのデフォルトの場所は C:¥Program Files¥IBM¥WMBT700 です。
  • Windows 64 ビット版では、デフォルトは C:¥Program Files (x86)¥IBM¥WMBT700 です。
  • Linux (x86) では、デフォルトは /opt/IBM/WMBT700 です。
インストール済み環境によって、デフォルトは異なる場合があります。

-b パラメーターは、BAR フィルの名前と、BAR ファイルを生成するオプションの代替パスを指定します。 -b パラメーターの一部としてパスが指定されない場合、mqsicreatebar コマンドが実行されるファイル構造内の場所が、BAR ファイルを作成する場所を指定します。 例えば、現在の場所が C:¥> である場合、mqsicreatebar コマンドを実行すると、BAR ファイルは C:¥ で作成されます。一方、-b c:¥myfiles¥myflow.bar を指定して mqsicreatebar を実行すると、BAR ファイルは myfiles ディレクトリー内に作成されます。

以下の例は、コマンドが実行されるディレクトリー内に myflow.bar という BAR ファイルを作成します。 TestFlowProject からの Test.msgflow メッセージ・フローが、コンパイル済みメッセージ・フロー (.cmf) ファイルとしてこの BAR ファイルに追加されます。
mqsicreatebar -data C:¥Workspace -b myflow.bar -p TestFlowProject -o TestFlowProject¥TestFlow¥Test.msgflow
以下の例は、mySet.bar という BAR ファイルを作成します。 messageSet.mset メッセージ・セットが TestSetProject からこの BAR ファイルに追加されます。
mqsicreatebar -data C:¥Workspace -b mySet.bar -o TestSetProject¥TestSet¥messageSet.mset
以下の例は、mySet.bar という BAR ファイルを作成します。 messageSet.msetメッセージ・セットが TestSetProject から、そして Test.msgflow メッセージ・フローが TestFlowProject からこの BAR ファイルに追加されます。 メッセージ・フローはコンパイル済みメッセージ・フロー (.cmf) ファイルとして追加されます。
mqsicreatebar -data C:¥Workspace -b mySet.bar -o TestFlowProject¥TestFlow¥Test.msgflow
TestSetProject¥TestSet¥messageSet.mset 
特記事項 | 商標 | ダウンロード | ライブラリー | サポート | フィードバック

Copyright IBM Corporation 1999, 2012Copyright IBM Corporation 1999, 2012.

        
        最終更新
        
        最終更新 : 2012-08-03 11:55:39


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