SAS Institute. The Power to Know

Knowledge Base


TS-676

Installing the Unix Spawner

To install the UNIX Spawner program, first ensure that the service name of the
Spawner has been defined in the /etc/services file. The service name specifies
the name of the service that the UNIX Spawner program uses to listen for
incoming requests. This service name is used as the REMOTE= value that is
specified at the local host prior to sign on. Because there is no default, you
must specify this value. In most cases, you should run the UNIX Spawner using
the root privilege in order to start the remote SAS processes with the
privileges of the user who connects to the Spawner.

To start the UNIX Spawner:
cd to the !sasroot/utilities/bin directory

*Where !sasroot is the directory in which SAS is installed.

If you're doing a scripted SIGNON, your Spawner installation command will
resemble the following:

	sastcpd -service unxspawn

*Where unxspawn is an entry in the SERVICES file:
For example: unxspawn   5019/tcp

**The services entry must be the same on the local and remote platforms.

An example of a scripted SIGNON follows:

options comamid=tcp remote=rmt.unxspawn;
filename rlink '!sasroot\connect\saslink\tcpunix.scr';
signon;

If you are not doing a scripted SIGNON, your UNIX Spawner installation will
require the -SASCMD option, which points to a command file that will issue 
the SAS invocation statement:

	sastcpd -service unxspawn -sascmd /local/u/sasusr/mytest

*Where the /local/u/sasusr/mytest command file contains the following:

#!bin/ksh
. ~/.profile
sas -dmr -noterminal -no$syntaxcheck -comamid tcp -device grlink

**The MYTEST file should have the execute bit set. To set the bit, use the
following command:
chmod .x /mytest
The file should have the following settings: -rwxr-xr-x

After installing the UNIX Spawner, the following commands can be used on the
client to initiate a non-scripted SIGNON:

options comamid=tcp remote=rmt.unxspawn;
%let tcpsec=userid.pswd;
signon noscript;

To end the Spawner program, enter the interrupt signal, which typically is
CTRL-C. If the UNIX Spawner is running in the background, kill its process.

NOTE: Refer to the SAS V8 ONLINE documentation for a complete list of options
that can be used on the UNIX Spawner installation.