トレーサーの現在のしきい値トレース レベルを返します。
構文：
call "CBL_CTF_TRACER_LEVEL_GET" using by value flags
by reference component-id
by reference trace-level
returning status-code
パラメーター：
| |
呼び出しプロトタイプ使用時 (「説明の読み方」を参照)
|
PIC |
| flags |
cblt-x4-comp5 |
pic x(4) comp-5 |
| component-id |
pic x(n) |
pic x(n) |
| trace-level |
cblt-x4-comp5 |
pic x(4) comp-5 |
| status-code |
「説明の読み方」を参照
|
|
入力パラメーター：
- flags
- 制御フラグ：
- ビット 0 から 29
- 将来使用するために予約されています。値は常に 0 です。
- ビット 30
-
| 値 |
意味 |
| 0 |
component-id は空白文字で終了します。
|
| 1 |
component-id は null で終了します。ビット 31 を設定していない場合は無視されます。
|
- ビット 31
-
| 値 |
意味 |
| 0 |
component-id は、CBL_CTF_TRACER_GET の呼び出しから返される pic x(4) comp-5 トレーサー ハンドルです。
|
| 1 |
component-id は、pic x(n) テキスト文字列です。文字列の終了文字はビット 30 で定義されます。
|
- component-id
- コンポーネント識別子。flags のビット 31 が設定されていない場合は pic x(4) comp-5 トレーサー ハンドル (CBL_CTF_TRACER_GET から取得)、flags のビット 31 が設定されている場合は pic x(n) テキスト識別子になります。
- NULL または空の文字列を指定した場合はデフォルトのトレース レベルが返されます。
出力パラメーター：
- trace-level
- トレーサーのしきい値トレース レベルを示す値：
| 値 |
レベル |
| 0 |
デバッグ |
| 1 |
情報 |
| 2 |
警告 |
| 3 |
エラー |
| 4 |
致命的 |
| 0xFFFFFFFF |
トレースが有効になっていない |
- status-code
- 次のいずれかになります。
- 78-CTF-RET-INVALID-COMPONENT-NAME
- 78-CTF-RET-INVALID-TRACE-HANDLE
- 78-CTF-RET-NOT-ENOUGH-MEMORY
- 78-CTF-RET-SUCCESS
例：
「mycomp」コンポーネントのイベントをトレースするためのトレーサー ハンドルを取得した後、CBL_CTF_TRACER_LEVEL_GET を使用して、コンポーネントでトレース操作を実行する前に情報レベルのイベントをトレースするように構成されているかどうかを確認します。
copy "cbltypes.cpy".
copy "mfctf.cpy".
78 78-EVENT-TYPE-A value 1.
01 component-name pic x(7) value "mycomp".
01 flags pic x(4) comp-5.
01 trace-event cblt-trc-event.
01 trace-level pic x(4) comp-5.
01 tracer-handle pic x(4) comp-5.
...
call "CBL_CTF_TRACER_GET" using by value 0
by reference component-name
by reference tracer-handle
...
call "CBL_CTF_TRACER_LEVEL_GET" using by value 0
by reference component-name
by reference trace-level
if 78-CTF-FLAG-LEVEL-INFO >= trace-level
set up trace-info
compute flags = 78-CTF-FLAG-LEVEL-INFO
call “CBL_CTF_TRACE” using by value flags
by reference tracer-handle
by reference trace-event
end-if
...
説明：
通常、このルーチンは、CBL_CTF_TRACE に関係する負荷が高いトレース データのフォーマット処理を実行する前に呼び出します。
トレーサーの構成に対する変更を処理するためのコールバック関数を CBL_CTF_TRACER_NOTIFY を使用して登録してある場合、CBL_CTF_TRACER_LEVEL_GET は、トレースの初期化時としきい値トレース レベルが変更されたときにコールバック関数で呼び出すだけで済みます。
コンポーネントで現在のしきい値トレース レベルのチェックが必要になったときは、CBL_CTF_TRACER_LEVEL_GET が前にしきい値を返した変数でチェックできます。