COPY_TRACE_TO_FILE

아티클
07/21/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 PostMessage 함수 호출이 아닌 Windows SendMessage 함수 호출을 발행하는 다른 애플리케이션이 호출한 메시지 루프로부터 발행되었습니다. 동사 처리를 수행할 수 없습니다.
SendMessage가 애플리케이션을 호출할 때 CSV가 발행되었습니다. InSendMessage Windows API 함수 호출을 사용하면, 애플리케이션이 SendMessage를 사용하여 호출되었는지 여부를 확인할 수 있습니다.

설명

두 개의 API/링크 서비스 추적 파일이 있습니다. 이들 파일은 번갈아 사용됩니다. 한 파일이 가득 찬 경우(250K 이상) 추적이 다른 파일로 전환됩니다. COPY_TRACE_TO_FILE을 호출하면 이러한 추적 파일이 연결되어 단일 파일에 복사됩니다. 이 파일의 이름은 호출에 대한 매개 변수로 지정됩니다.

API/링크 서비스 추적은 동사를 발행하기 전에 중지되고 복사가 완료된 후 다시 시작됩니다. 이 동사가 성공적으로 완료되면 추적 파일이 다시 설정됩니다.

다음을 통해 공유

COPY_TRACE_TO_FILE

구문

구성원

반환 코드

설명

추가 리소스