IsAlive

Description

Determines whether a server object is still running.

Applies to

OLEObject objects, OLETxnObject objects

Syntax

oleobject.IsAlive (  )

Argument

Description

oleobject

The name of an OLEObject or OLETxnObject variable that is connected to an automation server or COM object


Return value

Boolean.

Returns true if the server object appears to be running and false if it is dead.

Usage

Use the IsAlive function to determine whether a server process has died. This function does not replace the error-handling capability provided by the ExternalException and Error events. It provides a way to check the viability of the server at intervals or before specific operations to avoid runtime errors.

If IsAlive returns true, the server may only appear to be running, because the true state of the server may be masked. This is more likely to occur when the server is running on a different computer, because DCOM may be using cached information to determine the state of the server. A false return value always indicates that the server is dead.

Examples

This example creates an OLEObject variable and calls ConnectToNewObject to create and connect to a new instance of a PowerBuilder COM object. After performing some processing, it checks whether the server is still running before performing additional processing:

OLETxnObject EmpObj
Integer li_rc
 
EmpObj = CREATE OLEObject
li_rc = EmpObj.ConnectToNewObject("PB70COM.employee")
// Perform some work with the COM object
...
IF EmpObj.IsAlive()THEN
// Continue processing
END IF