Chapter 2 Working with the Component Builder

Deploying AI components

Once you have defined a component with one or more methods, you can deploy it to EAServer, where it can then be used in EAServer client applications.

Using the deployment wizard

The Component Builder includes a wizard that makes it easy to deploy components. The wizard:

Defines the component in EAServer
Copies the connection and Java source code for the component to the EAServer java\classes directory
Compiles the Java source code for the component on EAServer

When you deploy a component to EAServer, you must provide the information described in Table 2-7:

Table 2-7: Information needed by the Deploy Components wizard
Wizard dialog box	Field	Description
Jaguar connection information	User Name	Valid EAServer user ID.
Password	Valid password for EAServer user ID.
Host Name	Name of the machine on which EAServer is running. EAServer must be running.
Port Number	Number of the IIOP port on which EAServer is listening.
Jaguar package information	Package Name	The package name currently selected for this component. Enter a new name, accept the selected name, or select a different name from the Existing Packages field.
Existing Packages	The list of package names currently available. Click a package name to select the package. EAServer system packages (such as CosNaming) are not displayed.

After you provide the information needed by the wizard, the Deployment Progress window shows the status of component deployment. If deployment is not successful, use the messages that appear in the Deployment Progress window to troubleshoot errors.

For each EAServer you deploy components into, the first time you deploy a component, a message indicates that the feature for deploying components is not yet installed in EAServer. Click OK to install this feature.

Deploying components to EAServer

Each AI for Stored Procedures component built and deployed to EAServer consists of a set of Java classes that work with the AI for Stored Procedures Adapter.

The Adapter is a library of classes that provides access to server stored procedures and statements using JDBC drivers. The Adapter also provides security, transaction control, datatype conversion, and error-handling integration.

For each component that is deployed, AI for Stored Procedures creates (or modifies, if one already exists) the following items on EAServer:

An EAServer package (if a package with the specified package name does not already exist)
An EAServer component definition
An IDL module (modified, if it already exists)
An IDL interface
Java source files for the component
Java class files for the component
A file that contains the component's connection

When components are deployed into EAServer:

The EAServer package and IDL module are created only if they do not already exist.
- If the package already exists, AI for Stored Procedures adds the new component to the existing package.
- If the module already exists, the IDL interface is added to the existing module.
The Application Integrator deployment feature creates implementation files and stores them in the <EAServer_install_dir>\java\classes directory.
The component connection is created in a file named connection_name.ser in the <EAServer_install_dir>\java\classes\SybAiConnections directory.
The Application Integrator component definition is added to the EAServer repository. Application Integrator components also include a collection of user-defined EAServer properties, which allow you to configure additional properties for the component, such as debugging and connection caching.

If the properties need to be changed, you can edit them in Jaguar Manager. See Chapter 3, "EAServer and Application Issues" for details.

Deploying connections to EAServer

When you deploy a component into EAServer, the Component Builder also deploys the connection that is associated with the component.

When a component is deployed into EAServer, the information for the component's connection is sent to EAServer in the form of a serialized file, which is located in the EAServer installation directory structure (in the <EAServer_install_dir>\ java\classes\SybAIConnections directory).
If you need to change connection information for a component, you must edit the connection in the Component Builder, and then redeploy the component and connection.