SAS/CONNECT General SAS System Options

SASSCRIPT= System Option

Specifies one or more locations for SAS/CONNECT server sign-on script files.

Client:	Optional
Default:	Varies by operating environment.
Valid in:	configuration file, OPTIONS statement, SAS System Options window, SAS invocation
Category:	Communications: Networking and Encryption
PROC OPTIONS Group=	Communications

Syntax
Syntax Description
Details
Example 1: Assigning the File Path to SASSCRIPT=
Example 2: Assigning a Fileref to SASSCRIPT=
Example 3: Obtaining the Script File Path from the SAS Metadata Repository
See Also

Syntax

SASSCRIPT= "dir-name" |<"dir-name-1", ... ,"dir-name-n"> |"fileref" |<"fileref-1", ... ,"fileref-n">

Syntax Description

"dir-name" | fileref

specifies the name of one or more directories that contain SAS/CONNECT script files. Enclose the directory name in double or single quotation marks.

OpenVMS Default:	SAS$ROOT:[TOOLS]
UNIX Default:	!sasroot/misc/connect
Windows Default:	!sasext0\connect\saslink
z/OS Default:	&prefix.CTMISC

The directory name can also be specified as a fileref.

Details

If the CSCRIPT= option is specified in the SIGNON statement and the specified script file is not located in the current directory, the location that is specified in the SASSCRIPT= option is used to find the specified script file.

If quotation marks are omitted from the value, SAS can misinterpret the value as a physical filename and an error condition can result. Using quotation marks ensures that the value is correctly interpreted as a directory path.

The SASSCRIPT= option also enables you to find the location of a script file that has been configured as a property in the SAS Metadata Repository. The script path is among the properties of the SAS/CONNECT server component in the SAS Application Server that is stored in the SAS Metadata Repository.

Note: In order to obtain a script file path from the SAS Metadata Repository, you must have access to the repository. These SAS options can be used to configure access to the SAS Metadata Repository: METAAUTORESOURCES=, METACONNECT=, METAPASS=, METAPORT=, METAPROFILE=, METAPROTOCOL=, METAREPOSITORY=, METASERVER=, and METAUSER=. [cautionend]

Example 1: Assigning the File Path to SASSCRIPT=

In this example, the SASSCRIPT= option is used to specify an alternative file path to scripts for server sign-ons under the Windows operating environment.

options sasscript= "c:\my\favorite\scripts";

After the SASSCRIPT= option has been specified, the script can be invoked as follows:

signon remhost cscript="myscr.scr";

When myscr.scr is not located in the default location, a search for the script will be made at the location that is specified in the SASSCRIPT= option.

Here is an example in the SAS log of the representation of the SASSCRIPT= option and the assigned value:

SASSCRIPT=("c:\my\favorite\scripts")

SAS surrounds the quoted file path with parentheses.

Note: The SASSCRIPT= option is an alternative to the RLINK fileref that is used in the FILENAME statement for identifying the location of a script file. [cautionend]

Example 2: Assigning a Fileref to SASSCRIPT=

In this example, a FILENAME statement is used to assign the filename TESTFILE to the fileref POINTER. The OPTIONS statement is used to assign the SASSCRIPT system option to the value POINTER, which is a fileref to the filename TESTFILE. The fileref is not enclosed in quotation marks.

filename pointer 'testfile';
options sasscript=pointer;

Example 3: Obtaining the Script File Path from the SAS Metadata Repository

In this example, the path to the server sign-on script has been configured as a property in the SAS Metadata Repository. Here is the code to access the SAS Metadata Repository and to find out the script path:

options metaserver="max.apex.na.com";
signon serverv="SASApp";

The METASERVER= option is used to specify the fully qualified domain name of the computer on which the SAS Metadata Server runs. The SIGNON statement and the SERVERV= option are used to produce a list of the properties of the SAS/CONNECT server component in the SAS Application Server that is stored in a SAS Metadata Repository. The name of the SAS Application Server is "SASApp."

Here is an excerpt of the output that is sent to the SAS Log:

1    options metaserver="max.apex.na.com"; 
2    signon serverv="SASApp"; 
NOTE: Server=          SASApp - Connect Server 
      Remote Session ID=     remhost 
      ServerComponentID=     A5SXFC1R.AU000002  
      Remote Host=           max.apex.na.com 
      Communication Protocol=TCP 
      Port=                  7551 
      Scriptpath= F:\admin\work\favescript.scr 
      AuthDomain= DefaultAuth 
      Wait= Yes 
      SignonWait= Yes 
      Status= Yes 
      Notify= No

Knowing the script path and the script name, in a client session, you can sign on to a server session. Here is an example:

options sasscript= "F:\admin\work";
signon remhost cscript="favescript.scr";

Here is an alternative way to sign on to a server session:

signon remhost cscript="F:\admin\work\favescript.scr";