mqsichangebroker コマンド - Linux および UNIX システム

Linux および UNIX システムで mqsichangebroker コマンドを使用して、ブローカーを変更します。

構文

構文図を読む構文図をスキップする
>>-mqsichangebroker-- BrokerName -+-----+----------------------->
                                  +- -t +   
                                  '- -n '   

>--+------------------+--+---------------------------------+---->
   '- -l -userLilPath-'  '- -g -configurationChangeTimeout-'   

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

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

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

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

>--+-------------------------+--+-------------------+----------->
   '- -c -ICU converter path-'  '- -x -userExitPath-'   

>--+----------------------+--+---------------------+------------>
   '- -e -activeUserExits-'  '- -f -function level-'   

>--+-------------------+--+--------------------+---------------->
   '- -s -+-active---+-'  '- -d -+-defined---+-'   
          '-inactive-'           '-undefined-'     

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

パラメーター

BrokerName

(必須) このパラメーターは、最初のパラメーターでなければなりません。 変更するブローカーの名前を指定します。

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

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

-n

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

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

Linux および UNIX システムでは、ディレクトリー名は大/小文字を区別します。名前が大/小文字混合の場合は、名前を単一引用符で囲んでください。

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

独自のディレクトリーを作成して、.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 ICU converter path
(オプション) 追加のコード・ページ・コンバーターを検索する、コロン (:) で区切られたディレクトリーの集合。
コード・ページ・コンバーターは、codepagename.cnv の形式であるか、または icudt38.dat という ICU データ・パッケージ内に入っていなければなりません。 コード・ページ・コンバーターは、指定のディレクトリーの icudt38_<platform_suffix> というサブディレクトリーになければなりません。 <platform_suffix> は、以下の値のいずれかとなります。
  • l (リトル・エンディアン ASCII プラットフォーム)
  • b (ビッグ・エンディアン ASCII プラットフォーム)
  • e (EBCDIC プラットフォーム)
-x userExitPath
(オプション) このブローカー内の実行グループに対してロードされるすべてのユーザー出口の場所が含まれるパスです。このパスは、実行グループ・プロセスの場合にのみ、システム・ライブラリーの検索パス (PATH,LIBPATH,LD_LIBRARY_PATH,SHLIBPATH) に追加されます。
-e activeUserExits
(オプション) アクティブ・ユーザー出口。デフォルトでは、ユーザー出口は非アクティブです。このコロン区切りリストに userExit 名を追加することにより、このブローカーに対するデフォルト状態をアクティブに変更します。 mqsichangeflowuserexits コマンドを使用すると、実行グループまたはメッセージ・フロー・レベルのデフォルトの状態をオーバーライドできます。 ユーザー出口名を指定していて、実行グループが開始されたときに、そのユーザー出口が指定されたライブラリーが見つからない場合は、BIP2314 メッセージがシステム・ログに書き込まれます。実行グループの開始が失敗します。
-f function level
(オプション) このパラメーターを使用して、WebSphere Message Broker フィックスパックで使用可能になった関数を有効にします。 設定できる有効な値は、all (すべての関数を有効にする)、または形式が V.R.M.F のバージョン・ストリング (例えば、7.0.0.2、有効にするフィーチャー関数の最大レベルを示す) です。

このコマンドは、新規のすべてのフィーチャーを使用不可にするわけではありません。またこのフラグは、異なるメジャー・バージョンのブローカーを実行するために使用することはできません。

-s security_status
(オプション) ブローカーの管理セキュリティー状況を変更するには、このパラメーターを指定します。
  • active を指定すると、ブローカーの管理セキュリティーが使用可能になります。コマンドは、必要な許可キューがまだ存在していない場合に、それらを作成します。
  • inactive を指定すると、ブローカーの管理セキュリティーが使用不可になります。コマンドは、このブローカーとその実行グループに関連したセキュリティー・キューを削除したり消去したりしません。
このパラメーターを省略すると、セキュリティー状況は変更されません。
セキュリティーの使用について詳しくは、ブローカー管理セキュリティーの概要およびブローカー管理のためのユーザーへの権限付与を参照してください。
-d
(オプション) キュー・マネージャーが始動および停止するときに、ブローカーが WebSphere MQ サービスとして始動および停止するようにします。

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

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

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

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

他のブローカー・プロパティーを変更するには、まずブローカーを削除して再作成してから、WebSphere Message Broker Toolkit を使用してブローカー構成を再デプロイします。ブローカーが、デプロイされたメッセージ・フローから 1 つ以上のデータベースにアクセスするために使用するユーザー ID 証明書を更新する場合は、mqsisetdbparms コマンドを使用します。 詳しくは、メッセージ・フローからデータベースへのアクセスを参照してください。

例

以下のように、ユーザー定義出口へのパスを定義します。
mqsichangebroker MB8BROKER -x /opt/3rdparty/wmbexit
以下のように、WebSphere Message Broker バージョン 7.0.0.4 で提供されている新機能を使用可能にします。
mqsichangebroker MB8BROKER -f 7.0.0.4
ブローカーのセキュリティー状況を active に設定し、この変更後に要求されるアクションを完了するための正しい権限をユーザーが持っていることをブローカーが検査できるようにします。
mqsichangebroker MB8BROKER -s active
ブローカーの WebSphere MQ 状況を defined に設定して、 関連付けられたキュー・マネージャーが開始および停止するときにブローカーが開始および停止するようにします。
mqsichangebroker MB8BROKER -d defined
WebSphere MQ サービス状況を undefined に設定して、関連付けられたキュー・マネージャーが開始および停止するときにブローカーが開始および停止しなくなるようにします。 ブローカーは、mqsistart コマンドを使用するときにのみ始動します。
mqsichangebroker MB8BROKER -d undefined
特記事項 | 商標 | ダウンロード | ライブラリー | サポート | フィードバック

Copyright IBM Corporation 1999, 2012Copyright IBM Corporation 1999, 2012.

        
最終更新

        最終更新 : 2012-07-13 15:43:32


参照トピック参照トピック | バージョン 8.0.0.1 | an28145_