Using the IOM Server

This section introduces the steps necessary to construct and execute a Java application that uses the IOM server. As you become more familiar with Java client programming for the IOM server, you can build on these steps to exploit the more sophisticated features of the IOM server.

• a metadata server (SAS Metadata Server or LDAP server).
• server parameters supplied directly in the source code. (You can supply a ManualConnectionFactoryConfiguration object directly in the source code. For details, see Connecting with Directly Supplied Server Properties).

If you are using a SAS Metadata Server or supplying server parameters directly in the source code, the Connection Service can connect to SAS Workspace Servers, other metadata servers, SAS OLAP Servers, and SAS Stored Process Servers.

Note: If you are using an LDAP server, the Connection Service interface can only connect to workspace servers. Under LDAP, Integration Technologies does not support access to other types of IOM servers.

Note: The Version 8 Workspace Factory interface is still supported. However, it is recommended that you use the Java Connection Factory interface in order to take advantage of the new features available with SAS 9 Integration Technologies.

Using a Metadata Server with the Connection Service

If you are using a metadata server, the first step in developing and running a client program is to make sure you have access to a properly configured server. You can access a server by reading the connection information from a metadata server:

• If you are using a SAS Metadata Server, refer to the SAS Integration Technologies: Server Administrator's Guide for information about server configuration in various environments.
• If you are using an LDAP server, refer to the SAS Integration Technologies: Administrator's Guide (LDAP Version) for information about server configuration in various environments.

As is the case in client development, you can start with a basic server configuration and then move into more a sophisticated configuration over time.

After the IOM server has been configured, you can begin developing a Java client for the IOM server.

Connecting a Java Client to an IOM Server

With SAS 9 Integration Technologies, Java clients can use the Java Connection Factory interface to access an IOM server as follows:

1. From the Java Connection Factory, obtain a connection to an IOM server. Then, obtain the remote object reference connected to that IOM server and narrow it to the appropriate remote interface.

2. Use Java CORBA stubs for IOM objects and JDBC connection objects to exploit the power of SAS in the IOM server.

3. Return the Connection to the Java Connection Factory for disconnection or reuse.

Java clients can also still use the Workspace Factory to access an IOM server as follows:

1. From the Workspace Factory, obtain a Workspace remote object reference connected to an IOM server.

2. Use Java CORBA stubs for IOM objects and JDBC connection objects to exploit the power of SAS in the IOM server.

3. Return the Workspace object to the Workspace Factory for disconnection or reuse.

To get started, you can put together a simple client application by composing the examples given for each step. Then you can continue to read the additional documentation that is provided and learn about Java client programming for the IOM server in greater detail.