mqsicreatebroker コマンド

mqsicreatebroker コマンドを使用してブローカーおよび関連リソースを作成します。

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

  • Windows®
  • Linux® および UNIX® システム
  • z/OS®. BIPCRBK をカスタマイズおよび発行して、このコマンドを実行します。ブローカー PDSE の内容を参照してください。

目的

mqsicreatebroker コマンドの場合、
  1. 指定された WebSphere® MQ キュー・マネージャーがすでに存在するかどうかを検査します。
    • 存在しない場合には、次のようになります。
      • このコマンドを z/OS 上で実行した場合、エラーが報告されて、失敗します。
      • このコマンドを LinuxUNIX、または Windows 上で実行した場合、このコマンドがキュー・マネージャーを作成します。

        作成されたキューには、デッド・レター・キュー (DLQ)、SYSTEM.DEAD.LETTER.QUEUE が含まれます。 セキュリティー設定は、他のブローカー固有の WebSphere MQ キューと同じになります。

        メッセージ・フローから受信されたメッセージを処理できない場合、通常は入力キューにバックアウトされます。 バックアウトできない場合、またはメッセージ・フローがメッセージをバックアウトするように構成されていない場合、あるいは代わりのエラー処理を実行する場合、ブローカーはメッセージを DLQ に送ります。

        mqsideletebroker コマンドは、デフォルトの DLQ を削除しません (キュー・マネージャーが削除されない限り)。

    • このコマンドが存在する場合、キュー・マネージャーで DLQ が定義されていることを確認します。 DLQ はこのコマンドでは既存のキュー・マネージャー上に作成されません。ブローカーは処理できないメッセージを DLQ に送ります。

      WebSphere MQ クラスターをドメインで使用する場合、このコマンドを実行する前にキュー・マネージャーを定義し、クラスターでそのキュー・マネージャーを構成して、管理を減らし、可用性を向上させるという効果を得ます。

  2. WebSphere MQ キュー・マネージャーがまだ実行されていない場合には、それを開始します (z/OS の場合を除く)。

    このコマンドを使用してキュー・マネージャーを Windows 上に作成した場合、 それはサービスとして開始されません。 キュー・マネージャーはログオフすると停止します。 それゆえ、ログオンの状態を維持するか、またはキュー・マネージャー・サービスの開始状況を変更してください。 ワークステーションをロックしても、WebSphere MQ キュー・マネージャーは停止しません。

  3. 関連付けられたキュー・マネージャーに接続します。
  4. ブローカーが必要とする WebSphere MQ キューがまだ存在していない場合は、それらを作成します。
  5. 変更の始まり指定されたデータベース内の関連するスキーマにブローカー用のデータベース表を作成します。 ユーザー ID または表によって決まるスキーマが存在しない場合、 それらは作成されます。 表が既に存在する場合、コマンドはこのブローカー固有の行を既存の表に追加します。

    このコマンドに指定するパラメーターによって、このブローカーがデータベース・スキーマ内の表を他のブローカーと共用することになる場合、 これらすべてのブローカーが製品の同じバージョンであることを確認する必要があります。

    変更の終わり
  6. Windows の場合のみ、ブローカーの実行に使用するサービスをインストールします。
  7. レジストリー中にコンポーネントのレコードを作成します。
このコマンドの詳細については、社内のプラットフォームに適したリンクを選択してください。

許可

Windows システムでは、このコマンドを実行するのに使用するユーザー ID には、ローカル・システムに対する Administrator 権限がなければなりません。

Linux and UNIX システムでは、このコマンドを実行するのに使用するユーザー ID は mqbrkrs グループと mqm グループの両方のメンバーでなければなりません。

z/OS システムでは、このコマンドを実行するのに使用するユーザー ID は、コンポーネント・ディレクトリーに対する READ および WRITE の両方のアクセス権のあるグループのメンバーでなければなりません。 さらにそのユーザー ID には、WebSphere MQ リソースと DB2® へのアクセス権が必要です。

LDAP を使用する場合: 無許可アクセスできないように、レジストリーが適切に保護されていることを確認してください。ブローカーを正しく操作するために、 mqsicreatebrokerLdapPrincipal および LdapCredentials オプションを設定する必要はありません。 パスワードは平文でファイル・システム中に保管されません。

作成される WebSphere MQ キュー

  • SYSTEM.BROKER.ADMIN.QUEUE
  • SYSTEM.BROKER.AGGR.CONTROL
  • SYSTEM.BROKER.AGGR.REPLY
  • SYSTEM.BROKER.AGGR.REQUEST
  • SYSTEM.BROKER.AGGR.TIMEOUT
  • SYSTEM.BROKER.AGGR.UNKNOWN
  • SYSTEM.BROKER.CONTROL.QUEUE
  • SYSTEM.BROKER.EXECUTIONGROUP.QUEUE
  • SYSTEM.BROKER.EXECUTIONGROUP.REPLY
  • SYSTEM.BROKER.INTERBROKER.MODEL.QUEUE
  • SYSTEM.BROKER.INTERBROKER.QUEUE
  • SYSTEM.BROKER.MODEL.QUEUE
  • SYSTEM.BROKER.TIMEOUT.QUEUE
  • SYSTEM.BROKER.WS.ACK
  • SYSTEM.BROKER.WS.INPUT
  • SYSTEM.BROKER.WS.REPLY

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

作成されるデータベース表

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

応答

一部の環境では、DB2 によって発行された次のエラー・メッセージが表示されることがあります。
    (51002)[IBM][CLI Driver][DB2/NT]SQL0805N
    Package "NULLID.SQLLF000" was not found.  SQLSTATE=51002.

このエラーは、データベースへのバインドが正常に行われなかった場合に起きます。

  • Windows プラットフォームでは、ブローカー・データベースにバインディングは必要ありませんが、ユーザー・データベースにはバインディングが必要です。DB2 コントロール・センターを使用してデータベースを作成する場合、自動的にバインドが実行されます。 コマンド・インターフェースを使用した場合は、バインドは自動的には完了しません。例えば、データベース MYDB のバインドを作成または再作成するには、コマンド・プロンプトに次のコマンドを入力します。
    db2 connect to MYDB user db2admin using db2admin
    db2 bind X:¥sqllib¥bnd¥@db2cli.lst grant public
    db2 connect reset
    X:DB2 のインストール先のドライブです。
  • Linux および UNIX プラットフォームでは、すべてのデータベースでバインディングが必要です。たとえば、データベース WBRKBKDB のバインドを作成する場合、コマンド・プロンプトに次のコマンドを入力する必要があります (ここで、<user_name> はデータベース・インスタンスを作成したユーザー ID です)。
    db2 connect to WBRKBKDB user db2admin using db2admin
    db2 bind ~<user_name>/sqllib/bnd/@db2cli.lst grant public CLIPKG 5
    db2 connect reset

デフォルトの DB2 ユーザー ID およびパスワード (db2admin) を使用しない場合は、db2 connect コマンド内で値を正しい値に置き換える必要があります。

mqsicreatebroker コマンドを実行して失敗した場合は、失敗の原因を解明して問題を解決してください。 同じコマンドを再度実行すると、作成できない項目を示した一連のメッセージが表示されることがあります。 これらのメッセージが表示されても、mqsicreatebroker コマンド自体の問題が示されているわけではありません。
特記事項 | 商標 | ダウンロード | ライブラリー | サポート | フィードバック

Copyright IBM Corporation 1999, 2009Copyright IBM Corporation 1999, 2009.
最終更新 : 2009-02-20 12:44:11

an07080_