Creates a new connection to a Gateway daemon with the specified timeout. The connection will use the specified APPLID and APPLID qualifier for transaction tracking.

Namespace:  IBM.CTG
Assembly:  IBM.CTG.Client (in IBM.CTG.Client.dll) Version: 9.0.0.2

Syntax

C#
public GatewayConnection(
	string hostName,
	int port,
	int timeout,
	string applid,
	string applidQualifier
)
Visual Basic
Public Sub New ( _
	hostName As String, _
	port As Integer, _
	timeout As Integer, _
	applid As String, _
	applidQualifier As String _
)
Visual C++
public:
GatewayConnection(
	String^ hostName, 
	int port, 
	int timeout, 
	String^ applid, 
	String^ applidQualifier
)

Parameters

hostName
Type: System..::..String
The host name of the Gateway daemon to connect to.
port
Type: System..::..Int32
The port that the Gateway daemon is accepting TCP/IP requests on.
timeout
Type: System..::..Int32
The connection timeout, in seconds, or zero to specify no timeout.
applid
Type: System..::..String
The client APPLID (maximum 8 characters).
applidQualifier
Type: System..::..String
The client APPLID qualifier (maximum 8 characters).

Exceptions

ExceptionCondition
System..::..ArgumentException Value of applid or applidQualifier is longer than 8 characters.
System..::..ArgumentNullExceptionhostName is nullNothingnullptra null reference (Nothing in Visual Basic).
System..::..ArgumentOutOfRangeException The port number is not valid.
-or-
The timeout value is not valid.
System.Net.Sockets..::..SocketException The host name did not resolve to a valid IP address.
-or-
The connection timed out.
-or-
Failed to establish a connection with the Gateway daemon.
-or-
The connection to the Gateway daemon has been lost.
System.Security..::..SecurityExceptionA caller higher in the call stack does not have permission for the requested operation.
IBM.CTG..::..ClientConfigurationException The value of CtgApplid or CtgApplidQualifier specified in the application configuration file is longer than 8 characters.
IBM.CTG..::..GatewayExceptionAn error occurred within the Gateway daemon.

See Also