Working with the ConnectionInfo object

A client application
can retrieve information about client connections to a server application
by using the ConnectionInfo object. The ConnectionInfo object is
a structure that provides access to the list of active connections
to the server.

Retrieving connection information

You
use the GetServerInfo function of the Connection object to populate
the array of elements for the ConnectionInfo object. The first array
element of this structure represents the connection information
for the client application that requests information. A client application
that has administrative privileges can use GetServerInfo to retrieve
information about all
clients connected to
a particular server. A client that does not have administrative
privileges can see only information about its connection to the
server.

Monitoring activity against
a server

The ConnectionInfo
object allows you to monitor client connections to a server application.
You can display information retrieved using the ConnectionInfo object
in a console window. This allows the system administrator to see
which clients have connections to the server.

To retrieve information about client connections, a server
application must establish a client connection to itself. A server
application cannot access the ConnectionInfo object directly.

Disconnecting other clients

A client application that has administrative privileges can
optionally disconnect other client applications. This makes it possible
for a system administrator to terminate client connections that
are creating unnecessary traffic on the server.

For example, once a client with administrative privileges
has retrieved information from the ConnectionInfo object, the client
can find out how much time has elapsed since another client first
connected, and if necessary, disconnect that client.

To disconnect another client, you use the RemoteStopConnection
function.

For more information

For more information about the GetServerInfo and RemoteStopConnection functions,
see the PowerScript Reference
.

---