mqsichangeflowuserexits コマンド

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

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

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

目的

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

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

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

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

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

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

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

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

許可

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

関連概念
ユーザー出口
特記事項 | 商標 | ダウンロード | ライブラリー | サポート | フィードバック

Copyright IBM Corporation 1999, 2009Copyright IBM Corporation 1999, 2009.
最終更新 : 2009-02-20 12:44:21

an35900_