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

SAS/CONNECT

Local Host Tasks

User or Applications Programmer

To connect a VSE local host to a remote host, perform these tasks at the local host:

Specify the communications access method.
Specify the remote host name.
Sign on to the remote host.

Specifying the APPC Communications Access Method

You must specify the APPC 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. APPC (an acronym for Advanced Program-to-Program Communication) is an example of access-method-id.

Example:

options comamid=appc;

Specifying the Remote Host Name

To connect a VSE local host to a remote host, use the following syntax:

OPTIONS REMOTE=remote-session-id;

where remote-session-id specifies the logical unit of the remote host that you are connecting to. Types of valid values follow:

VSE APPC SAS/CONNECT REMOTE= Values
Type of Remote Host Remote Session Identifier

MVS/ESA LU name that is configured to the APPC /MVS scheduler

CMS name of AVS gateway

OS/2 name of control-point LU or other OS/2 locally defined LU

Windows NT, Windows 95 name of control-point LU or other SNA server locally defined LU

VSE name of VTAM APPL ID (ACBNAME) that was set up for APPC LU6.2 communications

***VSE APPC SAS/CONNECT REMOTE= Values***
Type of Remote Host	Remote Session Identifier
MVS/ESA	LU name that is configured to the APPC /MVS scheduler
CMS	name of AVS gateway
OS/2	name of control-point LU or other OS/2 locally defined LU
Windows NT, Windows 95	name of control-point LU or other SNA server locally defined LU
VSE	name of VTAM APPL ID (ACBNAME) that was set up for APPC LU6.2 communications

Example:

options remote=N02SV01;

The remote node N02SV01 is the LU name that is assigned to the APPC/MVS scheduler that you want to connect to. Ask your network administrator for the remote-session-id.

Signing On to the Remote Host

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

signon;

You do not need to use a script file for all connections that use the APPC access method because APPC has the ability to interface with the APPC/VSE subsystem to initiate a remote session. If you previously identified a script file in an RLINK fileref statement, you will receive an error message when you attempt to make a connection. If you do not want to omit the RLINK fileref but want to prevent the error, use the NOSCRIPT option in the SIGNON and SIGNOFF statements as follows:

signon noscript;
.
.
.
signoff noscript;

Local Host Example

The following example illustrates the statements that you specify in a VSE local host configuration file:

appcappl=sasappr
appclogm=sasappc

The APPCAPPL option is set to specify the APPC VTAM identifier that 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 local host SAS session to connect to a remote host with the APPC access method.

options appcsec=_prompt_ comamid=appc 
        remote=remotelu;
signon;

The APPCSEC option specifies that connecting local hosts be prompted for a username and a password that are valid on the remote host. The APPC communications access method is declared, and the remote host REMOTELU is identified. The SIGNON statement performs the sign-on process.

Remote Host Task

System Administrator

Specify the remote host name.
Optionally, set several remote host options.

Specifying the Remote Host Name

You must declare a remote host name at both the local host and the remote host in a SAS/CONNECT session. At both hosts, you specify an OPTIONS statement as follows:

OPTIONS REMOTE=remote-host-id;

where the remote-host-id that you specify at the remote host is based on the type of remote host that you are connecting to. See VSE APPC SAS/CONNECT REMOTE= Values for valid values.

The remote host identifiers that you specify at both the local and remote hosts must be identical.

Example:

options remote=remotelu;

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

Setting Options at the Remote Host

Although sign-on script files are not used for the APPC access method, you may set remote host options at the remote host. It is recommended that you set these options:

NO$SYNTAXCHECK

allows the continuation of statement processing at the remote host regardless of syntax error conditions.

This option is valid as part of a configuration file, at a SAS invocation, or in an OPTIONS statement.

NOTERMINAL

specifies whether a terminal is attached at SAS invocation. If NOTERMINAL is specified, requestor windows are not displayed.

Setting NOTERMINAL at the remote host is advisable so that no terminal is associated with the remote session. This option prevents SAS from displaying error messages and dialog boxes on the remote host, which requires user intervention.

This option is valid as part of a configuration file or at a SAS invocation. An example of configuration file entries for a remote host that is using the APPC method follows:

no$syntaxcheck
noterminal

See SAS Language Reference: Dictionary for details about this option.

Remote Host Example

The following example illustrates the statements that you specify in a VSE remote host configuration file to prepare for a connection from a local host with the APPC access method.

appcappl=sasappr

The APPCAPPL variable specifies the APPC VTAM identifier that causes VTAM to initialize for the APPC access method.

Chapter Contents
Previous
Next
Top of Page