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

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

mqsicreatebroker コマンド - Windows システム

mqsicreatebroker コマンドを使用して Windows システム上にブローカーを作成します。

構文

構文図を読む構文図をスキップする
>>-mqsicreatebroker--brokerName-- -i --+-serviceUserId-+-------->
                                       '-LocalSystem---'   

>-- -a --servicePassword-- -q --queueManagerName---------------->

>--+----------------+--+------+--+------+----------------------->
   '- -w --workPath-'  '- -t -'  '- -m -'   

>--+-------------------+---------------------------------------->
   '- -l --userLilPath-'   

>--+----------------------------------+------------------------->
   '- -g --configurationChangeTimeout-'   

>--+------------------------------------+----------------------->
   '- -k --internalConfigurationTimeout-'   

>--+------------------------+----------------------------------->
   '- -P --httpListenerPort-'   

>--+-------------------------------+---------------------------->
   '- -v --statisticsMajorInterval-'   

>--+------------------------------------------+----------------->
   '- -y--ldapPrincipal-- -z--ldapCredentials-'   

>--+------------------------+--+--------------------+----------->
   '- -c --icuConverterPath-'  '- -x --userExitPath-'   

>--+---------------------+--+--------------------+-------------->
   '- -o --operationMode-'  '- -s --+-inactive-+-'   
                                    '-active---'     

>--+----------------------+--+---------------------+------------>
   '- -e --sharedWorkPath-'  '- -d --+-defined---+-'   
                                     '-undefined-'     

>--+-------------------+--+----------------------+-------------->
   '- -b --cachePolicy-'  '- -r --cachePortRange-'   

>--+-------------------------+---------------------------------->
   '- -B --brokerDomainGroup-'   

>--+-------------------------------+---------------------------><
   '- -Q --queueManagerDomainGroup-'   

パラメーター

brokerName
(必須) 作成するブローカーの名前。 このパラメーターは、最初のパラメーターでなければなりません。 大文字でブローカーの名前を作成した場合、この名前は WebSphere® Message Broker Toolkit でも大文字で指定する必要があります。

使用できる文字セットの制約事項については、コマンドで使用できる文字を参照してください。

-i serviceUserId
(オプション) ブローカーの実行に使用するユーザー ID。

serviceUserID は、任意の有効なユーザー名の構文で指定できます。

  • ローカル名として:

    username

    .¥username

  • ユーザー・プリンシパル名 (UPN) として:

    username@domain

  • 従来方式のログオン名として:

    domain¥username

  • 特定のサーバーへの要求として:

    ¥¥server¥username

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

指定した serviceUserID は、mqbrkrs ローカル・グループの直接的または間接的なメンバーでなければなりません。 また serviceUserID は、ホーム・ディレクトリー (WebSphere Message Broker のインストール先) と作業ディレクトリー (-w パラメーターで指定した場合) へのアクセスも許可されていなければなりません。

ブローカーが WebSphere MQ トラステッド・アプリケーションとして実行されること (-t パラメーター) を指定した場合、 このサービス・ユーザー ID を mqm グループに追加する必要もあります。

serviceUserID のセキュリティー要件については、Windows システムでのセキュリティー要件を参照してください。

-iLocalSystem
(オプション) serviceUserId ではなく LocalSystem を指定できます。

LocalSystem を指定した場合、 servicePassword パラメーターは不要です。

-e パラメーターを指定する場合は、LocalSystem を使用しないでください。-e パラメーターを指定するときには、-i オプションの実際の userid を使用する必要があります。

Windows の場合は、-i LocalSystem オプションのみが使用可能です。 マルチインスタンス・ブローカーに -e パラメーターを指定すると、システムでエラー (「BIP8022E: 指定されたサービス・ユーザー ID とパスワードの組み合わせは無効です」) が発生します。

注: -i パラメーターには Localsystem オプションまたは serviceUserId オプションを指定する必要があります。
-a servicePassword
(必須) serviceUserId のパスワード。

既存のシステムとの互換性を保つために、<password> を指定することができます。 しかし、コマンドの実行時にパスワードをこのパラメーターとともに指定しない場合は、起動時にパスワードを入力するようにプロンプトが出されます。 正しく入力したことを確認するためにパスワードをもう一度入力しなければなりません。

-q queueManagerName
(必須) このブローカー・インスタンスに関連付けられたキュー・マネージャー (またはマルチインスタンス・ブローカーを作成している場合にはマルチインスタンス・キュー・マネージャー) の名前。 ネットワークの編成や管理を単純化するため、ブローカーとキュー・マネージャーの名前は同じにします。 キュー・マネージャー名の長さは 48 文字に限定されており、大/小文字の区別があります。

キュー・マネージャーが同じサーバー上にまだ存在しない場合、デフォルト動作として、デフォルト mqm パスを使ってキュー・マネージャーを作成します。

サーバー上にキュー・マネージャーが存在しない場合にマルチインスタンス・ブローカーを作成する際、次のように WebSphere MQ crtmqm コマンドを使用して、マルチインスタンス・ブローカー共有作業パスの下にマルチインスタンス・キュー・マネージャーが作成されます。
  crtmqm –md /<broker sharedWorkPath>/mqm/qmdata
         -ld //<broker sharedWorkPath>/mqm/qmlog queueManagerName

この共有キュー・マネージャー・パスが適切でない場合は、このコマンドを実行する前に、マルチインスタンス・キュー・マネージャーをサーバー上に作成してください。

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

使用できる文字セットの制約事項については、コマンドで使用できる文字を参照してください。

-w workPath
(オプション) このブローカーの作業ファイルが格納されるディレクトリー。 このパラメーターを指定しない場合、ファイルはデフォルトの作業パスに格納されます。このパスは、製品のインストール時に指定されています。 このパラメーターを指定した場合は、ブローカーを始動する前に、このディレクトリーを作成する必要があります。

–e フラグを使ってブローカーのマルチインスタンス・モードを有効にした場合、ブローカーの workPath は、このブローカー・インスタンスに固有のデータと、このブローカーおよび (mqsiaddbrokerinstance コマンドで作成される) インスタンスによって共有されるデータとの間で分割されます。 マルチインスタンスが有効になったブローカーに固有のデータはローカル・サーバー上の workPath ディレクトリーに保管されます。一方、共有データは、–e フラグを使って指定された場所であるネットワーク・ストレージ上のディレクトリーに保持されます。

このディレクトリーは、トレースがアクティブの際に作成されるトレース・レコードにも使用されます。 これらのレコードは、サブディレクトリー log に書き込まれます。 これは、ブローカーを始動する前に作成しておく必要があります。

プロセスが異常終了した際にブローカーによって作成されるエラー・ログは、このディレクトリーに保管されます。

エラー・ログに制限はなく、そのサイズは大きくなり続けます。 定期的にこのディレクトリーを調べ、古くなったエラー情報は消去してください。

mqsichangebroker コマンドを使用してこのパラメーターを変更することはできません。 作業パスを指定または変更するには、ブローカーを削除して再作成してください。

このパラメーターを指定すると、ブローカー用に別個の作業ディレクトリーが作成されます。 この作業ディレクトリーは、デフォルトの作業ディレクトリー構造のサブセットです。ここにはより少ない数のサブディレクトリーだけが含まれていて、common¥profiles サブディレクトリーはありません。

-t
(オプション) ブローカーを WebSphere MQ トラステッド・アプリケーションとして実行します。

このパラメーターを指定する場合は、 serviceUserID (-i パラメーターによって指定される) を mqm グループに追加します。

WebSphere MQ トラステッド・アプリケーションの使用に関する詳細は、WebSphere MQ バージョン 7 インフォメーション・センター・オンラインの「相互通信」のセクションを参照してください。

-l userLilPath
(オプション) ブローカーが、ユーザー定義のメッセージ処理ノード用のロード可能インプリメンテーション・ライブラリー (LIL ファイル) をロードする際のロード元のパス (ディレクトリー) のリスト。

パスに環境変数は含めないでください。ブローカーは環境変数を無視します。

独自のディレクトリーを作成して、.lil ファイルや .jar ファイルを保管してください。 これらのファイルを WebSphere Message Broker インストール・ディレクトリーに保管しないでください。

ディレクトリーを複数指定する場合は、セミコロン (;) でディレクトリーを区切ってください。

-g configurationChangeTimeout
(オプション) ユーザー構成要求の処理に許可される最大時間 (秒単位)。 これは開始した構成変更を実行グループに適用するためにブローカー内で費やす時間の長さを定義します。 例えば、WebSphere Message Broker Toolkit から構成をデプロイする場合、 ブローカーはこの時間内に構成マネージャーに応答する必要があります。

メッセージ・フローがアプリケーション・メッセージを処理中の場合、構成変更に応答することはできません。 実行グループのメッセージ・フローのいずれかが、アプリケーション・メッセージの処理を完了しておらず、そのタイムアウト内で構成変更を適用しない場合、この実行グループはデプロイされた構成メッセージに対して否定応答を返します。

10 から 3600 までの範囲の秒数で値を指定してください。 デフォルトは 300 です。

このタイムアウトの値を設定する方法について詳しくは、 構成のタイムアウト値の設定を参照してください。

-k internalConfigurationTimeout
(オプション) 内部構成変更の処理に許可される最大時間 (秒単位)。 例えば、これは実行グループを開始するためにブローカー内で費やす時間の長さを定義します。

各実行グループの応答時間は、システム負荷およびそれ自体のプロセスの負荷に応じて異なります。 この値には、実行グループが応答するのにかかる最も長い応答時間を反映する必要があります。 この値が短すぎると、ブローカーは否定応答を戻し、ローカル・エラー・ログにエラー・メッセージを出すこともあります。

10 から 3600 までの範囲の秒数で値を指定してください。 デフォルトは 60 です。

このタイムアウトの値を設定する方法について詳しくは、 構成のタイムアウト値の設定を参照してください。

-P httpListenerPort
(オプション) Web サービス・サポートが listen するポートの番号を入力します。

ブローカーは、HTTP ノードまたは Web サービス・サポートが含まれるメッセージ・フローの開始時にこのリスナーを始動し、そのデフォルトは 7080 です。

指定するポートが、他の目的で指定されていないことを確認してください。

-v statisticsMajorInterval
(オプション) 統計およびアカウンティング・アーカイブ・レコードが書き込まれる時間間隔 (分単位) を指定します。 有効範囲は、1 分から 43200 分です。デフォルト値は 60 です。
-y ldapPrincipal
(オプション。ただし、ldapCredentials が提供されている場合は必須)。 JMS プロバイダー用の JNDI 管理の初期コンテキストを保有するオプションの LDAP ディレクトリーにアクセスするためのユーザー・プリンシパル。
-z ldapCredentials
(オプション。ただし、ldapPrincipal が提供されている場合は必須)。 LDAP にアクセスするためのユーザー・パスワード。
-c icuConverterPath
(オプション) 追加のコード・ページ・コンバーターを検索する、区切り文字で区切られたディレクトリーの集合。 Windows システムでの区切り文字はセミコロン (;) です。 UNIX および Linux システムでの区切り文字は、コロン (:) です。
提供されている組み込みコンバーターの 1 つと一致するコンバーターを使用しており、そのコンバーターがブローカーのローカル・コード・ページである場合は、このパラメーターを使用してコンバーターのパスを設定しないでください。 代わりに ICU_DATA 環境変数を使用してください。
-x userExitPath
(オプション) このブローカー内の実行グループに対してロードされるすべてのユーザー出口の場所が含まれるパスです。 このパスは、実行グループ・プロセスの場合にのみ、システム・ライブラリーの検索パス (PATH,LIBPATH,LD_LIBRARY_PATH,SHLIBPATH) に追加されます。
-o operationMode
(オプション) このパラメーターを使用して、ブローカーの モード を設定します。 詳しくは、動作モードを参照してください。 設定可能な有効値は、Advanced (フル・パッケージ、Advanced モード)、 Express (Express® Edition モード)scale (Scale モード)、 Standard (Standard Edition モード)、および アダプター (Remote Adapter Deployment モード)。デフォルト値は Advanced ですが、Developer Edition があるときは異なり、その場合のデフォルト値は developer となります。 -o パラメーターを設定しない場合、デフォルト値が自動的に使われます。

Standard Edition のライセンスを購入した場合は、Standard モードまたは scale モードでブローカーを実行する権利が与えられています。

-s
(オプション) ブローカーの管理セキュリティー状況を指定します。

-s active を指定すると、管理セキュリティーが有効になります。権限が与えられたユーザー ID のみが、ブローカーに対するアクションを完了することを許可されます。セキュリティー・グループ mqbrkrs に属するすべてのユーザー ID に、セキュリティー・キュー SYSTEM.BROKER.AUTH に対する読み取り、書き込み、および実行権限が常に認可されます。 ブローカーが作成されたら、このキューにさらにユーザー ID 許可を追加できます。

管理セキュリティーが使用可能になっているブローカー上で実行グループを作成するとき、キュー SYSTEM.BROKER,AUTH.egroup_name が作成されます。 該当するユーザー許可をキューに取り込みます。

-s inactive を指定するか、またはこのパラメーターを省略すると、ブローカー管理セキュリティーが無効になります。すべてのユーザーが、ブローカーとすべての実行グループに対するすべてのアクションを実行できます。

ブローカー管理セキュリティーが無効になると、Web ユーザーは、データおよびブローカー・リソースへのアクセス権限が無制限のデフォルト・ユーザーとして、Web ユーザー・インターフェースにアクセスできます。

セキュリティーの使用について詳しくは、管理セキュリティーの概要および管理のためのユーザーへの権限の付与を参照してください。
-e sharedWorkPath
(オプション) この値を設定すると、マルチインスタンス・モードでブローカーを操作できるようになります。
ブローカーを開始する前に、ブローカーがこのネットワーク・ストレージ場所にアクセスできることを確認する必要があります。 また、ブローカーのキュー・マネージャーが WebSphere MQ マルチインスタンス・キュー・マネージャーとして構成されていることを確認する必要があります。 この共有ディレクトリーには、次のような情報が格納されます。
  • ブローカー・レジストリー
  • コンポーネント・ディレクトリー
  • デプロイされるメッセージ・フロー用の内部ブローカー表およびファイル
  • 構成可能なサービス・プロパティー。
-d
(オプション) キュー・マネージャーが始動および停止するときに、ブローカーが WebSphere MQ サービスとして始動および停止するようにするかどうかを指定します。

このオプションは、mqsistart コマンドを使用してマルチインスタンス・ブローカーを待機モードで始動することの代替となります。

-d defined を指定すると、WebSphere MQ サービスがキュー・マネージャーに定義されて、キュー・マネージャーが開始および停止するときにブローカーも開始および停止するようになります。

-d undefined を指定すると、WebSphere MQ サービスはキュー・マネージャーに定義されず、キュー・マネージャーが開始および停止するときにブローカーは開始および停止しなくなります。 これはデフォルト設定です。

-b cachePolicy
(オプション) キャッシュ・マネージャーで使用するポリシー。 このパラメーターは、defaultdisablednone、または XML ポリシー・ファイルの完全修飾名に設定します。
  • default を指定した場合、デフォルト・キャッシュ・ポリシーが使用されます。
  • disabled を指定した場合、ブローカーのグローバル・キャッシュ・コンポーネントは使用不可になります。 このキャッシュは、デフォルトでは使用不可に設定されています。
  • none を指定した場合、自分で設定した値が各実行グループのキャッシュ・マネージャーで使用されます。 ブローカー・レベルのポリシーによって最後に設定された実行グループ・プロパティーが、カスタマイズの開始点として保持されます。
  • ポリシー・ファイルの完全修飾名を指定する場合、ポリシー・ファイルにリストされるブローカーは、グローバル・キャッシュでデータを共用するように構成されます。 パスは、相対パスではなく、絶対パスでなければなりません。
-r cachePortRange
(オプション) キャッシュ・マネージャーが使用するポートの範囲。 このパラメーターを generate または特定のポート範囲に設定します。
  • ポートの範囲を指定する場合、このパラメーターの値を xxxx-yyyy という形式にする必要があり、範囲には少なくとも 20 個のポートを含める必要があります。
  • generate を指定した場合、ブローカーは、そのコンピューター上の他のブローカーによって使用されていないポートから成る範囲を生成します。 ブローカーは、2800 から始まる範囲を選択します。 例えば、別のブローカーがポート 2800 から 2819 までを使用している場合、ブローカーは 2820 から 2839 までの範囲を生成します。
変更の始まり-B brokerDomainGroup変更の終わり
変更の始まり(オプション) このパラメーターを使用して、複数インスタンス・ブローカーの sharedWorkPath にあるファイルを保護するために使用される Windows ドメイン・グループを設定します。これは、-e を指定する場合にのみ使用してください。変更の終わり
変更の始まり-Q queueManagerDomainGroup変更の終わり
変更の始まり(オプション) このパラメーターを使用して、複数インスタンス・ブローカーの sharedWorkPath にある WebSphere MQ・ファイルを保護するために使用される Windows ドメイン・グループを設定します。 これは、-e を指定する場合にのみ使用してください。キュー・マネージャーが存在しない場合はキュー・マネージャーを作成する必要があります。変更の終わり

トラステッド・アプリケーションとして実行するブローカーを作成します。
mqsicreatebroker MB8BROKER -i wbrkuid -a wbrkpw -q MB8QMGR -t
ユーザー出口を参照するブローカーを作成します。
mqsicreatebroker MB8BROKER -i wbrkuid -a wbrkpw 
	-q MB8QMGR -x /opt/3rdparty/wmbexits
管理セキュリティーを使用可能にしてブローカーを作成します。
mqsicreatebroker MB8BROKER -q MB8QMGR -s active
Scale モードでブローカーを作成します。
mqsicreatebroker MB8BROKER -q MB8QMGR -o scale 
特記事項 | 商標 | ダウンロード | ライブラリー | サポート | フィードバック

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

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


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