ACTIVATE_SESSION

發行項
07/21/2023

ACTI加值稅E_SESSION動詞要求 Microsoft® Host Integration Server 使用指定的模式，在本機邏輯單元 (LU) 和指定的夥伴 LU 之間啟用會話。當指定的會話變成作用中或失敗時，這個動詞就會完成。

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

語法

  
typedef struct activate_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   plu_alias[8];  
    unsigned char   mode_name[8];  
    unsigned char   fqplu_name[17];  
    unsigned char   polarity;  
    unsigned char   session_id[8];  
    unsigned long   conv_group_id;  
    unsigned char   reserv4[1];  
    unsigned char   type;  
    HANDLE          deactivation_event;  
    unsigned short* p_deactivation_status;  
    unsigned char   reserv5[10];  
} ACTIVATE_SESSION;

成員

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

reserv2
保留字段。

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

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

reserv3
保留字段。

lu_alias
提供的參數。提供在本機用於 LU 的 8 位元組 ASCII 名稱。如果要使用預設本機 LU，請將此參數填入空格。

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

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

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

極性
提供的參數。指定會話的極性。可能的值包括：

AP_POL_EITHER
如果已設定AP_POL_EITHER，ACTI加值稅E_SESSION如果有的話，就會啟動第一個說話者會話;否則，即會啟用自動計算程式會話。

AP_POL_FIRST_SPEAKER
如果已設定AP_POL_FIRST_SPEAKER，ACTI加值稅E_SESSION只有在要求的極性會話可用時才會成功。

AP_POL_BIDDER
如果已設定AP_POL_BIDDER，則只有在要求的極性會話可用時，ACTI加值稅E_SESSION才會成功。

session_id
傳回的參數。提供啟動會話的 8 位元組識別碼。

conv_group_id
傳回的參數。提供交談群組識別碼。您可以在 ALLOCATE 上指定此參數，並 MC_ALLOCATE 動詞來啟動此特定會話上的交談。

reserv4
保留字段。

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

AP_ACT_ACTIVE
如果指定了AP_ACT_ACTIVE，則主機整合伺服器會透過傳送 BIND 或 INIT-SELF) ，嘗試啟動必要的會話 (。

AP_ACT_PASSIVE
如果指定了AP_ACT_PASSIVE，則主機整合伺服器不會嘗試啟動會話，而且當夥伴啟動會話時，動詞將會完成。

deactivation_event
提供的參數。提供 APPC 在停用會話時發出訊號的事件控制碼。呼叫 CreateEvent 或 OpenEvent Win32® 函式，即可取得事件控制碼。

p_deactivation_status
傳回的參數。當停用事件發出訊號以提供完成狀態時所設定之值的指標。可以傳回下列值。

AP_SESSION_DEACTI加值稅ED
AP_COMM_SUBSYSTEM_ABENDED
reserv5
保留字段。

傳回碼

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

AP_POL_FIRST_SPEAKER
AP_POL_BIDDER
AP_PARAMETER_CHECK
主要傳回碼;動詞因為參數錯誤而未執行。

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

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

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

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

AP_INVALID_POLARITY
次要傳回碼;APPC 無法辨識指定的極性。

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

AP_ACTI加值稅ION_FAIL_NO_RETRY
主要傳回碼;因為需要動作的條件 (，例如組態不符或會話通訊協定錯誤) ，所以無法啟用會話。

AP_ACTI加值稅ION_FAIL_RETRY
主要傳回碼;因為暫時性狀況 (例如連結失敗) ，所以無法啟動會話。

AP_SESSION_LIMITS_EXCEEDED
主要傳回碼;無法啟用會話，因為已超過會話限制。

AP_SESSION_LIMITS_CLOSED
主要傳回碼;無法啟用會話，因為會話限制已關閉， (也就是零) 。

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
主要傳回碼;呼叫執行緒已經在封鎖呼叫中。

備註

這個動詞支援主動和被動啟用。

此動詞的作用中形式會導致主機整合伺服器嘗試藉由傳送系結給獨立 LUS 或 INIT-SELF 來起始會話 (，以取得相依的 LU) 。此動詞的作用中形式也會產生下列行為：

如果與夥伴 LU 的連線處於非作用中狀態，且設定為隨選，則節點會嘗試啟動連線。
如果使用動態夥伴，節點將會設定 LU-LU/MODE 合作關係。
如果 CNOS 尚未執行，節點將會啟動 CNOS (，但不會變更任何會話限制) 。

被動表單不會嘗試啟動會話，但當 LU 是由其夥伴 LU 的 BIND 啟動時完成。對於獨立 LUN，多個被動 ACTI加值稅E_SESSION 動詞可以排入佇列以取得相同的 LU-LU/MODE，並在新的會話啟動時完成。

此動詞也包含停用事件，當會話被 DEACTI加值稅E_SESSION動詞 (以外的任何方法停用時張貼，例如，來自其夥伴 LU 的未要求 UNBIND 會導致此事件張貼) 。

共用方式為

ACTIVATE_SESSION

語法

成員

傳回碼

備註

其他資源