Architecture and Installation

The Arcana Scheduler COM API provides an interface between your client application and the Arcana Scheduler service, which does the actual work of running scheduled jobs.

Installation

The Arcana Scheduler COM API is completely contained within adscom.dll. This DLL includes the proxy/stub information needed to use the component remotely (through DCOM).

The DLL is registered automatically when the Arcana Scheduler service is installed on a computer. You must register the DLL (using regsvr32.exe) on each other computer from which you wish to run client applications. For basic usage of the API, no other installation is required on the client computer.

Remote Connections Using DCOM

To establish a connection with the Scheduler service on a given computer, your application must create an instance of the ADSSession class on the computer on which the service is installed.

For example, the client application on the remote computer in the diagram above would use CoCreateInstanceEx (C++) or CreateObject (Visual Basic) to create the ADSSession on the server, not on the remote computer itself.

Installation for Remote Connections Using ConnectRemote

The ConnectRemote method provides an alternative to using DCOM and may provide better performance on slow networks. When you use this method, the API objects are all created locally on the client computer, rather than on the server through DCOM.

However, this approach requires that more files be installed on the client computer. In addition to installing and registering adscom.dll, you must install the following files to the client computer's winnt\system32 directory (registration of these DLLs is not required):

adscheduler.dll
adlicense.dll
adutil.dll
bds52t.dll
cw3230mt.dll

The "Arcana Scheduler ActiveX Component" option in the Arcana Scheduler setup program can be used to install the necessary DLLs on the client computer, or you may do so manually or in your own setup program.