LIBNAME Statement for WebDAV Server Access

Arguments

libref

specifies a shortcut name for the aggregate storage location where your SAS files are stored.

Tip:The association between a libref and a SAS library lasts only for the duration of the SAS session or until you change it or discontinue it with another LIBNAME statement.

'SAS-library'

specifies the URL location (path) on a WebDAV server. The URL specifies either HTTP or HTTPS communication protocols.

Restriction:Only one data library is supported when using the WebDAV extension to the LIBNAME statement.

Requirement:When using the HTTPS communication protocol, you must use the SSL (Secure Sockets Layer) protocol that provides secure network communications. For more information, see Encryption in SAS.

engine

specifies the name of a valid SAS engine.

Restriction:REMOTE engines are not supported with the WebDAV options.

See:For a list of valid engines, see the SAS documentation for your operating environment.

CLEAR

disassociates one or more currently assigned librefs. When a libref using a WebDAV server is cleared, the cached files stored locally are deleted also.

Tip:Specify libref to disassociate a single libref. Specify _ALL_ to disassociate all currently assigned librefs.

LIST

writes the attributes of one or more SAS libraries to the SAS log.

Tip:Specify libref to list the attributes of a single SAS library. Specify _ALL_ to list the attributes of all SAS libraries that have librefs in your current session.

_ALL_

specifies that the CLEAR or LIST argument applies to all currently assigned librefs.

LIBNAME Options

WebDAV Specific Options

WEBDAV

specifies that the libref access a WebDAV server.

USER="user-ID"

specifies the user name for access to the WebDAV server. The user ID is case sensitive and it must be enclosed in single or double quotation marks.

Alias:UID

Tip:If PROMPT is specified, but USER= is not, then the user is prompted for an ID as well as a password.

PASSWORD="user-password"

specifies a password for the user to access the WebDAV server. The password is case sensitive and it must be enclosed in single or double quotation marks.

Alias:PWD=, PW=, PASS=

Tip:You can specify the PROMPT option instead of the PASSWORD= option.

PROMPT

specifies to prompt for the user login password, if necessary.

Interaction:If PROMPT is specified without USER=, then the user is prompted for an ID, as well as a password.

Tip:If you specify the PROMPT option, you do not need to specify the PASSWORD= option.

AUTHDOMAIN="auth-domain"

specifies the name of an authentication domain metadata object in order to connect to the WebDAV server. The authentication domain references credentials (user ID and password) without your having to explicitly specify the credentials. The auth-domain name is case sensitive, and it must be enclosed in double quotation marks.

An administrator creates authentication domain definitions while creating a user definition with the User Manager in SAS Management Console. The authentication domain is associated with one or more login metadata objects that provide access to the WebDAV server and is resolved by the BASE engine calling the SAS Metadata Server and returning the authentication credentials.

Requirement:The authentication domain and the associated login definition must be stored in a metadata repository, and the metadata server must be running in order to resolve the metadata object specification.

Interaction:If you specify AUTHDOMAIN=, you do not need to specify USER= and PASSWORD=.

See:For complete information about creating and using authentication domains, see the discussion on credential management in the SAS Intelligence Platform: Security Administration Guide.

PROXY=url

specifies the Uniform Resource Locator (URL) for the proxy server in one of these forms:

• "http://hostname"
• "http://hostname:port"

LOCALCACHE="directory name"

specifies a directory where a temporary subdirectory is created to hold local copies of the server files. Each libref has its own unique subdirectory. If a directory is not specified, then the subdirectories are created in the SAS WORK directory. SAS deletes the temporary files when the SAS program completes.

Default:SAS WORK directory

LOCKDURATION=n

specifies the number of minutes that the files written through the WebDAV libref are locked. SAS unlocks the files when the SAS program successfully completes. If the SAS program fails, then the locks expire after the time allotted.

Default:30