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

SHARE

System Administrator or User

To use the APPC access method with a Windows host for SAS/CONNECT and SAS/SHARE, perform these tasks:

Verify that you have met all your site and software requirements.
Verify that the resources for the APPC access method have been defined.
Verify that you know how to set options in SAS software.
Set the SAS/CONNECT and SAS/SHARE options that you want.

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

Ensure that the following conditions have been met:

APPC has been installed at both the local and remote hosts at your site.
SAS has been installed on both the local and remote hosts.

The APPC access method gives you access to an SNA network. SAS/CONNECT and SAS/SHARE software use the Microsoft Windows Open Services Architecture (WOSA) standard (WinAPPC). Therefore, you should be able to use software from any vendor that supports this standard. The following package has been verified by SAS Institute:

the Microsoft SNA Server, Version 2.11 SP1 (Service Pack 1) or subsequent release.
any program that supports the WOSA APPC standard.

Sample configuration files for Windows NT, Windows 95, and Windows 32s are included on the install media in !SASROOT\CONNECT\SASMISC and !SASROOT\SHARE\SASMISC.

Configuring a Microsoft Server Environment

Network Administrator

An IBM Systems Network Architecture (SNA) network enables a Windows host to provide client and server functionality for both SAS/CONNECT and SAS/SHARE using the APPC communications access method. Before you can use SAS/CONNECT and SAS/SHARE along with the APPC access method, you must install and configure the Microsoft SNA Server Gateway.

Optionally, for Windows NT only, you may want to configure Windows NT Host Security Integration features that simplify the login procedure and manage multiple passwords that you may need for accessing Windows NT and host security domains.

See Installing and Configuring a Microsoft Server Environment for information about configuring Windows NT Host Security Integration features and installing an SNA server and SNA clients.

Understanding SNA Server Terminology

Familiarity with these terms will help you when you talk to your network administrator about selection options.

LU (logical unit): a device or program by which a user (LU6.2 applications program) gains access to an SNA network.
local LU: a named LU that is associated with a local host that connects to a SAS/CONNECT remote host or with a client that accesses a SAS/SHARE server.
remote LU: a named LU that is associated with the SAS/CONNECT remote host or with a SAS/SHARE server to which a local host or a client attaches.
LU alias: an alternative name assigned to an LU (local or remote).

For more information about this terminology, see the Microsoft SNA Server Administration Guide.

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 APPC communications access method.

Consult with your network administrator to determine what options must be set and what values to assign to them.

You may specify an option in any of several forms, as follows:

OPTIONS statement in a SAS session or in an AUTOEXEC file:
OPTIONS SET=variable-name value;
Example:
```
options set=appc_secure _prompt_;
```
SAS configuration file or on SAS invocation:
-SET variable-name value
Example:
```
-set appc_secure _prompt_
```
DOS operating system environment variable:
SET variable-name=value
Example:
```
set appc_secure=_prompt_
```

Values for these options can 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, here is the order of precedence that is followed:

OPTIONS statement

AUTOEXEC file

SAS invocation

SAS configuration file

DOS environment variable.

SAS/CONNECT and SAS/SHARE Options

APPC_LUNAME

specifies the name of the local LU alias to use. You must declare APPC_LUNAME unless a default local APPC LU has been defined. A default APPC LU is defined when setting up the Microsoft SNA Server gateway. You use the value assigned to the APPC_LUNAME when making a remote host connection with SAS/CONNECT or when accessing a SAS/SHARE server.

Ask your network administrator for the name of the local LU that you can use to assign to APPC_LUNAME or for the default local LU value.

APPC_LU62MODE

specifies the mode name that is associated with an LU-LU pair and determines the session properties for that pair.

The default mode name is SASAPPC. Whether you assign a mode name to the option or you accept the default SASAPPC, you must define the mode and use the same mode name value in both the local session and the remote environments (either on the remote host in a SAS/CONNECT session or on a SAS/SHARE server, as necessary).

Ask your network administrator for advice about setting this option.

APPC_SECURE _NONE_

| _PROMPT_ | userid.password | _SAME_

Note: This section shows the APPC_SECURE form that you use in an OPTIONS statement in a SAS session or in an AUTOEXEC file. Alternatively, you may use the APPCSEC option form that you use in a SAS configuration file or at a SAS invocation. See Setting SAS Options for more information. [cautend]

For SAS/CONNECT and SAS/SHARE, you must set the APPC_SECURE variable in order to pass a remote host userid and a password to a remote SAS/CONNECT host or to a SAS/SHARE server for verification. After the userid and the password have been verified, the connection to the remote SAS/CONNECT host or the SAS/SHARE server can proceed.

_NONE_

must be set at the SAS/CONNECT local host or the SAS/SHARE client. This is the default.

Setting _NONE_ does not establish secure sessions for connecting SAS/CONNECT local hosts or SAS/SHARE clients.

_PROMPT_

must be set at the SAS/CONNECT local host or the SAS/SHARE client.

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

userid.password

must be set at the SAS/CONNECT local host or the SAS/SHARE client.

This option specifies both the userid and password. Assigning the userid and the password directly to the APPC_SECURE variable at the SAS/CONNECT local host or the SAS/SHARE client may inadvertently publicize this information and compromise the security of the SAS/CONNECT remote host or the SAS/SHARE server. Assigning the value to the variable in a file allows anyone to read it.

If the userid or the password contains numeric or special characters, enclose the entire userid.password in quotation marks.

_SAME_

CAUTION:: Windows NT only This value is supported on Windows NT only.

This option must be set at the SAS/CONNECT local host or the SAS/SHARE client.

_SAME_ offers the convenience of not having to specify a userid and password to APPC_SECURE. Setting _SAME_ automatically obtains the appropriate host userid and password from the NT Host Security Integration system. In order to take advantage of this feature, you must have installed and configured the NT Host Security Integration feature in your Windows NT environment. For details about installing and configuring this feature, see Configuring Windows NT Host Security Integration Features.

Examples:

options set=appc_secure _none_;
options set=appc_secure _prompt_;
options set=appc_secure bass.timego;
options set=appc_secure "bass.time2go";
options set=appc_secure _same_;

See Setting SAS Options for examples of the forms that you can use to specify APPC_SECURE.

APPC_PARTNER_COUNT

specifies the maximum number of simultaneous remote hosts that this local session has at any one time. This estimate permits better allocation of memory for resources for internal control block usage.

SAS/CONNECT Only Options

APPC_SURROGATE_LUNAME

specifies an LU to use for a SAS/CONNECT remote session on an OS/390 host. If APPC_SURROGATE_LUNAME is not defined, the OS/390 remote session dynamically selects an LU from the pool of LUs that is defined on the OS/390 host for this purpose.

Note: This option applies only when connecting to an OS/390 remote host. [cautend]

Ask your network administrator for the name of the remote LU for the OS/390 host that you can use to assign to APPC_SURROGATE_LUNAME .

APPC_DEPLU

enables dependent LU processing support by releasing unused sessions.

In order for APPC_DEPLU to work properly, when specifying the connection name during Microsoft SNA server gateway configuration, you must configure the remote LU as a dependent host connection. See Configuring the Server for the context for this requirement.

	OPTIONS statement
	AUTOEXEC file
	SAS invocation
	SAS configuration file
	DOS environment variable.