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

SAS/SHARE

Client Tasks

System Administrator or User

To prepare to create or access a SAS/SHARE server, you must perform the following tasks:

Set the server's userid and password for connecting clients.
Specify the APPC access method.
Know how to specify a server name.

Setting the Server Userid and Password

Requiring connecting clients to supply both a valid server userid and password enforces server security. At the client, set the APPCSEC option to store the server's userid and password. See SAS/CONNECT and SAS/SHARE Options for more information about setting the APPCSEC option.

Specifying the APPC Communications 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.

Because the server runs on a host on which only one communications access method is available, use only the COMAMID option. See SAS/CONNECT and SAS/SHARE: Supported Access Methods According to Host Release for the supported access methods by host.

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. An example of how to specify the APPC access method in a configuration file follows:

comamid=appc

Specifying a Server Name

You must specify the server name in the LIBNAME and PROC OPERATE statements as follows:

SERVER=server-id

The value of server-id is based on the type of host on which the server runs, where server-id is defined in an APPL statement when you configure the VSE system for use with the APPC access method. See System Configuration for the APPC Access Method for acceptable values for server-id.

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

Client Example

The following example illustrates the statements that you specify in a VSE client's configuration file:

appcappl=sasappr
appclogm=sasappc

The APPCAPPL option is set to specify the APPC VTAM identifier, which causes VTAM to initialize for the APPC access method. The APPCLOGM option specifies the communications mode and its properties.

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

options comamid=appc appcsec=_prompt_;
libname sasdata 'edc.prog2.sasdata' server=share1;

The APPC access method is declared. The APPCSEC option specifies that clients be prompted for a username and a password that are valid on the server. The LIBNAME statement specifies the data library that is accessed through the server SHARE1. The server-id is the name of the VTAM APPL ID (ACBNAME) that was set up for APPC LU6.2 communications.

Server Tasks

Server Administrator

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

Set server security through the APPCSEC option.
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 to verify a user's authority to access a SAS library or a file.

Make sure that you have set the value _SECURE_ for the APPCSEC option at the SAS/SHARE server before you start the server. Also, verify that connecting clients have set the APPCSEC option to the appropriate userids and passwords. See SAS/CONNECT and SAS/SHARE Options for information about setting the APPCSEC system option.

Specifying the APPC Access Method at the Server

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.

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. An example of configuration file entries for a server that is running on a VSE host follows:

comamid=appc

Specifying a Server Name

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

SERVER=server-id

The value of server-id is based on the type of host on which the server runs, where server-id is defined in an APPL statement when you configure the VSE system for use with the APPC access method. SeeSystem Configuration for the APPC Access Method for acceptable values for server-id.

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 VSE 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 the server SHARE1, which is the name of the VTAM APPL ID (ACBNAME) that was set up for APPC LU6.2 communications, is started on the VSE host.

Chapter Contents
Previous
Next
Top of Page