Server object handle

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 ]

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.

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

¹ For this attribute to be valid, the handle must have an AppServer or Web service connection (the CONNECTED( ) method must return TRUE).

² For this attribute to be valid, the handle must have an AppServer or Web service connection (the CONNECTED( ) method must return TRUE).

³ For this attribute to be valid, the handle must have an AppServer or Web service connection (the CONNECTED( ) method must return TRUE).

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.