# Program: jddDialer.dll

# Version: 1.1 Demo, Javadabado takes no responsibility in miss-use or failed functions relative to this demo version.

# Description:
    Allows to phone with modem through browser. The dll dials a specified phone number, user pick up parallel connected
    "normal" phone and dll disconnects modem.
    
# Setup:
    Set classpath to comm.jar in autoexec.bat and restart your computer, ex. SET CLASSPATH=C:\...yourpath..\comm.jar;
    Set path to win32comm.dll (es SET PATH=C:\...yourpath..\win32comm.dll) or move win32comm.dll to system directory (windows98 folder windows/system, windowsNT folder windows/system32)
    Restart your computer.
    Register jddDialer.dll by editing "register_jddDialer.bat" and launching it.
    Edit jddDialer.properties to compile with your modem.
    
    To use from asp pages.
    Create object in asp and call dial function.
    es
    <%
    Set dialCom = Server.CreateObject("jddDialer.jddDialer")
    dialResponse = dialCom.dial("c:\..yourpath...\jddDialer.properties","0516770560")
    Set dialCom = Nothing
    response.write dialResponse 
    %>
    
    an example has been included make sure to edit path jddDialer.properties in jddDialer_dial.asp
    launch using asp server jddDialer_placeCall.html
    
    
# Dialfunction

   dial(String propertiesFile, String phoneNumber)
   
   @param propertiesFile, path to file that defines modem properties
   @param phoneNumber, phoneNumber to dial, avoid al spaces and caracters as -
   
   @return dialMessage, function returns string with return codes below
   
# Return codes
    100: Calling number
    
    210: No dialtone //note phone may be in use by other external user
    220: Serialport already in use by (current.owner) // modem is already in use by other user
    
    310: No serialports found //can't find any serialports, check correct installation of win32comm.dll
    320: No such serialport //can't find serial port specified in jddDialer.properties
    330: Can't initiate serialport input/output streams, + (error description)
    340: Can't add listener to serialport, + (error description)
    350: Serialport property not supported, + (error description) // check settings in jddDialer.properties
    360: Error in serialport input stream, + (error description)
    370: Error in serialport output stream, + (error description)
    
    410: Modem not responding correctly //modem is not responding correctly check log for further info // check that modem exists on serialPort specified in jddDialer.properties
    420: Modem command not correct, +(command sent) // modem is answering error, last command not correct // check modem settings in jddDialer.properties
    
    500: Can't load propertiesFile + fileName , + (error description) //check correct path to propertiesFile
    510: Missing property, + (error description)
    520: Not valid property, + (error description)

    Note: Program operations are logged to log file "jddDialerDLL.log" that can be found in root, normally c:\jddDialerDLL.log