Chapter Contents


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


Local Host Tasks

User or Applications Programmer
To connect a Windows local host to a remote host, perform these tasks at the local host:
  1. Specify the communications access method.

  2. Specify the remote node name.

  3. Sign on to the remote host.

Specifying the CPIC Communications Access Method

You must specify the CPIC communications access method to make a remote host connection. Use the following syntax:

OPTIONS COMAMID=access-method-id;

where COMAMID is an acronym for Communications Access Method Identification. access-method-id identifies the method used by the local host to communicate with the remote host. CPIC (an abbreviation for Common Programming Interface for Communications) is an example of access-method-id.


options comamid=cpic;

Alternatively, you may specify this option at a SAS invocation or in a SAS configuration file.

Specifying the Remote Node Name

To make a connection from a Windows 32s local host to a remote host, use the following syntax:

OPTIONS REMOTE=symbolic-destination-name 
              | remote-LU 
              | remote-LU-alias;

where symbolic-destination-name is defined to the underlying CPIC subsystem using side-information. The remote-LU specifies the logical unit of the remote host that you are connecting to. The remote LU name is concatenated with the network name (which is defined by the CPIC_NET variable) and forms a fully qualified partner LU name for an APPN EN capable environment, such as the Wall Data Rumba APPC engine. The remote-LU-alias specifies a remote LU that has been defined to the underlying CPIC subsystem.

Types of valid values are shown in the following table:

Windows CPIC SAS/CONNECT Values for the REMOTE= Option
Type of Remote Host Remote Host Identifier
OS/390 name of APPC/MVS scheduler LU
CMS name of AVS (APPC/VM VTAM Support) private gateway LU for VM system
OS/2 name of control-point LU or other locally defined LU
VSE name of VTAM APPL ID (ACBNAME) that was set up for APPC LU6.2 communications
Windows NT Windows 95 name of control-point LU or other SNA Server locally defined LU

Whether you use a symbolic destination name, a remote LU name, or a remote LU alias, the value of the REMOTE= option must be identical in the local and the remote sessions.

Ask your network administrator for advice about what value to assign to the REMOTE= option.


options remote=remotelu;

Alternatively, you may specify this option at a SAS invocation or in a SAS configuration file.

Signing On to the Remote Host

To complete your sign on to the remote host, enter the SIGNON statement, as follows:


Note:   Sign-on script files are not used on a Windows local host that uses the CPIC access method because CPIC communicates directly with the remote host.  [cautionend]

Although no errors are produced if you specify a script file, you do waste processing time. If you defined the RLINK fileref before you establish a connection, when you sign on, SAS/CONNECT processes and loads the script file identified by the fileref, but the CPIC access method will ignore the script.

If you do not want to omit the RLINK fileref but you want to avoid wasting processing time, use the NOSCRIPT option in the SIGNON and SIGNOFF statements, shown as follows:

signon noscript;
signoff noscript;

Local Host Example

The following example illustrates the statements that you specify in a Windows 32s local host configuration file to connect to a remote host with the CPIC access method:

-set cpic_lu62mode cpicmode
-set cpic_conformance wincpic
-set cpic_secure _prompt_

CPICMODE is the mode-name that is defined on the underlying CPIC subsystem. The value WINCPIC specifies a conformance to the WINCPIC standard. The CPIC_SECURE option specifies that connecting local hosts be prompted for a username and a password that are valid on the remote host.

The following example shows the statements that you specify in a local SAS session:

options comamid=cpic remote=remotelu;

The CPIC communications access method is declared with a connection to REMOTELU, which is the symbolic-destination-name, the remote-LU, or the remote-LU-alias. The SIGNON statement performs the sign-on procedure.

Note:   The value for the REMOTE= option must be identical on both the local and the remote hosts.  [cautionend]

Remote Host Example

SAS Institute does not provide support for connections to the Windows 32s remote host with the CPIC access method.

Chapter Contents



Top of Page

Copyright 1999 by SAS Institute Inc., Cary, NC, USA. All rights reserved.