Server Object Handle
Interfaces
|
OS
|
SpeedScript
|
All
|
All
|
Yes
|
Allows you to connect and execute remote procedures on a Progress AppServer.
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
A handle variable that references a server object created by the CREATE SERVER statement that, in turn, allows you to connect to and access a Progress AppServer instance.
attribute
An attribute of the server handle. The attributes are listed in the table that follows:
Attribute
|
Type
|
Description
|
|
INTEGER
|
Returns the number of active asynchronous requests for the server.
|
|
CHARACTER
|
Returns the connection ID for the AppServer connection associated with this server handle.
|
|
HANDLE
|
The first entry in the list of remote persistent procedures running on the connected AppServer.
|
|
HANDLE
|
The last entry in the list of remote persistent procedures running on the connected AppServer.
|
|
CHARACTER
|
The name of the Progress AppServer used in the Debugger.
|
|
HANDLE
|
The next entry in the list of server handles created for the current Progress session.
|
|
HANDLE
|
The previous entry in the list of server handles created for the current Progress session.
|
|
CHARACTER
|
An arbitrary string of data, that Progress does not check, associated with the server handle.
|
|
CHARACTER
|
The handle type, which is "SERVER" for a Progress AppServer handle.
|
- For this attribute to be valid, the handle must have an AppServer connection (the CONNECTED( ) method must return TRUE).
|
method
A method of the server handle. The methods are listed in the table that follows:
Method
|
Return Type
|
Description
|
|
LOGICAL
|
Raises a STOP condition in the context of the currently running asynchronous request and purges the send queue of any asynchronous requests that have not been executed.
|
[ connection-parameters ]
[ , userid ]
[ , password ]
[ , app-server-info ] )
|
LOGICAL
|
Connects to and associates a Progress AppServer instance with the server handle.
|
|
LOGICAL
|
Indicates if a Progress AppServer is currently connected and associated with the server handle.
|
|
LOGICAL
|
If the ASYNC-REQUEST- COUNT attribute is equal to zero (0), disconnects from and removes all reference to the Progress AppServer currently associated with the server handle.
|
|
HANDLE
|
Returns the first entry in the list of all current asynchronous request handles for the specified AppServer.
|
|
HANDLE
|
Returns the last entry in the list of all current asynchronous request handles for the specified AppServer.
|
NOTE
For SpeedScript, as in any 4GL 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.