Progress
Open Client
Developer’s Guide


Common Methods

AppObjects, SubAppObjects, and ProcObjects all support the common methods described in Table 4–1.

Table 4–1: Proxy Common Methods
Common Method1
Description
Java:
  • public void _cancelAllRequests() throws Open4GLException
ActiveX:
  • Sub OC_CancelAllRequests()
Stops or cancels any outstanding requests to the AppServer by this object or one that shares its connection.
This method is most useful for multi-threaded clients.
Java:
  • public String _getConnectionId() throws Open4GLException
ActiveX:
  • Function OC_GetConnectionId() As String
Returns a string containing a unique identifier for this connection that is used to identify entries in AppServer log files.
Java:
  • public String _getProcReturnString()
ActiveX:
  • Function OC_GetProcReturnString() As String
Returns the current value of the AppServer RETURN-VALUE function.
For more information, see the discussion on handling return values in the "Remote 4GL Methods" section.
Java:
  • public boolean _isStreaming() throws Open4GLException
ActiveX:
  • Function OC_IsStreaming() As Boolean
Returns true if there is an open output TEMP-TABLE for this connection.2
Java:
  • public void _release()
ActiveX:
  • Sub OC_Release()
Make this object unavailable for further use. If you execute this method on the last available proxy object that has shared a particular connection, the client disconnects the AppServer. If you execute this method on a ProcObject, the associated persistent procedure on the AppServer is deleted.
  1. ActiveX method prototypes follow the conventions used by the VB Object Browser to display method prototypes.
  2. For more information on streaming, see the "Passing TEMP-TABLE And TABLE-HANDLE Parameters" section.


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