SAS Component Language Dictionary

RSTITLE

Defines a description for an existing connection to a remote session

Category:	Interface to SAS Software
Requires SAS/CONNECT software

Syntax
Details
Example
See Also

Syntax

sysrc=RSTITLE(session-id,description);

sysrc

contains the return code for the operation:

0	successful
0	not successful

Type: Numeric

session-id

is one to eight characters that identify the remote session (the REMOTE= value).

Type: Character

description

is one to 40 characters to associate with the remote session.

Type: Character

Details

You can retrieve the information that RSTITLE saves by using RSESSION to build a list of connections. You can then use the list to select a connection when submitting statements to a remote host.

In order to use this function, Release 6.07 or later of SAS software must be running on both the local and remote host systems.

See SAS/CONNECT User's Guide for more information about establishing a link between local and remote hosts.

Example

Define the description MVS Payroll Data for the remote session that has the identifier A:

session='A';
   description='MVS Payroll Data';
   rc=rstitle(session,description);