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 送達。 |