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

SAS/SHARE

Client Tasks

System Administrator and User

To prepare to access a SAS/SHARE server, perform the following tasks:

Set security for connecting clients.
Specify the APPC access method.
Specify a server name.

Setting Security for Connecting Clients

Requiring connecting clients to supply a valid userid and password enforces server security. At the client, use the preferred security method for specifying a userid and a password that are valid on the server host. For details, see Setting Security for SAS/CONNECT and SAS/SHARE.

Specifying the APPC Access Method

You must specify the APPC communications access method at the client before you access a server.

Use the following syntax to specify the APPC access method at each connecting client:

OPTIONS COMAMID=access-method-id;

where COMAMID is an acronym for Communications Access Method Identification. access-method-id identifies the method used by the client to communicate with the server. APPC (an abbreviation for Advanced Program-to-Program Communication) is an example of an access-method-id.

Example:

options comamid=appc;

The server is accessed using the APPC access method.

You may specify the COMAMID option in an OPTIONS statement, at a SAS invocation, or in a SAS configuration file.

Additionally, you may use the COMAUX1 and COMAUX2 options to designate auxiliary communications access methods. See for the supported access methods by host. If the first method fails to access a server, the second method is attempted, and so on. You can specify up to two auxiliary access methods, depending on the number of access methods that are supported between client and server hosts.

COMAUX options can be specified only at SAS invocation or in a SAS configuration file. The syntax for the COMAUX options follows:

COMAUX1=alternate-method
COMAUX2=alternate-method

An example of configuration file entries for a CMS client connecting to a CMS server follows.

Example:

comamid=appc
comaux1=tcp
comaux2=iucv

If the server cannot be reached using the APPC method, a second attempt is made with the TCP/IP access method, and then with the IUCV access method.

Specifying a Server Name

You must specify the server name in the LIBNAME and PROC OPERATE statements using the following syntax:

SERVER=server-id

where server-id is defined in the communications directory file when configuring the CMS system for use with the APPC access method. See Creating a System Communications Directory File for details about defining a server-id for the server.

See SAS Language Reference: Dictionary for details about SAS naming rules. See SAS/SHARE User's Guide for details about the PROC OPERATE and LIBNAME statements.

Client Example

The following example illustrates the statements that you specify in a CMS client SAS session to connect to a server with the APPC access method:

options comamid=appc;
libname sasdata 'prog2 a' user=_prompt_ server=share1;

The COMAMID option specifies the APPC access method. The LIBNAME statement specifies the name of the data library that is accessed through the server SHARE1 by means of a prompt for a username and a password that are valid on the server.

Server Tasks

System Administrator

To set up a secure server and to make it accessible to a client, perform the following tasks:

Set server security.
Specify the APPC access method.
Specify the server name.

Setting Server Security

You may use file permissions to restrict a user's access to libraries and files through a server. A secured server allows connections only from those clients that provide valid userids and passwords for the host at which the server is running. A secured server uses a validated userid and password pair to verify a user's authority to access a SAS library or a file. You must provide a user exit to verify authority to access a SAS library or file. This user exit is optional. The default is to allow access to all files to any client that provides a valid userid and password. Documentation for user exits is provided in the CMS Installation Guide. For details about setting security, see Setting Security for SAS/CONNECT and SAS/SHARE.

Specifying the APPC Access Method

You must specify the APPC communications access method at the server before you create a SAS/SHARE server.

Use the following syntax to specify the APPC access method at the server:

OPTIONS COMAMID=access-method-id;

where COMAMID is an acronym for Communications Access Method Identification. access-method-id identifies the method used by the server to communicate with the client. APPC (an abbreviation for Advanced Program-to-Program Communication) is an example of an access-method-id.

For a server that is running on a host on which only one communications access method is available, use only the COMAMID option.

Example:

options comamid=appc;

The server will be available only to SAS/SHARE sessions that use the APPC access method.

You may specify the COMAMID option in an OPTIONS statement, at a SAS invocation, or in a SAS configuration file.

However, if the host on which a server is running supports multiple access methods, you may specify up to two auxiliary access methods by which clients may access the server. See SAS/CONNECT and SAS/SHARE: Supported Access Methods According to Host Release for the supported access methods by host.

All of the access methods initialize when the server initializes. The activation of multiple access methods makes a server available to several groups of clients, each using a different communications access method simultaneously.

COMAUX options can be specified only at a SAS invocation or in a SAS configuration file. The syntax for the COMAUX options follows:

COMAUX1=alternate-method
COMAUX2=alternate-method

An example of configuration file entries for a server that is running on a CMS host follows:

comamid=appc
comaux1=tcp
comaux2=iucv

When the server starts, all of the communications access methods are initialized. The server is simultaneously available to client sessions that use the APPC access method as well as to clients that use the TCP/IP and IUCV access methods.

See SAS/SHARE User's Guide for details about starting and accessing a server.

Specifying a Server Name

You must specify the server name in the PROC SERVER statement using the following syntax:

SERVER=server-id

where server-id is defined in the VM directory entry when configuring the CMS system for use with the APPC access method. See Creating the Server VM Directory Entry for the Server Virtual Machine for details about defining a server-id for the server.

See SAS Language Reference: Dictionary for details about SAS naming rules. See SAS/SHARE User's Guide for details about the PROC SERVER statement.

Server Example

The following example illustrates the statements that you specify in a SAS session on the CMS host at which you start a server:

options appcsec=_secure_ comamid=appc;
proc server id=share1;
run;

The _SECURE_ value for the APPCSEC option requires clients to supply a userid and a password that are valid on the server. The APPC access method is declared and a server with the server-id SHARE1 is started on the CMS host.

Chapter Contents
Previous
Next
Top of Page