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 attribute1	FIRST-ASYNC-REQUEST attribute
FIRST-PROCEDURE attribute1	HANDLE attribute	INSTANTIATING-PROCEDURE attribute
LAST-ASYNC-REQUEST attribute	LAST-PROCEDURE attribute1	NAME attribute
NEXT-SIBLING attribute	PREV-SIBLING attribute	PRIVATE-DATA attribute
REQUEST-INFO attribute	RESET( ) method	RESPONSE-INFO attribute
RESTART-ROWID attribute	SOAP-VERSION attribute	SSL-SERVER-NAME attribute
SUBTYPE attribute	TYPE attribute
1 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 (Web service)
CONNECTED( ) method	DISCONNECT( ) method

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.