Developer Reference : Platform Management : Distributed Tuning Objects (DTO) Guide : Monitoring Zen Servers with DTO : DtoMkdeClient Object
 
DtoMkdeClient Object
An object representing an active MicroKernel Engine client.
Properties
BtrvID
Returns the Btrieve ID of a MicroKernel Engine client.
CacheAccesses
Returns the number of cache accesses for a MicroKernel Engine client.
ClientPlatform
Returns the client platform enumeration for a MicroKernel Engine client. See Client Platform for a list of the possible values.
ClientPlatformName
Returns a text version of ClientPlatform.
ClientSite
Returns the client site for a MicroKernel Engine client.
ConnectionNumber
Returns the connection number for a MicroKernel Engine client.
CurrentLocks
Returns the current number of locks for a MicroKernel client.
DiskAccesses
Returns the number of disk accesses for a MicroKernel Engine client.
NetAddress
Returns the address of a MicroKernel Engine client.
NumCursors
Returns the number of cursors for a MicroKernel Engine client.
RecordsDeleted
Returns the number of deleted records for a MicroKernel Engine client.
RecordsInserted
Returns the number of inserted records for a MicroKernel Engine client.
RecordsRead
Returns the number of read records for a MicroKernel Engine client.
RecordsUpdated
Returns the number of updated records for a MicroKernel Engine client.
ServiceAgentID
Returns the service agent identification of a MicroKernel Engine client
TaskNumber
Returns the task number of a MicroKernel Engine client.
TransLevel
Returns the transaction level of a MicroKernel Engine client.
TransState
Returns the transaction state enumeration. See Transaction State for a list of possible values.
UserName
Returns the MicroKernel Engine client user name.
Collections
DtoMkdeClientHandles Collection
DtoMonitor Object
Methods
Disconnect method
Remarks
To obtain all the MicroKernel Engine clients, use the DtoMkdeClients Collection.
Example
’ Instantiate session and connect
Dim my_session as new DtoSession
Dim result as DtoResult
result = my_session.Connect("myserver", "username", "password")
’ Get monitor object from session
Dim my_monitor as DtoMonitor
my_monitor = my_session.Monitor
 
’ Now get MicroKernel Engine Clients from monitor
Dim my_mkdeclients as DtoMkdeClients
Set my_mkdeclients = my_monitor.MkdeClients
 
’ retrieve first client and query a property
Dim first_client as DtoMkdeClient
Dim num_locks as long
Set first_client = my_mkdeclients.Item(1)
num_locks = first_client.CurrentLocks
See Also
DtoMkdeClientHandles Collection
DtoMkdeClients Collection
Methods Detail
Disconnect method
Disconnects a specific MicroKernel Engine client.
Syntax
result = Object.Disconnect
Arguments
In
Object
DtoMkdeClient object
Return Values
result
DtoResult long value indicating the result of the method call. Use the Error property of the DtoSession Object to obtain a description for the result.
Remarks
Call this method for every MicroKernel Engine client that you wish to disconnect.
Example
Dim result as DtoResult
result = my_mkdeclient.Disconnect