Server object handle

Allows you to connect and execute remote procedures on an AppServer or Web service.

Note: This handle does not provide direct access to an AppServer session context as does a SESSION handle for the current context. Rather, it provides access to a server object in the current context that allows you to connect, disconnect, and retrieve a variety of information on a connected AppServer.

Syntax

server-handle [ :attribute | :method ]

server-handle: A handle variable that references a server object created by the CREATE SERVER statement that, in turn, allows you to connect to and access an AppServer instance or a Web service application.
attribute: An attribute of the server handle.
method: A method of the server handle.

Attributes

ASYNC-REQUEST-COUNT attribute	CLIENT-CONNECTION-ID attribute ¹	FIRST-ASYNC-REQUEST attribute
FIRST-PROCEDURE attribute ¹	HANDLE attribute	INSTANTIATING-PROCEDURE attribute
LAST-ASYNC-REQUEST attribute	LAST-PROCEDURE attribute ¹	NAME attribute
NEXT-SIBLING attribute	PREV-SIBLING attribute	PRIVATE-DATA attribute
REQUEST-INFO attribute	RESPONSE-INFO attribute	SOAP-VERSION attribute
SSL-SERVER-NAME attribute	SUBTYPE attribute	TYPE attribute

Methods

CANCEL-REQUESTS( ) method	CANCEL-REQUESTS-AFTER( ) method
CONNECT( ) method (AppServer)	CONNECT( ) method (Progress Application Server)
CONNECT( ) method (Web service)	CONNECTED( ) method
DISCONNECT( ) method (Handle)	–

Note

For SpeedScript, as in any ABL client, a WebSpeed Agent can use a valid server handle to access and run remote procedures on an AppServer. However, it does not access or affect the state of any WebSpeed Transaction Server.