オフラインへの呼び出しの後、LU0 セッションをオンライン状態に戻します。
構文
void Online(
short initType,
ref System.Array data,
int timeout)
パラメーター
| パラメーター | 説明 |
|---|---|
initType |
セッション開始の種類について説明します。 詳細については、「解説」セクションを参照してください。 |
data |
必要に応じて、INITSELF または SSCP ログオン メッセージを格納します。 |
timeout |
BIND と SDT が到着するまで待機する時間 (ミリ秒単位)。 SDT が到着する前にタイムアウトが切れると、SNA サーバー LU が解放され、エラーが返されます。 0xffffffffは無限タイムアウトを示します。 |
戻り値
| 価値 | 説明 |
|---|---|
| S_OK | LU0 セッションが正常に再アクティブ化され、LU セッションがアクティブになり、入力を受け取る準備ができました。 |
| CLU0_S_SSCP_ACTIVE | LU0 セッションが正常に再アクティブ化され、SSCP セッションがアクティブになり、入力を受け取る準備ができました。initTypeが INIT_SSCP に設定されている場合にのみ有効です。 |
| CLU0_E_NEG_RESPONSE | ホストまたは SNA サーバーが、INITSELF またはフォーマットされていないログオン・コマンドに否定応答を送信しました。initTypeが INIT_INITSELF または INIT_LOGON に設定されている場合にのみ有効です |
| CLU0_E_BADPARAM |
connectionStr に無効なプロパティ設定が含まれていました。 |
| CLU0_E_NOFREELU |
luname は SNA サーバー LU プールを指定しており、そのプールに空き LU はありません。 |
| 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に使用できる値について説明します。
| 名前 | 価値 | 説明 |
|---|---|---|
| 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 が到着するまで待ちます。 |