Files Added by the Stored Process Java Client Template

Introduction

When you add the “Java client for executing a SAS Stored Process” template to a SAS Java Project, the following files are added to the source folder for the project.

StoredProcessDriver.java

This class is an example of a Java console application client for executing a SAS Stored Process and writing the stored process results (and optionally the SAS Log) to a file. The default name of the class is StoredProcessDriver, but the actual name is derived from the class name for the client that was entered in the wizard.

StoredProcessConnection.java

A StoredProcessConnection contains the information needed to use SAS Foundation Services, a SAS Metadata repository, and the SAS Stored Process Service for executing SAS Stored Processes. The class initializes and connects to SAS Foundation Services in preparation for executing SAS stored processes, and binds a StoredProcessFacade with the StoredProcessDriver.
SAS does not support customer implementations or extension of this class. The StoredProcessConnection generated for a SAS Java Project cannot be used in a SAS Web Application Project.

StoredProcessFacade.java

A StoredProcessFacade represents a SAS Stored Process and the results of its execution after the stored process has been executed. The StoredProcessFacade class wraps two interfaces from the SAS Stored Process Service: com.sas.services.storedprocess.StoredProcess2Interface and com.sas.services.storedprocess.Execution2Interface.
This class can supply input parameters for the SAS Stored Process. Output parameter results or streaming results can be retrieved after the stored process is executed. The StoredProcessFacade provides other API methods for common operations, including the ability to access the underlying StoredProcess2Interface and Execution2Interface objects.
For more information, see the SAS Foundation Services Javadoc contained in the SAS BI API Documentation on the SAS AppDev Studio Developer’s Site ( http://support.sas.com/rnd/appdev/), in particular the package summary for com.sas.services.storedprocess.
SAS does not support customer implementations or extension of this class. The StoredProcessFacade generated for a SAS Java Project cannot be used in a SAS Web Application Project.

StoredProcessDriver.properties

This file contains information about the SAS Metadata Server, and specifies log and output filenames for the results of executing the SAS Stored Process. These values can be changed so that the generated client can use a different SAS Metadata Server. The default name of this file is StoredProcessDriver, but the actual name is derived from the class name for the client that was entered in the wizard.

jaas.config

This is the JAAS configuration file that is required by the Local Platform Services that are used in the Java application. Although the comment at the top of the file might claim the file is for a SAS Web Application, the file is also used with SAS Java Applications.

launchParameters.txt

This file provides an example of the Java System property that is needed to specify the JAAS configuration file that the Local Platform Services require. This Java System property must be included in the command line or launch configuration used to run the stored process Java application.