.. _associate_set_e164_numbers_to_one_directory_number:

Associate a Set of E.164 Numbers to One Directory Number
--------------------------------------------------------

Use this procedure to associate a set of E.164 numbers with one Directory Number
(DN) at a customer or site. For example, you could associate a set of E.164 numbers
for the sales department with an attendant's DN.

If you create the association at a site, you can mix customer-level DNs and E.164
numbers with site-level DNs and E.164 numbers.

You can optionally specify a primary E.164 number to associate with the DN. This
step can be useful when you perform a DN-to-E.164 translation (for example, when
provisioning translation rules for LBO gateways) and the DN is associated to more
than one E.164 presentation.

.. note::

   * You cannot associate numbers if Number Management has been disabled for the
     customer.
   * Only DNs or E.164 numbers that are not currently associated are available for
     association.

Procedure
.........

1. Log in as provider, reseller, customer, or site administrator.
2. Set the hierarchy path to the customer or site where you are associating a set
   of E.164 numbers with one DN.
3. Choose **Dial Plan Management > Number Management > E164 Associations (N to 1 DN)**.
4. Click **Add**.
5. From the **DN Number** drop-down, choose an extension number. This field is mandatory.
6. In the E164 Ranges table, click + as required, to add multiple sets of E.164
   numbers. The E.164 numbers do not need to be contiguous. Provide the following
   information:

.. tabularcolumns:: |p{3cm}|p{12cm}|

+-------------+-------------------------------------------------------+
| Field       | Description                                           |
+=============+=======================================================+
|             | Choose one of these ranges:                           |
|             |                                                       |
|             | Note:                                                 |
|             |                                                       |
|             | The range values you choose map to the mask value     |
|             | when the association translation pattern is created.  |
|             | For example, when 10 is chosen, all E.164 numbers     |
|             | and directory numbers that end in 0 are listed. The   |
|             | mask affects all digits 0 to 9, so you can't start    |
|             | the mask on a nonzero number. Likewise, when 100 is   |
|             | chosen, the E.164 number and DN end in two zeros.     |
|             | This pattern results in a mask of XX.                 |
|             |                                                       |
| E164 Range  | * 1 - To list all E.164 numbers                       |
|             | * 10 - To list all E.164 numbers that end in one      |
|             |   zero (0)                                            |
|             | * 100 - To list all E.164 numbers that end in two     |
|             |   zeros (00)                                          |
|             | * 1000 - To list all E.164 numbers that end in three  |
|             |   zeros (000)                                         |
|             |                                                       |
|             | This field is mandatory and affects what appears in   |
|             | the E.164 Number field.                               |
+-------------+-------------------------------------------------------+
|             | Choose the starting number of E.164 numbers. For a    |
| E164 Number | customer-level association, customer-level E.164      |
|             | numbers are available. For a site-level               |
|             | configuration, both customer-level and site-level     |
|             | E.164 numbers are available. This field is mandatory. |
+-------------+-------------------------------------------------------+


7. In the optional **Primary E164** field, enter the primary E.164 number to
   associate with the DN. Make sure the E.164 number you enter starts with \+ and
   falls within the range you specified in the **E164 Range** drop-down.
8. Click **Save**.

   * When listing the Directory Number Inventory and displaying a directory number,
     the E.164 number format is as listed in :ref:`view_directory_number_inventory`.
   * For a site-level association, one or more translation patterns that are used
     to route inbound PSTN calls to their proper DN are created on the Unified CM.
     These patterns are the mappings between the set of E.164 numbers and the
     single directory number. When you associate a set of E.164 numbers to a single
     DN, multiple translation patterns are created; that is, each DN-to-E.164
     range association results in a translation pattern being created on Cisco
     Unified Communications Manager.
   * For a customer-level association, the translation patterns are created on
     each Unified CM cluster that has a dial plan provisioned.
   * For a site-level association, if the site has one or more SIP Local Gateways
     associated with it, the HcsSipLocalGwAddMultiE164AssociationEVT is generated.
     If enabled, the IOS Command Builder generates the default IOS commands
     associated with the event for each SIP Local Gateway.
   * For a customer-level association, if the E.164 number has the same country
     as any SIP Local Gateway configured for the customer, the
     HcsSipLocalGwAddE164AssociationEVT event is generated. If enabled, the IOS
     Command Builder generates the default IOS commands associated with the event
     for each SIP Local Gateway.