• Print  |
  • Feedback  |

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, change directory 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

In this code, 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
In this statement, 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 these 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, stop its process.

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