mqsicreateconfigmgr コマンド

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

  • Windows 2000、Windows XP

目的

このコマンドは、以下を実行します。
  • WebSphere MQ キュー・マネージャーがまだ存在していなければ、作成します。
    注:
    1. mqsicreateconfigmgr コマンドを使用した結果 WebSphere MQ キュー・マネージャーが作成された場合、WebSphere MQ に備えられている DLQ (SYSTEM.DEAD.LETTER.QUEUE) が自動的に使用可能になります。セキュリティー設定は、他のブローカー固有の WebSphere MQ キューと同じになります。

      キュー・マネージャーを別個に作成することにした場合、送達不能キュー (DLQ) をセットアップします。 DLQ は、メッセージ・フロー内のメッセージの処理でエラーが発生したときに、WebSphere Business Integration Message Broker から参照されます。

      ユーザー定義のメッセージ・フロー中かパブリッシュ / サブスクライブ・モデル中にあるメッセージが処理できないと、 そのメッセージは最後の手段としてこの DLQ にルーティングされます。 もし、メッセージを入力キューにバックアウトさせ、 問題が解決するまで事実上メッセージ・フローを停止させておきたい場合には、 DLQ を使用不可にしておいてください。

      このキューは mqsideleteconfigmgr コマンドによって削除されません (キュー・マネージャーを削除した場合を除く)。

    2. mqsicreateconfigmgr コマンドとは無関係に作成された WebSphere MQ キュー・マネージャーを使用する場合、クラスターを定義することもできます。 これを使用すると、構成が簡単になります。
  • WebSphere MQ キュー・マネージャーがまだ実行されていない場合は開始します。構成マネージャー は常に WebSphere MQ トラステッド・アプリケーションとして実行されます。
  • 構成マネージャー固有の WebSphere MQ キューとチャネルが存在していない場合は作成します。
  • 構成リポジトリー中に構成マネージャーのデータベース・テーブルが存在していない場合は作成します。
  • 構成マネージャーを実行する Windows サービスをインストールします。
  • ブローカー・レジストリー中にコンポーネントのレコードを作成します。

VisualAge for Java をインストールし、 インストール内容の一部として WebSphere MQ Connector を選択した場合は、 VisualAge for Java の CLASSPATH エントリーが、 ご使用の Windows プラットフォームの WebSphere MQ (サーバーまたは Java クライアント) の CLASSPATH エントリーのにあることを確認します。 このようになっている場合、構成マネージャーmqsistart コマンドを使用して開始したときに (VisualAge クラスではなく) WebSphere MQ クラスに正しくアクセスします。 構成マネージャー がこの分野のエラーを検出すると、メッセージ BIP1004Windows システムのイベント・ログに書き込まれます。

構文

パラメーター

-i ServiceUserID
(必須) Windows サービスの実行に使用するユーザー ID。

これは、以下のような任意の有効な Windows ユーザー名構文の形式で指定できます。

  • domain¥username
  • ¥¥server¥username
  • .¥username
  • username

指定する ServiceUserID は、 ローカル・グループ mqbrkrs の (直接または間接の) メンバーでなければなりません。 また、ホーム・ディレクトリー (WebSphere Business Integration Message Broker のインストール先) と作業ディレクトリー (-w フラグで指定した場合) へのアクセスも許可されていなければなりません。さらにこのユーザー ID は、 ローカル・グループ mqm またはローカル WindowsAdministrators グループの (直接または間接の) メンバーでもなければなりません。

ServiceUserID のセキュリティー要件は、Windows プラットフォームでのセキュリティー要件 に詳述されています。

このユーザー ID の非修飾形式 (username) を使用すると、 オペレーティング・システムによってローカル・システムから始めてドメイン全体でこのユーザー ID が検索されます。この検索が完了するまでに多少の時間がかかることがあります。

-a ServicePassword
(必須) ServiceUserID のパスワード。
-q QueueManagerName
(必須) 構成マネージャーに関連したキュー・マネージャーの名前。

キュー・マネージャーがまだ存在していない場合は、このコマンドによって作成されます。 ただし、デフォルトのキュー・マネージャーとして作成されるわけではありません。これをこのシステム上のデフォルト・キュー・マネージャーにするには、このコマンドを発行する前にキュー・マネージャーを作成します。

キュー・マネージャー属性 MAXMSGL (キューに挿入できるメッセージの最大長) は、100 MB に更新されています。 この更新は、このコマンドによってキュー・マネージャーが作成されたかどうかに関係なく行われます。

-n DataBaseName
(必須) 構成リポジトリー・テーブルを保持するために作成したデータベースの名前。 このデータベースは、ブローカー・ドメイン全体の構成リポジトリーであり、 構成マネージャーの内部データに加えて、すべてのリソースの構成情報も収容します。

このデータベースはすでに存在していなければなりません。 JDBC によってアクセスが提供されるので、 このデータベースへの ODBC 接続を作成する必要はありません。

-u DataBaseUserID
(オプション) 構成リポジトリー・データベースへのアクセスに使用するユーザー ID。 これが指定されない場合、ServiceUserID で設定された値が使用されます。

このユーザー ID には、DataBaseName で識別されるデータベース中にテーブルを作成し、 そのデータベースを読み書きする権限がなければなりません。

-p DataBasePassword
(オプション) 構成リポジトリー・データベースへのアクセスに使用するユーザー ID のパスワード。 これを指定しない場合、 -a で指定した ServicePassword がデフォルトとして使用されます。
-d SecurityDomainName
(オプション) このパラメーターは、ヌルに設定する必要があります。構成マネージャーの作成時には、このパラメーターは省略してください。

mqsicreateaclgroup コマンドの -u および -g オプションは、 構成マネージャーがそのセキュリティーで使用するドメイン内のユーザーとグループを意味します。デフォルトでは、このドメインは構成マネージャーが常駐するマシンですが、 このオプションを使用する場合は異なります。

-s UserNameServerQueueManagerName
(オプション) ユーザー・ネーム・サーバーと関連した WebSphere MQ キュー・マネージャーの名前。 これが指定されない場合、構成マネージャーユーザー・ネーム・サーバーが定義されていないと見なし、 ユーザー・ネーム・サーバーとの通信を試行しません。
-w Workpath
(オプション) この構成マネージャーの作業ファイルが保管されるディレクトリー。これが指定されない場合、製品のインストール時に指定したデフォルトのディレクトリーが使用されます。
-l 2、0、または 1
(オプション) このパラメーターは、2 に設定する必要があります。 構成マネージャーを作成するときは、このパラメーターを省略します。このオプションについての詳細は、ワークベンチのセキュリティーの考慮を参照してください。

許可

このコマンドを使用すると、ServiceUserID のセキュリティー特権が変更されます。 このコマンドを呼び出すのに使用するユーザー ID は、 このローカル・システム上の Windows Administrators グループのメンバーでなければなりません。

作成される Websphere MQ キュー

  • SYSTEM.BROKER.CONFIG.QUEUE
  • SYSTEM.BROKER.CONFIG.REPLY
  • SYSTEM.BROKER.ADMIN.REPLY
  • SYSTEM.BROKER.SECURITY.REPLY
  • SYSTEM.BROKER.MODEL.QUEUE

上記のすべてのキューには、WebSphere Business Integration Message Broker グループ mqbrkrs へのアクセス権限が付与されます。DLQ が使用可能になっている場合は、DLQ にも同じ権限が付与されます。

キュー SYSTEM.BROKER.CONFIG.QUEUE および SYSTEM.BROKER.CONFIG.REPLY には、 WebSphere Business Integration Message Broker グループ mqbrdevtmqbrasgnmqbrops、および mqbrtpic へのアクセス権限が付与されます。

作成される Websphere MQ チャネル

  • SYSTEM.BKR.CONFIG

作成されるデータベース・テーブル

このコマンドで作成されるデータベース・テーブルについては、データベースの内容 に説明があります。

応答

このコマンドは、以下の応答を戻します。
  • BIP8011 構成データを作成できません
  • BIP8012 システム・コンポーネントに接続できません
  • BIP8014 コンポーネントを作成できません
  • BIP8022 ユーザー ID/パスワードが無効です
  • BIP8030 ユーザー ID 特権を変更できません
  • BIP8048 キュー・マネージャーを始動できません
  • BIP8050 キュー・マネージャーを作成できません
  • BIP8051 キューを作成できません
  • BIP8053 キュー・マネージャーのセキュリティーを設定できません
  • BIP8054 キューのセキュリティーを設定できません
  • BIP8055 Java クラスをロードできません
  • BIP8056 キュー・マネージャーが不明です
  • BIP8074 JVM を作成できません
  • BIP8075 Java 例外
  • BIP8076 現行ディレクトリーを設定できませんでした
  • BIP8077 構成データを初期化しようとしているときに問題が発生しました
  • BIP8078 構成データを初期化しようとしているときに問題が発生しました
  • BIP8084 ディレクトリーを作成できません
  • BIP8087 コンポーネントはすでに存在しています
  • BIP8093 キュー・マネージャーは現在作成されています
  • BIP8094 キュー・マネージャーは現在停止されています
  • BIP8097 Java オブジェクトを作成できませんでした


mqsicreateconfigmgr -i wbrkuid -a wbrkpw -q WBRK_CONFIG_QM
-n WBRKCMDB 

関連概念
構成マネージャー

関連タスク
構成マネージャーの作成
ワークベンチのセキュリティーの考慮

関連資料
データベースの内容
構文の設定
mqsichangeconfigmgr コマンド
mqsideleteconfigmgr コマンド