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

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

mqsicreatemsgdefs コマンド

mqsicreatemsgdefs コマンドを使用して、メッセージ・セット内にメッセージ定義ファイルを作成します。

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

  • Windows
  • Linux (x86)

目的

mqsicreatemsgdefs コマンドによって、オプション・ファイルに指定されている一連のインポート・オプションに従って、メッセージ定義ファイル (*.mxsd) が生成されます。 生成されたファイルは、指定のメッセージ・セット・フォルダー内に置かれます。

このコマンドは、他の各種パラメーターに加えて、さまざまなタイプのソース・ファイル (例えば、C や COBOL ソース・ファイルなど) が置かれているディレクトリーをパラメーターとしてとり、そのファイルの拡張子に基づいて適当な操作を開始します。

  1. 指定したディレクトリーおよびサブディレクトリー構造の中に、コマンドの実行に必要なファイルだけが入っていることを確認します。 mqsicreatemsgdefs コマンドが実行するアクションの 1 つに、メッセージ定義の作成の前に、ディレクトリーおよびサブディレクトリー内のすべてのファイルをワークスペースにコピーするというものがあります。 mqsicreatemsgdefs コマンドは、ソース・ファイルを messageSet プロジェクトのインポート・ファイル・フォルダーにコピーします。 このため、ソース・ディレクトリーはメッセージ・セット・プロジェクト・フォルダーであってはならず、それを含んでもなりません。 作成しようとしているメッセージ定義に関連しないファイルもコピーされることがあります。
  2. ターゲット・ワークスペースを指定する場合は、-data WorkspacePath パラメーターを指定する必要があります。

構文

構文図を読む構文図をスキップする
>>-mqsicreatemsgdefs-- -p --MessageSetProjectName--------------->

>-- -d--Pathname of source files folder------------------------->

>-- -data --WorkspacePath--------------------------------------->

>--+-------------------------------------------------------+---->
   '- -base --baseMessageSetProjectName¥baseMessageSetName-'   

>--+--------+--+--------+--+-------+--+--------+---------------->
   '- -rmp -'  '- -rmd -'  '- -ns -'  '- -msg -'   

>--+-----------------+--+------+-------------------------------->
   '- -opt --xxx.xml-'  '- -v -'   

>--+----------------------------+------------------------------><
   '- -log --ReportFilePathName-'   

パラメーター

-p MessageSetProjectName
(必須) メッセージ・セット・プロジェクトの名前。 プロジェクトが存在しない場合、新規のメッセージ・セット・プロジェクトが作成されます。
-d Pathname of source files folder
(必須) 定義ファイル (ソース・ファイル) のディレクトリーの絶対または相対パス名。

ソース・ファイル・フォルダーの下のすべてのサブフォルダー内に置かれている関連ファイルがすべてスキャンされてインポートされます。

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

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

-base baseMessageSetProjectName¥baseMessageSetName
(オプション) 新しいメッセージ・セットが作成される場合のベースとなる既存のメッセージ・セット・プロジェクトおよびメッセージ・セットを指定します。
-rmp
(オプション) 同一名の付いた既存のプロジェクトを置き換えます。
-rmd
(オプション) 同一名の付いた既存のメッセージ定義ファイルを置き換えます。
  1. このフラグを省略する場合、同一名のメッセージ定義ファイルが存在すると、警告が戻されます。
  2. メッセージ・セット内に生成されたメッセージ定義ファイルの位置は、ターゲットのネーム・スペースによって決まります。
-ns
(オプション) 新しいメッセージ・セットが作成される場合、そのメッセージ・セットを使用してネーム・スペースをサポートできます。
-msg
(オプション) 複合のインポートされた構造からメッセージを作成します。
-opt xxx.xml
(オプション) オプション・ファイルの絶対または相対パス名。 オプション・ファイルは、以下のタイプのうちのいずれかになります。 オプションを指定しないと、デフォルトのオプション・ファイル (mqsicreatemsgdefs.xml) が使用されます。メッセージ・セット: mqsicreatemsgdefs コマンド用のデフォルト・オプション・ファイルを参照してください。

デフォルト・オプション・ファイルをコピーしてカスタマイズし、ご使用の環境に合うようにオプション・ファイルを作成できます。

-v
(オプション) 冗長なレポート。
-log ReportFilePathname
(オプション) レポート・ファイルの絶対または相対パス名。 このオプションを省略すると、レポートはデフォルトのログ・ファイル (mqsicreatemsgdefs.report.txt) で Eclipse の現行ディレクトリーに書き込まれます。

レポート・ファイルのパス名を指定しないか、または無効なパス名を使って -log を指定すると、コマンドはエラー・メッセージを発行して停止します。

許可

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

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

その他のプラットフォームでは、このコマンドを実行するための特定の権限は必要ありません。

以下の例では、ソース・ファイル c:¥myproject¥source 中でメッセージ・セット・プロジェクト newproject を作成するか使用して、同じ名前の既存のメッセージ・プロジェクトとメッセージ定義ファイルを置き換えます。

mqsicreatemsgdefs -p newproject -d c:¥myproject¥source -rmp -rmd
特記事項 | 商標 | ダウンロード | ライブラリー | サポート | フィードバック

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

        
        最終更新:
        
        最終更新: 2015-02-28 17:47:39


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