モニター・プログラムからのコマンドのサブミット

モニター・プログラムは、COMMAND 関数を呼び出して、計測機能インターフェースを介して Db2® コマンドを発行できます。この機能がとりわけ役立つのは、トレースを開始、停止、表示、および変更するコマンドをサブミットする場合です。

プログラム固有のプログラミング・インターフェース情報の開始

指定されたトレース・クラスおよび IFCID を使用して、モニター・プログラムは データの量およびタイプを制御することができます。 モニター・プログラムは、次の操作を実行できるように設計することができます。

  • 事前定義トレース・クラスの活動化および非活動化
  • トレース・レコードまたはレコードのグループ (IFCID により示される) の 活動化および非活動化
  • トレースを特定の ID のセット (プラン名、許可 ID、リソース・マネージャー ID (RMID) など) に制限した、事前定義トレース・クラスおよびトレース・レコード (IFCID により示される) の活動化および非活動化

コマンドが処理され、出力メッセージが戻り域の モニター・プログラムに戻されます。

IFI を介した非同期コマンド

コマンドは、非同期に実行することも、同期して実行することもできます。 IFCA でビットを設定して、IFI でのコマンドの実行方法を指定することができます。 これによって影響を受けるコマンドは以下のとおりです。

  • ALTER BUFFERPOOL
  • SET LOG
  • STOP DATABASE
  • SET SYSPARM

IFI を使用した Db2 コマンドの例

プログラム固有のプログラミング・インターフェース情報の開始
以下の例では、MONITOR クラス 1 について Db2 START TRACE コマンドが出されています。

図 1. IFI によるトレースの始動
CALL DSNWLI,('COMMAND ',IFCAAREA,RETAREA,OUTAREA,BUFAREA),VL
⋮
COMMAND DC CL8 'COMMAND '
************************************************************************
* Function parameter declaration                                       *
************************************************************************
* Storage of LENGTH(IFCA) and properly initialized                     *
************************************************************************
IFCAAREA  DS       0CL180
⋮
************************************************************************
* Storage for length and returned info.                                *
************************************************************************
RETAREA   DS      CL608
************************************************************************
* Storage for length and Db2 Command                                   *
************************************************************************
OUTAREA   DS      0CL42
OUTLEN    DC      X'002A0000'
OUTCMD    DC      CL38'-STA TRAC(MON) DEST(OPX) BUFSIZE(1024)'
************************************************************************
* Storage of LENGTH(WBUF) and properly initialized                     *
************************************************************************
BUFAREA  DS       0CL16
⋮

プログラム固有のプログラミング・インターフェース情報の終了