For this program to work you need an modem-card that supports CAPI (Common ISDN API). All ISDN adapter cards for Windows and most for Linux do support CAPI. The only PSTN adapter cards (I know of) that support CAPI are Eicon's Diva Server Analog cards.

You need to install a java software development kit version 1.5 [aka 5.0] or higher (java.sun.com).

1. You need to set up the linux jcapi package first.

   Which means you need to put the library libjcapi.so into the library search path. Additional to the usual places this application is searching as well in the uk/co/mmscomputing/device/capi/lin32 directory. The package includes a libjcapi.so file generated with gcc 3.3 in above mentioned directory. If you use a SuSE 8.2 [9.1] distribution it should work out of the box. Other distributions might work as well. If not try recompiling libjcapi.so.

2. Start the application with :

   At the command line change the directory to the one where the package has been extracted and type
   java uk.co.mmscomputing.application.answerphone.MainApp

1. You need to set up the windows 32 bit jcapi package first.

   Which means you need to put the library jcapi.dll into the library search path. Additional to the usual places this application is searching as well in the uk/co/mmscomputing/device/capi/win32 directory. The package includes a jcapi.dll file generated with Borlands bcc 5.5 in above mentioned directory. If you use a 32 bit Windows it should work out of the box.

2. Start the application with :

   At the command line change the directory to the one where the package has been extracted and type
   java uk.co.mmscomputing.application.answerphone.MainApp

If you just want to try out the program.

1. You need to download

   uk.co.mmscomputing.application.answerphone.jar and start it with:
   java -jar uk.co.mmscomputing.application.answerphone.jar.

   Windows: Should start the application when you double click the jar file.
   Linux: You might need to recompile libjcapi.so.

For the fax part to work the isdn card needs to support

1. B-Protocol 'T.30 for Group 3' (see tab setup/controller)
2. DTMF detection (see tab setup/controller)

   
   To scan and display fax images you might need to add the option -Xmx128m when you call java.
   I.e. java -Xmx128m uk.co.mmscomputing.application.answerphone.MainApp
   

1. Phone Call Table

   The table that lists the received calls.
   Mouse Button Left Double Click: Plays recorded sound message.
   Mouse Button Left Double Click AND Shift Key Down: Enter remote number into phone book.
   Mouse Button Right Double Click: Delete recorded sound message (Confirmation dialog pops-up).

2. Fax Call Table

   The table that lists the received facsimile.
   Mouse Button Left Double Click: Show fax in image viewer tab.
   Mouse Button Left Double Click AND Shift Key Down: Enter remote number into phone book.
   Mouse Button Right Double Click: Delete facsimile (Confirmation dialog pops-up).

3. Phone Book

   The table that lists the known name-numbers pairs.
   Mouse Button Left Click: Select name-number pair for editing.
   Mouse Button Right Double Click: Deletes name-number pair (Confirmation dialog pops-up).

4. Property Tabs

   The property key-value pairs are saved when you close the application or stop the applet in folder mmsc in the users home directory. (The Log Book tells you where that is.)