- Preface
- Chapter 1 - Overview and Scripts
- Chapter 2 - Call Agents and Feature Servers
- Chapter 3 - Subscribers
- Chapter 4 - CALEA
- Chapter 5 - Features
- Chapter 6 - Announcements, Centrex, MLHG, VoiceMail, and ENUM
- Chapter 7 - Routes
- Chapter 8 - Release Cause Codes and Announcement IDs
- Chapter 9 - Signaling
Announcements, Centrex, MLHG, Voice Mail, and ENUM
Introduction
This chapter discusses the announcement Centrex, MLHG, Voice Mail, and ENUM features supported by the BTS 10200.
The BTS 10200 supports announcement features by sending requests to a customer-supplied announcement server. The BTS generates a request in response to either of the following:
•A call was released (did not go through), and an accompanying release cause code is activated on the BTS. The BTS signals the announcement server to play a designated audio file.
•The service provider has provisioned all calls to the target DN to be routed automatically to a designated announcement.
The announcement server accesses prerecorded audio files that can be played to the caller. The audio files are provided by one of the following servers:
•Cisco AS54xx series Announcement Server
•Cognitronics CX500 Media Resource Server
Note Contact Cisco for servers details. You supply the announcement server .
Announcements are tied to cause codes. A call release (internal cause code) triggers a specific announcement. The Call Agent controls announcement playback via Media Gateway Control Protocol (MGCP).
Industry-standard release cause code specifications are available in the following documents:
•[ANSI document T1.650-1995, ISDN—Usage of the Cause Information Element in Digital Subscriber Signaling System Number 1 (DSS1)
•ITU-T Recommendation Q.850, Usage of Cause and Location in the Digital Subscriber Signalling System No. 1 and the Signalling System No. 7 ISDN User Part
You can link any supported cause code to any announcement ID; you can link an announcement ID to an audio file. BTS triggers the recording to play when a cause code activates. Release Cause Codes and Announcement IDs shows default mapping of cause codes to announcement IDs and files. Use command-line interface (CLI) commands to provision the following changes to default mapping:
•Use the change release-cause command to change the mapping of release cause codes to announcement IDs.
•Use the change announcement command to change the mapping of announcement IDs to audio files.
Note If no announcement is available for a specific cause code, a reorder tone is played to the calling party.
Tip With the Cisco AS54xx series Announcement Server, service providers can enter new announcement file names and use their own audio announcement files. The announcement files must be in 8-bit mu-Law encoded, Next/Sun AU format (.au extension).
Announcements
You can provision all calls to a directory number (DN) to be routed to a designated announcement. This is provisioned using CLI commands in the DN2Subscriber table, as follows:
•Change the administrative status of the announcement service by setting the status token to annc.
•Designate the announcement to be played by setting the annc-id token to the appropriate announcement id. The announcement ID must be one that is listed in Release Cause Codes and Announcement IDs.
Table 6-1 has steps to provision the BTS to support an announcement server.
Centrex Group
Table 6-2 has steps to provision the BTS to connect to a Centrex group.
|
|
|
---|---|---|
Step 1 |
Adding MGW profiles. |
A profile is a template for provisioning MGWs by vendor. It has settings for communications between the BTS Call Agent (CA) and each type of MGW. Several tokens have values that can be overwritten after the CA queries the MGW for supported capabilities. If the MGW returns a different value from that provisioned, the returned value automatically replaces it. If necessary, change the value of other keepalive tokens in the mgw-profile table.
|
Step 2 |
Adding MGWs. |
The MGW table has information about each MGW the CA manages. Address the MGW uniquely by domain name, IP address, or TSAP address. The MGW table has the following associated commands: •RGW—provisions a residential gateway, with the type token set to RGW •TGW—provisions a trunking gateway, with the type token set to TGW. Both commands provision the MGW table, but you can use them to provide user security to individuals.
|
Step 3 |
Adding terminations. |
|
Step 4 |
Adding custom dial plan profiles. |
The Custom Dial Plan Profile (custom-dial-plan-profile) table defines custom dial plan IDs (CDP IDs) assigned to Centrex groups.
|
Step 5 |
Adding custom dial plans. |
The Custom Dial Plan (custom-dial-plan) table translates dialed digits to specific destinations for Centrex calls. If the result of a custom dial plan (CDP) is a POTS access code, call processing uses the POTS Dial Plan table to translate the digits dialed after the POTS access code.
|
Step 6 |
Adding digit maps. |
POTS subscribers use a public dialing plan. Centrex subscribers use a customized dialing plan.
|
Step 7 |
Adding subscriber profiles. |
|
Step 8 |
Changing POPs. |
If Centrex group members subscribe to the Calling Name Delivery (CNAM) feature and require name delivery, the cnam-option token must be specified in the Point of Presence (POP) table. Use the cnam-option values as follows: •cnam-option=local—Display the name from the calling party's Subscriber table, if present. •cnam-option=local-or-lidb—Set this option if external line information database (LIDB) CNAM queries are desired when the calling party's name is not present in the Subscriber table, for example, from an outside caller with no Subscriber table record. •If external LIDB CNAM queries are to be allowed for non-Centrex group calls, set centrex-group internal-cnd-only=n and POP cnam_option=local-or-lidb.
|
Step 9 |
Adding main subscribers. |
The Subscriber (subscriber) table defines subscriber or subscriber group characteristics in a CA. Set up the following terminations as subscribers: •any termination reached by a DN •any termination that can originate in the primary CA •all terminations to customers When the send-bdn-as-cpn token is Y, the subscriber sends the billing DN as the CPN. All terminations in the hunt group send the same DN as the main subscriber in the MLHG.
|
Step 10 |
Adding Centrex groups. |
Both CAs and POTS/Centrex/Tandem (PTC) FSs share the Centrex Group (centrex-grp) table. A Centrex group is typically assigned to a business group. Subscribers within a Centrex group can reach each other by intercom (extension) dialing. A Centrex group is an emulation of a PBX by a Class 5 switch. The Centrex Group table defines Centrex groups and their associated Call Agents. The PTC Feature Server provides Centrex group functionality. The properties assigned to the main subscriber ID are applicable to the whole Centrex group. If external line information database (LIDB) Calling Name Delivery (CNAM) queries are to be allowed for non-Centrex group calls, set internal-cnd-only=n and the POP cnam-option=local-or-lidb.
|
Step 11 |
Adding subscribers to Centrex groups. |
|
Step 12 |
Adding services. |
The Service (service) table defines services and features. A service is a collection of one or more features. Each feature within a service can have one or more triggers. You can group up to ten features into a service, and up to fifty services per subscriber.
|
Step 13 |
Adding subscriber service profiles. |
The Subscriber Service Profile (subscriber-service-profile) table links services to subscribers.
|
Step 14 |
Adding subscribers. |
The Subscriber (subscriber) table defines subscribers and subscriber groups on a CA. Set up the following as subscribers: •termination numbers reached by DNs •termination numbers originating in the CA •termination numbers to customers, such as MLHG or Centrex
Table 3-6 lists subscriber types and their required tokens. Note Each subscriber must have a unique term-id. Note Do not use double quotation marks (""), single quotation marks ('), dashes (-), or underscores (_) in subscriber names. |
Step 15 |
Adding extensions for subscribers. |
The Ext2subscriber (ext2subscriber) table is populated when a Centrex subscriber is created to map extensions to subscriber IDs.
|
Step 16 |
Adding subscriber service profiles. |
The Subscriber Service Profile (subscriber-service-profile) table links services to subscribers.
|
Step 17 |
Adding a Call Park subscriber group. |
The Call Park Subscriber Group (CPSG) table defines the Centrex-specific call park subscriber group identification and the call park timeout timer. Call park is similar to placing a call on hold, but the call is retrieved by dialing a call rather than by pressing a line button.
|
Step 18 |
Placing MGWs in service. |
|
Step 19 |
Preparing subscriber trunk terminations for service. |
|
Step 20 |
Placing subscriber trunk terminations in service. |
|
MLHG
Table 6-3 provides an example of the steps required to provision a multiline hunt group and add subscribers to it. It lists example CLI commands with mandatory tokens.
The following concerns multi-line hunt group operation in a BTS with call forward services:
Hunt List
Table 6-4 provides steps to provision a hunt list and add subscribers to it. It lists example CLI commands with mandatory tokens.
Enhanced MLHG Feature Provisioning
This section explains how to provision the Enhanced MLHG feature. Perform the steps detailed in this section in the sequence shown.
Note The commands shown in this section are examples; you should provision values that are appropriate for your network and service offerings. CLI syntax allows you to enter commands in uppercase or lowercase. In most cases, it allows you to enter hyphens (-) or underscores (_) interchangeably (exceptions, if any, are noted in those specific procedures.)
A complete list of tokens for each CLI table, allowed values, default values, and detailed descriptions for each token, are provided in the Cisco BTS 10200 Softswitch CLI Database.
SUMMARY STEPS
Note Ensure that all prerequisites listed in Step 1 of DETAILED STEPS are provisioned.
add mgw
add termination
add subscriber
add mlhg
change subscriber
add mlhg-terminal
control mgw
equip subscriber-termination
control subscriber-termination
DETAILED STEPS
MLHG Provisioning for SIP Endpoints
This section demonstrates how to provision SIP subscribers to be members of a MLHG. It is similar to the procedure for provisioning MGCP and NCS subscribers in a MLHG, but includes several values specific to SIP subscribers.
Step 1 Office provisioning—If you have not already provisioned the following office parameters on your system, enter commands similar to those in the following examples.
add call_agent id=CA146; tsap_addr=prica88;
add dial_plan_profile id=BASIC_DPP;
add pop id=1; state=TX; country=USA; timezone=CST;
add serving_domain_name domain_name=prica88; auth_reqd=N;
add destination dest_id=DEST_LOCAL; call_type=LOCAL; route_type=SUB;
add subscriber_profile id=SUB_PROFILE; pop_id=1; dial_plan_id=BASIC_DPP;
Step 2 Office code and dial plan provisioning—If you have not already provisioned office code and dial plan parameters on your system, enter commands similar to those in the following examples.
add ndc digit_string=777;
add exchange_code ndc=777; ec=555;
add office_code ndc=777; ec=555; dn_group=xxxx; call_agent_id=CA146;
add dial_plan id=BASIC_DPP; digit_string=777555; min_digits=10; dest_id=DEST_LOCAL;
Step 3 Add the main subscriber for the MLHG (the subscriber associated with the pilot number for the MLHG). This command example is for a SIP-based main subscriber.
Note Enter term_type=SIP if you want to have a physical SIP endpoint associated with the pilot number. Enter term_type=NONE if you do not want a physical endpoint associated with the pilot number. Enter category=mlhg to identify this subscriber as the main subscriber for the MLHG. (The system does not allow you to enter the MLHG ID yet. This will be done in a later step.)
add subscriber id=7775559900; name=7775559900; billing_dn=7775559900; dn1=7775559900; sub_profile_id=SUB_PROFILE; term_type=SIP; policy_id=NULL; aor_id=7775559900@prica88; category=MLHG;
Step 4 Add an individual subscriber for the MLHG. This command example is for a SIP-based MLHG individual subscriber. Repeat this command as needed to provision additional subscribers.
Note Enter category=mlhg_individual to identify this subscriber as a member of the MLHG. (The system does not allow you to enter the MLHG ID yet. This is done in a later step.)
add subscriber id=7775559901; name=7775559901; billing_dn=7775559901; dn1=7775559901; sub_profile_id=SUB_PROFILE; term_type=SIP; policy_id=NULL; aor_id=7775559901@prica88; category=MLHG_INDIVIDUAL;
Step 5 Enter the following command to create the MLHG and identify the main subscriber as the subscriber you provisioned in Step 3.
add mlhg id=MLGROUP0; call_agent_id=CA146; main_sub_id=7775559900;
Step 6 Link the main subscriber record and all of the individual subscriber records to the MLHG.
change subscriber id=7775559900; mlhg_id=MLGROUP0;
change subscriber id=7775559901; mlhg_id=MLGROUP0;
Step 7 If the main subscriber is associated with a physical endpoint (and you entered term_type=SIP in Step 3), add the terminal. You must enter term_type=SUB_ID and include the specific subscriber ID for the SIP endpoint. (However, if you entered term_type=NONE in Step 3, the main subscriber is virtual and cannot be a terminal; in that case, omit this step and do not add a mlhg-terminal for the main subscriber.)
add mlhg_terminal mlhg_id=MLGROUP0; terminal=1; term_type=SUB_ID; sub_id=7775559900;
Step 8 Add a terminal for each MLHG individual. If you entered term_type=SIP in Step 4, you must enter term_type=SUB_ID and include the specific subscriber ID for the SIP endpoint.
add mlhg_terminal mlhg_id=MLGROUP0; terminal=2; term_type=SUB_ID; sub_id=7775559901;
Note If you entered term_type=TERM in Step 4 (applicable to MGCP and NCS endpoints but not to SIP endpoints), you can enter either SUB_ID or TERM as the term_type, along with appropriate additional parameters, in the mlhg_terminal table.
Step 9 (Optional) If you want to provision a specific subscriber as a nonhunt line (so that calls to this DN do not invoke a hunt under any conditions), enter a command similar to this:
change subscriber id=7775559901; mlhg_id=MLGROUP0; mlhg_non_hunt_terminal=Y;
Tip The mlhg_non_hunt_terminal parameter is valid for MGCP, NCS, and SIP subscribers.
Step 10 (Optional) If you want the system to deliver calls to a SIP endpoint even when all MLHG lines are busy, enter a command similar to this:
change subscriber id=7775559901; mlhg_id=MLGROUP0; mlhg_sip_deliver_if_busy=Y;
Step 11 For each SIP subscriber, place the AOR in service.
change aor2sub aor_id=7775559900@prica88; status=INS;
change aor2sub aor_id=7775559901@prica88; status=INS;
MLHG Nonhunt
To support the MLHG Nonhunt feature, Cisco added to the Cisco BTS 10200 a new token (MLHG_NON_HUNT_TERMINAL), inserting it in the SUBSCRIBER table. The token MLHG_NON_HUNT_TERMINAL is initialized to N by default. This token only applies for subscribers that belong to the various MLHG categories (the subscriber should have a valid non-NULL MLHG_ID field).
You can set the token MLHG_NON_HUNT_TERMINAL to Y when you initially provision the subscriber or you can change it from the default (N) some time after you initially provision the subscriber.
Table 6-5 provides steps for provisioning a subscriber as a non-hunt subscriber. The table lists sample CLI commands with mandatory tokens.
Note For complete CLI information, see the Cisco BTS 10200 Softswitch CLI Database.
For details on provisioning MLGH, see the Cisco BTS 10200 Softswitch Provisioning Guide.
For information on the MLHG feature, see Chapter 3: "Subscriber Features," in the Cisco BTS 10200 Softswitch Network and Subscriber Feature Descriptions.
Voice Mail
Table 6-6 provides steps to provision the BTS to support voice mail and automated attendant. It lists example CLI commands with mandatory tokens.
|
|
|
---|---|---|
Step 1 |
Adding trunk group profiles. |
|
Step 2 |
Adding trunk groups. |
|
Step 3 |
Adding subscribers. |
The Subscriber (subscriber) table defines subscribers and subscriber groups on a CA. Set up the following as subscribers: •termination numbers reached by DNs •termination numbers originating in the CA •termination numbers to customers, such as MLHG or Centrex Table 3-6 lists subscriber types and their required tokens. Note Each subscriber must have a unique term-id. Note Do not use double quotation marks (""), single quotation marks ('), dashes (-), or underscores (_) in subscriber names. |
Step 4 |
Adding automated attendant subscribers. |
Automated attendants manage incoming calls by answering them without a live operator.
|
ENUM
Table 6-7 provides steps to provision the BTS to support ENUM. It lists example CLI commands with mandatory tokens.
Note After using the change enum_profile command, either restart the BTS 10200 Softswitch or restart the ENUM process to make the changes effective.