DEFINE_TRACE動詞は、指定された API のトレースを有効または無効にし、トレースの量を制御します。
次の構造体では、 DEFINE_TRACE 動詞で使用される動詞制御ブロック (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];
};
メンバー
オペコード
指定されたパラメーター。 操作コードを識別する動詞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 のトレースが必要かどうかを示します。
- dt_set パラメーターに 応じて、SV_CHANGEを使用して APPC のトレースを有効または無効にします。
- SV_IGNOREを使用して、APPC のトレースを現在の状態のままにします。
使用できる値は、ビット 0 のオンとオフを切り替えます。ビット 1 から 7 は予約されています。
reserv4
予約済みフィールド。
srpi
指定されたパラメーター。 SRPI のトレースが必要かどうかを示します。
- dt_set パラメーターに 応じて、SV_CHANGEを使用して APPC のトレースを有効または無効にします。
- SV_IGNOREを使用して、APPC のトレースを現在の状態のままにします。
sdlc
予約済みフィールド。
tkn_rng_dlc
予約済みフィールド。
pcnet_dlc
予約済みフィールド。
dft
予約済みフィールド。
acdi
予約済みフィールド。
reserv5
予約済みフィールド。
comm_serv
指定されたパラメーター。 COMM_SERV_APIのトレースが必要かどうかを示します。
- dt_set パラメーターに 応じて、SV_CHANGEを使用して 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® システムでエラーが発生しました。 オペレーティング システムのリターン コードは、セカンダリ リターン コードを通じて返されました。 問題が解決しない場合は、修正措置についてシステム管理者に問い合わせてください。
- CSV は、より一般的な Windows PostMessage 関数呼び出しではなく、Windows SendMessage 関数呼び出しを発行する別のアプリケーションによって呼び出されたメッセージ ループから発行されました。 動詞の処理は実行できません。
- SendMessage がアプリケーションを呼び出したときに CSV が発行されました。 アプリケーションが SendMessage で呼び出されたかどうかを確認するには、 InSendMessage Windows API 関数呼び出しを使用します。
注釈
トレースを実行して使用する方法については、製品に適したマニュアルを参照してください。