z/OS: TCP/IP Access Method

SAS/SHARE Server Tasks

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.
Configure SAS/SHARE servers in the SERVICES file.
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.
Specify TCP/IP as the communications access method.
Specify the server name.

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.

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. [cautionend]

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 the 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.

Top of Page