CONNECTREMOTE=

CONNECTREMOTE=

Identifies which remote session to connect to.

Local

Syntax
Syntax Description
SIGNON Example
Examples for Remote-Submitting

Syntax

CONNECTREMOTE=remote-session-id

Syntax Description

remote-session-id: specifies the remote session to connect to when using SAS/CONNECT.

Details

Use the CONNECTREMOTE= option to identify which remote session or machine to use with SAS/CONNECT. There is no default value for the CONNECTREMOTE= option; you must supply one. Aliases for this option are CREMOTE= and REMOTE=.

When you are signing on, the CONNECTREMOTE= option is used in combination with the COMAMID= option. Valid combinations of values for these options are shown in the table with the COMAMID= option.

You can also use this system option to identify the session to which statements should be remote-submitted when you have multiple links established.

Note: This option is available in Version 7 and later. [cautionend]

SIGNON Example

This example shows the OPTIONS statement that you use on the local host and the script TYPE statement that invokes the SAS System on the remote host. (For additional examples, refer to the chapters for each access method in Communications Access Methods for SAS/CONNECT and SAS/SHARE Software.)

Suppose you use Communications Manager to communicate with a CMS remote host and you have named this session MYCMS. Specify the COMAMID= and CONNECTREMOTE= options in the local SAS session OPTIONS statement as follows:

options comamid=ehllapi connectremote=mycms;

The TYPE statement in the script that invokes the SAS session on the CMS host looks like this:

type 
"sas (dmr comamid=pclink noterminal no$syntaxcheck)"
   enter;

Note: You can omit the CONNECTREMOTE= option and specify the remote-session id in the SIGNON command if you have assigned the fileref RLINK to the script file that is used to sign on. [cautionend]

Examples for Remote-Submitting

Suppose that you signed on to an OpenVMS Alpha host by means of TCP/IP and you use REMOTE=internet-address, then you signed on to an OS/390 host by means of EHLLAPI and you use REMOTE=A. You can remote-submit statements to either of these hosts by specifying the remote-session id when you issue the RSUBMIT statement or command. This example submits statements to both hosts:

options remote=a;
rsubmit;
   statements for OS/390 remote host
endrsubmit;

options cremote=tcp-host-name;
rsubmit;
   statements for OpenVMS Alpha remote host
endrsubmit;

You can also omit the REMOTE= option and simply include the remote-session id in the RSUBMIT statement as follows:

rsubmit a;
   statements for OS/390 remote host
endrsubmit;

rsubmit tcp-host-name;
   statements for OpenVMS Alpha remote host
endrsubmit;

Chapter Contents
Previous
Next
Top of Page