IWF COLP COLR Support

When you enable the connected line identity presentation (COLP) and connected line identity restriction (COLR) feature for calls being translated between SIP and H.323, the Oracle® Enterprise Session Border Controller converts the H.323 Connected Number Information element (IE) to the SIP P-Asserted-Identity (PAI) header and vice versa.

When there is no Q.931 Connected Number IE, the Oracle® Enterprise Session Border Controller converts the H.225 Connected Address alias (either E.164 or Public Party Number).

This section describes show the IWF COLP/COLR feature works for IWF calls that originate in SIP and are translated to H.323, and for calls that originate in H.323 and are translated to SIP.

SIP to H.323 Calls

For this type of call, the Oracle® Enterprise Session Border Controller checks the Connect that it receives for a Q.931 Connected Number IE. If it does not find one, then it continues by checking for H.225 Connected Address alias (either E.164 or Public Party Number). Then, it takes one of the following courses of action depending on circumstances:

If it finds the Q.931 Connected Number IE, the Oracle® Enterprise Session Border Controller extracts the screening indicator and the presentation indicator.
If there is no Q.931 Connected Number IE, the Oracle® Enterprise Session Border Controller extracts the screening indicator and the presentation indicator from the H.225 Connect-UUIE of the Connect message.

With these pieces of information in place, the Oracle® Enterprise Session Border Controller performs the conversion from H.323 Connected Number IE to SIP P-Asserted-Identity (PAI) header if and only if the screening indicator is either one of the following:

Network provided
User-provided, verified and passed

Then the Oracle® Enterprise Session Border Controller adds a SIP PAI header (with URI value) to the 200 OK message that it sends in the SIP call leg. The user part of the URI is set to the value of the Q.931 Connected Number IE’s numberDigits field, or to dialDigits value from the Connected Address alias. When the number type is a national number, the Oracle® Enterprise Session Border Controller adds a plus sign (+) and the IWF country code (that you configure) to the beginning of the user part. If the number type is an international number, the Oracle® Enterprise Session Border Controller only adds a plus sign (+). And when the Connected Number is empty, the Oracle® Enterprise Session Border Controller sets the user part of the PAI header URI to anonymous. When the value in the presentation indicator is Presentation restricted, the Oracle® Enterprise Session Border Controller adds the SIP Privacy header (with the value id) to the 200 OK.

In cases when it does not find a screening indicator, the Oracle® Enterprise Session Border Controller will not perform the conversion from the H.323 Connected Number IE to the SIP P-Asserted-Identity (PAI) header.

H.323 to SIP Calls

For this type of call, the Oracle® Enterprise Session Border Controller checks the 200 OK message for a SIP PAI header and a SIP Privacy header. Before it sends a Connect message on the H.323 call leg, the Oracle® Enterprise Session Border Controller generates a Connected Number. It uses the Connected Number to insert a Q.931 Connected Number IE and an H.225 Connected Address alias (type E.164) into the Connect message. The Connected Number is generated in this way:

If the
- SIP PAI header is not found, or
- User part of its URI value is unknown or anonymous, or
- User part of its URI does not follow the H.225 NumberDigits syntax,
  then the Connect Number that the Oracle® Enterprise Session Border Controller generates is a Q.931 Connected Number IE that has no digits and a number type of unknown. In this case, the Oracle® Enterprise Session Border Controller will not insert an H.225 Connected Address alias into the Connect message.
  
  The presentation indicator is set to Number not available due to interworking, and the screening indicator to Network provided. The H.225 NumberDigits’s syntax requires that it be between 1 and 128 characters, and only contain these characters: 0 through 9, the pound sign (#), the asterisk (*), and the comma (,).
In all other cases, the Oracle® Enterprise Session Border Controller uses the user part of the URI as the digits for the Connected Number after it performs the following:
- Strips the plus sign in front of the number, if there is one
- Strips the IWF country code at the beginning of the number, if there is one

Then the Oracle® Enterprise Session Border Controller inserts the Connected Number into the Connect message as the Q.931 Connected Number IE and an H.225 Connected Address alias (type E.164).

If the IWF country code is found in the PAI, the Oracle® Enterprise Session Border Controller sets the type of Q.931 Connected Number IE to National Number. Otherwise, the Oracle® Enterprise Session Border Controller sets it to international. The screening indicator is set to Network provided, and the presentation indicator is set to Presentation Restricted if the Oracle® Enterprise Session Border Controller finds a SIP Privacy header with a value of id, or Presentation Allowed is there is not SIP Privacy header.

IWF COLP COLR Configuration

You configure IWF COLP/COLR support in the IWF configuration by setting two options:

colp-colr-iwf—Setting this option enables support for IWF COLP/COLR
colp-colr-country-code—Must be set if you configure the colp-colr-iwf option to recognize or build a national number; the value you enter here:
- Must be a string of digits from 0 to 9
- Cannot exceed 32 digits
- Cannot contain any non-numeric characters; while it allows you to enter them, the system ignores any non-digits characters and so the feature might not work as needed
  To enable IWF COLP/COLR support:

In Superuser mode, type configure terminal and press Enter.
```
ORACLE# configure terminal
```
Type media-manager and press Enter to access the signaling-related configurations.
```
ORACLE(configure)# session-router
```
Type iwf-config and press Enter. The system prompt will change to let you know that you can configure individual
```
ORACLE(session-router)# iwf-config
```
options—Set the options parameter by typing options, a Space, the option names with a plus sign in front, and then press Enter.
Your entry for the colp-colr-country-code option require that you type in the

entire option name, an equal sign (=), and then the country code value.

To enter both options at once, separate the two with one command and enclose your entire entry in quotation marks ( ); see the following example for command-line syntax.
```
ORACLE(iwf-config)# options +colp-colr-iwf,colp-colr-country-code=1
```
If you type this enter without the plus sign, you will overwrite any previously configured options. In order to append options to the IWF configuration’s options list, you must prepend the new options with a plus sign as shown in the previous example.
Save and activate your configuration.