Confirm (CPI-C)

發行項
10/14/2023

Confirm呼叫 (函式名稱cmcfm) 會將本機邏輯單元的傳送緩衝區內容傳送 (LU) 和確認要求傳送給合作夥伴計畫，並等候確認。針對 Microsoft Windows，針對所有 CPI-C 通訊執行背景執行緒，並只保留使用者介面的前景執行緒。

語法

  
CM_ENTRY Confirm(   
  unsigned char FAR *conversation_ID,    
    CM_INT32 FAR *request_to_send_received,    
  CM_INT32 FAR *return_code              
);

參數

conversation_ID
提供的參數。指定交談的識別碼。此參數的值是由 Initialize_Conversation 或 Accept_Conversation傳回。

request_to_send_received
傳回的參數。提供要求到傳送接收的指標。可能的值包括：

CM_REQ_TO_SEND_RECEIVED
合作夥伴計畫發出 Request_To_Send，要求本機程式將交談變更為 RECEIVE 狀態。

CM_REQ_TO_SEND_NOT_RECEIVED
合作夥伴計畫未發出 Request_To_Send。如果return_code設定為 CM_PROGRAM_PARAMETER_CHECK 或 CM_PROGRAM_STATE_CHECK，這個值就不相關。

return_code
從這個呼叫傳回的程式碼。本主題稍後會列出有效的傳回碼。

傳回碼

CM_OK
主要傳回碼;已成功執行呼叫。合作夥伴計畫發出已確認的通話。

CM_OPERATION_NOT_ACCEPTED
主要傳回碼;此交談的先前作業不完整。

CM_OPERATION_INCOMPLETE
主要傳回碼;作業尚未完成 (處理模式只會) 封鎖，而且仍在進行中。程式可以發出 Wait_For_Conversation 等候作業完成，或 Cancel_Conversation 取消作業和交談。如果已呼叫 Specify_Windows_Handle ，應用程式應該等候 Windows 訊息的通知，而不是呼叫 Wait_For_Conversation。

CM_PROGRAM_PARAMETER_CHECK
主要傳回碼;發生下列其中一項：

conversation_ID指定的值無效。
本機程式嘗試在與同步處理層級為 CM_NONE 的交談中使用 Confirm 。同步處理層級必須CM_CONFIRM。

CM_PROGRAM_STATE_CHECK
主要傳回碼;發生下列其中一項：
交談未處於 SEND 或SEND_PENDING狀態。
本機程式的基本交談處於 SEND 狀態，而且本機程式未完成傳送邏輯記錄。

CM_PRODUCT_SPECIFIC_ERROR
主要傳回碼;發生產品特定的錯誤，並已記錄在產品錯誤記錄檔中。

CM_CONVERSATION_TYPE_MISMATCH
主要傳回碼;合作夥伴 LU 或計畫不支援在配置要求中指定的基本或對應) 交談 (類型。

CM_PIP_NOT_SPECIFIED_CORRECTLY
主要傳回碼;非 CPI-C LU 6.2 交易程式已拒絕配置要求， (TP) 。合作夥伴計畫需要一或多個 PIP 資料變數，CPI-C 不支援這些變數。

CM_SECURITY_NOT_VALID
主要傳回碼;合作夥伴 LU 不接受配置要求中指定的使用者識別碼或密碼。

CM_SYNC LEVEL_NOT_SUPPORTED_PGM
主要傳回碼;合作夥伴計畫不支援配置要求中指定的同步處理層級。

CM_TPN_NOT_RECOGNIZED
主要傳回碼;合作夥伴 LU 無法辨識配置要求中指定的計畫名稱。

CM_TP_NOT_AVAILABLE_NO_RETRY
主要傳回碼;由於永久條件，合作夥伴 LU 無法啟動配置要求中指定的計畫。錯誤的原因可能會記錄在遠端節點上。在更正錯誤之前，請勿重試配置。

CM_TP_NOT_AVAILABLE_RETRY
主要傳回碼;因為暫時條件，合作夥伴 LU 無法啟動配置要求中指定的程式。錯誤的原因可能會記錄在遠端節點上。重試配置。

CM_PROGRAM_ERROR_PURGING
主要傳回碼;發生下列其中一項：
處於 RECEIVE 或 CONFIRM 狀態時，合作夥伴計畫會發出Send_Error。已清除已傳送但尚未接收的資料。
處於SEND_PENDING狀態，錯誤方向設定為CM_RECEIVE_ERROR時，合作夥伴計畫會 發出Send_Error。未清除資料。

CM_RESOURCE_FAILURE_NO_RETRY
主要傳回碼;發生下列其中一項：
交談因為永久條件而提前終止。在更正錯誤之前，請勿重試。
合作夥伴計畫未在正常終止之前解除配置交談。

CM_RESOURCE_FAILURE_RETRY
主要傳回碼;交談因為暫時性狀況而提前終止，例如數據機失敗。重試交談。

CM_DEALLOCATED_ABEND
主要傳回碼;交談因下列其中一個原因而解除配置：
遠端程式發出 Deallocate ，並將 type 參數設定為 CM_DEALLOCATE_ABEND。如果在發出呼叫時，遠端程式的交談處於 RECEIVE 狀態，則會清除本機程式所傳送且尚未由遠端程式接收的資訊。
合作夥伴計畫正常終止，但未在終止之前解除配置交談。

CM_DEALLOCATED_ABEND_SVC
主要傳回碼;交談因下列其中一個原因而解除配置：
合作夥伴計畫發出 解除配置 ，並將 type 參數設定為 ABEND_SVC。
合作夥伴計畫在終止之前未解除配置交談。

如果在本機計畫發出此呼叫時，合作夥伴計畫的交談處於 RECEIVE 狀態，則會清除本機程式所傳送且尚未由合作夥伴計畫接收的資料。

CM_DEALLOCATED_ABEND_TIMER
主要傳回碼;交談已解除配置，因為合作夥伴計畫已發出 Deallocate ，並將 type 參數設定為 ABEND_TIMER。如果在本機計畫發出此呼叫時，合作夥伴計畫的交談處於 RECEIVE 狀態，則會清除本機程式所傳送且尚未由合作夥伴計畫接收的資料。

CM_SVC_ERROR_PURGING
主要傳回碼;處於 SEND 狀態時，合作夥伴計畫或合作夥伴 LU 會發出Send_Error 類型參數設定為 SVC。傳送給合作夥伴計畫的資料可能已經清除。

狀態變更

發出 [確認 ] 時，交談可以處於 SEND 或SEND_PENDING狀態。

下表摘要說明的狀態變更是以 return_code 參數的值為基礎。

return_code	新增狀態
CM_OK	沒有變更
通話已以 SEND 狀態發出	沒有變更
呼叫已發出SEND_PENDING狀態	SEND
CM_PROGRAM_ERROR_PURGING	RECEIVE
CM_SVC_ERROR_PURGING	RECEIVE
CM_CONVERSATION_TYPE_MISMATCH	RESET
CM_PIP_NOT_SPECIFIED_CORRECTLY	RESET
CM_SECURITY_NOT_VALID	RESET
CM_SYNC_LEVEL_NOT_SUPPORTED_PGM	RESET
CM_TPN_NOT_RECOGNIZED	RESET
CM_TP_NOT_AVAILABLE_NO_RETRY	RESET
CM_TP_NOT_AVAILABLE_RETRY	RESET
CM_RESOURCE_FAILURE_NO_RETRY	RESET
CM_RESOURCE_FAILURE_RETRY	RESET
CM_DEALLOCATED_ABEND	RESET
CM_DEALLOCATED_ABEND_SVC	RESET
CM_DEALLOCATED_ABEND_TIMER	RESET
All others	沒有變更

備註

為了回應確認，合作夥伴計畫通常會發出確認，以確認它已收到資料，而不會發生錯誤。 (如果合作夥伴計畫發生錯誤，它會Send_Error或使用 Deallocate 異常解除配置 conversation.)

只有當交談同步處理層級CM_CONFIRM時，程式才能發出確認。

確認等候合作夥伴計畫的回應。回應是由合作夥伴計畫中下列其中一個 CPI-C 呼叫所產生：

已確認
Send_Error
5Deallocate，並將交談解除配置類型設定為 CM_DEALLOCATE_ABEND

Confirm (CPI-C)

語法

參數

傳回碼

備註

其他資源