MC_RECEIVE_LOG_DATA

MC_RECEIVE_LOG_DATA動詞命令可讓使用者註冊,以接收與輸入函數管理標頭7相關聯的記錄資料 (FMH7) 錯誤報表。 動詞會將緩衝區傳遞給 APPC,而接收的任何記錄資料都會放在該緩衝區中。 APPC 會繼續使用這個緩衝區,因為後續的 FMH7s 會在與另一個緩衝區一起提供 (也就是,直到交易程式 (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 識別碼不符。