SASSCRIPT= System Option

Specifies one or more locations for SAS/CONNECT server sign-on script files.
Client: optional
Server: optional
Valid in: Configuration file, OPTIONS statement, SAS System Options window, SAS invocation
Category: Communications: Networking and Encryption
PROC OPTIONS GROUP= Communications
Default: Varies by operating environment

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. The directory name can also be specified as a fileref.
OpenVMS specifics:SAS$ROOT:[TOOLS]
UNIX specifics:!sasroot/misc/connect
Windows specifics:!sasext0\connect\saslink
z/OS specifics:&prefix.CTMISC

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=.

Examples

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.

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";