COPY_TRACE_TO_FILE

發行項
10/14/2023

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/連結服務追蹤檔案。這些檔案會替代使用;當一個檔案已滿 (大於 250K) 時，追蹤會從一個檔案切換到另一個檔案。呼叫 COPY_TRACE_TO_FILE 時，這些追蹤檔案會串連並複製到單一檔案，其名稱會指定為呼叫的參數。

API/link-service 追蹤會在發出動詞之前停止，並在複製完成後重新開機。成功完成此動詞命令時，會重設追蹤檔案。

Share via

COPY_TRACE_TO_FILE

語法

成員

傳回碼

備註

其他資源