Chapter 12 Calling Jaguar Component Methods from PowerDynamo

What does Jaguar bring to PowerDynamo applications?

Jaguar is a platform-independent component transaction server that allows you to develop component-based applications that can be accessed by thousands of clients simultaneously. Jaguar brings flexibility to PowerDynamo scripts by allowing you to create a component, deploy it to the Jaguar server, and share it among remote sites using PowerDynamo scripts that call the Jaguar component.

PowerDynamo also brings flexibility to Jaguar by providing a means for accessing Jaguar components and their business logic through an ultra-thin intranet or Internet client.

The benefits of using Jaguar CTS components with PowerDynamo

Jaguar components can be:

Java/Enterprise JavaBeans
CORBA C++
ActiveX (nonvisual)
C
PowerBuilder NVO

You can call these components from within a Dynamo script as stored procedures or as ActiveX or Java objects. The type of component being accessed is irrelevant to the client.

The main benefits to using Jaguar components in Dynamo scripts include:

Business logic stored in one Jaguar component becomes available to many presentation-independent clients.
Jaguar makes powerful native code components such as C and C++ available for execution by Dynamo scripts that would otherwise not have access to methods written in those languages. There are few limitations on the languages Dynamo scripts can use.
Components can be updated in one location. Without Jaguar, changes to a component or a stored procedure would be required at each client. Setting up Dynamo to access Jaguar components can be as simple as creating a connection to the Jaguar CTS server or installing the ActiveX proxy server.

The way that Jaguar components are accessible by Dynamo is advantageous because there are no restrictions on how Dynamo can manipulate the component results. The component results, in the form of HTML pages, are wholly controlled by Dynamo.

A brief summary on setting up clients to access Jaguar CTS is given in the next section. For detailed information on setting up clients that require Jaguar access, see the Jaguar CTS Programmer's Guide.

MASP method calls versus ActiveX or Java objects

There are a few benefits to using ActiveX or Java objects against a Jaguar component instead of MASP method calls:

ActiveX or Java objects exist until they go out of scope, whereas MASP calls create an instance of the component, execute it, and destroy it immediately.
ActiveX or Java objects can give any type of return. MASP calls, from PowerDynamo, can return only a result set.
ActiveX or Java objects are treated like normal DynaScript objects, while MASP calls (except the connection.CreateComponent method) require that you enter a full string each time you make a call.

If a script requires repeated use of a Jaguar component, creating an ActiveX object or Java stub is the preferred method of working with a Jaguar component and its methods. ActiveX, however, is a Microsoft technology, which means it is only available on Microsoft operating systems. Java, on the other hand, is platform-independent, which means that Java objects can run anywhere.