Proxy Service Interface API Reference

The ScreenConnectorProxy Service is a Windows service, which maintains a single instance of the Java Virtual Machine and services DCOM requests for stateless task execution via Attachmate's IConnectorAccess.

For details on IConnectorAccess, see Javadocs for Attachmate Interfaces.

IConnectorProxy Reference

Execute

HRESULT Execute([in]BSTR connector, [in] BSTR taskFile, [in] BSTR taskID, [in] BSTR input, {out, retval] BSTR * output)

Executes a stateless task. This is a stand-alone method. Open ( ) and Close ( ) should not be called.

Syntax

Output = proxy.Execute (connector, taskFile, taskID, input)

Input Parameters

Name Description Type
connector Fully qualified Java class name of the IConnectorAccess implementation. String
taskFile A path to the task file to open. This can be a file or a URL. String
taskID The name of the task. String
input The XML inputs for the task. String

Output Parameters

Name Description Type
output The XML results of the task execution. String

Open

HRESULT Open([in]BSTR connector, [in] BSTR taskFile

Initializes IConnectorProxy for stateful task execution. This method must be called prior to calling Exec ( ).

Syntax

proxy.Open(connector, taskFile)

Input Parameters

Name Description Type
connector Fully qualified Java class name of the IConnectorAccess implementation. String
taskFile A path to the task file to open. This can be a file or a URL. String

Exec

HRESULT Exec([in]BSTR taskID, [in] BSTR input[out, retval] BSTR* output)

Executes a stateful task. The Open ( ) method must be called first, after which, this method can be called repeatedly. Close ( ) must be called when finished.

Syntax

Output = proxy.Exec ((taskID, input)

Input Parameters

Name Description Type
TaskID The name of the task. String
Input The XML inputs for the task. String

Output Parameters

Name Description Type
Output The XML results of the task execution. String

Close

HRESULT Close ( )

Releases all resources associated with IConnectorProxy.

Syntax

proxy.Close( )

Related Topics
Bullet Building Applications Using Native Win32 Technologies
Bullet Javadocs for Attachmate Interfaces
Bullet Proxy Service Interface ASP Sample
Bullet Proxy Service Interface C# Sample
  Attachmate