MC_CONFIRMED

發行項
10/14/2023

MC_CONFIRMED動詞命令會回應合作夥伴交易計畫 (TP) 的確認要求。它會通知合作夥伴 TP 本機 TP 未偵測到所接收資料中的錯誤。因為發出確認要求的 TP 會等候確認， 所以MC_CONFIRMED 同步處理這兩個 TP。

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

語法


struct mc_confirmed {  
    unsigned short  opcode;  
    unsigned char   opext;  
    unsigned char   reserv2;  
    unsigned short  primary_rc;  
    unsigned long   secondary_rc;  
    unsigned char   tp_id[8];  
    unsigned long   conv_id;  
    unsigned char   rts_rcvd;  
};

成員

opcode
提供的參數。指定動詞作業程式碼，AP_M_CONFIRMED。

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

reserv2
保留字段。

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

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

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

conv_id
提供的參數。識別兩個 TP 之間建立的交談。叫用 TP 中的 MC_ALLOCATE 或叫用 TP 中的 RECEIVE_ALLOCATE ，會傳回此參數的值。

rts_rcvd
傳回的參數。指出合作夥伴 TP 是否發出MC_REQUEST_TO_SEND，要求本機 TP 將交談變更為 RECEIVE 狀態。

若要變更為 RECEIVE 狀態，本機 TP 可以使用 MC_PREPARE_TO_RECEIVE、 MC_RECEIVE_AND_WAIT或 MC_RECEIVE_AND_POST。

傳回碼

AP_OK
主要傳回碼;已成功執行動詞。

AP_PARAMETER_CHECK
主要傳回碼;動詞未執行，因為發生參數錯誤。

AP_BAD_CONV_ID

次要傳回碼; conv_id 的值與 APPC 所指派的交談識別碼不符。

AP_BAD_TP_ID

次要傳回碼; tp_id 的值不符合 APPC 所指派的 TP 識別碼。

AP_STATE_CHECK
主要傳回碼;指令動詞未執行，因為發出狀態無效。

AP_CONFIRMED_BAD_STATE

次要傳回碼;交談不在 CONFIRM、CONFIRM_SEND或CONFIRM_DEALLOCATE狀態。

AP_COMM_SUBSYSTEM_ABENDED
主要傳回碼;表示下列其中一個條件：

此交談所使用的節點遇到 ABEND。
TP 與 PU 2.1 節點之間的連線已中斷， (LAN 錯誤) 。
TP 電腦上的 SnaBase 遇到 ABEND。

系統管理員應該檢查錯誤記錄檔，以判斷 ABEND 的原因。

AP_COMM_SUBSYSTEM_NOT_LOADED
主要傳回碼;處理動詞時，無法載入或終止必要的元件。因此，無法進行通訊。請連絡系統管理員以取得更正動作。

AP_CONVERSATION_TYPE_MIXED
主要傳回碼;TP 已發出基本和對應的交談動詞。單一交談中只能發出一種類型。

AP_INVALID_VERB_SEGMENT
主要傳回碼;超出資料區段結尾的 VCB。

AP_STACK_TOO_SMALL
主要傳回碼;應用程式的堆疊大小太小，無法執行動詞。增加應用程式的堆疊大小。

AP_CONV_BUSY
主要傳回碼;在任何交談上一次只能有一個未完成的交談動詞。如果本機 TP 有多個執行緒，而且有多個執行緒使用相同的 conv_id發出 APPC 呼叫，就會發生這種情況。

AP_THREAD_BLOCKING
主要傳回碼;呼叫執行緒已經在封鎖呼叫中。

AP_UNEXPECTED_DOS_ERROR
主要傳回碼;作業系統在處理來自本機 TP 的 APPC 呼叫時，已將錯誤傳回給 APPC。作業系統傳回碼會透過 secondary_rc傳回。它會以 Intel 位元組交換的順序顯示。如果問題持續發生，請洽詢系統管理員。

備註

當 TP 發出此動詞命令時，交談必須處於下列其中一個狀態：

確認
CONFIRM_SEND
CONFIRM_DEALLOCATE

新狀態是由舊狀態所決定，也就是本機 TP 發出 MC_CONFIRMED時交談的狀態。舊狀態會以先前接收動詞命令的 what_rcvd 參數值表示。可能會變更下列狀態：

舊狀態	新增狀態
確認	RECEIVE
CONFIRM_SEND	SEND
CONFIRM_DEALLOCATE	RESET

確認要求

確認要求是由合作夥伴 TP 中的下列其中一個動詞所發出：

MC_CONFIRM
MC_PREPARE_TO_RECEIVE 如果 ptr_type 設定為 AP_SYNC_LEVEL，且MC_ALLOCATE ) 所建立交談的同步 (處理層級AP_CONFIRM_SYNC_LEVEL
MC_DEALLOCATE 如果 dealloc_type 設定為 AP_SYNC_LEVEL，且MC_ALLOCATE) 所建立的對話同步處理層級 (AP_CONFIRM_SYNC_LEVEL
MC_SEND_DATA 類型設定為 AP_SEND_DATA_CONFIRM，且MC_ALLOCATE) 所建立交談的同步處理層級 (AP_CONFIRM_SYNC_LEVEL

本機 TP 透過下列其中一個動詞的 what_rcvd 參數收到確認要求：
MC_RECEIVE_IMMEDIATE
MC_RECEIVE_AND_WAIT
MC_RECEIVE_AND_POST

只有在what_rcvd包含下列其中一個值時，本機TP 才會發出MC_CONFIRMED：
AP_CONFIRM_WHAT_RECEIVED
AP_CONFIRM_SEND
AP_CONFIRM_DEALLOCATE

如果 rtn_status 參數設定為 AP_YES，what_rcvd 也可以包含下列值：
AP_DATA_COMPLETE_CONFIRM
AP_DATA_COMPLETE_CONFIRM_SEND
AP_DATA_COMPLETE_CONFIRM_DEALL

共用方式為

MC_CONFIRMED

語法

成員

傳回碼

備註

確認要求

其他資源