GatewayConnection Class

CICS Transaction Gateway V10.1.0.0
Represents a connection to a Gateway daemon.
Inheritance Hierarchy

SystemObject
  IBM.CTGGatewayConnection
    IBM.CTGSslGatewayConnection

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

public class GatewayConnection : IDisposable

The GatewayConnection type exposes the following members.

Constructors

  NameDescription
Public methodGatewayConnection(String, Int32)
Creates a new connection to a Gateway daemon.
Public methodGatewayConnection(String, Int32, Int32)
Creates a new connection to a Gateway daemon with the specified timeout.
Public methodGatewayConnection(String, Int32, Int32, String, String)
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.
Top
Properties

  NameDescription
Public propertyApplid
Gets the client APPLID used for transaction tracking on this GatewayConnection.
Public propertyApplidQualifier
Gets the client APPLID qualifier used for transaction tracking on this GatewayConnection.
Public propertyConnectionPool
Gets the GatewayConnectionPool that this GatewayConnection is associated with.
Public propertyHostName
Gets the host name of the Gateway daemon this GatewayConnection is or was connected to.
Public propertyIsOpen
Gets a value indicating whether this GatewayConnection is connected to a Gateway daemon.
Public propertyPort
Gets the remote TCP/IP port this GatewayConnection is or was connected to.
Top
Methods

  NameDescription
Public methodClose
Closes the connection to the Gateway daemon.
Public methodEquals
Determines whether the specified object is equal to the current object.
(Inherited from Object.)
Protected methodFinalize
Allows an object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection.
(Inherited from Object.)
Public methodFlow
Flows a GatewayRequest to the Gateway daemon.
Public methodGetHashCode
Serves as the default hash function.
(Inherited from Object.)
Public methodGetType
Gets the Type of the current instance.
(Inherited from Object.)
Public methodListSystems
Retrieves a list of the CICS servers defined in the Gateway daemon.
Protected methodMemberwiseClone
Creates a shallow copy of the current Object.
(Inherited from Object.)
Public methodToString
Returns a string that represents the current object.
(Inherited from Object.)
Top
Remarks

Instances of GatewayConnection are thread safe and can be used with threads other than the thread that created them. CICS TG version 8.1 added thread safety to GatewayConnection. To create a Secure Sockets Layer (SSL) connection to the Gateway daemon, use SslGatewayConnection. Transaction tracking can be enabled by setting the properties: Applid and ApplidQualifier, this can be done programatically with the GatewayConnection, or by using an application or web configuration file. The constructor GatewayConnection(String, Int32, Int32, String, String) provides the programatical means of setting APPLID and APPLID qualifier . The configuration file values of "CtgApplid" and "CtgApplidQualifier" will override the values defined by the constructor GatewayConnection(String, Int32, Int32, String, String) The APPLID and APPLID qualifier are part of the origin data associated with running a client application. When transaction tracking is enabled the system administrator is able to track requests from a client application, as they pass through the Gateway daemon, and through the connected CICS servers, to the related tasks that are being processed in CICS. Tracking requests through the Gateway daemon can be done via connectionlogging or request monitoring exits, for more information refer to the product documentation.
Thread Safety

Static members of this type are safe for multi-threaded operations. Instance members of this type are safe for multi-threaded operations.
See Also

Reference