トレーサーの現在のしきい値トレース レベルを返します。
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 | 「説明の読み方」を参照 |
「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 が前にしきい値を返した変数でチェックできます。