Configure Calling Search Spaces
-------------------------------

A calling search space comprises an ordered list of route partitions that are
typically assigned to devices. Calling search spaces determine the partitions
that calling devices search when they are attempting to complete a call.


1. Log in as the Provider, Reseller, or Customer Administrator.                                           
2. Perform one of the following:                            

   * If you logged in as the Provider or Reseller Administrator, select
     **Device Management > CUCM > Calling Search Spaces**.
   * If you logged in as the Customer Administrator, select
     **Device Management > Advanced > Calling Search Spaces**.
3. Make sure that the hierarchy path is set to the correct level.
4. Perform one of the following:                            

   * To add a new calling search space, click **Add**, then go to step 5.
   * To edit an existing calling search space, click on the line item in the table.
     Go to step 6.            
5. In the popup, select from the pull-down the network device list (NDL) to which
   you are adding the calling search space, and click **OK**.
    
   .. note::
                                                            
      The NDL popup will only appear when you are adding a new calling search space.
      If you are updating an existing calling search space, go to Step 6.
                                                    
   If you are adding the calling search space to a Site hierarchy node, the NDL
   popup will not appear. You will go right to the Calling Search Spaces add page
   using the NDL associated to the site.                                            
6. From the Calling Search Spaces page, modify the following fields as required.

   .. tabularcolumns:: |p{4cm}|p{11cm}|

   +----------------+-------------------------------------------+
   | Option         | Description                               |
   +================+===========================================+
   | Name           | Enter a name in the field. The name can   |
   | (Mandatory)    | comprise up to 50 alphanumeric characters |
   |                | and can contain any combination of        |
   |                | spaces, periods (.), hyphens (-), and     |
   |                | underscore characters (_). Ensure each    |
   |                | calling search space name is unique to    |
   |                | the system.                               |
   |                |                                           |
   |                | Note                                      |
   |                |                                           |
   |                | Use concise and descriptive names for     |
   |                | your calling search spaces. The           |
   |                | CompanynameLocationCalltype format        |
   |                | usually provides a sufficient level of    |
   |                | detail and is short enough to enable you  |
   |                | to quickly and easily identify a calling  |
   |                | search space. For example,                |
   |                | CiscoDallasMetroCS identifies a calling   |
   |                | search space for toll-free, inter-local   |
   |                | access and transport area (LATA) calls    |
   |                | from the Cisco office in Dallas.          |
   |                |                                           |
   |                | Default value: None                       |
   +----------------+-------------------------------------------+
   | Description    | Enter a description in the field. The     |
   |                | description can include up to 50          |
   |                | characters in any language, but it cannot |
   |                | include double-quotes ("), percentage     |
   |                | sign (%), ampersand (&), back-slash (\),  |
   |                | or angle brackets (<>).                   |
   |                |                                           |
   |                | Default value: None                       |
   +----------------+-------------------------------------------+
   | Route          | Click the Add (+) button to add a         |
   | Partitions     | partition to the calling search space.    |
   |                | Repeat as necessary to add multiple       |
   |                | partitions to the calling search space.   |
   +----------------+-------------------------------------------+
   | Partition Name | Click the drop-down list and select a     |
   |                | partition to add to the calling search    |
   |                | space.                                    |
   |                |                                           |
   |                | Click **Add (+)** to add another          |
   |                | partition to the Route Partitions list.   |
   |                | Repeat as necessary to add multiple       |
   |                | partitions to the list.                   |
   |                |                                           |
   |                | Click the **Remove (-)** button to remove |
   |                | a partition from the list.                |
   |                |                                           |
   |                | Click the up and down arrow buttons to    |
   |                | change the order of a partition in the    |
   |                | list.                                     |
   +----------------+-------------------------------------------+
   | Partition      | Enter the priority number for this        |
   | Index          | partition in the calling search space.    |
   |                | The smaller the integer, the higher the   |
   |                | priority.                                 |
   +----------------+-------------------------------------------+

   The following table provides examples of the maximum number of partitions that
   can be added to a calling search space if partition names are of fixed length.     

   +-------------------------+------------------------------------+ 
   |  Partition Name Length  |  Maximum Number of Partitions      | 
   +=========================+====================================+ 
   |  2 characters           |  170                               | 
   +-------------------------+------------------------------------+ 
   |  3 characters           |  128                               | 
   +-------------------------+------------------------------------+ 
   |  4 characters           |  102                               | 
   +-------------------------+------------------------------------+ 
   |  5 characters           |  86                                | 
   +-------------------------+------------------------------------+ 
   |  ...                    |  ...                               | 
   +-------------------------+------------------------------------+ 
   |  10 characters          |  46                                | 
   +-------------------------+------------------------------------+ 
   |  15 characters          |  32                                | 
   +-------------------------+------------------------------------+ 

7. Click **Save**. The calling search space appears in the list.            


To modify any of these characteristics, click the item in the list, make
your changes, and click **Save**.

To delete a calling search space, check the box to the left of the Name
column in the group list, and click **Delete**.