Mastering PowerBuilder

Connection Object Functions

The connection object has five functions:

ConnectToServer: connects the client application to the server application using the values set in its various properties.

DisconnectServer: disconnects the client application from the server application.

RemoteStopConnection: allows a connected client application with administrative privileges to disconnect a specified client connection from the server application.

RemoteStopListening: allows a connected client application with administrative privileges to command a server application to stop listening for requests.

Lookup: allows a PowerBuilder client to create an instance of a Jaguar component and is explained later in this session.

GetContextService: Creates a reference to a context-specific instance of the specified service.

GetserverInfo: allows a client to retrieve information about its connection to the server into a structure of the type ConnectionInfo. Client with administrative privileges can retrieve information about all client connections to a server. The ConnectionInfo structure has the following properties:

Property	Data Type	Description
Busy	Boolean	Indicates whether the client connection is currently making a request or receiving results of the previous requests.
CallCount	Long	Indicates the total number of requests made by that client connection.
ClientID	String	Indicates the ID of the client connection.
ConnectTime	DateTime	Indicates the date and time the client initiated the connection.
LastCallTime	DateTime	Indicates the date and time of the last request made by this client connection.
Loaction	String	Indicates the location of the client.
UserID	String	Indicates the user ID of the client that made the connection.

Home	Previous Lesson: Connection Object Events Next Lesson: Communication Drivers