IcomLUO.Online メソッド
オフラインへの呼び出し後に、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 セッションがアクティブになり、入力を受け取る準備ができました。 が INIT_SSCP に設定されている場合 initType にのみ有効です。 |
CLU0_E_NEG_RESPONSE | ホストまたは SNA サーバーは、INITSELF またはフォーマットされていないログオン・コマンドに否定応答を送信しました。 が INIT_INITSELF または INIT_LOGON に設定されている場合 initType にのみ有効です |
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 が到着するまで待ちます。 |