DEACTIVATE_SESSION

發行項
10/14/2023

DEACTI加值稅E_SESSION動詞會要求 Microsoft® Host Integration Server 停用本機邏輯單元 (LU) 和指定夥伴 LU 之間的特定會話，或特定模式上的所有會話。

下列結構描述 DEACTI加值稅E_SESSION 動詞動詞所使用的動詞控制項區塊。

語法

  
typedef struct deactivate_session {  
    unsigned short  opcode;  
    unsigned char   reserv2[2];  
    unsigned short  primary_rc;  
    unsigned long   secondary_rc;  
    unsigned char   reserv3[8];  
    unsigned char   lu_alias[8];  
    unsigned char   session_id[8];  
    unsigned char   plu_alias[8];  
    unsigned char   mode_name[8];  
    unsigned char   type;  
    unsigned char   reserv4[3];  
    unsigned short  sense_data;  
    unsigned char   fqplu_name[17];  
    unsigned char   reserv5[19];  
} DEACTIVATE_SESSION;

成員

opcode
提供的參數。指定動詞作業程式碼，AP_DEACTI加值稅E_SESSION。

reserv2
保留字段。

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

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

reserv3
保留字段。

lu_alias
提供的參數。提供在本機用於 LU 的 8 位元組 ASCII 名稱。

session_id
提供的參數。提供會話的 8 位元組識別碼，以停用 ACTI加值稅E_SESSION動詞) 傳回 (。如果此欄位設定為 8 個二進位零，主機整合伺服器會停用夥伴 LU 和模式的所有會話。

plu_alias
提供的參數。提供本機用於合作夥伴 LU 的 8 位元組 ASCII 名稱。如果要使用預設遠端 LU，請將此參數填入空格。如果要使用 fqplu_name 參數指定夥伴 LU，請將此參數填入二進位零。

mode_name
提供的參數。指定 EBCDIC (類型 A) 模式名稱。

類型
提供的參數。指定停用的類型。可能的值包括：

AP_DEACT_CLEANUP
立即停用會話，而不等待會話結束。

AP_DEACT_NORMAL
使用會話的所有交談都結束之前，請勿停用會話。

sense_data
傳回的參數。指定會話的停用感知資料。

reserv4
保留字段。

fqplu_name
提供的參數。在 EBCDIC 中提供合作夥伴 LU 名稱 (輸入 A) ，當本機節點未定義 任何plu_alias 名稱，且夥伴 LU 位於不同的節點。如果指定 plu_alias ，則會忽略此參數。

reserv5
保留字段。

傳回碼

AP_OK
主要傳回碼;成功執行動詞。次要傳回碼表示已建立會話的極性。可以傳回下列值。

AP_PARAMETER_CHECK
主要傳回碼;動詞未執行，因為參數錯誤，由下列其中一個次要傳回碼指定：

AP_INVALID_LU_ALIAS
次要傳回碼;APPC 在定義的 lu_alias 之間找不到指定的。

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

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

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

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

AP_INVALID_TYPE
次要傳回碼;APPC 無法辨識指定的類型。

AP_COMM_SUBSYSTEM_ABENDED
主要傳回碼;指出發生下列其中一個狀況：

此交談所使用的節點遇到 ABEND。

TP 與 PU 2.1 節點之間的連線已中斷， (發生區域網路錯誤) 。

TP 電腦的 SnaBase 遇到 ABEND。

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

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

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

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

共用方式為

DEACTIVATE_SESSION

語法

成員

傳回碼

其他資源