RECEIVE_LOG_DATA

RECEIVE_LOG_DATA 동사를 사용하면 사용자가 등록하여 FMH7(인바운드 함수 관리 헤더 7) 오류 보고서와 연결된 로그 데이터를 받을 수 있습니다. 동사는 버퍼를 APPC에 전달하고 받은 모든 로그 데이터는 해당 버퍼에 배치됩니다. APPC는 연속 FMH7s가 다른 버퍼와 함께 제공될 때까지(즉, 트랜잭션 프로그램(TP)가 다른 버퍼를 지정하는 다른 RECEIVE_LOG_DATA 발급하거나 버퍼를 전혀 지정하지 않을 때까지 이 버퍼를 계속 사용합니다.

TP 자체는 버퍼를 할당하고 해제해야 합니다. 버퍼가 APPC에 전달된 후 TP는 새 버퍼 또는 길이가 0인 버퍼를 지정하는 다른 RECEIVE_LOG_DATA 실행하거나 원래 버퍼를 해제하기 전에 대화가 완료될 때까지 기다려야 합니다.

FMH7이 수신되면 APPC는 연결된 오류 로그 GDS(일반 데이터 스트림)를 버퍼에 복사합니다. 연결된 오류 로그 변수가 없으면 버퍼가 0이 됩니다. 수신 동사의 반환 코드가 오류가 수신되었음을 나타내는 경우 버퍼를 검사 것은 TP의 입니다.

다음 구조체는 RECEIVE_LOG_DATA 동사에서 사용하는 동사 제어 블록(VCB)을 설명합니다.

구문

  
struct receive_log_data {  
    unsigned short      opcode;  
    unsigned char       opext;  
    unsigned char       reserv1;  
    unsigned short      primary_rc;  
    unsigned long       secondary_rc;  
    unsigned char       tp_id[8];  
    unsigned long       conv_id;  
    unsigned short      log_dlen;  
    unsigned char FAR * log_dptr;  
};   

구성원

opcode
제공된 매개 변수입니다. 동사 작업 코드 AP_B_RECEIVE_LOG_DATA 지정합니다.

opext
제공된 매개 변수입니다. 동사 연산 확장 AP_BASIC_CONVERSATION 지정합니다.

reserv1
예약된 필드입니다.

primary_rc
반환된 매개 변수입니다. 동사를 완료할 때 APPC에서 설정하는 기본 반환 코드를 지정합니다. 유효한 반환 코드는 발행된 APPC 동사에 따라 다릅니다. 이 동사의 유효한 오류 코드는 반환 코드를 참조하세요.

secondary_rc
반환된 매개 변수입니다. 동사를 완료할 때 APPC에서 설정하는 보조 반환 코드를 지정합니다. 유효한 반환 코드는 발행된 APPC 동사에 따라 다릅니다. 이 동사의 유효한 오류 코드는 반환 코드를 참조하세요.

tp_id
제공된 매개 변수입니다. 로컬 TP를 식별합니다. 이 매개 변수의 값은 호출하는 TP의 TP_STARTED 또는 호출된 TP의 RECEIVE_ALLOCATE 반환됩니다.

conv_id
제공된 매개 변수입니다. 대화 식별자를 제공합니다. 이 매개 변수의 값은 호출하는 TP의 ALLOCATE 또는 호출된 TP의 RECEIVE_ALLOCATE 반환됩니다.

log_dlen
제공된 매개 변수입니다. APPC가 버퍼에 배치할 수 있는 로그 데이터의 최대 길이(즉, 버퍼 크기)를 지정합니다. 범위는 0에서 65535까지입니다. 여기서 길이가 0이면 이전 RECEIVE_LOG_DATA 동사를 취소해야 했음을 나타냅니다.

log_dptr
제공된 매개 변수입니다. APPC가 로그 데이터를 저장하는 데 사용할 버퍼의 주소를 지정합니다.

반환 코드

AP_OK
기본 반환 코드입니다. 동사가 성공적으로 실행되었습니다.

AP_PARAMETER_CHECK
기본 반환 코드입니다. 매개 변수 오류로 인해 동사가 실행되지 않았습니다.

AP_BAD_CONV_ID

보조 반환 코드; conv_id 값이 APPC에서 할당한 대화 식별자와 일치하지 않습니다.

AP_BAD_TP_ID

보조 반환 코드; tp_id 값이 APPC에서 할당한 TP 식별자와 일치하지 않습니다.