SHARESESSIONCNTL= System Option

In a SAS Intelligence Platform environment, specifies the number of connections between SAS clients and a SAS/SHARE server via a SAS server. There can be a single connection for all SAS clients or a separate connection for each SAS client.

Server:	optional
Valid in:	configuration file, SAS invocation, OPTIONS statement, System Options window
Category:	Communications: Networking and encryption
PROC OPTIONS GROUP=	COMMUNICATIONS

Syntax

Details

Syntax

SHARESESSIONCNTL= SERVER | ENV

Syntax Description

SERVER: creates a single connection between the SAS/SHARE client and the SAS/SHARE server. A typical connection occurs when a client uses a LIBNAME statement to access data from a library on the computer that the SAS/SHARE server runs on. This is the default.

ENV: in a SAS Intelligence Platform environment, creates a connection between each SAS client that accesses data from SAS/SHARE server library via another SAS server. An example of a SAS/SHARE server connection in the SAS Intelligence Platform environment might involve several SAS Enterprise Guide clients that request data sources from a SAS/SHARE server via a SAS Workspace Server. Each SAS Enterprise Guide client (and other SAS clients) will establish a separate connection to the SAS/SHARE server via the workspace server. Maintaining separate client connections to a SAS/SHARE server ensures security and simplifies client administration.

If ENV is not specified in a SAS Intelligence Platform environment, a single connection is maintained between the SAS server (such as the workspace server) and the SAS/SHARE server. All SAS clients that request data from the SAS/SHARE server via a SAS server will communicate using a single connection. Not using ENV reduces security and obscures the identities of the SAS clients that request access to the SAS/SHARE server.

This option and value must be specified at the SAS server, which communicates on behalf of the SAS clients to the SAS/SHARE server.

Details

This option is useful in a SAS Intelligence Platform environment in which the administrator wants to maintain a separate security context for each SAS client (such as a SAS Enterprise Guide client) that connects to the SAS/SHARE server.

The SHARESESSIONCNTL= option should be specified only in the SAS session of the SAS server that will connect to the SAS/SHARE server. The option is effective when it is specified in the SAS configuration file or in an OPTIONS statement in the SAS server session and when it is executed before the SAS server completes its initialization and connection to the SAS/SHARE server. The SHARESESSIONCNTL= option should not be specified while the SAS server is already connected to a SAS/SHARE server. Otherwise, this note is written to the SAS log:

The Remote engine is active.
The SHARESESSIONCNTL setting is referenced only if the engine is reloaded.

The REMOTE engine is active for the duration of the SAS client connections to the SAS/SHARE server. The REMOTE engine is unloaded after all client connections to a SAS/SHARE server are terminated. The REMOTE engine is reloaded when subsequent SAS clients connect to the SAS/SHARE server.