COPY_TRACE_TO_FILE動詞串連個別 API/鏈接服務追蹤檔案，以形成單一檔案。
下列結構描述 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];
};
成員
opcode
提供的參數。 識別作業程式代碼的動詞，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
次要傳回碼;為 file_option指定了 SV_NEW 或 SV_OVERWRITE 以外的值。
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 SendMessage 函式呼叫的另一個應用程式叫用的訊息循環發出，而不是較常見的 Windows PostMessage 函式呼叫。 無法進行動詞處理。
SendMessage 叫用您的應用程式時發出 CSV。 您可以使用 InSendMessage Windows API 函數呼叫，判斷是否已使用 SendMessage 叫用應用程式。
備註
有兩個 API/link-service 追蹤檔案。 檔案會交替使用;當一個檔案已滿時，追蹤會從一個檔案切換到另一個檔案（大於 250K）。 呼叫 COPY_TRACE_TO_FILE 時，這些追蹤檔案會串連並複製到單一檔案，其名稱會指定為呼叫的參數。
API/link-service 追蹤會在發出動詞之前停止，並在複製完成後重新啟動。 成功完成此動詞命令時，會重設追蹤檔案。