PURPOSE:

      PHONE_ALERT is a voice message sender to a telephone from computers running
      Windows 2000,Windows NT, Windows 95, Windows 98 or UNIX..

      PHONE_ALERT can use WAVE files.

      PHONE_ALERT can be used with text to speech engine like VoiceWare or Rhetorical .

      PHONE_ALERT , using an easy command, is able to send a voice message
      to any telephone type fixes at home or cellular (mobiles).
      
      PHONE_ALERT can be used in a command file and is able to send alarms
      immediately to the network Admistrator.
      
      With PHONE_ALERT you can use the telephone keyboard to send back
      a return code to the computer.

      With PHONE_ALERT you can use the telephone keyboard to enter a numeric value
      and run a command with this value as parameter.
     
      PHONE_ALERT can be used with a network monitoring software
      like HP OpenView, Tivoli, Patrol, AppManager, SiteScope or BULL ISM Open Master.

      PHONE_ALERT can send multiple voice messages in a single call

      With PHONE_ALERT you can choose the telephone number depending on the time
      or the day (working day or no working day)      

      All PHONE_ALERT events are written in a journal file.

      PHONE_ALERT can use multiple modem for sending multiple
      voice message at the same time.
 
      PHONE_ALERT runs with :
		 WINDOWS 2000
                 WINDOWS 95 and 98,
		 WINDOWS NT 3.51 and 4,
		 UNIX AIX, SCO, HP-UX,SOLARIS,FreeBSD,OpenBSD,IRIX,Tru64 and LINUX,
		 HVX

INSTALLATION

      With WINDOWS 2000,95, 98 and NT.
	   create a directory
	   copy the phone.zip file to this directory
	   execute the commands :
	   
	   pkunzip phone.zip

	   install 

       PHONE_ALERT need Visual Basic 6 runs time.If necessary you can download it
       with IE5 or Netscape at:
	 http://www.ifrance.com/p-jean/windows/vb6_32.zip

         then copy the files under the %WINDIR%\system32 directory for NT or 2000
                          or under the %WINDIR%\system   directory for 9x
 
  
      With UNIX.
	   copy the phone.xxx file
	   execute the commands :
	   
	   cpio -idv < phone.xxx
	   cd phone
	   ./install
	   copy the phone.key file to the phone directory
 
	         xxx =  aix for IBM AIX
			sco for UNIX SCO
			hpx for HP-UX
			lin for LINUX
			fre for FreeBSD
			opn for OpenBSD
			sls for SUN SOLARIS
			irx for IRIX
			osf for Tru64

STATUS

      PHONE_ALERT is shareware. This version is not a fully functionning version.
      With the demo version you can:
		
      - only send the voc1 file to the telephone line
      - record voice messages. If you want to listen your recorded
	voice message you have to use the -SPEAKER parameter (see the
        SPEAKER.BAT file (Windows) or speaker file (UNIX) or you can copy
        your recorded file to the announce file and record another one.
	
RECORDING VOICE MESSAGE

      WAVE file with the CCITT u-Law 8,000 kHz; 8 Bit; Mono format or
      the PCM 8,000 kHz; 16 Bit; Mono format are accepted by PHONE_ALERT.

      If your operating system is Windows you can use the Windows sound recorder
      else to record a voice message from the modem execute the command :

        	phone -record Result_File_Name

      By default the user will record the voice message from a telephone
      line calling the computer telephone number.
      In this mode ,recording stops when no speaking during 3 seconds or
      the user can hit the star key (do not use the star key if for using 
      with multiple messages).
                
      If you want to record from the modem speaker use the -MODEM parameter
      
      The result file name cannot be longer than 31 characters.

      You can change the greetings message replacing the announce file.

TO USE WAVE FILES

      PHONE use wave files with the CCITT u-Law 8,000 kHz; 8 Bit; Mono format or
      the PCM 8,000 kHz; 16 Bit; Mono format.

      With US Robotics or Rockwell chipset voice modem it is possible to use wave files
      with the CCITT u-Law 8,000 kHz; 8 Bit; Mono format or
      the PCM 8,000 kHz; 16 Bit; Mono format, but you have to use the -usr or -rockwell
      parameter before the -file parameter to convert it. 
      
TO SEND VOICE MESSAGES      

      To send a voice message to the telephone line the user execute
      the command :

	 phone -file file_name -phone telephone_number or file_name  
 
	 Required parameters:

	 -phone         telephone_number or file_name which can contains
                        a telephone number or another file name which
                        can contains a telephone number or etc......

	 -file          file_name

         for multiple voice messages you can use as many -file you want
         for example:   -file file1 -file file2 -file file3 .......
 
 
	 Optional parameters :

	 -device xxx    xxx=Serial port. The default serial port is :

			the first available   for Windows systems
			/dev/tty0             for AIX
			/dev/tty1A            for UNIX SCO
			/dev/ttyS0            for LINUX
			/dev/tty0p0           for HP-UX
			/dev/cuaa0            for FreeBSD
			/dev/tty00            for OpenBSD
			/dev/ttyd1            for IRIX
			/dev/term/a           for SUN SOLARIS
			/dev/tty00            for OSF1
	-phone2 telephone_number or
                file_name               If the telephone number of the -phone
					parameter is busy or dont answer,
					the PHONE program will call the
					telephone number of the -phone2
					parameter
	
        -ack                            acknowlegment.The telephone user must
                                        send back a return code (see the
                                        ENTERING KEYBOARD KEYS chapter below)

        -retry xx                       xx=attempts number if the telephone
					number is busy or dont answer or
					no acknowlegment  (99 for default).
					If this counter is exhausted the
					PHONE program returns the value 99.

        -delay xx                       xx=seconds number for waiting between
					2 attempts (60 seconds for default)

       -usr                             To work with US Robotics voice modem you 
                                        have to use the -usr parameter.
                                        if you want to use a wave file this parameter
                                        must be before the -file parameter.

       -rockwell                        use this parameter before the -file parameter if you want
                                        to use a wave file with a Rockwell chipset voice modem.
 

       -dir directory_name              directory of the PHONE software

       -log file_name                   all the PHONE messages are written on this file

       -pulse                           try this parameter if PHONE can't dial the
                                        phone number

       -tone                            try this parameter if PHONE can't dial the
                                        phone number and if the -pulse parameter
                                        has no effect
        
       -pf file_name                    this Parameters File can contains parameters
                                        but only one by line for example:
                                        -device 2
                                        -ack
                                        -phone 0,0123456789
                                        -file f:\phone\voc1
                                        -dir f:\phone\
                                        in the same command you can use this parameter
                                        as many as you like for example:
                                        phone -pf f1 -pf f2 -pf f3

       -nofast                          with this parameter the voice message is sent 
                                        only when the remote user picked up the line 

       -fast_retries xx                 this parameter can be used with the -fast parameter
                                        and xx = the number of times the message is repeated
                                        if this parameter is omitted 10 times by default. 

       -ring_max xx                     xx = maximum time in seconds PHONE wait the phone
                                        is picked-up.
                                        if this parameter is omitted 60 seconds by default.

       -prefix xxx                      xxx = access number

       -from  hhmm                      hh = hours
                                        mm = minutes
       -until hhmm                      with these 2 parameters you can define time to execute
                                        the command.If out of time the PHONE program returns
                                        the value 97

       -except monday                   with this parameter you can except one or more days 
               tuesday                  to execute the command.If out of day the PHONE program 
               wednesday                returns the value 97
               thursday
               friday
               saturday
               sunday
               weekend           -->    for saturday and sunday
               holiday           -->    in the holidays file you can define no working days
       
       -day    monday                   with this parameter you can define one or more days 
               tuesday                  to execute the command.If out of day the PHONE program 
               wednesday                returns the value 97
               thursday
               friday
               saturday
               sunday
               weekend            -->   for saturday and sunday
               holiday            -->   in the holidays file you can define no working days
  
       -data 'command'                  with this parameter the user can enter a numeric value
                                        from the telephone keyboard then the PHONE
                                        program will run the 'command' with this
                                        value as parameter.(see the
                                        ENTERING KEYBOARD KEYS chapter below) 
                                          
       -min                             this parameter can only be used with
                                        Windows to minimize the PHONX window

       -verify                          with this parameter ,the return code or numeric data
                                        entered from the telephone keyboard, can be verified.
                                        
                                        The files verif1, verif2, star, one, two, three, four,
                                        five, six, seven, eight, nine , zero are recorded in 
                                        english language.You can change them by yours.

       -max_# xx                        xx = the number of times the phone user can use the
                                        # key to listen again the voice message  
                                        if this parameter is omitted 99 times by default.

       -no_*                            with this parameter the user enters ONLY one character from
                                        the telephone keyboard

       -at hhmm                         with this parameter PHONE will be sending the voice message at a certain time
                                        hh = hours
                                        mm = minutes 

       -vsm xxx                         this parameter is only used with Venus chipset and change the default (131)
                                        compression method label.
                                        to know the compression method label for your voice modem execute the
                                        modem command (under the PHONE directory).
                                        
                                        xxx=compression method label for 8-bit u-law, (8000).
                                        

 
      To only listen a voice message to modem speaker the user execute
      the command :

	 phone -speaker -file file_name  
    
ENTERING KEYBOARD KEYS

     The telephone user can enter return code or numeric data from the telephone
     keyboard.To validate the operation he must strike the '*' key.
     With this version of PHONE the return code value cannot be greater than 50
     To listen again the voice message the user press the '#' key.
     To cancel entered numeric value the user press the '#' key.
     To listen again the voice message when numeric value has been entered
     but not validated the user must press the '#' key 2 times.
     The user can strike keyboard keys without waiting the end of the voice
     message.

PHONE_ALERT JOURNALIZATION
  
     All PHONE events are written in the file named journal

RETURN CODES

     The PHONE program returns the followed values:

     0    OK
     209  File name or Phone number missing
     99   -retry exhausted
     98   Aborted by the Operator
     97   Out of time or day
     96   the phone number is BLACKLISTED
     95   the code returned by the command of the -data parameter is not = 0
     94   NO DIALTONE
     
     1    when the user hits the 1 key on the telephone keyboard
     2    when the user hits the 2 key on the telephone keyboard
     3    when the user hits the 3 key on the telephone keyboard
     4    when the user hits the 4 key on the telephone keyboard
     5    when the user hits the 5 key on the telephone keyboard
     6    when the user hits the 6 key on the telephone keyboard
     7    when the user hits the 7 key on the telephone keyboard
     8    when the user hits the 8 key on the telephone keyboard
     9    when the user hits the 9 key on the telephone keyboard
     10   when the user hits the 1 and the 0 keys on the telephone keyboard
     .
     .
     50   when the user hits the 5 and the 0 keys on the telephone keyboard 

     Please see the example.bat file (Windows) or example file (Unix)
 
MODEM TECHNICAL CHARACTERISTICS.
 
     The modem must be a voice modem. 
     
     By default, the voice files  announce  and  voc1 
     are WAVE files format.
       
     To use a US Robotics voice modem you must:

     1) execute the command usr under the phone directory (only 1 time)
     2) use the -usr parameter,before the -file parameter, in your command line

     To use a Rockwell chipset voice modem you must:

     1) execute the command rockwell under the phone directory (only 1 time)


PHONE VERSION

     You can download the most recent version of PHONE_ALERT at:

     http://www.ifrance.com/p-jean/windows/phone.zip
 
 
CONTACT US:

     E-mail PierreJEAN2@Wanadoo.fr
 
     SARL EUPROSOFT
     4 rue Plichon
     75011 PARIS
     FRANCE
     
     Tl : (33)1.55.28.81.81     Fax : (33)1.55.28.81.82

PHONE HISTORY

 --  27-11-2000   Version 3 of PHONE

     The new parameter -data has been added.The PHONE program can run a command
     with a numeric entered from the telephone keyboard as parameter
     
     It is now possible to strike a key from the telephone keyboard without
     waiting the end of the voice message.
     
     The return code value has been changed.Before when pressing the '1' key
     the code returned was 49.Now the PHONE program returns the value 1.
     The maximum return code value is 50.

 --  30-11-2000

     This problem has been solved:
     Sometimes at the end of session the modem was locked.

 --  19-12-2000

     These problems encountered with the -pf file have been solved:
     1- When using Notepad for modify the -pf file the last character of the last line
        was truncated
     2- When the line was ended by spaces the program did not recognize the parameter 
  
 --  22-12-2000

     In recording mode PHONE verify if the announce file is available.If it is
     not found PHONE returns code 209.

 --  03-04-2001
     
     Two news parameters -except and -day have been added:

     with these two parameters you can define or except one or more days to execute 
     the command.If out of day the PHONE program returns the value 97.
 
 --  07-07-2001
    
     The new parameter -min has been added.
     This parameter can only be used with Windows to minimize the 
     PHONX window.

--   27-07-2001
    
     With Windows when the modem was busy, the PHONE program was blocked and
     waiting for an operator response.Now PHONX returns the code $F$ and don't block.

--   09-08-2001
    
     The modem hardware control flow has been improved

--   14-08-2001

     This problem has been solved:
     With Unix version when the PHONE program was stopped by CTRL-C the modem was locked.

--   04-09-2001

     Now the user can stop the recording mode with the star key but
     be careful this feature don't work with all modems models
     (do not use the star key if for using with multiple messages).

     -file2 and -file3 parameters have been deleted.
     Now for multiple voice messages you can use as many -file you want
         for example:   -file file1 -file file2 -file file3 .......

     Now to record a voice message you must delete the -file parameter
           for example   phone -record Result_File_Name

--   25-09-2001

     Two news parameters -fast_retries and -ring_max have been added:

       -fast_retries xx                 this parameter can be used with the -fast parameter
                                        and xx = the number of times the message is repeated
                                        if this parameter is omitted 10 times by default. 

       -ring_max xx                     xx = maximum time in seconds PHONE wait the phone
                                        is picked-up.
                                        if this parameter is omitted 60 seconds by default.

--   27-09-2001

     With the Windows version, if the -DEVICE parameter is not present PHONE
     will work with the first modem available.

--   04-12-2001

     The new parameter -verify has been added.

       -verify                          with this parameter ,the return code or numeric data
                                        entered from the telephone keyboard, can be verified

                                        The files verif1, verif2, star, one, two, three, four,
                                        five, six, seven, eight, nine , zero are recorded in 
                                        english language.You can change them by yours.

--   03-01-2002

     The new parameter -max_# has been added.

       -max_# xx                        xx = the number of times the phone user can use the
                                        # key to listen again the voice message  
                                        if this parameter is omitted 99 times by default.

--   29-04-2002

     The new parameter -no_* has been added.

     With this parameter the user enters ONLY one character from the telephone keyboard

--   15-05-2002

     The new parameter -at has been added.

      -at hhmm                         with this parameter PHONE will be sending the voice message at a certain time
                                       hh = hours
                                       mm = minutes

--   21-06-2002

     It is now possible to strike a key from the telephone keyboard without
     waiting the end of the verify voice message.
      
--   19-07-2002

     The new return code 94 has been added when the modem returns NO DIALTONE

--   15-08-2002   Version 4 of PHONE

     With this new PHONE release you can now use any model of voice modem.

     Now , PHONE can use WAVE files with
     the CCITT u-Law 8,000 kHz; 8 Bit; Mono format or
     the PCM 8,000 kHz; 16 Bit; Mono format.

     The new -vsm parameter has been added:

       -vsm xxx                         this parameter is only used with Venus chipset and change the default (131)
                                        compression method label.
                                        to know the compression method label for your voice modem execute the
                                        modem command (under the PHONE directory).
                                        
                                        xxx=compression method label for 8-bit u-law, (8000).
       
     By default, the voice files  announce  and  voc1 
     are WAVE files format.
       
     To use a US Robotics voice modem you must:

          1) execute the command usr under the phone directory (only 1 time)
          2) use the -usr parameter,before the -file parameter, in your command line.
             you can use WAVE files.

     To use a Rockwell chipset voice modem you must:

          1) execute the command rockwell under the phone directory (only 1 time)
            you can use WAVE files.

     the -hayes parameter has been replaced by the -usr parameter

     the -fast parameter has been replaced by the -nofast parameter

--   05-09-2002

     Now PHONE can use wave file with US Robotics, Rockwell chipset or Venus chipset voice modem.

     a new -rockwell parameter has been added

       -rockwell                        use this parameter before the -file parameter if you want
                                        to use a wave file with a Rockwell chipset voice modem.
  