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

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

mqsichangebroker コマンド - z/OS

z/OS®mqsichangebroker コマンドを使用して、 ブローカーを変更します。

構文

z/OS コマンド - BIPCHBK

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

>--+----------------------------------+------------------------->
   '- -g --ConfigurationChangeTimeout-'   

>--+------------------------------------+----------------------->
   '- -k --InternalConfigurationTimeout-'   

>--+------------------------+----------------------------------->
   '- -P --HTTPListenerPort-'   

>--+-------------------------------+---------------------------->
   '- -v --StatisticsMajorInterval-'   

>--+------------------------------------------+----------------->
   '- -y--LdapPrincipal-- -z--LdapCredentials-'   

>--+------------------------+--+--------------------+----------->
   '- -c --ICUConverterPath-'  '- -x --UserExitPath-'   

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

>--+--------------------+--+-------------------+---------------->
   '- -s --+-active---+-'  '- -b --cachePolicy-'   
           '-inactive-'                            

>--+----------------------+------------------------------------><
   '- -r --cachePortRange-'   

z/OS コンソール・コマンド

同義語: cb

構文図を読む構文図をスキップする
                     .------------------------------------.   
                     V                                    |   
>>-+-changebroker-+----+-g=ConfigurationChangeTimeout---+-+----->
   '-cb-----------'    +-k=InternalConfigurationTimeout-+     
                       +-l=UserLilPath -----------------+     
                       +-v=StatisticsMajorinterval------+     
                       '-P=HTTPListenerPort-------------'     

>--+------------------------------------+----------------------->
   '-y=LdapPrincipal--z=LdapCredentials-'   

>--+--------------------+--+----------------+------------------->
   '-c=ICUConverterPath '  '-x=UserExitPath-'   

>--+-------------------+--+------------------+------------------>
   '-e=ActiveUserExits-'  '-f=function_level-'   

>--+-------------------+--+---------------+--------------------->
   '-s=security_status-'  '-b=cachePolicy-'   

>--+------------------+----------------------------------------><
   '-r=cachePortRange-'   

パラメーター

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

このパラメーターは、コマンドのコンソール・フォームでは暗黙指定されます。

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

この名前には大/小文字の区別があります。大/小文字混合の場合は名前を単一引用符で囲んでください。

このパスに環境変数は含めないでください。WebSphere® Message Broker は環境変数を無視します。

独自のディレクトリーを作成して、.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 です。

ゼロ分のインターバルは、外部通知手段 (ENF タイマー) が装備されているため、オペレーティング・システムでは WebSphere Message Broker の内部タイマーを使用しないことを示します。

-y LdapPrincipal
(オプション。ただし、ldapCredentials が提供されている場合は必須)。 JMS プロバイダー用の JNDI 管理の初期コンテキストを保有するオプションの LDAP ディレクトリーにアクセスするためのユーザー・プリンシパル。
-z LdapCredentials
(オプション。ただし、ldapPrincipal が提供されている場合は必須)。 LDAP にアクセスするためのユーザー・パスワード。
-c ICUConverterPath
(オプション) 追加のコード・ページ・コンバーターを検索する、区切り文字で区切られたディレクトリーの集合。区切り文字は、ピリオド (.) です。
コード・ページ・コンバーターは、codepagename.cnv の形式であるか、または icudt48.dat という ICU データ・パッケージ内に入っていなければなりません。 コード・ページ・コンバーターは、指定のディレクトリーの icudt48_<platform_suffix> というサブディレクトリーになければなりません。 <platform_suffix> は、以下の値のいずれかとなります。
  • l (リトル・エンディアン ASCII プラットフォーム)
  • b (ビッグ・エンディアン ASCII プラットフォーム)
  • e (EBCDIC プラットフォーム)
バージョン 6.0 以上によって提供されている組み込みコンバーターの 1 つと一致するコンバーターを使用しており、そのコンバーターがブローカーのローカル・コード・ページである場合は、このパラメーターを使用してコンバーターのパスを設定しないでください。 代わりに ICU_DATA 環境変数を使用してください。
-x UserExitPath
(オプション) このブローカー内の実行グループに対してロードされるすべてのユーザー出口の場所が含まれるパスです。 このパスは、実行グループ・プロセスの場合にのみ、システム・ライブラリーの検索パス (PATH,LIBPATH,LD_LIBRARY_PATH,SHLIBPATH) に追加されます。
-e ActiveUserExits
(オプション) アクティブ・ユーザー出口。 デフォルトでは、ユーザー出口は非アクティブです。このコロン区切りリストに userExit 名を追加することにより、このブローカーに対するデフォルト状態をアクティブに変更します。 mqsichangeflowuserexits コマンドを使用すると、実行グループまたはメッセージ・フロー・レベルのデフォルトの状態をオーバーライドできます。 ユーザー出口名を指定していて、実行グループが開始されたときに、そのユーザー出口が指定されたライブラリーが見つからない場合は、BIP2314 メッセージがシステム・ログに書き込まれます。 実行グループの開始が失敗します。
-f function level
(オプション) このパラメーターを使用して、WebSphere Message Broker フィックスパックで使用可能になった関数を有効にします。 設定できる有効な値は、all (すべての関数を有効にする)、または形式が V.R.M.F のバージョン・ストリング (例えば、8.0.0.2、有効にするフィーチャー関数の最大レベルを示す) です。 このパラメーターを使用して以前のフィックスパック・レベルに戻すことができますが、その前にまず、新しい関数を使用しているすべてのフローを除去する必要があります。

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

-s security_status
(オプション) ブローカーの管理セキュリティー状況を変更するには、このパラメーターを指定します。
  • active を指定すると、ブローカーの管理セキュリティーが使用可能になります。 コマンドは、必要な許可キューがまだ存在していない場合に、それらを作成します。
  • inactive を指定すると、ブローカーの管理セキュリティーが使用不可になります。 コマンドは、このブローカーとその実行グループに関連したセキュリティー・キューを削除したり消去したりしません。
このパラメーターを省略すると、セキュリティー状況は変更されません。
セキュリティーの使用について詳しくは、管理セキュリティーの概要および管理のためのユーザーへの権限の付与を参照してください。
-b cachePolicy
(オプション) キャッシュ・マネージャーで使用するポリシー。 このパラメーターは、defaultdisablednone、または XML ポリシー・ファイルの完全修飾名に設定します。
  • default を指定した場合、デフォルト・キャッシュ・ポリシーが使用されます。
  • disabled を指定した場合、ブローカーのグローバル・キャッシュ・コンポーネントは使用不可になります。 このキャッシュは、デフォルトでは使用不可に設定されています。
  • none を指定した場合、自分で設定した値が各実行グループのキャッシュ・マネージャーで使用されます。 ブローカー・レベルのポリシーによって最後に設定された実行グループ・プロパティーが、カスタマイズの開始点として保持されます。
  • ポリシー・ファイルの完全修飾名を指定する場合、ポリシー・ファイルにリストされるブローカーは、グローバル・キャッシュでデータを共用するように構成されます。 パスは、相対パスではなく、絶対パスでなければなりません。
-r cachePortRange
(オプション) キャッシュ・マネージャーが使用するポートの範囲。 このパラメーターを generate または特定のポート範囲に設定します。
  • ポートの範囲を指定する場合、このパラメーターの値を xxxx-yyyy という形式にする必要があり、範囲には少なくとも 20 個のポートを含める必要があります。
  • generate を指定した場合、ブローカーは、そのコンピューター上の他のブローカーによって使用されていないポートから成る範囲を生成します。 ブローカーは、2800 から始まる範囲を選択します。 例えば、別のブローカーがポート 2800 から 2819 までを使用している場合、ブローカーは 2820 から 2839 までの範囲を生成します。

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

コンソール・コマンドを実行すると、各コマンド・オプションの間にコンマを使用する必要があります。

構成タイムアウト・パラメーターを以下のように変更します。
F MQP1BRK,cb g=100,k=200
ユーザー出口パスを設定し、出口をアクティブ状態に設定するには、x および e パラメーターの両方を指定します。
/f MA05BRK,cb x='/u/test/wbi/MsgFlowTrackingUserExit/zOS',e='MqsiStrUserExit02:MqsiStrUserExit03'
以下のように、WebSphere Message Broker バージョン 8.0.0.2 で提供されている新機能を使用可能にします。
F MQP1BRK,cb f=8.0.0.2
ブローカーのセキュリティー状況を active に設定し、この変更後に要求されるアクションを完了するための正しい権限をユーザーが持っていることをブローカーが検査できるようにします。
mqsichangebroker MB8BROKER -s active
特記事項 | 商標 | ダウンロード | ライブラリー | サポート | フィードバック

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

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


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