メイン コンテンツをスキップする 補完的コンテンツへスキップ
Qlik リソース

CDC 処理のコントロール

Data Movement gateway では、CDC 処理中に形成される R4Z CDC サービスと呼ばれる ECSA メモリ構造を使用しています。各 z/OS LPAR には、このような R4Z CDC サービスが複数含まれている場合があります。R4Z CDC サービスを形成するために、特別なユーティリティ プログラムである R4ZCTL が提供されています。

このプログラムは、CDC 処理の状態や z/OS 側のトラフィック レベルを管理するためにも使用できます。

次の目的には、R4Z コントロール プログラム (R4ZCTL ) が必要です: CDC のチェック、CDC サービスのステータスの報告、CDC 処理の一時停止、一時停止した CDC の再開、CDC 処理の正常終了または強制終了。

R4ZCTL プログラムを実行するときは、次のコマンド パラメーターを使用できます。

情報メモ

パラメーターなしでコマンドを実行すると、CDC サービスの現在のステータスが返されます。

  • CHECKCONFIG - コンフィギュレーション パラメーターが有効であることを確認します
  • PAUSE_TASK - 特定の CDC タスクのサービスを停止します
  • PAUSE_CDC - CDC サービスの全体のアクティビティを停止します
  • RESUME_TASK - 一時停止したタスクを続行できるようにします
  • RESUME_CDC - 一時停止した CDC サービスを続行できるようにします
  • TERMINATE - CDC サービスを停止し、停止後にそのリソースを解放します
  • FORCE - リソースを保持しているタスクが「ハング」した場合、TERMINATE と同じ

R4ZCTL プログラムは APF 許可を必要とするため、STEPLIB 内のすべてのライブラリは APF 許可されている必要があります。

パラメーターなしで R4ZCTL を実行すると、環境が初期化されている (CC=0) か初期化されていない (CC=1) かに基づいて、その完了コードが設定されます。

制御プログラム呼び出し構文

R4ZCTL プログラムは、ジョブ ステップ (つまり EXEC PGM=R4ZCTL) として呼び出され、ジョブ ステップの呼び出しパラメーターを介して指示を受け取ります。

R4ZCTL 呼び出しパラメーターは、次のようにカンマで区切られたオプションのサブパラメーターを含むことができる文字列です。

[SERVICE=CDC-service-qualifier,][MSGLVL={0 | 1},][action]

情報メモ

文字列内のサブパラメーターの順序は重要ではありません。

ここで、

SERVICE=CDC-service-qualifier は、制御プログラムが動作する Data Movement gateway アクティビティの論理的範囲を指定します。

MSGLVL={0 | 1 | 2} は、制御プログラムの動作中にメッセージ ファイルに表示される通知のレベルを指定します。

  • 0 = 通知なし
  • 1 = 標準
  • 2 = 最大

action-verb は次のいずれかになります。

  • PAUSE_TASK(*|ALL|task-qualifier)

    括弧内に指定されたタスクの CDC 取得を一時停止します。

  • PAUSE_CDC

    CDC サービス全体の CDC 取得を一時停止します。一定時間以上停止した Replicate タスクは、複数回にわたり回復を試みます。新しいタスクは提供されません。

  • RESUME_TASK(*|ALL|task-qualifier)

    task-qualifier によって指定されたタスクの CDC 取得を再開します。

  • RESUME_CDC

    session-limits 修飾子に一致するすべてのインスタンスの CDC 取得を再開します。

  • DUMP_TASK(*|ALL|task-qualifier)

    常駐メモリ構造内の制御情報のフォーマットされたダンプを要求します。 ALL はすべてのセッションを指定し、SUMMARYONLY はアンカーのみを指定します。

  • TERMINATE

    すべての R4Z 常駐メモリ構造を解放し、すべてのアクティブなインスタンスを終了させ、関連するリソースを削除します。この時点から、CDC リーダー UDF への着信によって CDC サービスが自動アクティブ化されるまで、すべての CDC 要求は非アクティブ ステータスを返します。

構文要素の参照

上記の構文の説明で使用される要素は次のとおりです。

  • CDC-service-qualifier

    CDC サービスを指定する 4 文字の名前 (最初の文字は英字、残りは英数字)。

    「CDC サービス」とは、メモリ構造、DB2 で定義されたユーザー定義テーブル関数 (UDTF)、WLM ポリシーで定義されたアプリケーション環境 (APPLENV) などのリソースのグループを指します。R4Z では、各 CDC サービスごとにプロパティ (メモリ制限や処理のしきい値) を指定できます。1 つの LPAR で使用される複数の Data Movement gateway リリースを提供し、それぞれが他のサービスとは独立してメモリ構造を維持するなどの理由で、複数の CDC サービスを管理する必要がある場合もあります。

  • task-qualifier

    タスクの開始時に割り当てられる 4 桁の識別子。この識別子は、主に特定のタスクの CDC トラフィックを制御および追跡することを目的としています。これは、CDC を提供する DB2 スレッドの CORRID (関連付け ID) を形成するために使用され、9〜12 バイトを占有しています。

制御プログラム完了コード

  • 0 – 正常な完了
  • 1 – 環境が session-limits 修飾子を終了しない (action が指定されていない場合)
  • 4 – 警告
  • 8 – エラー

サンプル ジョブ (INSTALL ライブラリ内)

IV1CHECK – すべての CDC サービスの構成を確認します

XMDUMP – すべてのセッションをダンプします

XMPAUSE – セッションを一時停止します

XMRESUME – セッションを再開します

XMTERMIN – すべてのセッションを終了します

CDC プロセスの有効化 (自動アクティブ化)

CDC リーダーの UDTF 関数を有効にするには、UDTF が呼び出されたときや z/OS システム開始後の最初のときに、この関数が ECSA でメモリ構造を割り当てて事前フォーマットできる必要があります。 また、UDTF が提供する CDC サービスに設定された構成 (CDC サービス レベルで指定されていない値の場合は「デフォルト」の構成) にアクセスする必要があります。

これを考慮し、インストール プロセスでは次のことが重要となります。

  1. CDC サービスを提供するために、特別な UDTF が作成されるようにする。作成された UDTF には、その名前の末尾に 2 つのアンダースコア ("__") が付けられ、その後に CDC-service-qualifier が続き、<schema>.R4Z_UDTF__<CDC-service-qualifier>という名前になります。
  2. 上記の UDTF の呼び出しを実行するために WLM APPLENV が作成されるようにする。作成された APPLENV には、APPLENV 名の一意性を確保するために、CDC サービス修飾子を付けた名前を付けることが推奨されますが、複数の UDTF が単一の APPLENV を使用することもできます。
  3. WLM APPLENV 実行を「ホスト」するための JCL プロシージャが作成されるようにする。この JCL プロシージャは通常の WLM STC プロシージャとは異なり、特別な DDNAME、R4ZCNFG を指定する必要があり、その DSN は R4Z 製品の CONFIG ライブラリを参照します。このライブラリには、デフォルトの CDC サービス構成を指定する「CDCS」という名前の既存のメンバーが存在する必要があります。この CDC サービスに適用する構成値を持つ「CDCS<CDC-service-qualifier>」という名前のメンバーも存在することができます。

  4. CONFIG ライブラリ内の各 CDCS* メンバーの内容が、カードごとに 1 つずつ、「キーワード = 値」という形式の割り当てステートメントのリストになるようにする。ステートメントはスペースに続くことができ、スペースで終了することもできます。 ステートメントにスペースを入れることはできません。ハイフン (「-」) で始まるカードはコメント カードとして処理されます。 終了のスペースに続く内容もコメントとして処理されます。

    キーワード、最大値、最小値、既定値
    キーワード 説明 最小 最大 既定

    MAXSESSIONS

    CDC セッションの最大数。

    1

    128

    32

    SESSIONTIMEOUTSECS

    セッションがタイムアウトになるまでの秒数。

    300

    7200

    900

    MAXIFIBUFKBYTES

    IFI 読み取りに許可される最大バッファー サイズ (KB 単位)。

    64

    1024

    256

    MAXRESULTSETMBYTES

    蓄積された結果セットが到達する最大サイズ (MB 単位)。 到達すると、結果セットが返されます。

    1

    2048

    4

    MAXRESULTSETSECS

    結果セットを蓄積する最大時間間隔 (秒単位)。 到達すると、結果セットが返されます。

    1

    120

    30

    R4Z CDC サービスの確立

    CDC サービスの決定: 独立したレプリケーション処理の必要性の予測 (バージョンの違いの許容、十分な ECSA メモリの確保、許容される異なる待機時間の考慮など) に基づき、各 LPAR に存在する R4Z CDC サービスを決定します。サービスごとに、CDC サービス修飾子 (4 文字) を選択します。また、各 CDC サービスに独自の WLM APPLENV (アプリケーション環境) を持たせるか、単一の APPLENV ですべての CDC サービスを提供するかを決定する必要があります。

    DFSYMLST メンバーの変数 DEFWLMAE (DEFine WLM Applic. Env.) を、PER (1 つ目のオプション) または ONE (2 つ目のオプション) に設定する必要があります。設定したら、インストールを続行できます。

    情報メモ

    • DEFWLMAE に ONE を選択した場合、ジョブ DO2* および DO3SRVTF を 1 回実行する必要があります。PER を選択した場合、これらのジョブは、JCL SET 変数 CDCSRV が CDC サービスの修飾子に設定された後、CDC サービスごとに実行される必要があります。

    • ジョブ DO3SRVDF は、CONFIG ライブラリを作成し、デフォルトの構成ファイルとなる「CDCS」という名前のメンバーを配置します。ジョブ DO3SRVTF を実行すると、ライブラリにはすべての CDC サービスの構成が含まれるようになり、編集して特定の CDC サービスの構成を変更できるようになります。

    • DEFWLMAE に ONE を使用すると、CONFIG ライブラリ メンバーの代わりに製品の既定値が使用されます。

このページは役に立ちましたか?

このページまたはコンテンツに、タイポ、ステップの省略、技術的エラーなどの問題が見つかった場合は、お知らせください。改善に役立たせていただきます。

こちらにフィードバックをお寄せください