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
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).

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.

OpenEdge Release 10.2B

Copyright © 2009 Progress Software Corporation