SAS/SHARE Server Tasks

Task List

  1. To allow a client to connect to a server that runs under z/OS, verify that the SAS SVC routine has been installed. See Installation of the SAS SVC Routine.
  2. Configure SAS/SHARE servers in the SERVICES file.
  3. Configure SAS options (optional).
    • Set the TCPSEC= option to require client authentication.
    • Set security service options to encrypt data that is transferred between a server and a client.
  4. Specify TCP/IP as the communications access method.
  5. Specify the server name.

Configuring the Server Service

Each server must be defined as a service in the TCP/IP SERVICES file on each node that a client will connect to. This file usually is located in the directory that the TCP/IP software is installed in. For details about editing the SERVICES file, see Configuring the SERVICES File.
Example:
sassrv2   5011/tcp  # 
SAS/SHARE server 2

Setting the TCPSEC Option to Require Client Authentication

To authenticate connecting clients, you must specify the value _SECURE_ in the TCPSEC= option to require that clients provide a user ID and a password that are valid on the server. For details about the TCPSEC= option, see SAS/SHARE Options Only .

Encrypting Data in Server/Client Transfers

If network security is configured at the server, you can specify SAS options to encrypt data that a server transfers to a client. For example:
options netencrypt netencryptalgorithm=rc4;
The NETENCRYPT option specifies that all data transfers between a server and a client will be encrypted. The RC4 security algorithm is assigned in the NETENCRYPTALGORITHM= option. For details about encryption services, see Encryption in SAS, located in the Base SAS Help and Documentation.

Specifying TCP/IP as the Communications Access Method

You must specify TCP/IP as the communications access method at the server before a client can access it. You can use the COMAMID= option in an OPTIONS statement. For example:
options comamid=tcp;
The COMAMID= option specifies the communications access method. TCP specifies the TCP/IP access method.
Alternatively, you can specify the COMAMID= option in a SAS start-up command or in a SAS configuration file.
The COMAUX1= option specifies an auxiliary communications access method and can be specified only in a SAS start-up command or in a SAS configuration file.
Here is the syntax for the COMAUX1= option:
COMAUX1=alternate-method
If the first method fails to access a server, the second method is used. You can specify one auxiliary access method.
Example:
comamid=tcp
comaux1=xms

Specifying the Server

You must specify the name of the server in the SERVER= option in the PROC SERVER statement.
SERVER=server
server can be either a server-ID or a port number. The server-ID corresponds to the service that was configured in the SERVICES file. For details, see Configuring the Server Service . The value for port is the unique number that is associated with the service that is used for transferring data between a client and a server. Precede the port number with two consecutive underscores.
Note: Do not space after the first underscore or the second underscore.
Examples:
proc server server=apex;
proc server server=_ _5000;
For details about creating valid SAS names, see SAS Language Reference: Concepts. For details about PROC SERVER, see The SERVER Procedure in SAS/SHARE User's Guide.

SAS/SHARE Server Example

The following example shows the statements that you specify in the server configuration file on a computer that runs the z/OS operating environment:
tcpsec=_secure_
options comamid=tcp;
proc server id=share1;
run;
The value _SECURE_ that is specified for the TCPSEC option requires clients to provide a user ID and a password that are valid on the server.
The COMAMID= option specifies the TCP/IP access method. The PROC SERVER statement specifies the server SHARE1.