CONNECTREMOTE= System Option

Identifies the server session that a SAS/CONNECT client connects to.
Client: required
Server: optional
Valid in: Configuration file, OPTIONS statement, SAS System Options window, SAS invocation
Category: Communications: Networking and Encryption
PROC OPTIONS GROUP= Communications
Alias: CREMOTE=, REMOTE=, PROCESS=

Syntax

CONNECTREMOTE=server-ID

Syntax Description

server-ID
identifies the specific server session that the client connects to. This ID might correspond to the name of the machine that the client connects to. If connecting to a server session on a multi-processor machine (that is, a machine that is equipped with SMP hardware), the ID can be a descriptive name that you assign to the session.

Details

In addition to being a system option, CONNECTREMOTE= can be set as an option in the RSUBMIT and SIGNON statements. The option in an RSUBMIT or SIGNON statement or command takes precedence over the system option.

Examples

Example 1: CONNECTREMOTE= in SIGNON

At the client, the following OPTIONS statement specifies the TCP/IP access method for connecting to a SAS session on a machine named APEX.
options comamid=tcp connectremote=apex;
signon;
Alternatively, you can specify the CONNECTREMOTE= option in the SIGNON statement.
signon connectremote=apex;
After a successful signon, the CONNECTREMOTE= value is updated.

Example 2: CONNECTREMOTE= in RSUBMIT

The following OPTIONS statement specifies the TCP/IP access method for connecting to a SAS session on the machine named APEX, which connects to the session ID of the OpenVMS server that statements are remotely submitted to.
options comamid=tcp connectremote=apex;
rsubmit;
   statements for OpenVMS server
endrsubmit;
The following OPTIONS statement specifies the TCP/IP access method and the macro variable HOST1, which contains the IP address of a UNIX server that the statements are remotely submitted to.
%let host1=IP-address;
options comamid=tcp connectremote=host1;
rsubmit;
   statements for UNIX server
endrsubmit;
Alternatively, you can specify the session ID directly in the RSUBMIT statement.
rsubmit apex;
   statements for OpenVMS server
endrsubmit;
%let host1=IP-address;
rsubmit host1;
   statements for UNIX server
endrsubmit;
After a successful RSUBMIT, the CONNECTREMOTE= value is updated.