Share via


IcomLUO.Online 方法

在呼叫 Offline 之後,將 LU0 會話設定回線上狀態。

語法

  
void Online(  
   short initType,  
   ref System.Array data,  
   int timeout)  
  

參數

參數 Description
initType 描述會話初始類型。 如需詳細資訊,請參閱<備註>一節。
data 視需要包含 INITSELF 或 SSCP 登入訊息。
timeout 等候 BIND 和 SDT 抵達的毫秒時間週期。 如果逾時在 SDT 抵達之前到期,SNA 伺服器 LU 將會釋出,並傳回錯誤。

0xffffffff表示無限逾時。

傳回值

描述
S_OK 已成功重新開機 LU0 會話,且 LU 會話為作用中且已準備好接收輸入。
CLU0_S_SSCP_ACTIVE 已成功重新開機 LU0 會話,且 SSCP 會話為作用中且已準備好接收輸入。

只有在 設定為 INIT_SSCP 時才 initType 有效。
CLU0_E_NEG_RESPONSE 主機或 SNA 伺服器傳送了負回應給 INITSELF 或未格式化的登入命令。

只有在 設定為 INIT_INITSELF 或 INIT_LOGON 時才 initType 有效
CLU0_E_BADPARAM connectionStr 包含不正確屬性設定。
CLU0_E_NOFREELU luname 指定了 SNA 伺服器 LU 集區,而且該集區中沒有可用 RU。
CLU0_E_LUINUSE luname 指定了 SNA 伺服器 LU,而 LU 目前正由另一個應用程式使用。
CLU0_E_LUNOTFOUND LU 或集區名稱不存在。
CLU0_E_TIMEDOUT 會話未在指定的逾時內啟動。
CLU0_E_SESSION_FAILED 基礎 SNA 會話失敗,可能是因為連結中斷或其他暫時性失敗。

您必須中斷連線並釋放伺服器會話。 您可以選擇性地對 Icom3270.Offline 發出呼叫來重設伺服器,然後使用對 Icom3270.Online 的呼叫重新啟用會話。
CLU0_E_SERVER_FAILURE TSS 會話不再有效。

您應該釋放會話控制碼。
CLU_E_WAITING 另一個執行緒已發出這個方法的 Receive 呼叫,但尚未傳回。
CLU_E_SYSERROR 此方法因內部錯誤而失敗。

例外

備註

線上會嘗試取得相同的 SNA 伺服器 LU,因此,在會話上一次線上使用相同的 SNA 伺服器。

下表描述 的 initType 可能值。

名稱 Description
INIT_BIND 0 等候來自 PLU 的未經要求 BIND 和 SDT。
INIT_SSCP 1 等候 BIND 和 SDT 抵達,但允許存取 SSCP 會話,讓應用程式傳送 SSCP 資料和命令。
INIT_INITSELF 2 傳送 中指定的 data INITSELF 命令之後,等候 BIND 和 SDT 抵達。
INIT_LOGON 3 傳送 中指定的 data UNFORMATTED SSCP 登入訊息之後,等候 BIND 和 SDT 送達。

另請參閱

IcomLU0 方法
LU0 的工作階段整合器