SAS Component Language Dictionary

RLINK

Reports whether a link exists between the current SAS session and a remote SAS session

Category:	Interface to SAS Software
Requires SAS/CONNECT software

Syntax
Details
Example
See Also

Syntax

rc=RLINK(remote-session-id);

rc

contains the return code for the operation:

1	The link exists.
0	The link does not exist.

Type: Numeric

remote-session-id

is the name of the remote session (REMOTE= value) that is being tested.

Type: Character

Details

See SAS/CONNECT User's Guide for details about accessing remote hosts from SAS software.

To get the name of the last remote host that was linked to during the current SAS session, use OPTGETC, specifying 'REMOTE' as option-name.

Example

Check to see whether the link is active:

REMSESS=optgetc('remote');
msg=sysmsg();
put msg REMSESS;
rc=rlink(REMSESS);
   if (rc=0) then
      msg='No link exists.';
   else
      msg='A link exists.';
put msg;