Progress
Language Reference


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 [ :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 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.
  1. 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.


Copyright © 2004 Progress Software Corporation
www.progress.com
Voice: (781) 280-4000
Fax: (781) 280-4095