|Communications Access Methods for SAS/CONNECT and SAS/SHARE Software|
|Local Host Tasks|
|Specifying the APPC Communications Access Method|
You must specify the APPC communications access method to make a remote host connection. Use the following syntax:
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.
|Specifying the Remote Host Name|
To connect a VSE local host to a remote host, use the following syntax:
where remote-session-id specifies the logical unit of the remote host that you are connecting to. Types of valid values follow:
|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|
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:
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:
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|
|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:
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.
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:
This option is valid as part of a configuration file, at a SAS invocation, or in an OPTIONS statement.
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:
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.
The APPCAPPL variable specifies the APPC VTAM identifier that causes VTAM to initialize for the APPC access method.
Top of Page
Copyright 1999 by SAS Institute Inc., Cary, NC, USA. All rights reserved.