*** This interface provides Binary Compatibility only, not Source Compatibility ***

com.sas.services.information.metadata
Interface SASLibraryInterface

All Superinterfaces:

com.sas.services.information.metadata.DeployedDataPackageInterface, MetadataInterface, PublicObjectInterface, RelationalSchemaInterface, java.rmi.Remote

public interface SASLibraryInterface
extends RelationalSchemaInterface

Field Summary

static java.lang.String	ENGINE_KEY Key used to obtain the engine name from a library assignment Map created by genAssignLibrefMap
static java.lang.String	NAME_KEY Key used to obtain the libref name from a library assignment Map created by genAssignLibrefMap
static java.lang.String	OPTIONS_KEY Key used to obtain the options parameter of a library assignment Map created by genAssignLibrefMap
static java.lang.String	PATH_KEY Key used to obtain the library path name from a library assignment Map created by genAssignLibrefMap

Fields inherited from interface com.sas.services.information.metadata.MetadataInterface

METADATA_STATE_DELETED, METADATA_STATE_DESTROYED, METADATA_STATE_NEW, METADATA_STATE_NORMAL, PERMISSION_READMETADATA, PERMISSION_WRITEMETADATA

Method Summary

java.lang.String	generateLibref() Generate a SAS Libref statement for this library.
java.lang.String	generateLibref(java.lang.String prompt, boolean encodePasswords, boolean genFilenameForXMLLibs, boolean ignorePreassigned) Generate a SAS Libref statement for this library.
java.util.Map	generateLibrefMap(java.lang.String prompt, boolean encodePasswords, boolean genFilenameForXMLLibs, boolean ignorePreassigned, java.lang.String overrideLibname) Generate a library assignment java.util.Map for a SASLibrary stored in metadata.
java.lang.String	getEngine() Get the SAS engine name.
java.lang.String	getLibref() Get the SAS libref string.
java.util.List	getPhysicalTables() Return just the PhysicalTableInterface objects that are associated to this library.
com.sas.services.information.metadata.SASLibraryInterface.PreAssignmentType	getPreAssignmentType() Gets the PreAssignment type of the library
java.util.List	getWorkspaceServers() Returns a List of Logical workspace servers that can access this SASLibrary.
boolean	isDBMSLibname() Does this SASLibrary represent a DBMS libname.
boolean	isPreassigned() Is this SASLibrary preassigned.
void	setEngine(java.lang.String engine) Set the engine string for the SASLibrary.
void	setIsDBMSLibname(boolean value) Set the value of the isDMBSLibname attribute.
void	setIsPreassigned(boolean flag) Set the flag indicating if the SASLibrary is preassigned or not.
void	setLibref(java.lang.String libref) Set the libref string for the library.
void	setPreAssignmentType(com.sas.services.information.metadata.SASLibraryInterface.PreAssignmentType type) Sets the PreAssignment type of the Library

Methods inherited from interface com.sas.services.information.metadata.RelationalSchemaInterface

addTable, getDatabaseCatalog, getTables, removeTable, setDatabaseCatalog

Methods inherited from interface com.sas.services.information.metadata.MetadataInterface

add, addAccessControl, addAttribute, addAttributes, addDocument, addExtension, addGroup, addImplementor, addKeyword, addObjectProperty, addObjectProperty, addPermissions, addPrompt, addPropertySet, addRemark, addResponsibleParty, addTransactionListener, addUsedByPrototype, checkin, checkout, commit, copyTo, countAssociatedObjects, delete, deleteAttribute, deleteAttributes, destroy, getAccessControls, getAttribute, getAttributes, getAuthorizationUtil, getCreateDate, getDescription, getDocuments, getEntityKey, getEntityURL, getExtensions, getGroups, getGUID, getIdentities, getImplementors, getKeywords, getLockedBy, getModifyDate, getObjectProperties, getParent, getParentPath, getParents, getPath, getPaths, getPermission, getPermissions, getPermissions, getPreviousVersionNames, getPrimaryPropertyGroup, getPrompt, getPrompts, getPropertyBag, getPropertySets, getRemarksList, getReposId, getRepository, getRepositoryEntity, getRepositoryName, getReposKey, getResponsibleParties, getState, getTrackingId, getType, getUsageVersion, getUsedByPrototypes, getUsingPrototype, getVersion, isAuthorized, isCompatible, isDeleted, isDestroyed, isLoggingEnabled, isObjectAlive, isReadCompatible, logMessage, mapNameToFilesystem, mapUrlToFilesystem, moveTo, newServiceObject, refresh, removeAccessControl, removeDocument, removeExtension, removeGroup, removeImplementor, removeKeyword, removeObjectProperty, removePermissions, removePrompt, removePropertySet, removeResponsibleParty, removeUsedByPrototype, rollback, setAttribute, setAttributes, setDeleted, setDescription, setDocuments, setExtensions, setGroups, setGUID, setKeywords, setName, setObjectProperties, setPermission, setPrimaryPropertyGroup, setPrompt, setPrompts, setRemarksList, setRepository, setUsingPrototype, startTransaction, toByteArray, transactionEvent, uncheckout, update, updateFromBag, version

Methods inherited from interface com.sas.services.information.publicobject.PublicObjectInterface

addProcessorInterface, getContainer, getIdentifier, getName, getObjectURI, getPathUrl, getProcessorInterface, getTypeDescriptor

Field Detail

NAME_KEY

static final java.lang.String NAME_KEY

Key used to obtain the libref name from a library assignment Map created by genAssignLibrefMap

See Also:

Constant Field Values

ENGINE_KEY

static final java.lang.String ENGINE_KEY

Key used to obtain the engine name from a library assignment Map created by genAssignLibrefMap

See Also:

Constant Field Values

PATH_KEY

static final java.lang.String PATH_KEY

Key used to obtain the library path name from a library assignment Map created by genAssignLibrefMap

See Also:

Constant Field Values

OPTIONS_KEY

static final java.lang.String OPTIONS_KEY

Key used to obtain the options parameter of a library assignment Map created by genAssignLibrefMap

See Also:

Constant Field Values

Method Detail

isDBMSLibname

boolean isDBMSLibname()
                      throws ServiceException,
                             java.rmi.RemoteException

Does this SASLibrary represent a DBMS libname.

Returns:

True if it is a DBMS libname, false otherwise.

Throws:

ServiceException - If a repository error occurs.

java.rmi.RemoteException - In the event of remote object failure.

setIsDBMSLibname

void setIsDBMSLibname(boolean value)
                      throws ServiceException,
                             java.rmi.RemoteException

Set the value of the isDMBSLibname attribute.

Parameters:

value - The new value of isDMBSLibname.

Throws:

ServiceException - If a repository error occurs.

java.rmi.RemoteException - In the event of remote object failure.

getEngine

java.lang.String getEngine()
                           throws ServiceException,
                                  java.rmi.RemoteException

Get the SAS engine name.

Returns:

The SAS engine name.

Throws:

ServiceException - If a repository error occurs.

java.rmi.RemoteException - In the event of remote object failure.

setEngine

void setEngine(java.lang.String engine)
               throws ServiceException,
                      java.rmi.RemoteException

Set the engine string for the SASLibrary.

Parameters:

engine - The String representing the engine.

Throws:

ServiceException - If a repository error occurs.

java.rmi.RemoteException - In the event of remote object failure.

getLibref

java.lang.String getLibref()
                           throws ServiceException,
                                  java.rmi.RemoteException

Get the SAS libref string.

Returns:

The SAS libref string.

Throws:

ServiceException - If a repository error occurs.

java.rmi.RemoteException - In the event of remote object failure.

setLibref

void setLibref(java.lang.String libref)
               throws ServiceException,
                      java.rmi.RemoteException

Set the libref string for the library.

Parameters:

libref - The new libref string.

Throws:

ServiceException - If a repository error occurs.

java.rmi.RemoteException - In the event of remote object failure.

isPreassigned

boolean isPreassigned()
                      throws ServiceException,
                             java.rmi.RemoteException

Is this SASLibrary preassigned.

Returns:

True if this is a preassigned library, false otherwise.

Throws:

ServiceException - If a repository error occurs.

java.rmi.RemoteException - In the event of remote object failure.

setIsPreassigned

void setIsPreassigned(boolean flag)
                      throws ServiceException,
                             java.rmi.RemoteException

Set the flag indicating if the SASLibrary is preassigned or not.

Parameters:

flag - true if the library should be preassigned. False otherwise.

Throws:

ServiceException - If a repository error occurs.

java.rmi.RemoteException - In the event of remote object failure.

generateLibref

java.lang.String generateLibref()
                                throws ServiceException,
                                       java.rmi.RemoteException

Generate a SAS Libref statement for this library.

Returns:

A String containing a SAS Libref statement.

Throws:

ServiceException - If a repository error occurs.

java.rmi.RemoteException - In the event of remote object failure.

generateLibref

java.lang.String generateLibref(java.lang.String prompt,
                                boolean encodePasswords,
                                boolean genFilenameForXMLLibs,
                                boolean ignorePreassigned)
                                throws ServiceException,
                                       java.rmi.RemoteException

Generate a SAS Libref statement for this library. Use the parameters provided to configure the output.

Parameters:

prompt - A prompt string to use if a challenge callback is set up and credentials are required from the user.

encodePasswords - True to encode any passwords in the libref.

genFilenameForXMLLibs - True to generate file names for XML libraries.

ignorePreassigned - True to ignore preassigned libname information.

Returns:

The libref String.

Throws:

ServiceException - If a repository error occurs.

java.rmi.RemoteException - In the event of remote object failure.

generateLibrefMap

java.util.Map generateLibrefMap(java.lang.String prompt,
                                boolean encodePasswords,
                                boolean genFilenameForXMLLibs,
                                boolean ignorePreassigned,
                                java.lang.String overrideLibname)
                                throws ServiceException,
                                       java.rmi.RemoteException

Generate a library assignment java.util.Map for a SASLibrary stored in metadata. The key-value pairs in the generated Map represent the parameters needed to assign a libref using the com.sas.iom.SAS.IDataService.AssignLibref method

Parameters:

prompt - A prompt string to use if a challenge callback is set up and credentials are required from the user.

encodePasswords - True to encode any passwords in the libref.

genFilenameForXMLLibs - True to generate file names for XML libraries.

ignorePreassigned - True to ignore preassigned libname information.

overrideLibname - override for the default libref name associated with this library or null

Returns:

a Map with the keys defined in this interface

Throws:

ServiceException - If a service level error occurs.

java.rmi.RemoteException - In the event of remote object failure.

getPhysicalTables

java.util.List getPhysicalTables()
                                 throws ServiceException,
                                        java.rmi.RemoteException

Return just the PhysicalTableInterface objects that are associated to this library.

Returns:

A List of the PhysicalTable objects in this library.

Throws:

ServiceException - If a repository error occurs.

java.rmi.RemoteException - In the event of remote object failure.

getWorkspaceServers

java.util.List getWorkspaceServers()
                                   throws ServiceException,
                                          java.rmi.RemoteException

Returns a List of Logical workspace servers that can access this SASLibrary. It traverses the DeployedComponents association, which should find ServerContext objects. It then gets those objects' Logical Servers, and checks for a class id that indentifies them as workspace servers.

Returns:

A List of Workspace servers that can access this library.

Throws:

ServiceException - If a repository error occurs.

java.rmi.RemoteException - In the event of remote object failure.

setPreAssignmentType

void setPreAssignmentType(com.sas.services.information.metadata.SASLibraryInterface.PreAssignmentType type)
                          throws ServiceException,
                                 java.rmi.RemoteException

Sets the PreAssignment type of the Library

Parameters:

type -

Throws:

ServiceException - - If a repository error occurs.

java.rmi.RemoteException - - In the event of remote object failure.

getPreAssignmentType

com.sas.services.information.metadata.SASLibraryInterface.PreAssignmentType getPreAssignmentType()
                                                                                                 throws ServiceException,
                                                                                                        java.rmi.RemoteException

Gets the PreAssignment type of the library

Returns:

Throws:

ServiceException - - If a repository error occurs.

java.rmi.RemoteException - - In the event of remote object failure.

*** This interface provides Binary Compatibility only, not Source Compatibility ***