S-PLUS Client Login Dialog

Session Profile

Select the desired session profile. The session profile contains the user name, server host, and a variety of optional settings for the S-PLUS session.

To create a new session profile, select "<New Profile>" and press the Edit button.

To create a new profile based on an existing profile, select the existing profile name and press the Edit button. Change the profile name and possibly other profile fields. Press Save on the Edit Session Profile dialog. In the resulting dialog, indicate that a new profile should be created.

Password

Enter the user's password for the server host. This entry is required. A null password is not allowed.

Edit Button

Press the Edit button to launch the Edit Session Profile dialog. The dialog will be initialized with the values of the selected Session Profile, or with default values if is selected.

Login Button

Press the Login button to attempt a login to the server. If the login is unsuccessful, an error dialog will appear. Otherwise the S-PLUS Client Login dialog will disappear and the Java GUI will appear.

Cancel Button

Press the Cancel button to close the S-PLUS Client Login dialog.

Help Button

Press the Help button to view this help file.

Edit Session Profile Dialog

Profile Name

Enter a name for the profile. Each profile must have a unique name. This is a required field.

User Name

Enter the user name to use when logging in to the specified server. This is a required field. The user name, "root", is not permitted.

Server Host

Enter the name of the server on which to run the S-PLUS session. This is a required field.

Work Directory

Enter the name of the working directory on the server. This is the directory in which S-PLUS will attempt to locate an S-PLUS chapter containing the S-PLUS database of saved user objects. It will also be the default directory for locating server files.

The default value is the home directory of the user.

Advanced Button

Press the Advanced button to display the Advanced Session Profile Options dialog.

X Server Display

Enter the display name. This is typically the same value as would be specified as the DISPLAY environment variable. This value is used by S-PLUS to launch X windows from functions such as brush(), edit(), fix(), motif(), page(), and spin().

The default value is the default display of the client host.

Save Button

Press the Save button to save changes to the session profile. If the profile name has changed a dialog will appear asking whether a new profile should be created, or the name of the profile should be changed to the new name.

If this is a new profile or the profile name has changed, the new name must be different from any other profile names.

Cancel Button

Press the Cancel button to dismiss the Edit Session Profile dialog without saving changes to the session profile.

Remove Button

Press the Remove button to remove the profile from the list of profiles.

Help Button

Press the Help button to view this help file.

Advanced Session Profile Options Dialog

Help Viewer Off at Startup

By default, a help viewer process is launched in the background when the GUI is started. Check this box to avoid starting the help viewer.

If the help viewer is not running, requesting help at the command line will launch help in an xterm window. If your DISPLAY is not set properly, opening the xterm may fail and the help request may appear to have no effect.

Requesting help from a menu or dialog will launch the help viewer, after which requests for help at the command line will go to the help viewer.

The help viewer may be started using "help.start()" or stopped using "help.off()".

Help System URL

Specify the URL for the help system. This may be used to make S-PLUS help available from a web server.

The default value is

http://hostname/shome

where hostname is the name of the server host.

RMI Port

Specify the port number to use for Java Remote Method Invocation (RMI). Most users will leave this as 1099, which is the default port for RMI.

Telnet Prompt

Specify the prompt returned by the telnet process.

A telnet session is employed in acquiring an S-PLUS engine on the server. Something like a "chat" script is used during this process, where the client expects a particular response from the server before sending each new command via telnet. The default is to accept a space character as a valid server response. If there is difficulty in logging on to the server, one may specify a prompt string here. The telnet client will wait for the specified prompt to be returned by the server before sending new commands.

Telnet Script

Specify the name of a file containing a telnet "chat" script needed to connect to the server via telnet. (This feature is not yet implemented.)

OK Button

Press the OK button to close the dialog and store the current field values as part of the current edits to the session profile.

Cancel Button

Press the Cancel button to close the dialog and discard and changes to the field values.

Help Button

Press the Help button to view this help file.