# Calling name identification presentation (CNIP)

The CNIP service allows name information of the calling party to be passed to the called party (caller ID).

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_calling_name (Acu_conn_rq_a_ss_cnip_name) | Pointer to a buffer containing a calling name.
Acu_conn_rq_calling_name_size (Acu_conn_rq_ss_cnip_name_size) | Size of a buffer containing a calling name.
Acu_conn_rq_calling_name_active (Acu_conn_rq_ss_cnip_name_active) | Indicates CNIP supplementary service is invoked.
Acu_conn_rq_calling_name_pres (Acu_conn_rq_ss_cnip_name_pres) | Calling name 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

Note: The names of the macros have been modified to make them more descriptive. Both names are currently supported with the deprecated names appearing in parentheses.

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_calling_name_active to determine if the service has been invoked. If it has, the application examines the value of Acu_conn_in_calling_name_pres to determine if the calling name is provided to the served user.