目的
DLC トレース・チャネルのトレース・イベント (タイム・スタンプを含む) を記録します。
パラメーター
| 項目 |
説明 |
| Chan |
トレース・セッションのチャネル番号を指定します。 この番号は、 Trcstart サブルーチンから取得されます。 |
| HK ワード |
/usr/include/sys/trchkid.h ファイルに定義されたトレース・フック ID が入っています。 フック ID を使用して登録されるリンク・トレース項目のタイプには、以下のものがあります。
- HKWD_SYSX_DLC_START (WD_SYSX_DLC_START)
- リンク・ステーション完了の開始
- HKWD_SYSX_DLC_TIMER (WD_SYSX_DLC_TIMER)
- タイムアウトが完了しました
- HKWD_SYSX_DLC_XMIT (WD_SYSX_DLC_XMIT)
- 送信の完了
- _ 翻訳不要 _HKWD_SYSX_DLC_RECV
- 受信の完了
- HKWD_SYSX_DLC_HALT (WD_SYSX_DLC_HALT)
- リンク・ステーション停止の完了
|
| データ・ワード |
トレース・データ・フォーマット・フィールドを指定します。 このフィールドは、フック ID によって異なります。 これらの定義はそれぞれ、 /usr/include/sys/gdlextcb.h ファイルにあります。
- 最初のハーフワードには、以下のいずれかの定義を含むデータ・リンク・プロトコル・フィールドが常に含まれます。
- DLC_DL_SDLC
- SDLC
- DLC_DL_HDLC
- HDLC
- DLC_DL_BSC
- Bisync
- DLC_DL_ASC
- ASYNC
- DLC_DL_PCNET
- PC ネットワーク
- DLC_DL_ETHER
- 標準イーサネット
- DLC_DL_802_3
- IEEE 802.3
- DLC_DL_TOKEN
- トークンリング
|
| |
- リンク・ステーションの開始または停止が完了すると、2 番目のハーフワードには使用中の物理リンク・プロトコルが入ります。
- DLC_PL_EIA232
- EIA-232D 通信
- DLC_PL_EIA366
- EIA-366 自動ダイヤル
- DLC_PL_X21
- CCITT X.21 データ・ネットワーク
- DLC_PL_PCNET
- PC ネットワーク・ブロードバンド
- DLC_PL_ETHER
- 標準ベースバンド・イーサネット
- DLC_PL_スマート
- スマート・モデム自動ダイヤル
- DLC_PL_802_3
- IEEE 802.3 Baseband イーサネット
- DLC_PL_TBUS
- IEEE 802.4 トークン・バス
- DLC_PL_TRING
- IEEE 802.5 トークンリング
- DLC_PL_EIA422
- EIA-422 通信
- DLC_PL_V35
- CCITT V.35 通信
- DLC_PL_V25BIS
- CCITT V.25 Bis Autodial for Telecommunications (通信用 CCITT VTAM 自動ダイヤル)
|
| |
- タイムアウトの完了時には、次のハーフワードにタイムアウト発生のタイプが含まれます。
- DLC_TO_SLOW_POLL
- 低速ステーション・ポーリング
- DLC_TO_IDLE_POLL
- アイドル・ステーション・ポーリング
- DLC_TO_ABORT
- リンク・ステーションが打ち切られた
- DLC_TO_INACT
- リンク・ステーション受信非活動
- DLC_TO_FAILSAFE (送達不能コード)
- コマンド・フェイルセーフ
- DLC_TO_REPOLL_T1
- コマンド再ポーリング
- DLC_TO_ACK_T2
- I フレーム確認応答
|
| |
- 伝送が完了すると、2 番目のハーフワードは、送信されるデータ・リンク制御バイトに設定されます。 一部の送信パケットには、1 つの制御バイトしかありません。その場合、2 番目の制御バイトは表示されません。
- 受信が完了すると、2 番目のハーフワードは、受信されたデータ・リンク制御バイトに設定されます。 一部の受信パケットには 1 つの制御バイトしかありません。その場合、2 番目の制御バイトは表示されません。
|
| len |
ブフ パラメーターで指定された項目固有のデータの長さ (バイト単位) を指定します。 |
| buf |
以下のものから構成される項目固有のデータへのポインターを指定します。
- リンク・ステーション完了の開始
- リンク・ステーション診断タグおよびリモート・ステーションの名前とアドレス。
- タイムアウトになった完了
- 特定のデータは記録されません。
- 送信完了数
- ショート/ロング・トレース・オプションに応じて、最初の 80 バイトまたはすべての送信データのいずれか。
- 完了の受信
- ショート/ロング・トレース・オプションに応じて、最初の 80 バイトまたはすべての受信データのいずれか。
- リンク・ステーション完了の停止
- リンク・ステーション診断タグ、リモート・ステーションの名前とアドレス、および結果コード。
|
説明
指定されたトレース・チャネルのトレース・セッションがアクティブな場合、 Trcgenkt カーネル・サービスはトレース・イベントを記録します。 トレース・セッションがアクティブでない場合、 Trcgenkt カーネル・サービスは単に戻ります。 Trcgenkt カーネル・サービスは、固定されたカーネル・メモリー内にあります。
Trcgenkt カーネル・サービスは、 HK ワード 項目、 データ・ワード 項目、可変数のバイト数のトレース・データ、およびタイム・スタンプで構成されるトレース項目を記録するために使用されます。
実行環境
Trcgenkt カーネル・サービスは、 処理 環境または 割り込み 環境のいずれかから呼び出すことができます。
戻り値
Trcgenkt カーネル・サービスには戻り値はありません。