| 59.8. Message files | ||
|---|---|---|
 | Chapter 59. DISA - Direct Inward System Access |  |
| 59.8. Message files | ||
|---|---|---|
| | Chapter 59. DISA - Direct Inward System Access | |
Every DISA action corresponds to a tone or a message, which informs the user on the action realized. Filenames are predefined for the event correlated to the message. This section shows how to load the message files and how to compile them with Abilis.
Message files must be recorded on a PC and saved in WAV format with CCITT A-law (or u-law) 8KHz, 8 bit, Mono (Windows sound recorder supports it).
![[Note]](../images/note.png) | Note |
|---|---|
An alternative app for recording and editing audio is Audacity. |
Messages must be renamed according to the following table:
Table 59.1. Message filenames
| Filename | Event | Notes |
|---|---|---|
| INTRO | Intro message. | This message is played before the call goes ACTIVE. When the network allows it to pass it can be used to play an introductory message prior to start the paid part of the call. |
| WELCOME | Welcome message. | This message welcomes callers. It's played only once and it's interrupted when the caller enters a digit; when it ends the INITDIAL phase will start or AUTO-CDO is called. It can't be a CtiSys tone. |
| INITDIAL | Initial dial. | It's the first dial message played; from this moment the user can make a call or enter a PIN (the message is interrupted when the caller enters a digit). |
| AFTERPIN | Pin entered and user identification succeeded. | It's played when the user enters a PIN and the identification has been successfully. |
| IDENFAIL | Identification failure message. | It's played when the identification fails; it can occur only when the user enters a wrong PIN. |
| CALLNA | Called number not allowed. | It's played when the number/prefix called by the user isn't allowed. |
| LOOPDIAL | Dial after loop. | It's played when the post-selection fails (and loop is active) or when ACD is active. If this file is missing the INITDIAL message is played. |
| ALERT | Alerting message. | It's played when the called number is alerting. Normally this file isn't present and DISA uses default CtiSys tones. |
| BUSY | User Busy (cause 0x91). | It's played when a call fails with reason “user busy” (ISDN cause 0x91). |
| NOANSWER | User not answered after a timeout (cause 0x93). | It's played when a call fails with reason “user not responding, user alerted” (ISDN cause 0x93). |
| DISC | Generic failures. | It's played upon failures not covered by specific events. |
| HOLD | Call Parked. | It's played when the call gets parked; it requires that DISA still control the call in active state. Normally this file isn't present and DISA uses default CtiSys tones. |
| BYE | Goodbye. | It's played before closing the call. Normally this file isn't present and DISA doesn't reproduce anything (the file can't be a CtiSys tone). |
Audio files must be loaded, using either FTP, WEB interface or FILE PUT commands, into the appropriate directory (or a subdirectory) of the following location:
<disa-working-dir>\MSG\, typically
C:\APP\DISA\MSG\
For example, if you want to create the messages set “prova”, the files must be copied in the directory:
C:\APP\DISA\MSG\prova
![[Warning]](../images/warning.png) | Warning |
|---|---|
The subdirectory “MSG” (and its subdirectories) doesn't exist by default; you must previously create them with an FTP client or using the command msg add ctidisa <msgset>. Go to the FTP section for more information about FTP resource. |
| Note |
|---|---|
To load the audio files through WEB interface, please refert to: Section 69.12.7, “Managing messages sets”. |
Once WAV files are loaded, they must be converted in the CPM (CPX Packed Messages) format (i.e. The format that allows Abilis to play the messages with any coder supported).
File messages can be managed with the following commands:
msg update ctidisa [MsgSet [MsgName]]: recreates CPM files only if the corresponding WAV file is newer;
msg rebuild ctidisa [MsgSet [MsgName]]: recreates CPM files, regardless of the corresponding WAV file date/time;
msg extract ctidisa [MsgSet [MsgName]]: extracts the G.711 A-law from the CPM file and writes the corresponding WAV file. The date/time of the extracted WAV should be set equal to the CPM date/time, so that the MSG UPDATE command doesn't recognize it as newer.
| Warning |
|---|---|
The operation could persist for some minutes; the duration depends on the number of coder installed in the CPX. |
This section shows an example of the use of the rebuild command.
Record an audio file for every event (WELCOME, INITDIAL, AFTERPIN, LOOPDIAL, IDENFAIL, CALLNA, ALERT, BUSY, NOANSWER, DISC, HOLD, BYE) and save it in the following formats (you can use the Windows sound recorder):
WAV CCITT A-law 8KHz, 8 bit, Mono;
WAV CCITT u-law 8KHz, 8 bit, Mono.
Rename the files according the syntax event.wav (e.g. initdial.wav, alert.wav, etc).
Load the files into the directory naming the “message set” desired; you have three possibilities:
Through FTP: you must access to the directory and load the wav files (the FTP user must have the requested authorizations);
Through WEB interface, please refer to: Section 69.12.7, “Managing messages sets”.
From CPX prompt with the FILE PUT command.
If you want to load the file bye.wav in the “test” directory, type:
[00:56:19] ABILIS_CPX:file put z c:\app\disa\msg\test\bye.wav
READY TO RECEIVE FILE...
Upload Zmodem
bye.wav (17.8 KB, 0:00 min = 18246 cps eff)
FILE TRANSFER ENDED, PRESS <ENTER> TO CONTINUE...
FILE TRANSFER SUCCESSFULLY COMPLETED
RECEIVED FILE 'c:\app\disa\msg\test\bye.wav' FORMAT IS UNKNOWN.
NO CHECK DONE. | Note |
|---|---|
The command must be repeated for every file. |
To verify the directory content, type:
[00:15:12] ABILIS_CPX:sys dir c:\app\disa\msg\test
Directory listing of c:\app\disa\msg\test
. <DIR> 29/05/2015 00:11:48
.. <DIR> 29/05/2015 00:11:48
afterpin.wav 17566 29/05/2015 00:12:02
alert.wav 17686 29/05/2015 00:12:02
busy.wav 17486 29/05/2015 00:12:02
bye.wav 18246 29/05/2015 00:12:02
callna.wav 22606 29/05/2015 00:12:02
disc.wav 18126 29/05/2015 00:12:02
hold.wav 18326 29/05/2015 00:12:02
idenfail.wav 20086 29/05/2015 00:12:02
initdial.WAV 18046 29/05/2015 00:12:02
loopdial.wav 16486 29/05/2015 00:12:02
noanswer.wav 19886 29/05/2015 00:12:02
welcome.wav 16435 29/05/2015 00:12:02
Found 2 directories, 12 files.
Total 62 MB, Used 11 MB, Free 50 MB.Create the CPM file with the command:
[00:15:16] ABILIS_CPX:msg rebuild ctidisa test
YOU ASKED TO REBUILD CTIDISA test
PROCEED (N/Y)?y
MSG REBUILD IN PROGRESS ON CTIDISA test
THIS MAY TAKE FEW MINUTES (Type CTRL+C + ENTER to stop)...
Converting C:\APP\DISA\MSG\test\afterpin.wav
Converting to G711A/64k .......... END
Converting C:\APP\DISA\MSG\test\alert.wav
Converting to G711A/64k .......... END
Converting C:\APP\DISA\MSG\test\busy.wav
Converting to G711A/64k .......... END
Converting C:\APP\DISA\MSG\test\bye.wav
Converting to G711A/64k .......... END
Converting C:\APP\DISA\MSG\test\callna.wav
Converting to G711A/64k .......... END
Converting C:\APP\DISA\MSG\test\disc.wav
Converting to G711A/64k .......... END
Converting C:\APP\DISA\MSG\test\hold.wav
Converting to G711A/64k .......... END
Converting C:\APP\DISA\MSG\test\idenfail.wav
Converting to G711A/64k .......... END
Converting C:\APP\DISA\MSG\test\initdial.WAV
Converting to G711A/64k .......... END
Converting C:\APP\DISA\MSG\test\loopdial.wav
Converting to G711A/64k .......... END
Converting C:\APP\DISA\MSG\test\noanswer.wav
Converting to G711A/64k .......... END
Converting C:\APP\DISA\MSG\test\welcome.wav
Converting to G711A/64k .......... END
COMMAND COMPLETEDType the following command to verify the directory content:
[00:18:04] ABILIS_CPX:sys dir c:\app\disa\msg\test
Directory listing of c:\app\disa\msg\test
. <DIR> 29/05/2015 00:11:48
.. <DIR> 29/05/2015 00:11:48
afterpin.wav 17566 29/05/2015 00:12:02
alert.wav 17686 29/05/2015 00:12:02
busy.wav 17486 29/05/2015 00:12:02
bye.wav 18246 29/05/2015 00:12:02
callna.wav 22606 29/05/2015 00:12:02
disc.wav 18126 29/05/2015 00:12:02
hold.wav 18326 29/05/2015 00:12:02
idenfail.wav 20086 29/05/2015 00:12:02
initdial.WAV 18046 29/05/2015 00:12:02
loopdial.wav 16486 29/05/2015 00:12:02
noanswer.wav 19886 29/05/2015 00:12:02
welcome.wav 16435 29/05/2015 00:12:02
afterpin.CPM 18346 29/05/2015 00:18:18
alert.CPM 18469 29/05/2015 00:18:18
busy.CPM 18264 29/05/2015 00:18:20
bye.CPM 19043 29/05/2015 00:18:20
callna.CPM 23512 29/05/2015 00:18:20
disc.CPM 18920 29/05/2015 00:18:22
hold.CPM 19125 29/05/2015 00:18:22
idenfail.CPM 20929 29/05/2015 00:18:22
initdial.CPM 18838 29/05/2015 00:18:24
loopdial.CPM 17239 29/05/2015 00:18:24
noanswer.CPM 20724 29/05/2015 00:18:26
welcome.wav 19765 29/05/2015 00:18:26
Found 2 directories, 24 files.
Total 62 MB, Used 12 MB, Free 50 MB.The wav files can be deleted from the directory; you have two possibilities:
Through FTP: you must access to the directory and delete the wav files (the FTP user must have the requested authorizations);
From CPX prompt with the file delete command.
Type the below command to delete the
bye.wav file in the “test”
directory:
[19:05:57] ABILIS_CPX:file delete c:\app\disa\msg\test\bye.wav
FILE 'C:\APP\DISA\MSG\TEST\BYE.WAV' IS GOING TO BE DELETED.
PROCEED (N/Y)?y
FILE 'C:\APP\DISA\MSG\TEST\BYE.WAV' DELETED | Note |
|---|---|
The command must be repeated for every file. |
| |  | |
| 59.7. Example of Data Call Back configuration |  | 59.9. CTIDISA diagnostics and statistics |