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

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

mqsichangeflowuserexits コマンド

mqsichangeflowuserexits コマンドを使用して、アクティブまたは非アクティブ・ユーザー出口のリストを設定します。 アクティブ・ユーザー出口と非アクティブ・ユーザー出口のリストは、実行グループおよびメッセージ・フローごとに保守されます。 特定のフローのユーザー出口の有効な状態は、フローの開始時に決定されます。

サポートされるオペレーティング・システム

  • Windows
  • Linux および UNIX システム
  • z/OS®. このコマンドは、コンソール・コマンドとして実行するか、または BIPCHUE ユーティリティーをカスタマイズして実行依頼することにより実行します。ブローカー PDSE の内容を参照してください。

目的

優先順位は、メッセージ・フロー、実行グループ、ブローカー・デフォルトの順です。 アクティブ・リストは、メッセージ・フローおよび実行グループ設定の非アクティブ・リストに優先します。

メッセージ・フローの特定のユーザー出口の状態が設定されていない場合、その状態は実行グループ設定から取られます。 メッセージ・フローまたは実行グループの状態が設定されていない場合、暗黙的に非アクティブのデフォルト状態が使用されます。または、mqsichangebroker コマンドを介して、ブローカー・プロパティー activeUserExits で明示的にアクティブと定義することができます。

メッセージ・フローまたは実行グループのアクティブ・リストと非アクティブ・リストの両方に特定のユーザー出口名が存在する場合、アクティブ・リストが優先され、ユーザー出口はそのレベルでアクティブになります。 したがって、ユーザー出口をアクティブから非アクティブに変更する場合は、-i フラグを使用してユーザー出口を非アクティブ・リストに属するものとして指定すると同時に、-a フラグを使用して新しいアクティブ・リストを再指定し、ユーザー出口をアクティブ・リストから除去する必要があります。

特定のフローで複数の出口がアクティブになっている場合、それらの出口は定義された順序で起動されます。 最初にメッセージ・フローのアクティブ・リスト内の出口が、-a フラグで指定した順序で起動されます。

これらの出口の起動後に、実行グループのアクティブ・リスト内の出口 (メッセージ・フローのアクティブ・リストと非アクティブ・リストのいずれにも存在しない) が起動されます。 これらの出口は、-a フラグで指定した順序で起動されます。

ただし、ユーザー出口リストをクリアする場合は、そのクリアするユーザー出口リストに応じて、-i フラグまたは -a フラグで二重引用符を引数として使用する必要があります。

実行グループまたはメッセージ・フローのアクティブ・リストまたは非アクティブ・リストでは言及されておらず、ブローカーのアクティブ・リストに存在するすべてのユーザー出口は、ブローカー・プロパティー activeUserExits の設定時に指定された順序で起動されます。

アクティブ・リストまたは非アクティブ・リストに指定されているユーザー出口のいずれかがターゲット実行グループに登録されていない場合、コマンドは BIP8858 エラーで失敗します。

コマンドの正常終了後、ユーザー出口が無効になると、そのユーザー出口がどのリストにあるかに基づいて、以下のアクションが取られます。
  • ユーザー出口が、メッセージ・フローのアクティブ・リストまたは非アクティブ・リストに指定されている場合、フローは開始せず、BIP2315 メッセージがシステム・ログに書き込まれます。
  • ユーザー出口が、実行グループのアクティブ・リストまたは非アクティブ・リストに指定されている場合、実行グループは開始せず、BIP2314 メッセージがシステム・ログに書き込まれます。
ユーザー出口は、以下の 3 つのいずれかの理由で無効になる場合があります。
  • ユーザー出口ライブラリーが含まれているディレクトリーを削除して MQSI_USER_EXIT_PATH 変数を変更した後に、ブローカーまたは実行グループが再始動される。
  • ユーザー出口ライブラリーが含まれているディレクトリーを削除して userExitPath ブローカー・プロパティーを変更した後に、ブローカーまたは実行グループが再始動される。
  • ユーザー出口ライブラリー (または依存関係にあるもののいずれか) が除去されるか、ブローカーがそれをロードできない。
このコマンドの詳細については、社内のプラットフォームに適したリンクを選択してください。

許可

プラットフォーム固有の許可について詳しくは、以下のトピックを参照してください。 ブローカー管理セキュリティーを有効に設定した場合は、管理セキュリティーのタスクと権限で説明されている権限もセットアップする必要があります。
特記事項 | 商標 | ダウンロード | ライブラリー | サポート | フィードバック

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

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


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