Configuring the Error Announcement Map

You map error codes to media files on the session router in the error-announcement-map element. The same map is used for all realms and interfaces for which announcement-on-error is set to enabled.

  1. Access the entries configuration element for the error-announcement-map:
    ORACLE# configure terminal
    ORACLE(configure)# session-router
    ORACLE (session-router)# error-announcement-map
    ORACLE (error-announcement-map)# entries
    ORACLE (error-announcement-map-entry)# 
  2. Set the following parameters:
    1. sip-response-code: Set to the SIP response code to map the playback file to. Either this or q850-cause-code is required (you can specify both).
    2. q850-cause-code: Set to the Q.580 cause code to map the playback file to. Either this or sip-response-code is required (you can specify both).
    3. announcement-file: Required. Set this to the name of the file containing the announcement to play when the callee sends the mapped response code. This file must be present in the /code/media directory, can be a maximum of 32 characters (including the extension), and may not contain a slash (/).
  3. Save and activate your changes.

You can add up to 100 entries, update existing entries, and delete entries using the standard ACLI configuration commands. Each entry must contain a unique combination of sip-response-code and q850-cause-code. You cannot map the same combination to two different announcement files.

For example, because the following three entries use different combinations of SIP and Q.850 codes, they are all valid, even though the individual codes are the same:

error-announcement-map
        entries
                sip-response-code       400
                q850-cause-code         18
                announcement-file       file1.pcm
        entries
                sip-response-code       400
                announcement-file       file2.pcm
        entries
                q850-cause-code         18
                announcement-file       file3.pcm

However, adding the following entry would be invalid, because the specified code combination already matches file1.pcm:

error-announcement-map
        entries
                sip-response-code       400
                q850-cause-code         18
                announcement-file       file2.pcm