Cisco BTS 10200 Softswitch

Table Of Contents

Cisco BTS 10200 Softswitch Terminating White and Black List Feature Module

Understanding the Terminating White and Black List Feature

Provisioning the Terminating White and Black List

terminating-wb-list attribute in cos-restrict table

terminating-wb-list table

Provisioning Steps

Cisco BTS 10200 Softswitch Terminating White and Black List Feature Module

---

Revised: July 31, 2008

This document describes the Terminating White and Black List feature for Release 6.0.x of the Cisco BTS 10200 Softswitch and explains how to use it. This document includes the following topics:

•Understanding the Terminating White and Black List Feature

•Provisioning the Terminating White and Black List

Understanding the Terminating White and Black List Feature

A service provider can provision a list of directory numbers (DNs) to appear on a Black List or a White List. A Black List contains the calling numbers that are rejected or denied for a subscriber on the terminating side. A White List contains the calling numbers that are allowed or accepted for a subscriber on the terminating side.

The Terminating White and Black List feature is a new functionality for Temporary Disconnect (TDISC) subscribers. This feature is used to allow or block certain incoming calls made to a subscriber whose status is temporarily disconnected (for example, for nonpayment of bills). The service provider provisions the accepted or blocked dialing numbers in the Terminating White and Black List, and assigns the list to the COS-RESTRICT-ID of the subscriber. This feature also enables the service provider to contact the TDISC subscriber, without having to change the status of the subscriber to active.

---

Note This list is provisionable only by the service provider and cannot be controlled by the individual subscribers.

---

---

Note To enable this feature, the service provider must associate the COS restriction (cos-restrict id) of the subscriber to the POP table. See the "Provisioning Steps" section for more details.

---

This feature can be set up to perform either White List screening or Black List screening, but not both. The following restrictions can be applied:

•No Terminating White and Black List is set for the subscriber—All incoming numbers to the TDISC subscriber are blocked.

•Terminating White List is set—Only the DNs provisioned in the Terminating White List are accepted as incoming calls to the TDISC subscriber. All other incoming calls are blocked. If a White List is set for the subscriber, but no DNs are entered in the White List, then all incoming calls are blocked for the subscriber.

•Terminating Black List—Only the DNs provisioned in the Terminating Black List are blocked. All other calling DNs are accepted as incoming calls to the TDISC subscriber. If a Black List is defined for the subscriber, but no DNs are entered in the Black List, then all incoming calls are accepted for the subscriber.

---

Note The number of digits of the provisioned directory number can be from 1 to 14.

---

The Terminating White and Black List also supports the following:

•A subscriber from a Hostage Negotiation (HN) list can call to a TDISC subscriber, even if the HN subscriber is restricted through use of the Terminating White and Black List.

•A subscriber from the Emergency Call Back (ECB) list can call to a TDISC subscriber, even if the ECB subscriber is restricted through use of the Terminating White and Black List.

•The service provider can either provision a full DN in the Terminating White and Black List, or just provision the prefix of a DN in the list. If only the prefix of a DN is provisioned in the list, then any incoming number with that prefix will be allowed or blocked. For example, an incoming call with DN, such as 206-622-1801, or 206-622-1234, or 206-622-3456 is accepted, when the provisioned digit-string in the Terminating White List is 206-622.

If the full DN is provisioned in the Terminating White and Black List, then only the provisioned DN is allowed or blocked.

Provisioning the Terminating White and Black List

To provision the Terminating White and Black List for TDISC subscribers, use the following attribute and table:

•terminating-wb-list attribute in cos-restrict table

•terminating-wb-list table

terminating-wb-list attribute in cos-restrict table

To provision the Terminating White and Black List, configure the terminating-wb-list attribute in the cos-restrict table. The TERMINATING-WB-LIST attribute has the following token name, type, and values:

Token	PK/FK	Type	Values
TERMINATING-WB-LIST		CHAR	NONE/ BLACK/ WHITE

If the terminating-wb-list token is set to

•NONE—All incoming calls are blocked.

•WHITE—An incoming call is accepted if the calling number is found in the list. All other incoming numbers are blocked.

•BLACK—An incoming call is blocked if the calling number is found in the list. All other incoming numbers are allowed.

terminating-wb-list table

The terminating-wb-list table has the following tokens:

Token	PK/FK	Type	Values
COS-RESTRICT-ID	PK/FK	CHAR/VAR
DIGIT-STRING	PK	CHAR	1-14 NUMERIC DIGITS

•The COS-RESTRICT-ID token is the ID of the cos-restrict table that contains the terminating-wb-list attribute.

After adding the cos-restrict id, you need to associate the id to a POP. See the Provisioning Steps section for more information.

•The DIGIT-STRING token is the DN (1-14 digits) specified to be blocked or accepted.

Provisioning Steps

This feature can be configured only for TDISC subscribers. To provision TDISC subscribers, see the Temporary Disconnect section in the Cisco BTS 10200 Softswitch Provisioning Guide, Release 6.0.x.

Step 1 Add the cos-restrict id and the Terminating White List to the cos-restrict table.

add cos-restrict id=<cos-res-id>; terminating-wb-list= [NONE | WHITE | BLACK];

add cos-restrict id=T-COS-R; terminating-wb-list=WHITE;

Step 2 Associate cos-restrict to a POP.

add pop id=<id>; temp-disc-cos-restrict-id=<cos-res-id>;

add pop id=POP1; temp-disc-cos-restrict-id=T-COS-R;

Step 3 Add the cos-restrict-id and the allowed DN to the White List in the terminating-wb-list table.

add terminating-wb-list; cos-restrict-id= <cos-res-id>; digit-string=<value>;

add terminating-wb-list; cos-restrict-id= T-COS-R; digit-string=206-622-1801;

The cos-restrict-id provisioned in terminating-wb-list table must be the temp-disc-cos-restrict-id specified in the POP table.

Use the following additional CLI commands while provisioning the Terminating White and Black List Screening feature:

•Use the show command to verify that the cos-restrict id and digit-string were added to the terminating-wb-list.

show terminating-wb-list;

•Use the delete command to delete the provisioned terminating-wb-list table.

delete terminating-wb-list; cos-restrict-id=<cos-res-id>; digit-string=<value>;

•Use the show, add, change, delete commands as given below to verify, add, change, or delete the cos-restrict table. For a complete list of CLI commands used with the cos-restrict table, see the Cisco BTS 10200 Softswitch CLI Database.

show cos-restrict id=<cos-res-id>;terminating-wb-list= [NONE | WHITE | BLACK];

add cos-restrict id=<cos-res-id>;terminating-wb-list= [NONE | WHITE | BLACK];

change cos-restrict id=<cos-res-id>;terminating-wb-list= [NONE | WHITE | BLACK];

CCDE, CCENT, Cisco Eos, Cisco Lumin, Cisco Nexus, Cisco StadiumVision, Cisco TelePresence, the Cisco logo, DCE, and Welcome to the Human Network are trademarks; Changing the Way We Work, Live, Play, and Learn and Cisco Store are service marks; and Access Registrar, Aironet, AsyncOS, Bringing the Meeting To You, Catalyst, CCDA, CCDP, CCIE, CCIP, CCNA, CCNP, CCSP, CCVP, Cisco, the Cisco Certified Internetwork Expert logo, Cisco IOS, Cisco Press, Cisco Systems, Cisco Systems Capital, the Cisco Systems logo, Cisco Unity, Collaboration Without Limitation, EtherFast, EtherSwitch, Event Center, Fast Step, Follow Me Browsing, FormShare, GigaDrive, HomeLink, Internet Quotient, IOS, iPhone, iQ Expertise, the iQ logo, iQ Net Readiness Scorecard, iQuick Study, IronPort, the IronPort logo, LightStream, Linksys, MediaTone, MeetingPlace, MeetingPlace Chime Sound, MGX, Networkers, Networking Academy, Network Registrar, PCNow, PIX, PowerPanels, ProConnect, ScriptShare, SenderBase, SMARTnet, Spectrum Expert, StackWise, The Fastest Way to Increase Your Internet Quotient, TransPath, WebEx, and the WebEx logo are registered trademarks of Cisco Systems, Inc. and/or its affiliates in the United States and certain other countries.

All other trademarks mentioned in this document or Website are the property of their respective owners. The use of the word partner does not imply a partnership relationship between Cisco and any other company. (0807R)

Copyright © 2008 Cisco Systems, Inc. All rights reserved.