Communications Access Methods for SAS/CONNECT and SAS/SHARE Software

SHARE

System Administrator and User

To use the TCP/IP access method with a Macintosh host for SAS/CONNECT and SAS/SHARE, perform these tasks:

Verify that you have met all your site and software requirements.
Verify that you know how to set options in SAS software.
Set the TCPSEC option.
Configure services for the TCP/IP access method.

System and Software Requirements for SAS/CONNECT and SAS/SHARE

Ensure that the following conditions have been met:

The Macintosh TCP/IP package is installed on the local host.
SAS is installed on both the local host and the remote host.
The remote host is attached to a TCP/IP network.

Using the TCP/IP access method, you can connect to any supported platform that is on the TCP/IP network and is running a SAS release that has the corresponding access method support with SAS/CONNECT and SAS/SHARE properly licensed.

Setting SAS Options

You may need to set specific options in SAS to establish the connections that you want with SAS/CONNECT and SAS/SHARE when using the TCP/IP communications access method. Ask your network administrator for advice about these settings.

You may specify an option in any of the following ways:

in an OPTIONS statement in a SAS session or in an AUTOEXEC file:
OPTIONS variable-name=value;
Example:
```
options tcpsec=_prompt_;
```
in a SAS configuration file:
-SET variable-name value
Example:
```
-set tcpsec _prompt_
```
in a SAS macro variable:
%LET variable-name=value;
Example:
```
%let tcpsec=_prompt_;
```

Values for these options may contain up to eight characters, consisting of alphanumeric characters, the percent sign (%), the dollar sign ($), the pound sign (#), the at sign (@), and the underscore (_).

If you set multiple forms of the same option, this is the order of precedence that is followed:

SAS macro variable

OPTIONS statement

AUTOEXEC file

SAS configuration file.

SAS/CONNECT TCPSEC Option

For SAS/CONNECT, to sign on to a UNIX, an OS/2, a Windows NT, or a Windows 95 remote host through a spawner program instead of a script file, you must set the TCPSEC option. Setting the TCPSEC option allows local hosts whose userids and passwords have been verified to access the desired remote host. See Spawner Programs for more information.

Values for TCPSEC that you may set at a local host and a remote host are

TCPSEC= _PROMPT_ | userid<.password>

_PROMPT_

must be set at the SAS/CONNECT local host.

_PROMPT_ causes SAS to prompt the user for userid and password information. When prompted for a password, the input field is not displayed. Choosing to prompt for a userid and a password provides more security than assigning the userid and the password to the system option.

userid<.password>

must be set at the SAS/CONNECT local host.

This value specifies both the userid and password. Assigning the userid and the password to the TCPSEC option in a file may inadvertently publicize this information and compromise the security of the spawner program that is used with SAS/CONNECT. Assigning the value to the option in a file allows anyone to read it.

Optionally, you may assign userid to TCPSEC and prompt only for password.

Examples:

%let tcpsec=_prompt_;
%let tcpsec=bass.time2go;

Configuring Services in the CONFIG.SAS6xx File

You can configure TCP/IP services by editing the CONFIG.SAS. version.release file, where version.release reflects the current version and release of SAS that you are using; for example, CONFIG.SAS612.

Entries in the CONFIG.SAS file are specified as follows:

-set gsbn_service-name port-number

where GSBN is a command that specifies the service name and port number. service-name may have either of two values: protocol or server-id.

For SAS/CONNECT, enter either of the following in the CONFIG.SAS file:

the TELNET protocol and the associated port number.
Example:
```
-set gsbn_telnet 23
```
the UNIX spawner service and the associated port number.
Example:
```
-set gsbn_unxspawn 5020
```

For SAS/SHARE, enter the following in the CONFIG.SAS file:

the server's identifier and the associated port number.
Example:
```
-set gsbn_sasshare 5018
```
if the server is to be accessed by Java clients, then you will also need to set:
```
-set gsbn_5018 sasshare
```

The person responsible for the SAS applications at your site can provide you with the names of the services that you can use. Before you configure a service, you can find out whether it has already been configured by issuing the following:

%PUT %SYSGET(gsbn_service);

Examples:

%put %sysget(gsbn_telnet);
23

%put %sysget(gsbn_mktserv);
5015

In these examples, the port numbers are reported for the TELNET protocol and the MKTSERV server, respectively. If the service has not been configured, an error message is returned.

Chapter Contents
Previous
Next
Top of Page

	SAS macro variable
	OPTIONS statement
	AUTOEXEC file
	SAS configuration file.