MC_RECEIVE_LOG_DATA

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

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

收到 FMH7 時，APPC 會將任何相關聯的錯誤記錄檔一般資料流程複製到緩衝區 (GDS) 。 如果沒有相關聯的錯誤記錄變數，則會將緩衝區零出。每當接收動詞的傳回碼指出已收到錯誤時，TP 就會檢查緩衝區。

下列結構描述動詞控制項區塊 (MC_RECEIVE_LOG_DATA動詞動詞所使用的 VCB ) 。

語法

  
struct mc_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_M_RECEIVE_LOG_DATA。

opext
提供的參數。 指定動詞操作延伸模組，AP_MAPPED_CONVERSATION。

reserv1
保留字段。

primary_rc
傳回的參數。 指定 APPC 在動詞完成時所設定的主要傳回碼。 有效的傳回碼會根據發出的 APPC 動詞命令而有所不同。 如需此動詞命令的有效錯誤碼，請參閱傳回碼。

secondary_rc
傳回的參數。 指定 APPC 在動詞完成時所設定的次要傳回碼。 有效的傳回碼會根據發出的 APPC 動詞命令而有所不同。 如需此動詞命令的有效錯誤碼，請參閱傳回碼。

tp_id
提供的參數。 識別本機 TP。 叫用 TP 中的 TP_STARTED 或叫用 TP 中的 RECEIVE_ALLOCATE ，會傳回此參數的值。

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

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