Client Requirements

Connecting to the SAS Metadata Server

The SAS Metadata Server is an object server. It uses the IOM provided by SAS Integration Technologies to communicate with clients.

SAS Integration Technologies provides interfaces that enable you to connect to the SAS Metadata Server generically as an IOM server. When you use these interfaces, you must be familiar with the interfaces and classes that define the SAS Metadata Server and the SAS Open Metadata Interface server interfaces. In addition, you must know how to read and write an XML document to use the metadata access functionality of the IOMI server interface.

As an alternative to the SAS Integration Technologies interfaces, SAS provides the SAS Java Metadata Interface. The SAS Java Metadata Interface hides the details of IOM servers and how to create a connection to a SAS Metadata Server from the client. It provides a Java object interface to the metadata access functionality of the SAS Open Metadata Interface. This object interface defines an interface for each SAS Metadata Model metadata type so that clients can use getter or setter methods to read and write metadata attributes and associations, instead of requiring clients to submit XML metadata property strings that define values, like the IOMI methods do. In addition, it provides methods for connecting to the SAS Metadata Server with the ISecurity, ISecurityAdmin, and IServer server interfaces, so that clients don't need to know the details of their implementation.

Because of its ease of use, the SAS Java Metadata Interface is recommended over the SAS Integration Technologies interfaces, both for performing metadata access tasks and for connecting to the SAS Metadata Server with the non-metadata server interfaces.

The SAS Integration Technologies interfaces continue to be supported for metadata clients that already use them. A metadata client that was created before SAS 9.2 should use the latest SAS Integration Technologies interfaces. Because of architectural changes in the SAS 9.2 Metadata Server, a SAS Open Metadata Interface client created using SAS 9.1 or earlier technology cannot connect to a SAS 9.2 Metadata Server without modification. To prevent access, the SAS 9.2 Metadata Server has a new class factory number, which all clients must specify to connect with a SAS 9.2 Metadata Server. The latest SAS Integration Technologies interfaces use the new class number.

SAS Integration Technologies provides the SAS Object Manager for SAS 9.2 Windows client development, and the Java Connection Factory for SAS 9.2 Java client development. For more information about the interfaces, see the SAS 9.2 Integration Technologies: Windows Client Developer's Guide and the SAS 9.2 Integration Technologies: Java Client Developer's Guide.

Connecting to the SAS Metadata Server with the SAS Java Metadata Interface

The SAS Java Metadata Interface and SAS Open Metadata Interface are contained in JAR files in the SAS 9.2 VJR. For information about the Java Runtime Environment and JAR files required by the SAS Java Metadata Interface, see JRE and JAR Requirements. The server interfaces are provided in the sas.oma.omi.jar file.

A Java client accesses the APIs by importing the appropriate packages, instantiating an object factory, and connecting to the SAS Metadata Server with a handle to the interface that is appropriate for the task that it wants to perform. A SAS Java Metadata Interface client that will perform metadata access tasks imports the com.sas.metadata.remote package. A client that accesses the ISecurity, ISecurityAdmin, or IServer server interface imports the com.sas.metadata.remote package and appropriate interfaces from the com.sas.meta.SASOMI package. For information about the specific com.sas.meta.SASOMI interfaces that are required, see the server interface documentation.

The SAS Java Metadata Interface provides the MdFactory interface to instantiate an object factory for the SAS Metadata Server, and the MdOMRConnection interface for connecting to the SAS Metadata Server. The MdOMRConnection interface includes the following methods to enable you to connect to the SAS Metadata Server:

makeOMIConnection -- connects to the SAS Metadata Server with the SAS Java Metadata Interface. A client uses this interface to read and write metadata.
makeISecurityConnection -- connects to the SAS Metadata Server with ISecurity server interface. ISecurity contains metadata authorization methods. A client uses the ISecurity server interface to request user-defined authorization decisions on access controls that are stored as metadata.
makeISecurityAdminConnection -- connects to the SAS Metadata Server with the ISecurityAdmin server interface. ISecurityAdmin contains security administration methods. A client uses the ISecurityAdmin server interface to administer access controls that are defined directly on resources and to manage ACTs.
makeIServerConnection -- connects to the SAS Metadata Server with the IServer server interface. IServer contains server control methods. A client uses the IServer server interface to pause and resume, refresh, get the status of, and stop the SAS Metadata Server.

For an example of the statements that are required to establish a connection to the SAS Metadata Server with the SAS Java Metadata Interface, see Sample Program. The sample program is a metadata access client.

For more information about the SAS Java Metadata Interface, see Understanding the SAS Java Metadata Interface, and Using the SAS Java Metadata Interface.

For more information about connecting with the non-metadata server interfaces, see Authorization (ISecurity Interface), Security Administration (ISecurityAdmin Interface), and Server Control (IServer Interface).

Server Connection Properties

A client must specify the following server connection properties to connect to a SAS Metadata Server. Optional properties are described in the SAS Integration Technologies documentation.

host: The IP address of the machine hosting the SAS Metadata Server.
port=number: The TCP port to which the SAS Metadata Server listens for requests, and that clients will use to connect to the SAS Metadata Server. The number value must be a unique number from 0 to 65,535. The default port number is 8561.
username: A valid user name on the host machine, or a SAS internal account. For information about internal authentication, see SAS Intelligence Platform: Security Administration Guide.
password: the password for the user name.

Top of Page