COPY_TRACE_TO_FILE動詞は、個々の API/リンク サービス トレース ファイルを連結して 1 つのファイルを形成します。
次の構造体では、 COPY_TRACE_TO_FILE 動詞で使用される動詞制御ブロック (VCB) について説明します。
構文
struct copy_trace_to_file {
unsigned short opcode;
unsigned char opext;
unsigned char reserv2;
unsigned short primary_rc;
unsigned long secondary_rc;
unsigned char reserv3[8];
unsigned char file_name[64];
unsigned char file_option;
unsigned char reserv4[12];
};
メンバー
オペコード
指定されたパラメーター。 操作コードを識別する動詞SV_COPY_TRACE_TO_FILE。
opext
予約済みフィールド。
reserv2
予約済みフィールド。
primary_rc
返されたパラメーター。 動詞の完了時に APPC によって設定される主なリターン コードを指定します。 有効なリターン コードは、発行された APPC 動詞によって異なります。 この動詞の有効なエラー コードについては、リターン コードを参照してください。
secondary_rc
返されたパラメーター。 動詞の完了時に APPC によって設定されるセカンダリ リターン コードを指定します。 有効なリターン コードは、発行された APPC 動詞によって異なります。 この動詞の有効なエラー コードについては、リターン コードを参照してください。
reserv3
予約済みフィールド。
file_name
指定されたパラメーター。 トレース データのコピー先となるファイルの名前を指定します。 このパラメーターは 64 バイトの文字列であり、パスを含めることができます。 名前が 64 バイト未満の場合は、スペースを使用して右側に埋め込みます。
file_option
指定されたパラメーター。 出力ファイルのコピー オプションを指定します。
指定したファイルがまだ存在しない場合にのみ、SV_NEWを使用してトレースをコピーします。
SV_OVERWRITEを使用してトレースを既存のファイルにコピーし、現在のデータを上書きします。 ファイルのサイズは、必要に応じて大きくなります。ファイルがまだ存在しない場合は作成されます。
reserv4
指定されたデータが存在するアドレス。
リターン コード
SV_OK
プライマリ リターン コード。動詞が正常に実行されました。
SV_PARAMETER_CHECK
プライマリ リターン コード。パラメーター エラーのため、動詞が実行されませんでした。
SV_INVALID_FILE_OPTION
セカンダリ リターン コード。SV_NEWまたはSV_OVERWRITE以外の値が file_optionに指定されました。
SV_STATE_CHECK
プライマリ リターン コード。無効な状態で発行されたため、動詞は実行されませんでした。
SV_COPY_TRACE_IN_PROGRESS
セカンダリ リターン コード。以前に発行された COPY_TRACE_TO_FILE 動詞はまだ進行中です。
SV_TRACE_FILE_EMPTY
セカンダリ リターン コード。トレース ファイルにデータがありません。
SV_TRACE_NOT_STOPPED
セカンダリ リターン コード。動詞が発行されたときにトレースが進行中でした。
SV_COMM_SUBSYSTEM_NOT_LOADED
プライマリ リターン コード。動詞の処理中に必要なコンポーネントを読み込んだり終了したりできませんでした。 したがって、通信は行われませんでした。 修正措置については、システム管理者に問い合わせてください。
SV_FILE_ALREADY_EXISTS
プライマリ リターン コード。SV_NEW ファイル オプションが使用されたとき、指定されたファイル名は既存のファイルの名前でした。
SV_INVALID_VERB
プライマリ リターン コード。 opcode パラメーターが動詞の操作コードと一致しませんでした。 動詞は実行されません。
SV_INVALID_VERB_SEGMENT
プライマリ リターン コード。データ セグメントの末尾を超えて拡張された VCB。
SV_OUTPUT_DEVICE_FULL
プライマリ リターン コード。出力ファイルが存在するデバイスに十分な領域がありません。 追加のディスク領域を解放した後、操作を再試行してください。
SV_UNEXPECTED_DOS_ERROR
プライマリ リターン コード。次のいずれかの条件が発生しました。
動詞の処理中に、Microsoft Windows システムでエラーが発生しました。 オペレーティング システムのリターン コードは、セカンダリ リターン コードを通じて返されました。 問題が解決しない場合は、修正措置についてシステム管理者に問い合わせてください。
CSV は、より一般的な Windows PostMessage 関数呼び出しではなく、Windows SendMessage 関数呼び出しを発行する別のアプリケーションによって呼び出されたメッセージ ループから発行されました。 動詞の処理は実行できません。
SendMessage がアプリケーションを呼び出したときに CSV が発行されました。 アプリケーションが SendMessage で呼び出されたかどうかを確認するには、 InSendMessage Windows API 関数呼び出しを使用します。
注釈
API/link-service トレース ファイルは 2 つあります。 ファイルは別の方法で使用されます。トレースは、1 つのファイルがいっぱい (250K を超える) 場合に、1 つのファイルから他方のファイルに切り替えます。 COPY_TRACE_TO_FILE呼び出されると、これらのトレース ファイルが連結され、1 つのファイルにコピーされます。その名前は、呼び出しのパラメーターとして指定されます。
API/link-service トレースは動詞を発行する前に停止され、コピーが完了した後に再起動されます。 トレース ファイルは、この動詞が正常に完了するとリセットされます。