59.8. Message files

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.

59.8.1. File audio format

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]Note

An alternative app for recording and editing audio is Audacity.

Figure 59.1. Audio file format

Audio file format

Messages must be renamed according to the following table:

Table 59.1. Message filenames

FilenameEventNotes
INTROIntro 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.
WELCOMEWelcome 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.
INITDIALInitial 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).
AFTERPINPin entered and user identification succeeded.It's played when the user enters a PIN and the identification has been successfully.
IDENFAILIdentification failure message.It's played when the identification fails; it can occur only when the user enters a wrong PIN.
CALLNACalled number not allowed.It's played when the number/prefix called by the user isn't allowed.
LOOPDIALDial 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.
ALERTAlerting message.It's played when the called number is alerting. Normally this file isn't present and DISA uses default CtiSys tones.
BUSYUser Busy (cause 0x91).It's played when a call fails with reason “user busy” (ISDN cause 0x91).
NOANSWERUser not answered after a timeout (cause 0x93).It's played when a call fails with reason “user not responding, user alerted” (ISDN cause 0x93).
DISCGeneric failures.It's played upon failures not covered by specific events.
HOLDCall 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.
BYEGoodbye.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]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]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).

59.8.2. Commands to manage audio files

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]Warning

The operation could persist for some minutes; the duration depends on the number of coder installed in the CPX.

59.8.3. Example of insertion of WAV files and creation of CPM

This section shows an example of the use of the rebuild command.

  1. 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.

  2. Rename the files according the syntax event.wav (e.g. initdial.wav, alert.wav, etc).

  3. 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]Note

    The command must be repeated for every file.

  4. 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.
  5. 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 COMPLETED
  6. Type 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.
  7. 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]Note

    The command must be repeated for every file.