This file contains information for Java programmers who want to write applications to interact with the SAS platform using SAS Foundation Services which provide a set of core infrastructure services. Foundation services are provided for the following:
Extension services for event management, information publishing, stored process execution, and an enhanced version of the IOM client connection service for Java are also provided.
Production versions of the IOM client class libraries for Java that were distributed in previous releases are also included in the foundation services distribution. See Compatibility with Previous Releases for more information.
Note: Full API documentation for the services is available at
<SAS_HOME>\SASFoundationServices\1.1\doc\api\index.html<SAS_HOME>/SASFoundationServices/1.1/doc/api/index.htmlAlso included are SAS Management Console plug-ins that enable you to manage administration and configuration tasks for various components of SAS Integration Technologies.
The JAR files contain the following packages:
| Package name | Component Description |
|---|---|
| sas.svc.connection.jar | |
| com.sas.services.connection | Connection Service |
| com.sas.services.connection.jndi | Connection Service Tools for JNDI/LDAP |
| com.sas.iom | Workspace Factory for Java |
| com.sas.iom.* | IOM Workspace Server Proxies |
| com.sas.rio | IOM Driver for JDBC |
| com.sas.net.brg.orb | IOM Bridge for Java |
| com.sas.net.util | Connection Utilities |
| org.omg.PortableServer.* | CORBA ORB Interface |
| sas.svc.connection.platform.jar | |
| com.sas.services.connection.omr | Connection Service Tools for the SAS Metadata Repository |
| com.sas.services.connection.platform | Connection Service Tools for SAS Foundation Services |
| sas.iom.tools.jar | |
| com.sas.net.omgidl | IDL-to-Java compiler |
| sas.svc.core.jar | |
| com.sas.services.discovery.* | Discovery Service |
| com.sas.services.security | User Authentication Service |
| com.sas.services.user | User Context and Profile Service |
| com.sas.services.session | Session Context Service |
| com.sas.services.information.* | Metadata and Content Information Service |
| com.sas.services.logging | Logging Service |
| sas.svc.events.jar | |
| com.sas.services.events.* | Event and Broker Services |
| sas.svc.storedprocess.jar | |
| com.sas.services.storedprocess.* | Stored Process Service |
| sas.svc.publish.jar | |
| com.sas.services.publish.* | Publish Service |
| sas.svc.webdav.jar | |
| com.sas.services.webdav.* | WebDAV Client Service |
The following SAS Management Console plug-ins are installed with the SAS Foundation Services:
A service deployment containing groups of services is defined to support the foundation infrastructure needs of an application. This plug-in provides the capability to manage an application's foundation services including utilities to export/import metadata from a SAS Metadata Server to/from an XML file.
You must have the Sun Java 2 Runtime Environment, Standard Edition, v 1.4.1.
For communication with a SAS server, your client machine must have a valid TCP/IP configuration. In addition, the IOM Bridge server you want to access from a Java program must be reachable over the network from the client machine.
To install the SAS Management Console plug-ins, you must have SAS Management Console installed.
Note: The API documentation for foundation services is installed with the software.
The public Java classes that are provided in the foundation services distribution have run-time dependencies on other JAR files. These JAR files that the public Java classes are dependent upon are either included in the distribution or are available from other third-party sources.
When deploying an application that utilizes these classes, the primary JAR file together with its dependency JAR files should be available in the run-time environment. In some instances, the dependency JAR files only exist for certain features' support.
The event and broker services refer to the contents of sas.svc.events.jar. This JAR contains the following:
| Package | Component Description |
|---|---|
| com.sas.services.events | Event factory used to create events |
| com.sas.services.events.broker.* | Event Broker Service |
| com.sas.services.events.discovery.* | Event Broker Discovery Service |
The event and broker services are dependent upon the following JAR files provided by SAS:
The event and broker services also have dependencies upon the discovery and logging components of foundation services. User services and authentication services are required for authenticating incoming event credentials and running events within a particular user (Subject) context. Other foundation services components might also be required depending on usage model.
The discovery and logging components are dependent upon the following JAR files:
| Discovery | sas.svc.connnection.jar |
|---|---|
| sas.oma.joma.jar | |
| sas.oma.omi.jar | |
| Logging | log4j-1.2.3.jar |
The event and broker services might be configured to monitor a number of optional third-party transports. The following table contains the transport monitor type and its dependent JAR files (some that are licensed by other vendors and not included in our installation) that the event and broker services are dependent upon:
| Transport Monitor |
Dependent JAR File | Vendor | How is it distributed? | License |
|---|---|---|---|---|
| JMS | jms.jar | JMS provider | JMS provider | n/a |
| fscontext.jar | JMS provider | JMS provider | n/a | |
| providerutil.jar | JMS provider | JMS provider | n/a | |
| com.ibm.mq.jar | IBM | WebsphereMQ (MQSeries) JMS provider | n/a | |
| com.ibm.mqjms.jar | IBM | WebsphereMQ (MQSeries) JMS provider | n/a | |
| imq.jar | Sun | SunONEMQ JMS provider | n/a | |
| activation.jar | Sun | SAS Foundation Services | n/a | |
| mail.jar | Sun | SAS Foundation Services | n/a | |
| HTTP (SOAP) |
saaj-ri.jar | Sun | SAS Foundation Services | n/a |
| saaj-api.jar | Sun | SAS Foundation Services | n/a | |
| activation.jar | Sun | SAS Foundation Services | n/a | |
| mail.jar | Sun | SAS Foundation Services | n/a | |
| dom4j.jar | MetaStuff, Ltd. | SAS Foundation Services | License | |
| commons-logging.jar | The Apache Software Foundation | SAS Foundation Services | License |
Java clients that need to encrypt communication with an IOM Bridge server using strong encryption need additional support. This additional encryption support is supplied by SAS/SECURE software. SAS/SECURE software supplies the support necessary to use the following encryption algorithms:
This support is packaged in archives named sasecjav.zip or sasecjav.tar. These archives are available on the SAS/SECURE CD and the SAS/SECURE for Windows CD. For client machines running Windows, the archives are also available in a self-installing executable named secwin.exe that is available on the SAS/SECURE for Windows CD. The archives contain a README file that contains information about using the archive contents. For more information, see the product overview for SAS/SECURE software.
A Window's Java Service Wrapper provided by Tunaki Software is distrubuted (License Agreement) to enable remote SAS Foundation Services to run as a Windows Service. The Wrapper handles user log outs, as well as provides automatic restarts when required.
For users upgrading from Release 8.2 of the IOM Client for Java, the Version 9 update is the connection service component, which is included in the foundation services distribution. In foundation services, the following components are updated, producti on quality, and compatible with software from previous releases:
The following Version 9 JAR filenames replace the Release 8.2 filenames:
| Component Description | Version 9 JAR File | Release 8.2 JAR File |
|---|---|---|
| Workspace Factory for Java | sas.svc.connection.jar sas.core.jar |
brgorb.jar iomdriver.jar iomprx.jar orb.jar netutil.jar |
| IOM Driver for JDBC | ||
| IOM Bridge for Java | ||
| IOM Workspace Server Proxies | ||
| IOM IDL-to-Java compiler | sas.iom.tools.jar | idl2java.jar binder.jar |
| Binder tool | ||
| other IOM server proxies | sas.iom.prx.sasarbor.jar | sasarbor.jar |
| sas.iom.prx.sasgms.jar | sasgms.jar | |
| sas.iom.prx.sasmdx.jar | sasmdx.jar | |
| sas.iom.prx.sasmqx.jar | sasmqx.jar |
You might have written applications that use the old JAR files that were installed in your Java extensions directory. If one of these applications has a missing file (or is an earlier version that is not compatible), the
application will either attempt to download the old file or fail. The application will only attempt to download the file if it has been redirected to the downloading site. To preserve compatibility for these applications while allowing the applications
to use the updated code in the Version 9 JAR files, we have created empty JAR files with the old names and more current version numbers.
To prevent the Java extensions mechanism from downloading old JAR files or failing, copy the empty JAR files with more current version numbers from the <installation_root>\jars\compatibility directory to the
extensions directory. The extensions directory also contains the Version 9 JAR files.
/* * ==================================================================== * * The Apache Software License, Version 1.1 * * Copyright (c) 1999-2001 The Apache Software Foundation. All rights * reserved. * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions * are met: * * 1. Redistributions of source code must retain the above copyright * notice, this list of conditions and the following disclaimer. * * 2. Redistributions in binary form must reproduce the above copyright * notice, this list of conditions and the following disclaimer in * the documentation and/or other materials provided with the * distribution. * * 3. The end-user documentation included with the redistribution, if * any, must include the following acknowlegement: * "This product includes software developed by the * Apache Software Foundation (http://www.apache.org/)." * Alternately, this acknowlegement may appear in the software itself, * if and wherever such third-party acknowlegements normally appear. * * 4. The names "The Jakarta Project", "Commons", and "Apache Software * Foundation" must not be used to endorse or promote products derived * from this software without prior written permission. For written * permission, please contact apache@apache.org. * * 5. Products derived from this software may not be called "Apache" * nor may "Apache" appear in their names without prior written * permission of the Apache Group. * * THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE * DISCLAIMED. IN NO EVENT SHALL THE APACHE SOFTWARE FOUNDATION OR * ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF * USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND * ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT * OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF * SUCH DAMAGE. * ==================================================================== * * This software consists of voluntary contributions made by many * individuals on behalf of the Apache Software Foundation. For more * information on the Apache Software Foundation, please see * <http://www.apache.org/>. * */
Copyright (c) 1999, 2004 Tanuki Software Permission is hereby granted, free of charge, to any person obtaining a copy of the Java Service Wrapper and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sub-license, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. Portions of the Software have been derived from source code developed by Silver Egg Technology under the following license: Copyright (c) 2001 Silver Egg Technology Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sub-license, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
Copyright © 2003-2006 SAS Institute Inc., Cary, NC, USA. All Rights Reserved.