9.1 Introduction

9.1.1 Invoking Identification Services

9.2 Calling Name Identification Presentation (CNIP)

9.3 Connected Name Identification Presentation (CONP)

9.4 Calling Line Identification Presentation (CLIP)

9.4.1 CLIP Under Non-Q.SIG Variants

9.4.2 CLIP Under the Q.SIG Variant

9.4.3 CLIP and Call Forwarding Services

9.5 Calling Line Identification Restriction (CLIR)

9.5.1 CLIR and Other Services

9.6 Connected Line Identification Presentation (COLP)

9.6.1 COLP Under Non-Q.SIG Variants

9.6.2 COLP Under the Q.SIG Variant

9.6.3 COLP and Call Forwarding Services

9.7 Connected Line Identification Restriction (COLR)

9.7.1 COLR and Other Services

9.1 Introduction

This chapter describes supplementary services related to identification of one party to another. The following identification services are implemented in NMS ISDN:

• Calling Name Identification Presentation (CNIP): The called party receives the name of the calling party. Available only under the Q.SIG variant.

• Connected Name Identification Presentation (CONP): The calling party receives the name of the called party. Available only under the Q.SIG variant.

• Calling Line Identification Presentation (CLIP): The called party receives the calling party's address information.

• Calling Line Identification Restriction (CLIR): Prevents the calling party's address information from being presented to called users.

• Connected Line Identification Presentation (COLP): Allows the calling party to determine the connected party's address information.

• Connected Line Identification Restriction (COLR): Restricts the calling party from determining the connected party's address information.

9.1.1 Invoking Identification Services

Unlike other supplementary services, none of the identification services require exchange of information using extended data structures. Rather, all information is exchanged in fields in the basic call control primitives.

For information on filling the macros and sending the messages documented in this chapter, see your NMS ISDN Messaging API Developer's Reference Manual.

9.2 Calling Name Identification Presentation (CNIP)

The CNIP service allows name information of the calling party to be passed to the called party (caller ID). The service is available only under Q.SIG.

To send name information, the originating node application populates the CNIP-related fields in an ACU_CONN_RQ primitive. These fields are accessible by means of the following macros:

Macro	Description
acu_conn_rq_a_ss_cnip_name	Pointer to buffer containing Calling Name Identification Presentation (CNIP) name.
acu_conn_rq_ss_cnip_name_size	Size of buffer containing CNIP name.
acu_conn_rq_ss_cnip_name_active	Indicates CNIP supplementary service is invoked.
acu_conn_rq_ss_cnip_name_pres	CNIP presentation mode. Allowed values: ACU_SS_NAME_ALLOWED_ISO8859 ACU_SS_NAME_ALLOWED_T61 ACU_SS_NAME_RESTRICTED_ISO8859 ACU_SS_NAME_RESTRICTED_T61 ACU_SS_NAME_NOT_AVAILABLE

Name information is presented to the served user in the ACU_CONN_IN primitive. To receive name information, the served user node checks the value of acu_conn_in_ss_cnip_name_active to determine if the service has been invoked. If it has, the application examines the value of acu_conn_in_ss_cnip_name_pres to determine if the calling name is provided to the served user.

9.3 Connected Name Identification Presentation (CONP)

The CONP supplementary service provides the calling party with the name information of the called party. The service is available only under Q.SIG.

There are three call scenarios where this service can be invoked:

• When the called party answers.

• When the called party is being alerted.

• When the called party is busy.

To send connected name information, the originating node application populates the CNIP-related fields in one of the following primitives, depending upon the state of the called party:

Primitive	Scenario	The served user node receives:
ACU_CONN_RS	When the called party answers.	ACU_CONN_CO
ACU_ALERT_RQ	When the called party is being alerted.	ACU_ALERT_IN
ACU_CLEAR_RQ	When the called party is busy.	ACU_CLEAR_IN

The CNIP-related fields are accessible by means of the following macros:

Macro	Description
acu_xxxx_yy_a_ss_cnip_name	Pointer to buffer containing Calling Name Identification Presentation (CNIP) name.
acu_ xxxx_yy_ss_cnip_name_size	Size of buffer containing CNIP name.
acu_ xxxx_yy_ss_cnip_name_active	Indicates CNIP supplementary service is invoked.
acu_ xxxx_yy_ss_cnip_name_pres	CNIP presentation mode. Allowed values: ACU_SS_NAME_ALLOWED_ISO8859 ACU_SS_NAME_ALLOWED_T61 ACU_SS_NAME_RESTRICTED_ISO8859 ACU_SS_NAME_RESTRICTED_T61 ACU_SS_NAME_NOT_AVAILABLE

xxxx_yy is the name of an ACU message primitive minus the ACU_ prefix, in lowercase: conn_rq, facility_rq, etc.:

Acu_facility_rq_start_ext_data

To receive name information, the served user node checks the value of acu_xxxx_yy_ss_cnip_name_active to determine if the service has been invoked. If it has, the application examines the value of acu_xxxx_yy_ss_cnip_name_pres to determine if the calling name is provided to the served user.

9.4 Calling Line Identification Presentation (CLIP)

The CLIP supplementary service causes the called party to receive the calling party's address information. This information consists of:

• The calling party's national (ISDN) number;

• The country code, and other international call information (if any); and

• (Optional) Subaddress information, if provided by the calling user.

This service is available under many variants, including Q.SIG.

9.4.1 CLIP Under Non-Q.SIG Variants

Under most non-Q.SIG variants, the service is generally available to the called user (for example, no subscription is required).

The CLIP supplementary service is activated and deactivated by the service provider. When the service is activated, the network automatically invokes the service in the call setup phase. The application need not perform any special activation or invocation operations to use the service.

The calling user can present address information to the network in the ACU_CONN_RQ primitive. If the calling user does not include address information in the primitive, the network fills in the information by default.

To specify address information, the calling user uses the following macros:

Macro	Description
acu_conn_rq_a_calling_nb	Pointer to buffer containing calling number.
acu_conn_rq_calling_nb_size	Size of buffer containing calling number.
acu_conn_rq_a_calling_nb_sub	Pointer to buffer containing calling subaddress.
acu_conn_rq_calling_nb_sub_size	Size of buffer containing calling subaddress.
acu_conn_rq_calling_nb_plan	Calling number plan.
acu_conn_rq_calling_nb_pres	Calling number presentation.
acu_conn_rq_calling_nb_type	Calling number type.
acu_conn_rq_calling_nb_sub_odd_even	Called subaddress odd/even.
acu_conn_rq_calling_nb_sub_type	Calling subaddress number type.

The acu_conn_rq_calling_nb_pres macro determines whether or not this information is to be made available to the called user. If the calling user sets acu_conn_rq_calling_nb_pres to N_PRES_ALLOWED, the called user can access this information. If the calling user sets acu_conn_rq_calling_nb_pres to N_PRES_RESTRICTED, the network invokes the Calling Line Presentation Restriction (COLP) supplementary service, and blocks this information from the called user. For more information about COLP, see Section 9.7.

The called user receives the address information in the ACU_CONN_IN primitive. To access this information, the called user uses the following macros:

Macro	Description
acu_conn_rq_a_calling_nb	Pointer to buffer containing calling number.
acu_conn_rq_calling_nb_size	Size of buffer containing calling number.
acu_conn_rq_a_calling_nb_sub	Pointer to buffer containing calling subaddress.
acu_conn_rq_calling_nb_sub_size	Size of buffer containing calling subaddress.
acu_conn_rq_calling_nb_plan	Calling number plan.
acu_conn_rq_calling_nb_pres	Calling number presentation.
acu_conn_rq_calling_nb_screen	Calling number screening indicator.
acu_conn_rq_calling_nb_type	Calling number type.
acu_conn_rq_calling_nb_sub_odd_even	Called subaddress odd/even.
acu_conn_rq_calling_nb_sub_type	Calling subaddress number type.

The acu_conn_in_calling_nb_screen macro indicates the result of the network's screening of the address information. Screening is the process by which the network checks that the address information provided by the calling user is acceptable to the network. Possible values for this macro are:

Value	Meaning
N_SCREEN_USER_PASSED	The number was successfully screened.
N_SCREEN_USER_FAILED	The number was not acceptable to the network.
N_SCREEN_NETWORK_PROVIDED	The number was provided by the network (for example, the calling user did not provide the information directly).
N_SCREEN_USER_PROVIDED	No screening took place.

9.4.2 CLIP Under the Q.SIG Variant

The Q.SIG application has the role of network. As a provider of the CLIP service, the application is responsible for the following:

• Determining whether the calling party address information is to be presented to the called user or not, depending upon the presentation setting;

• Sending the calling party address information to the called user;

• Screening the calling party address information, and providing the screening result in the primitive sent to the called user.

If the application cannot verify the calling party address information (e.g. if the screening result is N_SCREEN_NETWORK_PROVIDED or N_SCREEN_USER_PROVIDED), it can include the default access number for the calling user interface in the message sent to the called user. This information is stored in the following macros:

Macro	Description
acu_conn_rq_a_calling_nb2	Order to buffer containing second calling number.
acu_conn_rq_calling_nb2_size	Size of buffer containing second calling number.
acu_conn_rq_calling_nb2_pres	Presentation of second calling number.
acu_conn_rq_calling_nb2_screen	Screen indicator of second calling number.
acu_conn_rq_calling_nb2_type	Type of second calling number.

The information is available to the called user in the following macros:

Macro	Description
acu_conn_in_a_calling_nb2	Order to buffer containing second calling number.
acu_conn_in_calling_nb2_size	Size of buffer containing second calling number.
acu_conn_in_calling_nb2_pres	Presentation of second calling number.
acu_conn_in_calling_nb2_screen	Screen indicator of second calling number.
acu_conn_in_calling_nb2_type	Type of second calling number.

9.4.3 CLIP and Call Forwarding Services

When a call has been diverted or deflected, and the diverted-to user has been provided with the CLIP service, the diverted-to user receives the address information of the calling user, unless the calling user has subscribed to the CLIR service (see Section 9.5).

9.5 Calling Line Identification Restriction (CLIR)

The CLIR supplementary service is used in conjunction with the CLIP service. The CLIR supplementary service blocks calling party address information from being presented to the called user.

This service is available under many variants, including Q.SIG.

The CLIR supplementary service can be provided in either of these two modes:

• Permanent mode: Usually provided to the calling user on a subscription basis. Prevents the calling user's address information from being presented to called users.

• Temporary mode: May be provided to the calling user on a subscription basis or may be generally available. Allows the calling user to decide, on a call-by-call basis, whether to allow the called user access to the calling party address information. When subscribing, the user can specify a default behavior:

• Presentation restricted: By default, the network blocks the calling user's address information from the called user.

• Presentation not restricted: By default, the network allows the calling user's address information to be presented to the called user.
  The calling user can override either default on a call-by-call basis.

If the calling user has subscribed to CLIR in temporary mode, the application determines if the called user can access the address information, by setting the acu_conn_rq_calling_nb_pres macro in the ACU_CONN_RQ message. If the calling user sets acu_conn_rq_calling_nb_pres to N_PRES_ALLOWED, the called user can access this information. If the calling user sets acu_conn_rq_calling_nb_pres to N_PRES_RESTRICTED, the information is denied the called user. In this case, calling line information is not included in the ACU_CONN_IN primitive.

Note: A subscription option exists which causes presentation restricted to be overridden.

9.5.1 CLIR and Other Services

This section describes the interaction between the CLIR service and other supplementary services.

Call Diversion, Call Deflection

If the CLIR supplementary service is active, the calling party's address information is not presented to the diverted-to user unless the diverted-to user has the CLIR override subscription option.

Explicit Call Transfer

The calling user's restriction requirement from the original call is used to restrict the presentation of that user's address information to the transferred-to user.

9.6 Connected Line Identification Presentation (COLP)

The COLP supplementary service allows the calling party to receive a connected party's address information. The calling party can use this service to obtain the address information of the final connected party (the party causing the "Connect" message transmission at the remote end). This information consists of:

• The calling party's national (ISDN) number;

• The country code, and other international call information (if any); and

• (Optional) Subaddress information, if provided by the connected party.

This service is available under many variants, including Q.SIG.

9.6.1 COLP Under Non-Q.SIG Variants

Under most non-Q.SIG variants, the service is generally available to the calling user (for example, no subscription is required).

The COLP supplementary service is activated and deactivated by the service provider. When the service is activated, the network automatically invokes the service on each outgoing call made by the calling user. The application need not perform any special activation or invocation operations to use the service.

The called user can present address information to the network in the ACU_CONN_RS primitive. If the called user does not include address information in the primitive, the network fills in the information by default.

To specify address information, the called user uses the following macros:

Macro	Description
acu_conn_rs_a_connected_nb	Pointer to buffer containing connected number.
acu_conn_rs_connected_nb_size	Size of buffer containing connected number.
acu_conn_rs_a_connected_sub	Pointer to buffer containing connected subaddress.
acu_conn_rs_connected_sub_size	Size of buffer containing connected subaddress.
acu_conn_rs_connected_nb_pres	Connected number presentation.
acu_conn_rs_connected_nb_type	Connected number type.
acu_conn_rs_connected_sub_odd_even	Connected subaddress odd/even.
acu_conn_rs_connected_sub_type	Connected subaddress type.

The acu_conn_rs_connected_nb_pres macro determines whether or not this information is to be made available to the calling user. If the calling user sets acu_conn_rs_connected_nb_pres to N_PRES_ALLOWED, the calling user can access this information. If the called user sets acu_conn_rs_connected_nb_pres to N_PRES_RESTRICTED, the network invokes the Connected Line Presentation Restriction (COLR) supplementary service, and blocks this information from the calling user. For more information about COLP, see Section 9.7.

The calling user receives the address information in the ACU_CONN_CO primitive. To access this information, the called user uses the following macros:

Macro	Description
acu_conn_co_a_connected_nb	Pointer to buffer containing connected number.
acu_conn_co_connected_nb_size	Size of buffer containing connected number.
acu_conn_co_a_connected_sub	Pointer to buffer containing connected subaddress.
acu_conn_co_connected_sub_size	Size of buffer containing connected subaddress.
acu_conn_co_connected_nb_pres	Connected number presentation.
acu_conn_co_connected_nb_screen	Connected number screening indicator.
acu_conn_co_connected_nb_type	Connected number type.
acu_conn_co_connected_sub_odd_even	Connected subaddress odd/even.
acu_conn_co_connected_sub_type	Connected subaddress type.

The acu_conn_co_connected_nb_screen macro indicates the result of the network's screening of the address information. Screening is the process by which the network checks that the address information provided by the called user is acceptable to the network. Possible values for this macro are:

Value	Meaning
N_SCREEN_USER_PASSED	The number was successfully screened.
N_SCREEN_USER_FAILED	The number was not acceptable to the network.
N_SCREEN_NETWORK_PROVIDED	The number was provided by the network (for example, the calling user did not provide the information directly).
N_SCREEN_USER_PROVIDED	No screening took place.

9.6.2 COLP Under the Q.SIG Variant

The Q.SIG application has the role of network. As a provider of the COLP service, the application is responsible for the following:

• Determining whether the called party address information is to be presented to the calling user or not, depending upon the presentation setting;

• Sending the called party address information to the calling user;

• Screening the called party address information, and providing the screening result in the primitive sent to the calling user.

9.6.3 COLP and Call Forwarding Services

If the forwarding user selects the option that the calling user is not notified of call forwarding, then the calling user does not receive forwarding notification. In addition, the calling user does not receive COLP information when the call is answered, unless the calling user has an override subscription option

If the forwarding user selects the option that the calling user is notified, but without the forward-to number, then the calling user does not receive COLP information when the call is answered, unless the calling user has an override subscription option.

9.7 Connected Line Identification Restriction (COLR)

The COLR supplementary service is used in conjunction with the COLP service. The COLR supplementary service blocks called party address information from being presented to the calling user.

This service is available under many variants, including Q.SIG.

The COLR supplementary service can be provided in either of these two modes:

• Permanent mode: Usually provided to the called user on a subscription basis. Prevents the called user's address information from being presented to calling users.

• Temporary mode: May be provided to the called user on a subscription basis or may be generally available. Allows the called user to decide, on a call- by-call basis, whether to allow the calling user access to the called party address information. When subscribing, the user can specify a default behavior:

• Presentation restricted: By default, the network blocks the called user's address information from the calling user.

• Presentation not restricted: By default, the network allows the called user's address information to be presented to the calling user.
  The called user can override either default on a call-by-call basis.

If the called user has subscribed to COLR in temporary mode, the application determines if the calling user can access the address information, by setting the acu_conn_rs_connected_nb_pres macro in the ACU_CONN_RS message. If the called user sets acu_conn_rs_connected_nb_pres to N_PRES_ALLOWED, the calling user can access this information. If the called user sets acu_conn_rs_connected_nb_pres to N_PRES_RESTRICTED, the information is denied the calling user. In this case, called line information is not included in the ACU_CONN_CO primitive.

Note: A subscription option exists that causes presentation restricted to be overridden.

9.7.1 COLR and Other Services

This section describes the interaction between the COLR service and certain other supplementary services.

Notify Diversion

If a forwarded-to or deflected-to user subscribes to COLR permanent mode, then the user's number is not provided with the diversion notification.

If a forwarded-to or deflected-to user subscribes to COLR temporary mode, then the user's number is not provided until negotiations with the user have taken place and a positive indication from the user has been received (for example, the default value will not be used). Note that the user's number can still be released on answer, after confirmation, or the default can be used.

In either situation, a calling user that subscribes to COLP and who has override capability will not receive the forwarded-to or deflected-to user's number as part of the Notify Diversion message, but can use the override capability to receive COLP information when the call is answered.

Explicit Call Transfer

The connected user's restriction requirement from the original call is used to restrict the presentation of that user's address information to the transferred-to user.