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

Note: This handle does not provide direct access to an application server 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 application server.

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 application server 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#rfi1424920291187__attribute-valid-fn FIRST-ASYNC-REQUEST attribute
FIRST-PROCEDURE attribute#rfi1424920291187__attribute-valid-fn HANDLE attribute INSTANTIATING-PROCEDURE attribute
LAST-ASYNC-REQUEST attribute LAST-PROCEDURE attribute#rfi1424920291187__attribute-valid-fn 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 for OpenEdge)
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 application server. However, it does not access or affect the state of any WebSpeed Transaction Server.

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