NVA Alarmprograms
***************************************************************************

Descripton:

The to mainprograms that are needed are nvagrp.nve and nvadial.nve. All other
programs are optional and are only needed for special functions. The alarmgroups
with the names, phonenumbers and phonetypes are stored in groupdatabases. Each group
has its one database. For example group 11 whould have the alarmdata in the database 
nvagrp11.dbf. The groupdatabases can be created and modified with the personal editor
nvpers.exe. 
The program nvagrp.nve reads the specified groupdatabase and launches for every entry
found the program nvadial.nve as postjob. ( Default configuration ) Nvadial.nve dials
the phonenumber and plays an alarmvoxfile if the call was answerd.
For special function, moduls can be added.



Programs:
--------------------------------------------------------------------------
nvarun.nve	For initalisation. Starts nvagrp.nve
nvagrp.nve      Mainprogram to read groupdatabase and start postjobs
nvadial.nve	Dials the given number


Moduls:
--------------------------------------------------------------------------

For nvarun.nve:
nvainit.nve     For extra initalisation

For nvagrp.nve:
nvaseq.nve     	Checks if alarm is sequent 
nvaprio1.nve   	Checks priority of the found number             
nvaprio2.nve   	Posts jobs with a low priority last
nva*.nve        * is Phonetype (Expl: nvasms.nve)  Doesn't work if defined sequent

For nvadial.nve:
nvabusy.nve    	Dials number again if it was busy
nvadial2.nve	Dials a 2nd or more number if dialout failed
nvamore.nve	To play a 2nd or more alarmvoxfiles on answer
nvafname.nve	To get name of alarmvoxfile 
nvadec.nve	To modify text for DEC displays

For nvaseq.nve:
nvaseqdl.nve    Dials group sequent


More information about the programs and moduls is in the header of each
program and module.



Variables:
------------------------------------------------------------------------------

nvtini_i1:  nbrrings                    
nvtini_i2:  dbentry                     
nvtini_i3:  Alarmgroup 11.. 88
nvtini_i4:  Alarmtextnumber ( optional for voxfile/dec-display)    

nvtini_s1:  Name of person/room to be called           
nvtini_s2:  First phonenumber                        
nvtini_s3:  Alarmrefnumber for filenames
nvtini_s4:  First phonetype
nvtini_s5:  Name of voxfile to be played when answerd (optional)
nvtini_s6:  Directory with alarmvoxfiles
nvtini_s7:  Alarmtype ( for sequent alarming s7=seq)
nvtini_s8:  Name of logfile  ( Refnumber(s3)+ .l1 or .l2 or .log )

nvtini_statdir:   Directory where logfiles (l1 and l2 ) are written to.


Voxfile:
--------------------------------------------------------------------------------
The voxfile which should be played if a call is answered, can be defined in 
nvtini_s5. If nvtini_s5 is empty the first personal greeting messgage, 
( vXXX_1.vox  XXX=mailboxnumber) from the mailbox defined in nvtini_i4, is
played. 


Alarmtype ( parallel / sequent ):
--------------------------------------------------------------------------------
If the alarmtype "sequent" is used, the phonenumbers are dialed sequent and with
one line. The phonenumbers from the alarmdatabase are dialed until somebody answers
or the end of the database is reached. 
There are two ways to define an alarmgroup as sequent:
1. Set nvtini_s7=seq in the initalisation program nvainit.nvt
2. Set "seq" under pager in the voicemail database ( Use Pmvm001.exe or vmnvt.exe )
   in the mailbox defined in nvtini_i4. 


Logfiles:
--------------------------------------------------------------------------------

All logfiles are written to the nvtini_statdir directory. ( \nvt\log )

Every call is written to the logfile defined in nvtini_s8.
Every error is written to the errorlogfile "nva_"+month+".err".
Every posted job is written to the logfile "nvq_"+month+".log"