MC_SEND_ERROR

發行項
10/14/2023

MC_SEND_ERROR動詞會通知合作夥伴交易程式 (TP) 本機 TP 發生應用層級錯誤。

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

語法

  
struct mc_send_error {  
    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;  
      unsigned char       err_type;  
    unsigned char       err_dir;  
    unsigned char       reserv4;  
    unsigned char       reserv5[2];  
    unsigned char       reserv6[4];  
};

成員

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

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 中的 MC_ALLOCATE或叫用 TP 中的 RECEIVE_ALLOCATE ，會傳回此參數的值。

rts_rcvd
傳回的參數。指出合作夥伴 TP 是否發行MC_REQUEST_TO_SEND。可能的值包括：

AP_YES表示合作夥伴 TP 已發出 MC_REQUEST_TO_SEND，要求本機 TP 將交談變更為 RECEIVE 狀態。若要變更為 RECEIVE 狀態，本機 TP 可以使用 MC_PREPARE_TO_RECEIVE、 MC_RECEIVE_AND_WAIT或 MC_RECEIVE_AND_POST。
AP_NO表示合作夥伴 TP 尚未發出 MC_REQUEST_TO_SEND。

err_type
針對對應的交談，如果支援同步點，則會提供此參數。有效值為：

AP_PROG

AP_BACKOUT_NO_RESYNC

AP_BACKOUT_RESYNC

err_dir
提供的參數。指出錯誤是否只接收資料，或即將傳送的資料。只有在交談處於SEND_PENDING狀態時，才使用此參數。否則會忽略參數。以下是允許的值：
AP_RCV_DIR_ERROR表示在偵測到剛收到之資料相關聯的錯誤之後 ，發出 TP MC_SEND_ERROR 。
AP_SEND_DIR_ERROR表示偵測到與即將傳送之資料相關聯的錯誤之後 ，發出 TP MC_SEND_ERROR 。例如，從磁片磁碟機讀取資料時，TP 發生錯誤。

reserv3
保留字段。

傳回碼

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

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

AP_BAD_CONV_ID

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

AP_BAD_TP_ID

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

AP_BAD_ERROR_DIRECTION

次要傳回碼;APPC 無法辨識指定的 err_dir 。

AP_SEND_ERROR_BAD_TYPE

次要傳回碼; err_type 的值無效。

AP_SEND_ERROR_LOG_LL_WRONG

次要傳回碼;錯誤記錄檔 GDS 變數的 LL 欄位不符合資料的實際長度。

當 MC_SEND_ERROR 以任何允許的狀態發出時，可以產生下列傳回碼：

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

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

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

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

當此傳回碼與 MC_ALLOCATE搭配使用時，可能表示找不到任何通訊系統來支援本機邏輯單元 (LU) 。 (例如，以 TP_STARTED 指定的本機 LU 別名不正確或尚未設定。) 請注意，如果 lu_alias 或 mode_name 少於八個字元，您必須確定這些欄位會填入右邊的空格。如果這些參數未填入空格，就會傳回此錯誤，因為沒有任何節點可以滿足 MC_ALLOCATE 要求。

當 MC_ALLOCATE 針對以多個節點設定的 Microsoft Host Integration Server Client 系統產生此傳回碼時，有兩個次要傳回碼，如下所示：

0xF0000001

次要傳回碼;尚未啟動任何節點。

0xF0000002

次要傳回碼;至少有一個節點已啟動，但在未在任何作用中節點上設定 TP_STARTED發出) 時，本機 LU (。問題可能是下列其中一項：
未啟動具有本機 LU 的節點。
未設定本機 LU。

AP_CONV_FAILURE_NO_RETRY
主要傳回碼;交談因永久條件而終止，例如會話通訊協定錯誤。系統管理員應該檢查系統錯誤記錄檔，以判斷錯誤的原因。在更正錯誤之前，請勿重試交談。

AP_CONV_FAILURE_RETRY
主要傳回碼;交談因暫時錯誤而終止。重新開機 TP 以查看問題是否再次發生。如果這樣做，系統管理員應該檢查錯誤記錄檔，以判斷錯誤的原因。

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 位元組交換的順序顯示。如果問題持續發生，請洽詢系統管理員。

只有在MC_SEND_ERROR以 SEND 狀態 發出時， 才能產生下列傳回碼：

AP_ALLOCATION_ERROR
主要傳回碼;APPC 無法配置交談。交談狀態會設定為 RESET。

此程式碼可以透過 MC_ALLOCATE之後發出的動詞傳回。

AP_ALLOCATION_FAILURE_NO_RETRY

次要傳回碼;因為有永久條件，例如組態錯誤或會話通訊協定錯誤，所以無法配置交談。若要判斷錯誤，系統管理員應該檢查錯誤記錄檔。在修正錯誤之前，請勿重試配置。

AP_ALLOCATION_FAILURE_RETRY

次要傳回碼;因為暫時性狀況，例如連結失敗，所以無法配置交談。失敗的原因會記錄在系統錯誤記錄檔中。重試配置。

AP_CONVERSATION_TYPE_MISMATCH

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

AP_PIP_NOT_ALLOWED

次要傳回碼;配置要求指定的 PIP 資料，但合作夥伴 TP 不需要此資料，或合作夥伴 LU 不支援此資料。

AP_PIP_NOT_SPECIFIED_CORRECTLY

次要傳回碼;合作夥伴 TP 需要 PIP 資料，但配置要求未指定 PIP 資料或參數數目不正確。

AP_SECURITY_NOT_VALID

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

AP_SYNC_LEVEL_NOT_SUPPORTED

次要傳回碼;合作夥伴 TP 不支援配置要求中指定的 sync_level (AP_NONE 或AP_CONFIRM_SYNC_LEVEL) ，或無法辨識 sync_level 。

AP_TP_NAME_NOT_RECOGNIZED

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

AP_TRANS_PGM_NOT_AVAIL_NO_RETRY

次要傳回碼;遠端 LU 拒絕配置要求，因為它無法啟動要求的合作夥伴 TP。條件是永久的。錯誤的原因可能會記錄在遠端節點上。在修正錯誤之前，請勿重試配置。

AP_TRANS_PGM_NOT_AVAIL_RETRY

次要傳回碼;遠端 LU 拒絕配置要求，因為它無法啟動要求的合作夥伴 TP。條件可能是暫時的，例如逾時。錯誤的原因可能會記錄在遠端節點上。重試配置。

AP_PROG_ERROR_PURGING
主要傳回碼;在 RECEIVE、PENDING、PENDING_POST、CONFIRM、CONFIRM_SEND或CONFIRM_DEALLOCATE狀態中，合作夥伴 TP 發出 MC_SEND_ERROR。已清除傳送但尚未接收的資料。

AP_DEALLOC_ABEND
主要傳回碼;交談已解除配置，原因如下：
合作夥伴 TP 發出MC_DEALLOCATE，dealloc_type設為 AP_ABEND。
合作夥伴 TP 遇到 ABEND，導致合作夥伴 LU 傳送 MC_DEALLOCATE 要求。

只有在以 RECEIVE 狀態發出 MC_SEND_ERROR 時，才能產生下列傳回碼：

AP_DEALLOC_NORMAL
主要傳回碼;這個傳回碼不會指出錯誤。

合作夥伴 TP 發出MC_DEALLOCATE，dealloc_type設定為下列其中一項：
AP_FLUSH
使用指定為 AP_NONE 之交談的同步處理層級進行AP_SYNC_LEVEL

備註

當 TP 發出此動詞時，交談可以處於 RESET 以外的任何狀態。如果使用 err_dir， 則必須SEND_PENDING交談狀態。

本機 TP 會立即將錯誤通知傳送給合作夥伴 TP;它不會在本機 LU 的傳送緩衝區中保存資訊。

成功執行此動詞時，交談會處於本機 TP 的 SEND 狀態，且處於合作夥伴 TP 的 RECEIVE 狀態。

新狀態取決於 primary_rc。下表摘要說明可能的狀態變更。

primary_rc	新增狀態
AP_OK	SEND
AP_ALLOCATION_ERROR	RESET
AP_CONV_FAILURE_RETRY	RESET
AP_CONV_FAILURE_NO_RETRY	RESET
AP_DEALLOC_ABEND	RESET
AP_DEALLOC_ABEND_PROG	RESET
AP_DEALLOC_ABEND_SVC	RESET
AP_DEALLOC_ABEND_TIMER	RESET
AP_DEALLOC_NORMAL	RESET
AP_PROG_ERROR_PURGING	RECEIVE
AP_SVC_ERROR_PURGING	RECEIVE

如果交談在 TP 發出 MC_SEND_ERROR時處於 RECEIVE 狀態，則 APPC 會清除傳入的資料。此資料包括：

MC_SEND_DATA所傳送的資料。
傳回碼指標。
確認要求。
解除配置要求。

APPC 不會清除傳入的要求到傳送指標。 APPC 會將清除的傳入傳回碼指標取代為其他傳回碼。主要傳回碼AP_OK會取代下列清除的傳回碼指標：

AP_PROG_ERROR_NO_TRUNC

AP_PROG_ERROR_PURGING

AP_PROG_ERROR_TRUNC

AP_SVC_ERROR_NO_TRUNC

AP_SVC_ERROR_PURGING

AP_SVC_ERROR_TRUNC

主要傳回碼AP_DEALLOC_NORMAL會取代下列清除的傳回碼指標：

AP_ALLOCATION_ERROR

AP_ALLOCATION_FAILURE_NO_RETRY

AP_ALLOCATION_FAILURE_RETRY

AP_CONVERSATION_TYPE_MISMATCH

AP_DEALLOC_ABEND

AP_DEALLOC_ABEND_PROG

AP_DEALLOC_ABEND_SVC

AP_DEALLOC_ABEND_TIMER

AP_PIP_NOT_ALLOWED

AP_PIP_NOT_SPECIFIED_CORRECTLY

AP_SECURITY_NOT_VALID

AP_SYNC_LEVEL_NOT_SUPPORTED

AP_TP_NAME_NOT_RECOGNIZED

AP_TRANS_PGM_NOT_AVAIL_NO_RETRY

AP_TRANS_PGM_NOT_AVAIL_RETRY

當交談處於SEND_PENDING狀態時，APPC 會根據 err_dir中的值，向合作夥伴 TP 回報下列傳回碼：

AP_PROG_ERROR_PURGING
本機 TP 以 RECEIVE 作為 err_dir 發出 MC_SEND_ERROR。

AP_PROG_ERROR_NO_TRUNC
本機 TP 以 SEND 作為 err_dir 發出 MC_SEND_ERROR。

MC_SEND_ERROR

語法

成員

傳回碼

備註

其他資源