9.2.4 ホスト接続/切断

ホスト接続はConnectXのインタフェース使用宣言でもあり、「Open（ホスト接続）」メソッド完了から「Close（ホスト切断）」の間のみ有効となるメソッド、プロパティが存在します。また、逆にホスト接続中には無効となるメソッド、プロパティも存在します。

●無効時のメソッド動作: 発行は可能ですが処理に失敗します。

●無効時のプロパティ動作: 設定、参照が可能なプロパティでは、参照のみ可能となります。
参照のみ可能なプロパティでは値に意味を持たなくなります。

ホスト未接続時に有効なメソッドはホスト接続「Open（ホスト接続）」メソッドのみです。

■エミュレータ種別EmuTypeプロパティ

構文	object. EmuType
データ型	整数
アクセス方法	参照（ホスト接続中の間有効）
初期値	なし
対象エミュレータ

エミュレータの種別が格納されます。
値は参照のみ可能であり、ホスト接続中の間有効です。
初期値はありません。

「EmuType（エミュレータ種別）」には、次の値が格納されます。

意味	定義名	値
F6680ディスプレイ端末	CX_EMU_6680DSP	1
F6685プリンタ端末	CX_EMU_6685PRN	2
LBPサポート端末	CX_EMU_LBP	3

■接続名SessionToプロパティ

構文	object. SessionTo [=pathname]
データ型	文字列
アクセス方法	参照/設定（ホスト未接続状態に限る）
設定値範囲	255バイト以内の文字列
初期値	なし
対象エミュレータ

WSMGRセットアップウィザードで作成した接続名を指定します。
値は設定、参照することが可能であり、ホスト接続中には参照のみ可能です。
初期値はありません。

「Open（ホスト接続）」メソッド発行のための必須設定プロパティです。

接続名には、ホストへの接続パスと、エミュレータ種別の情報が含まれています。

なお、WSMGRセットアップウィザードと接続名については、各エミュレータの使用手引書を参照してください。

<接続名「c:\wsmgr\接続.emd」を指定した例>

SessionTo = “接続”

または

SessionTo = “c:\wsmgr\接続.emd”

■接続モードOpenModeプロパティ

構文	object. OpenMode [=mode]
データ型	整数
アクセス方法	参照/設定（ホスト未接続状態に限る）
設定値範囲	0～2
初期値	0:「CX_ANY」
対象エミュレータ

「Open（ホスト接続）」メソッドのホスト接続動作を指定します。
値は設定、参照することが可能であり、ホスト接続中には参照のみ可能です。
初期値は「CX_ANY」です。

「OpenMode（接続モード）」プロパティで「CX_CREATE」および「CX_ATTACH」を指定することにより接続パスの使用状態を意識した接続処理が可能です。

接続パスの使用状態が「OpenMode（接続モード）」プロパティの指定と合わない場合、「Open（ホスト接続）」メソッドは失敗します。

「OpenMode（接続モード）」へ設定する値には次のものがあります。

意味	定義名	値
新規/乗り入れ	CX_ANY	0
新規	CX_CREATE	1
乗り入れ	CX_ATTACH	2

■ホスト接続Openメソッド

構文	object. Open ( )
引数	なし
二重発行動作	エラー復帰（3007：同一メソッドが処理中です）
復帰値	0:正常/その他の値:異常
対象エミュレータ
関連プロパティ	WaitTime,SessionTo,OpenMode,EmuProfileName

ホストへ接続を行います。

メソッドの処理にはプロパティの「WaitTime（メソッド応答待ち時間）」指定値が使用され、動作中のエミュレータ、または未使用接続パスへの接続でエミュレータ動作可能状態（「SystemConnection（システム状態）」プロパティの「CX_SYS_NOTREADY（未接続）」以外の状態）を確認した時点で処理の完了とします。

エミュレータ動作可能状態は回線レベルの接続完了ではありません。

回線レベルの接続完了については、「Open（ホスト接続）」メソッドの完了後、“通信状態”を参照するプロパティ、メソッド等を使用してアプリケーションが確認する必要があります。

■ホスト切断Closeメソッド

構文	object. Close ( )
引数	なし
二重発行動作	キャンセル
復帰値	0:正常/その他の値:異常
対象エミュレータ
関連プロパティ	WaitTime,WaitStatusTime

同一オブジェクトの「Open（ホスト接続）」メソッドによって接続中のホストセッションとの切断を行います。

メソッドの処理にはプロパティの「WaitTime（メソッド応答待ち時間）」「WaitStatusTime（ホスト状態監視時間）」指定値が使用され、「キー入力可能」状態を待って切断処理を開始します。

「WaitTime（メソッド応答待ち時間）」の間に「キー入力可能」状態にならない場合、ホストが処理中であっても切断処理は実行されます。