DEFINE_TRACE

[アーティクル]
07/21/2023

DEFINE_TRACE 動詞は、指定された API のトレースを有効または無効にし、トレースの量を制御します。

次の構造体に、DEFINE_TRACE 動詞で使用される Verb 制御ブロック (VCB) を示します。

構文

  
struct define_trace {  
    unsigned short       opcode;  
    unsigned char        opext;  
    unsigned char        reserv2;  
    unsigned short       primary_rc;  
    unsigned long        secondary_rc;  
    unsigned char        reserv3[8];  
    unsigned char        dt_set;  
    unsigned char        appc;  
    unsigned char        reserv4;  
    unsigned char        srpi;  
    unsigned char        sdlc;  
    unsigned char        tkn_rng_dlc;  
    unsigned char        pcnet_dlc;  
    unsigned char        dft;  
    unsigned char        acdi;  
    unsigned char        reserv5;  
    unsigned char        ehllapi;  
    unsigned char        x25_api;  
    unsigned char        x25_dlc;  
    unsigned char        twinax;  
    unsigned char        reserv6;  
    unsigned char        lua_api;  
    unsigned char        etherand;  
    unsigned char        subsym;  
    unsigned char        reserv7[8];  
    unsigned char        reset_trc;  
    unsigned short       trunc;  
    unsigned short       strg_size;  
    unsigned char        reserv8;  
    unsigned char        phys_link[8];  
    unsigned char        reserv9[56];  
};

メンバー

opcode
指定されたパラメーター。操作コードを識別する動詞、SV_DEFINE_TRACE。

opext
予約済みフィールド。

reserv2
予約済みフィールド。

primary_rc
返されたパラメーター。動詞の完了時に APPC によって設定されるプライマリリターンコードを指定します。有効なリターンコードは、発行された APPC 動詞によって異なります。この動詞の有効なエラーコードについては、「リターンコード」を参照してください。

secondary_rc
返されたパラメーター。動詞の完了時に APPC によって設定されるセカンダリリターンコードを指定します。有効なリターンコードは、発行された APPC 動詞によって異なります。この動詞の有効なエラーコードについては、「リターンコード」を参照してください。

reserv3
予約済みフィールド。

dt_set
指定されたパラメーター。トレース状態を設定します。

API に関連するパラメーター (appc や comm_serv など) が SV_CHANGE に設定されている場合は、SV_ON を使用して、特定の API のトレースを有効にします。
API に関連するパラメーターが SV_CHANGE に設定されている場合は、SV_OFF を使用して、特定の API のトレースを無効にします。

appc
指定されたパラメーター。 APPC のトレースが必要かどうかを示します。

SV_CHANGE を使用して、 dt_set パラメーターに応じて、APPC のトレースを有効または無効にします。
SV_IGNORE を使用して、トレースを APPC の現在の状態にしておきます。

許可値は、ビット 0 をオンまたはオフにします。ビット 1 ～ 7 は予約されています。

reserv4
予約済みフィールド。

srpi
指定されたパラメーター。 SRPI のトレースが必要かどうかを示します。

SV_CHANGE を使用して、 dt_set パラメーターに応じて、APPC のトレースを有効または無効にします。
SV_IGNORE を使用して、トレースを APPC の現在の状態にしておきます。

sdlc
予約済みフィールド。

tkn_rng_dlc
予約済みフィールド。

pcnet_dlc
予約済みフィールド。

dft
予約済みフィールド。

acdi
予約済みフィールド。

reserv5
予約済みフィールド。

comm_serv
指定されたパラメーター。 COMM_SERV_API のトレースが必要かどうかを示します。

SV_CHANGE を使用して、 dt_set パラメーターに応じて、APPC のトレースを有効または無効にします。
SV_IGNORE を使用して、トレースを APPC の現在の状態にしておきます。

ehllapi
予約済みフィールド。

x25_api
予約済みフィールド。

x25_dlc
予約済みフィールド。

twinax
予約済みフィールド。

reserv6
予約済みフィールド。

lua_api
予約済みフィールド。

etherand
予約済みフィールド。

subsym
予約済みフィールド。

reserv7
予約済みフィールド。

reset_trc
指定されたパラメーター。トレースファイルポインターをリセットする必要があるかどうかを示します。

トレースファイルポインターをトレースファイルの先頭にリセットしないようにするには、SV_NO を使用します。以前のトレースレコードは上書きされません。
トレースファイルポインターをトレースファイルの先頭にリセットするようにするには、SV_YES を使用します。以前のトレースレコードは上書きされます。

trunc
指定されたパラメーター。各トレースレコードの最大バイト数を指定します。余分なバイトは切り捨てられます。切り捨てが不要な場合は、この値を 0 に設定します。

strg_size
予約済みフィールド。

reserv8
予約済みフィールド。

phys_link
予約済みフィールド。

reserv9
予約済みフィールド。

リターンコード

SV_OK
プライマリリターンコード。動詞は正常に実行されました。

SV_PARAMETER_CHECK
プライマリリターンコード。パラメーターエラーのため、動詞は実行されませんでした。

SV_INVALID_RESET_TRACE
セカンダリリターンコード。 reset_trc パラメーターに無効な値が含まれています。

SV_INVALID_SET
セカンダリリターンコード。 dt_set パラメーターに無効な値が含まれています。

SV_STATE_CHECK
プライマリリターンコード。動詞は無効な状態で発行されたため、実行されませんでした。

SV_COPY_TRACE_IN_PROGRESS
セカンダリリターンコード。以前に発行された COPY_TRACE_TO_FILE がまだ進行中です。 DEFINE_TRACE の使用中はトレースをアクティブにできません。

SV_COMM_SUBSYSTEM_NOT_LOADED
プライマリリターンコード。動詞の処理中に、必要なコンポーネントを読み込めなかったか、終了できませんでした。そのため、通信を行うことができませんでした。是正措置については、システム管理者に問い合わせてください。

SV_INVALID_VERB
プライマリリターンコード。opcode パラメーターが、どの動詞の操作コードとも一致しませんでした。動詞は実行されませんでした。

SV_INVALID_VERB_SEGMENT
プライマリリターンコード。VCB がデータセグメントの終わりを越えています。

SV_UNEXPECTED_DOS_ERROR
プライマリリターンコード。次のいずれかの条件が発生しました。

Microsoft® Windows® システムで、動詞の処理中にエラーが発生しました。オペレーティングシステムのリターンコードが、セカンダリリターンコード経由で返されました。問題が解決しない場合は、システム管理者に是正措置について問い合わせてください。
より一般的な Windows PostMessage 関数呼び出しではなく、Windows SendMessage 関数呼び出しを発行している別のアプリケーションによって呼び出されたメッセージループから、CSV が発行されました。動詞処理を行うことはできません。
SendMessage によってアプリケーションが呼び出されたときに CSV が発行されました。アプリケーションが SendMessage で呼び出されているかどうかを確認するには、InSendMessage Windows API 関数呼び出しを使用します。

解説

トレースの実行方法と使用方法の詳細については、製品の適切なマニュアルを参照してください。

次の方法で共有

DEFINE_TRACE

構文

メンバー

リターンコード

解説

その他のリソース

次の方法で共有

DEFINE_TRACE

構文

メンバー

リターン コード

解説

その他のリソース

リターンコード