Contents Developing Java Clients  

CORBA Interface IStoredProcessService

A service to execute SAS language programs that are stored on a server.

Definition

CORBA Module SAS

IStoredProcessService Description

This component is a service for executing stored processes. A stored process is a SAS language program stored in a repository on the server host's file system. This service enables you to execute stored processes by name and, optionally, receive the results as a ResultPackage.

CORBA Definitions
 attribute Parent  The LanguageService.
 attribute Repository  Designates the repository for stored processes in this SAS workspace.
 attribute ResultPackageArchivePath  LDAP URL naming the server file system directory where result package archives are stored.
 method Execute  Execute a stored process.
 method ExecuteWithResults  Execute a stored process that returns results.
 method Define  Define a stored process to the designated repository (not currently implemented).
 method RetrieveDefinition  Retrieve a stored process from the designated repository (not currently implemented).
 method DeleteDefinition  Delete a stored process from the designated repository (not currently implemented).


Java Classes
 IStoredProcessServiceHelper  Used to manipulate the IStoredProcessService type
 IStoredProcessServiceHolder  Used to process the IStoredProcessService type as an out parameter


Java Interfaces
 IStoredProcessService  A service to execute SAS language programs that are stored on a server.


Java Interface IStoredProcessService

A service to execute SAS language programs that are stored on a server.

Package com.sas.iom.SAS

IStoredProcessService Description
This component is a service for executing stored processes. A stored process is a SAS language program stored in a repository on the server host's file system. This service enables you to execute stored processes by name and, optionally, receive the results as a ResultPackage.

public interface IStoredProcessService
extends org.omg.CORBA.Object

Method Summary

 void Execute ( java.lang.String name , java.lang.String nameValuePairs )
throws ( GenericError );

Execute a stored process.

 void ExecuteWithResults ( java.lang.String name , java.lang.String nameValuePairs , IResultPackageHolder resultPackage )
throws ( GenericError );

Execute a stored process that returns results.

 void Define ( java.lang.String name , java.lang.String nameValuePairs , java.lang.String[] sourceLines )
throws ( GenericError );

Define a stored process to the designated repository (not currently implemented).

 void RetrieveDefinition ( java.lang.String name , org.omg.CORBA.StringHolder nameValuePairs , StringSeqHolder sourceLines )
throws ( GenericError );

Retrieve a stored process from the designated repository (not currently implemented).

 void DeleteDefinition ( java.lang.String name )
throws ( GenericError );

Delete a stored process from the designated repository (not currently implemented).


CORBA Attribute Parent (readonly)

The LanguageService.

Description
This LanguageService containing this component.

Usage

Java Method Parent

public ILanguageService Parent ();


CORBA Attribute Repository

Designates the repository for stored processes in this SAS workspace.

Description
This attribute specifies the repository which is searched when a stored process is executed.

Usage
This attribute specifies the repository to be used by the other methods in this service. The repository name must be formed with a location prefix. A prefix of "FILE:" designates that the repository is implemented as a directory in the server's file system. The remainder of the string is the directory pathname.

Additional prefixes might become available in a future release. For example, the "LDAP:" prefix could indicate that the repository location should be resolved through a directory lookup operation for the distinguished name indicated by the supplied LDAP URL.

Java Method Repository

public java.lang.String Repository ();
public void Repository ( java.lang.String Repository );


CORBA Attribute ResultPackageArchivePath

LDAP URL naming the server file system directory where result package archives are stored.

Description
This attribute specifies the LDAP URL for the sasArchivePaths directory entry. This LDAP directory entry names a file system directory at which to store the result package archives that are created from stored processes executed by this service.

Usage

Java Method ResultPackageArchivePath

public java.lang.String ResultPackageArchivePath ();
public void ResultPackageArchivePath ( java.lang.String ResultPackageArchivePath );


CORBA Method Execute

Execute a stored process.

Description
This method executes a stored process. The stored process definition is found in the location identified by the Repository attribute. The "name" parameter indicates the particular stored process definition within this repository. The provided "nameValuePairs" parameter to this operation supplies the name-value pairs used in the stored process execution.

Usage

Java Method Execute

void Execute (

    java.lang.String name ,
    java.lang.String nameValuePairs 
    )
    throws (
            GenericError
    );

Parameter Details

Parameter Direction Type Description
name  in  java.lang.String  The stored process name within the Repository.  
nameValuePairs  in  java.lang.String  A single string containing one or more name-value pairs used in the stored process execution. The pairs are specified as "name=value" and are blank separated.  


CORBA Method ExecuteWithResults

Execute a stored process that returns results.

Description
Execute the stored process defined with the provided name using the provided name/value parameters and return results. This method is similar to Execute, but it also returns a ResultPackage containing the outputs from the execution of the stored process.

The stored process must create the package and then and publish publish it using the "TO_REQUESTER" transport in the PACKAGE_PUBLISH call. See the Integration Technologies Library - Application Facilities documentation for an explanation of how a SAS language program can create and publish a result package.

Usage

Java Method ExecuteWithResults

void ExecuteWithResults (

    java.lang.String name ,
    java.lang.String nameValuePairs ,
    IResultPackageHolder resultPackage 
    )
    throws (
            GenericError
    );

Parameter Details

Parameter Direction Type Description
name  in  java.lang.String  The stored process name within the Repository.  
nameValuePairs  in  java.lang.String  A single string containing one or more name-value pairs used in the stored process execution. The pairs are specified as "name=value" and are blank separated.  
resultPackage  out  IResultPackageHolder  The result package created by the stored process.  


CORBA Method Define

Define a stored process to the designated repository (not currently implemented).

Description

Usage

Java Method Define

void Define (

    java.lang.String name ,
    java.lang.String nameValuePairs ,
    java.lang.String[] sourceLines 
    )
    throws (
            GenericError
    );

Parameter Details

Parameter Direction Type Description
name  in  java.lang.String   
nameValuePairs  in  java.lang.String   
sourceLines  in  java.lang.String[]   


CORBA Method RetrieveDefinition

Retrieve a stored process from the designated repository (not currently implemented).

Description

Usage

Java Method RetrieveDefinition

void RetrieveDefinition (

    java.lang.String name ,
    org.omg.CORBA.StringHolder nameValuePairs ,
    StringSeqHolder sourceLines 
    )
    throws (
            GenericError
    );

Parameter Details

Parameter Direction Type Description
name  in  java.lang.String   
nameValuePairs  out  org.omg.CORBA.StringHolder   
sourceLines  out  StringSeqHolder   


CORBA Method DeleteDefinition

Delete a stored process from the designated repository (not currently implemented).

Description

Usage

Java Method DeleteDefinition

void DeleteDefinition (

    java.lang.String name 
    )
    throws (
            GenericError
    );

Parameter Details

Parameter Direction Type Description
name  in  java.lang.String   


Contents Developing Java Clients