mqsicreatebroker コマンド

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

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

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

目的

mqsicreatebroker コマンドの場合、
  1. 指定された WebSphere® MQ キュー・マネージャーが存在するかどうかを検査します。
    • 存在しない場合には、次のようになります。
      • このコマンドを z/OS 上で実行した場合、エラーが報告されて、失敗します。
      • このコマンドを Linux、UNIX、または 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. Windows の場合のみ、ブローカーの実行に使用するサービスをインストールします。
  6. 使用可能な モード の 1 つでブローカーを作成します。 フル・パッケージがインストールされた場合、デフォルト・モードは「Advanced」となります。 トライアル・パッケージがインストールされた場合、デフォルト・モードは「トライアル」となります。詳しくは、動作モードを参照してください。
  7. レジストリー中にコンポーネントのレコードを作成します。
  8. Windows プラットフォーム、Linux、および UNIX システム では、ブローカーの作成時に、ブローカーを WebSphere MQ サービスとして開始および停止することが可能かどうかを指定できます。

ブローカーはローカル・キュー・マネージャーにしかアクセスできないため、リモート・システム上にあるキュー・マネージャーでブローカーを作成することはできません。

使用上の注意

バージョン 6.1 からマイグレーションした場合は、次のようにします。

WebSphere Message Broker の以前のバージョンでは、このコマンドに指定したパラメーターは、データベース・アクセスのデフォルト許可 (データベース・ユーザー ID とパスワード (指定した場合) またはサービス・ユーザー ID とパスワードのいずれか) を提供するために、ブローカーにより使用されました。 バージョン 8.0 ブローカーはデータベースを独自の目的では使用しないので、データベース・ユーザー ID およびパスワードのパラメーターは推奨されなくなりました。 ブローカー・サービス ID およびパスワードのパラメーターも、(Windows 上での使用を除き) 推奨されなくなりました。

前のリリースからブローカーをマイグレーションした場合、関連した値は保管され、それらの値は mqsisetdbparms コマンドを使用してユーザー自身が入力したものであるかのように、デフォルトのユーザー・データベース・アクセスで使用されることになってしまいます。

バージョン 8.0 ブローカーを作成した場合、mqsisetdbparms コマンドを使用して、データベース・アクセス許可をセットアップする必要があります。

社内でご使用のオペレーティング・システムにおけるこのコマンドの詳細については、以下のリンクから該当するものを選択してください。

許可

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

Windows 7および Windows Server 2008 システムでは、このコマンドを実行するためのユーザー ID は、以下のようにローカル・システム上で高位の特権が付与されて実行される必要があります。
  • ユーザー ID は、管理者グループのメンバーでなければなりません。
  • このコマンドは、昇格コマンド・プロンプトから実行する必要があります。 昇格コマンド・プロンプトを取得するには、mqsicommandconsole コマンドを実行し、Windows プロンプトの指示に従って新しい昇格コマンド・コンソールを起動します。

    このコンソールは、正しい mqsiprofile 環境で開始されます。その環境から、昇格が必要なコマンドを実行できます。

このコマンドを特権コマンド・コンソール内から実行しない場合は、コマンドが正常に処理されません。

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

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

どのシステムの場合でも、このコマンドを実行するのに使用するユーザー ID は、mqm グループのメンバーでなければなりません。これは、ブローカーで使用するために複数のキューが作成されるためです。

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

作成される WebSphere MQ キュー

  • SYSTEM.BROKER.ADAPTER.FAILED
  • SYSTEM.BROKER.ADAPTER.INPROGRESS
  • SYSTEM.BROKER.ADAPTER.NEW
  • SYSTEM.BROKER.ADAPTER.PROCESSED
  • SYSTEM.BROKER.ADAPTER.UNKNOWN
  • SYSTEM.BROKER.ADMIN.QUEUE
  • SYSTEM.BROKER.ADMIN.REPLYTODM
  • SYSTEM.BROKER.AGGR.CONTROL
  • SYSTEM.BROKER.AGGR.REPLY
  • SYSTEM.BROKER.AGGR.REQUEST
  • SYSTEM.BROKER.AGGR.TIMEOUT
  • SYSTEM.BROKER.AGGR.UNKNOWN
  • SYSTEM.BROKER.AUTH
  • SYSTEM.BROKER.CONTROL.QUEUE
  • SYSTEM.BROKER.DEPLOY.QUEUE
  • SYSTEM.BROKER.DEPLOY.REPLY
  • SYSTEM.BROKER.EDA.COLLECTIONS
  • SYSTEM.BROKER.EDA.EVENTS
  • SYSTEM.BROKER.EXECUTIONGROUP.QUEUE
  • SYSTEM.BROKER.EXECUTIONGROUP.REPLY
  • SYSTEM.BROKER.INTER.BROKER.COMMUNICATIONS
  • 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 にも同じ権限が付与されます。

応答

mqsicreatebroker コマンドを実行して失敗した場合は、失敗の原因を解明して問題を解決してください。
  • 応答を確認します。これについては、コマンドに対する応答を参照してください。
  • エラー・ログを確認します。これについては、ローカル・エラー・ログを参照してください。
  • エラー・ログに含まれているエラー・メッセージを確認します。 インフォメーション・センターでエラー・メッセージを検索できます。
同じコマンドを再度実行すると、作成できない項目を示した一連のメッセージが表示されることがあります。 これらのメッセージが表示されても、mqsicreatebroker コマンド自体の問題が示されているわけではありません。
特記事項 | 商標 | このリンクは新しいウィンドウに開きます ダウンロード | このリンクは新しいウィンドウに開きます ライブラリー | このリンクは新しいウィンドウに開きます サポート | フィードバック

Copyright IBM Corporation 1999, 2011Copyright IBM Corporation 1999, 2011.

        
最終更新

        最終更新 : 2011-11-04 05:55:32


参照トピック参照トピック | バージョン 8.0.0.0 | an07080_