ACU_ALERT_RQ

This topic describes:

Note: Address parameters must be set according to the filling order. If one of them is unused, its size field must be set to 0.

Purpose

Sends an alert message.

Conn_id

An allocated call.

ACU_ALERT_RQ protocol variants

The following table lists the variants under which each macro is supported for this primitive. In this table, x indicates both NT and TE sides.

Macro

4
E
S
S

E
1
0

N
I
2

D
M
S

E
T
S
I

V
N
6

H
K
G

A
U
S
T
E
L
1

N
T
T

K
O
R
E
A

T
A
I
W
A
N

Q
S
I
G

D
P
N
S
S

T
1
6
0
7

Acu_alert_rq_a_display,
Acu_alert_rq_display_size
Filling order: 2

 

 

 

 

 

 

 

 

 

 

 

 

 

 

Acu_alert_rq_a_display_list

 

 

 

 

 

 

 

 

 

x

x

 

 

 

Acu_alert_rq_a_ext_parms

 

 

 

 

 

 

 

 

 

 

 

 

 

 

Acu_alert_rq_a_pcs_user,
Acu_alert_rq_pcs_user_size
Filling order: 3

 

 

 

 

 

x

 

 

 

 

 

 

 

 

Acu_alert_rq_a_ss_cnip_name,
Acu_alert_rq_ss_cnip_name_size
Filling order: 4

 

 

 

 

 

 

 

 

 

 

 

x

 

 

Acu_alert_rq_a_tsp_ie_list,
Acu_alert_rq_tsp_ie_list_size
Filling order: 5

x

x

x

x

x

x

x

x

x

x

x

x

x

x

Acu_alert_rq_a_uui,
Acu_alert_rq_uui_size
Filling order: 1

 

 

 

 

x

x

 

 

x

x

x

 

 

 

Acu_alert_rq_data_chani

x

x

x

x

x

x

x

x

x

x

x

x

 

x

Acu_alert_rq_data_chani_excl

x

x

x

x

x

x

x

x

x

x

x

x

 

x

Acu_alert_rq_data_chani_nai

 

 

 

 

 

 

 

 

 

 

 

 

 

 

Acu_alert_rq_data_chani_nb

x

x

x

 

 

 

 

 

 

 

 

 

 

x

Acu_alert_rq_data_chani_tab

x

x

x

 

 

 

 

 

 

 

 

 

 

x

Acu_alert_rq_data_chani_tab_nai

 

 

 

 

 

 

 

 

 

 

 

 

 

 

Acu_alert_rq_ext_parms_lgth

 

 

 

 

 

 

 

 

 

 

 

 

 

 

Acu_alert_rq_ext_parms_nb

 

 

 

 

 

 

 

 

 

 

 

 

 

 

Acu_alert_rq_pcs_user_protocol

 

 

 

 

 

x

 

 

 

 

 

 

 

 

Acu_alert_rq_progress_descr_x [i]

 

 

 

 

 

 

 

 

 

 

 

 

 

x

Acu_alert_rq_progress_description

 

 

 

 

 

 

 

 

 

 

 

 

 

x

Acu_alert_rq_progress_ind_nb

 

 

 

 

 

 

 

 

 

 

 

 

 

x

Acu_alert_rq_progress_loc_x [i]

 

 

 

 

 

 

 

 

 

 

 

 

 

x

Acu_alert_rq_progress_location

 

 

 

 

 

 

 

 

 

 

 

 

 

x

Acu_alert_rq_signal_val

 

 

 

 

 

 

 

 

 

 

 

 

 

 

Acu_alert_rq_ss_cnip_name_active

 

 

 

 

 

 

 

 

 

 

 

x

 

 

Acu_alert_rq_ss_cnip_name_pres

 

 

 

 

 

 

 

 

 

 

 

x

 

 

Acu_alert_rq_uui_protocol

 

 

 

 

 

 

 

 

 

x

x

 

 

 

Acu_alert_rq_x_display_nb

 

 

 

 

 

 

 

 

 

 

 

 

 

 

Acu_alert_rq_x_display_size[i]

 

 

 

 

 

 

 

 

 

 

 

 

 

 

Acu_alert_rq_x_display_total_size

 

 

 

 

 

 

 

 

 

 

 

 

 

 

Acu_alert_rq_x_display_type[i]

 

 

 

 

 

 

 

 

 

 

 

 

 

 

Acu_alert_rq_x_p_display[i]

 

 

 

 

 

 

 

 

 

 

 

 

 

 


ACU_ALERT_RQ macro descriptions and Q.931 IE

Macro

Description

Q.931 IE

Acu_alert_rq_a_display,
Acu_alert_rq_display_size
Filling order: 2

Pointer to (and size of) buffer containing ISDN display info (optional).

Display

Acu_alert_rq_a_display_list

Pointer to display structure.

Display

Acu_alert_rq_a_ext_parms

Pointer to buffer containing extended parameters.

Not used.

Acu_alert_rq_a_pcs_user,
Acu_alert_rq_pcs_user_size
Filling order: 3

Pointer to (and size of) buffer containing ISDN PCS-to-user/user-to-PCS information. See PCS-user information elements for more information on this IE.

PCS-user

Acu_alert_rq_a_ss_cnip_name, Acu_alert_rq_ss_cnip_name_size
Filling order: 4

Pointer to (and size of) buffer containing calling name identification presentation (CNIP) name.

CNIP

Acu_alert_rq_a_tsp_ie_list, Acu_alert_rq_tsp_ie_list_size
Filling order: 5

Pointer to (and size of) transparent IE buffer.

Does not map to an IE.

Acu_alert_rq_a_uui,
Acu_alert_rq_uui_size
Filling order: 1

Pointer to (and size of) buffer containing ISDN user-to-user information (optional).

User-user

Acu_alert_rq_data_chani

Data channel to use (B1, B2, ... D).

Channel identification

Acu_alert_rq_data_chani_excl

Channel IDs are preferred (OFF) or exclusive (ON).

Channel identification

Acu_alert_rq_data_chani_nai

NAI.

Channel identification

Acu_alert_rq_data_chani_nb

Number of channel IDs in the chani_list field. If no channel IDs, use 0.

Channel identification

Acu_alert_rq_data_chani_tab

Channel ID.

Channel identification

Acu_alert_rq_data_chani_tab_nai

NAI.

Channel identification

Acu_alert_rq_ext_parms_lgth

Total length of buffer containing extended parameters.

Not used.

Acu_alert_rq_ext_parms_nb

Number of parameters in buffer containing extended parameters.

Not used.

Acu_alert_rq_pcs_user_protocol

Protocol discriminator for the pcs_user information element. See PCS-user information elements for more information on this IE.

PCS-user

Acu_alert_rq_progress_descr_x [i]

Description for information element i. See Progress description values for a list of valid values.

Progress indicator

Acu_alert_rq_progress_description

Description for information element 0. See Progress description values for a list of valid values.

Progress indicator

Acu_alert_rq_progress_ind_nb

Number of progress indication information elements.

Progress indicator

Acu_alert_rq_progress_loc_x [i]

Location of information element i. See Location values for a list of valid values and default setting information.

Progress indicator

Acu_alert_rq_progress_location

Location of information element 0. See Location values for a list of valid values and default setting information.

Progress indicator

Acu_alert_rq_signal_val

Signal value. See Signal values for a list of valid values.

Not used.

Acu_alert_rq_ss_cnip_name_active

Indicates calling name identification presentation (CNIP) supplementary service should be invoked.

CNIP

Acu_alert_rq_ss_cnip_name_pres

Calling name identification presentation mode. Allowed values:

N_PRES_ALLOWED: Presentation allowed
N_PRES_RESTRICTED: Presentation restricted
N_PRES_NOT_AVAILABLE: Presentation not available

CNIP

Acu_alert_rq_uui_protocol

UUI protocol discriminator value. See UUI protocol discriminator values for a list of valid values.

Default: UUI_IA5 (UUI_USER_SPF for HKG variant).

User-user

Acu_alert_rq_x_display_nb

Number of present occurrences.

Display

Acu_alert_rq_x_display_size[i]

Size of occurrence i (optional).

Display

Acu_alert_rq_x_display_total_size

Total size of the stored strings.

Display

Acu_alert_rq_x_display_type[i]

Type of display i.

Display

Acu_alert_rq_x_p_display[i]

Pointer to occurrence i.

Display