SAS/CONNECT Client Tasks

Before you can access the spawner, the spawner program must be running on the server. For information about the spawner that you are connecting to, see Introduction to the SAS/CONNECT Spawner.

The name of the server can be specified in an OPTIONS statement:

OPTIONS REMOTE=node-name[.service-name | .port-number ];

You can also specify it directly in the SIGNON statement or command:

SIGNON node-name[.service-name | .port-number];

node-name is based on the server that you are connecting to. node-name must be a valid SAS name that is 1 to 8 characters in length and is either of the following:

Here is the process for evaluating node-name:

You specify service-name when connecting to a server that runs a spawner program that is listening on a port other than the Telnet port. If the spawner was started using the -SERVICE spawner option, you must specify an explicit service-name. The value of service-name and the value of the -SERVICE spawner option must be identical. Alternatively, you can specify the explicit port number that is associated with service-name.

Example 1:

In the following example, REMHOST is the name of the node that the spawner is running on. cspawn is the name of the service that is defined at the client. The client service cspawn must be assigned to the same port that the spawner is listening on.

signon remhost.cspawn;

Example 2:

In the following example, the macro variable REMHOST is assigned to the fully qualified name of the computer that the server runs on. This server has a spawner running that is listening on port 5050. The server session that is specified in the SIGNON statement uses the node-name REMHOST and the port number 5050.

%let remhost=pc.rem.us.com;signon remhost.5050;

You can also assign a specific port number by including the port number in the definition of the macro variable. For example:

%let remhost=pc.rem.us.com 5050;signon remhost;

You can use a sign-on script to sign on to the spawner, or you can sign on to a spawner without a script. If you do not use a sign-on script and if the spawner is running secured, you must supply a user ID and password to sign on to the spawner.

If you are signing on by using a script, you must specify the script that you want to use. The script file is executed by the SIGNON statement or command. By default, the script prompts for user ID and password.

To use one of the sample script files that are supplied with SAS/CONNECT for signing on and signing off, assign the default fileref RLINK to the appropriate script file. The script is based on the server that you are connecting to. The sample scripts are installed at this location:

prefix.CTMISC

To specify a script, use the FILENAME statement. For example:

FILENAME RLINK 'prefix.CTMISC/script-name';

script-name specifies the appropriate script file for the server.

The following table lists the scripts that are supplied in SAS software.

If you are signing on to the spawner without using a script and the spawner is running secured, then you must submit the SIGNON statement and provide a user ID and a password in order to log on to the server. For example:

SIGNON USER=user-ID | _PROMPT_ [ PASSWORD=password | _PROMPT_ ];

To start SAS, sign on to the server by using the spawner.

In the following example, a client connects to a UNIX server through a spawner without using a script file. In the SIGNON statement, rmthost.spawner specifies the node rmthost and the service spawner. This server specification presumes that a spawner is running on the node rmthost, and that the spawner was started with the service spawner. Specifying USER=_PROMPT_ causes a logon dialog box to appear so that a user ID and a password can be provided.

options comamid=tcp;
signon rmthost.spawner user=_prompt_;

The name of the server can be specified in an OPTIONS statement:

OPTIONS REMOTE=node-name;

You can also specify it directly in the SIGNON statement or command:

SIGNON node-name;

If you are signing on by using a script, you must specify the script that you want to use. The script file is executed by the SIGNON statement or command. By default, the script prompts for user ID and password. For details, see Specifying a Sign-On Script.

In the following example, you specify the statements at a z/OS client to use the TCP/IP access method to connect to a server. The FILENAME statement identifies the script file that you use to sign on to the server. The script file contains a prompt for a user ID and a password that are valid on the server. The COMAMID= option specifies the TCP/IP communications access method for connecting to the server rmtnode, which is specified in the REMOTE= option.

filename rlink 'prefix.CTMISC/tcptso.scr';
options comamid=tcp remote=rmtnode;
signon;