Connect to the host using the host connection properties.
bool HostConnection.connect() bool HostConnection.connect(String type) |
Arguments
HostConnection
Required. HostConnection object.
type
When omitted, type = "Standard" (see below)
Remarks
The connection type will be used to enhance connection options and control. The available connection types are:
•"standard" - Default, primary connection to the session. In the case of a monitoring connection (see sessionMonitor property) the waitForUpdate method will exit and the waitForUpdateFlag will return a value of "cancelled".
•"monitor" -- connect as a monitor...can share the session
•"sendonly" -- for terminal emulation environments, connect to send keystrokes but not act as an event receiver
•"prtmon" -- Connect as both a monitor and print monitor--to enable integration for print buffers in a VT environment
•"termentry" -- for terminal emulation, connect to send keystrokes and monitor for screen ready
•"refresh" -- Connect solely to access the screen buffer as a reader
•"viewer" -- Connect as a full function terminal emulator
There are two ways of specifying information about which host to connect to:
•set the hostName property - this option will use information stored in the registry (set by using the Admin Console). This information is preset.
•setting session property information. This information is set at runtime.
The following c# example makes a standard connection to the host definition called "Insure":
HostConnection oConn=new HostConnection();
oConn.hostName = "Insure";
oConn.connect("standard");
The following example sets the connection properties before making the connection:
HostConnection oConn=new HostConnection();
oConn.sessionPort = 23;
oConn.sessionType = "TN3270";
oConn.sessionHost = "localhost";
oConn.sessionOptions = "ConnectTestRow:23;ConnectTestColumn:2;ConnectTestText:ENTER;";
oConn.connect("standard");
The default connection settings are used to make the connection. The default settings can be:
•Modified by using the Admin Console
•Modified manually in the registry
•Overwritten by using the HostConnection object's properties
Please note that the hostName property is overridden if the sessionOptions property is set and it includes a hostName attribute.
Requirements
Inventu Viewer+
See Also
Disconnect | poolGetActiveCount | poolGetAllocCount | poolGetMaxCount | quickSend | hostName | newSession | sessionKey | sessionHost | sessionMonitor | sessionOptions | sessionPool | sessionPort | sessionType | sessionUserLocation
Applies To: HostConnection object
© 2022 Inventu Corporation
