SAS/CONNECT General SAS System Options

SASCMD= System Option

Specifies the command that starts a server session on a symmetric multiprocessing (SMP) computer.

Client:	Optional
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
Examples
See Also

Syntax

OpenVMS, UNIX, Windows

SASCMD=<"SAS-command <SAS-system-options>" | "!sascmd SAS-system options">

z/OS

SASCMD=<":SAS-system-options" | "!sascmd SAS-system-options" >

Syntax Description

SASCMD= <"SAS-command <SAS-system-options>" | "!sascmd SAS-system-options">

under the OpenVMS, UNIX, and Windows operating environments, this command starts a server session on a multi-processor computer. The TCP/IP access method is used to connect to the server session.

!sascmd specifies that the same SAS command that was used to invoke the client session should be used to invoke the server session. The SAS command can be specified with additional or overriding SAS system options.

SASCMD= <":SAS-system-options" | "!sascmd SAS-system-options">

under the z/OS operating environment, starts a server session on a multiprocessor computer, and passes values for the following SAS system options to the server session: DMR, COMAMID=, REMOTE=, SASHELP=, SASMSG=, SASAUTOS=, and CONFIG=. You might also specify additional SAS system options to be passed to the server session. The XMS access method is used to connect to the server session.

The fork command under UNIX is used to spawn an MVS BPX address space, which inherits the same STEPLIB and USERID as the client address space.

Details

SASCMD= is most useful for starting multiple sessions to run asynchronously on multiprocessor computers. You can also use SASCMD= to develop an application on a single-processor computer that will be executed later on a multi-processor computer.

In addition to being a system option, SASCMD= can be set as an option in the SIGNON and the RSUBMIT statements or commands. The option in an RSUBMIT or SIGNON statement or command takes precedence over the system option.

Examples

The following OPTIONS statement invokes a SAS session.

options sascmd="sas";

The following OPTIONS statement invokes a server session on a computer under the z/OS operating environment and sets the MEMSIZE= and NONUMBER options.

options sascmd=":memsize=64M nonumber";

The following OPTIONS statement invokes a server session on a computer under the z/OS operating environment with no additional SAS options.

options sascmd="any-string";

The following OPTIONS statement specifies a script file to invoke SAS.

options sascmd="mysas.bat";

For the preceding example, the following code is contained in the text file MYSAS.BAT.

cd "C:\Program Files\SAS System\9.0"
mkdir mywork
sas -nosyntaxcheck -work "mywork" %*

Note: The %* positional parameter enables you to specify additional SAS options when you invoke SAS. [cautionend]

When the SASCMD= option is executed, the MYSAS.BAT script is executed.