dialup service 3

The java client jclient is in alpha stage, too, which means that not all features are implemented yet. But it is already useable. Runs on all platforms ?!

On some (all?!) platforms you can use the java client. It does not support all ds3 features yet, but it is nice.

You can run the ds3 java client standalone or as an applet.

Running the standalone version

The standalone version is called by executing DialerClientStandalone.class in the normal way. Usually, you will set some of the java system properties (see below) to set the server host etc.

Install: I suggest: Extend your path variable to the java client source directory and (edit and) use the shell script jclient.sh located in the java client source directory to start the client.

Running the applet version

To call the applet version, you need a html page which includes the applet DialerClienetApplet.class.

This is a short example:

   \begin{verse}
   \begin{verbatim}
   <html>
   <body>
   <applet code="DialerClientApplet.class" alt="Sorry, you need Java support." width=406 height=328>
   </applet>
   </body>
   <html>
   \end{verbatim}
   \end{verse}

Usually, you will set some of the applet parameters in order to set some default values.

Install: I suggest: Look at (and edit/copy) the files jclient-index.html, dialermain.html, and dialermini.html located in the java client source directory.

Running the standalone client like an applet

Mainly for debugging purposes it is possible to run the standalone client like an applet. The difference is what happens on terminating the client, which happens when the user quits by pressing the exit button or if an I/O error occures.

Normally, the standalone version terminates completely. But if you set the java property dialer.likeapplet to yes, it reacts like the applet. The applet does not terminate completely, it offers the user to restart the program by pressing a button.

Parameters

Parameter overview

These java properties / applet parameters are defined:

Java properties	Applet parameter	Data type	Description
dialer.serverport	serverport	integer	Server port number, default is 8002
dialer.serverhost	serverhost	string	Server hostname, default is the applet's webserver host
user.name	username	string	Default username
dialer.localhostname	localhostname	string	Hostname to be accepted by dialup server
dialer.miniversion	miniversion	yes or no	Run applet in mini version, default: no
dialer.likeapplet		yes or no	Run standalone version like applet version

The ds3 server

ds3 server hostname

If running as an applet, the ds3 server host is given by the applet runtime environment and is set by this to the (http) host from which the applet code was loaded. Nevertheless, it can be set with the applet parameter serverhost. Anyway, a real applet may only connect to the webserver host.

If running standalone, you have to set the serverhost by setting the java property dialer.serverhost.

ds3 portnumber

The default ds3 server port is 8002. This can be changed by setting the applet parameter serverport or java property dialer.serverport.

The client properties

The username

The default username is set with the applet parameter username. The standalone version uses the system username, which is given by the java property user.name.

Anyway, the user can edit its name before login at ds3.

The localhost

This entry, set by the applet parameter localhostname or the java property dialer.localhostname, respectively, is out of date. In former version of the dialer server it was used. Maybe, it will be used in future versions.

Anyway, the user can edit its host before login at ds3.

Big version and small version

The java client has got a big, full feature view and a tiny view. This is done by setting the java property dialer.miniversion or the applet parameter miniverion, respectively, to yes.

It is recommended first to use the big version, and later on, if you are familiar with the client, you can use the small version.

Screenshots

The big one: (everyone love screenshots :))