RSTITLE SCL Function

Defines a description for an existing connection to a SAS/CONNECT server session.

Client:	optional
Server:	optional

Syntax

Details

Example

Syntax

sysrc=RSTITLE(session-ID, description);

Syntax Description

sysrc: is 0 if the description was saved or nonzero if the operation failed.

session-ID: is the name of the server session (specified by CONNECTREMOTE= server-ID). The string can contain a maximum of eight characters.

description: is a description to associate with the server session. The string can contain a maximum of 40 characters.

Details

The RSTITLE function saves the session identifier and description for an existing connection to a server session. This information can be retrieved by using the RSESSION function to build a list of connections. The list can then be used to select a connection when submitting statements to a server.

Example

The following statements define the description z/OS Payroll Data for the remote session by using the identifier A:

session='A';
descrip='z/OS Payroll Data';
rc=rstitle(session,descrip);