RECEIVE_LOG_DATA

RECEIVE_LOG_DATA動詞可讓使用者註冊以接收與輸入函式管理標頭 7 相關聯的記錄資料， (FMH7) 錯誤報表。 動詞會將緩衝區傳遞至 APPC，而接收的任何記錄資料都會放在該緩衝區中。 APPC 會繼續使用此緩衝區作為連續 FMH7s 抵達，直到它與其他一 (個緩衝區一起提供，也就是直到交易程式 (TP) 另一個 RECEIVE_LOG_DATA 指定不同的緩衝區或完全沒有緩衝區) 為止。

請注意，TP 本身負責配置和釋放緩衝區。 將緩衝區傳遞至 APPC 之後，TP 應該發出另一個 RECEIVE_LOG_DATA 指定新緩衝區或零長度緩衝區，或等到交談完成再釋放原始緩衝區。

收到 FMH7 時，APPC 會將任何相關聯的錯誤記錄一般資料流程複製到緩衝區 (GDS) 。 如果沒有相關聯的錯誤記錄變數，緩衝區就會零出。每當來自接收動詞的傳回碼指出已收到錯誤時，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 中的RECEIVE_ALLOCATE會TP_STARTED傳回此參數的值。

conv_id
提供的 參數。 提供交談識別碼。 在叫用 TP 或叫用 TP 的RECEIVE_ALLOCATE中，ALLOCATE會傳回此參數的值。

log_dlen
提供的 參數。 指定 APPC 可以在緩衝區 (中放置的記錄資料長度上限，也就是緩衝區大小) 。 範圍是從 0 到 65535。 請注意，此處的長度為零，表示應該取消任何先前 的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 識別碼不符。