CI: Add silent cmake SonarCloud scan
[ric-plt/lib/rmr.git] / docs / msg_types.rst
1 .. This work is licensed under a Creative Commons Attribution 4.0 International License.
2 .. SPDX-License-Identifier: CC-BY-4.0
3 .. CAUTION: this document is generated from source in doc/src/rtd.
4 .. To make changes edit the source and recompile the document.
5 .. Do NOT make changes directly to .rst or .md files.
6
7 ============================================================================================
8 RIC Message Types
9 ============================================================================================
10
11
12 Overview
13 --------
14
15 RMR routes messages based on a combination of message type
16 and subscription ID both of which are integers. The message
17 type constants are defined in the RIC_msg_types.h header file
18 included with the RMR development package while subscription
19 IDs are generated by the subscription manager process at
20 run-time. This document does not include the constant values
21 to avoid incorrectly propagating a stale value through the
22 reference of an outdated document.
23
24
25 Non-Routable Message Types
26 --------------------------
27
28 These message types are not routable and a message passed to
29 an RMR function with any of these constants set will not be
30 sent.
31
32     .. list-table::
33       :widths: 30,70
34       :header-rows: 0
35       :class: borderless
36
37       * - **RIC_UNDEFINED**
38         -
39           Message type is unset or undefined. Newly allocated messages
40           have the type value set to this constant.
41
42
43
44
45 RMR Reserved Message Types
46 --------------------------
47
48 These message types are reserved for RMR communications (e.g.
49 with Route Manager).
50
51     .. list-table::
52       :widths: 30,70
53       :header-rows: 0
54       :class: borderless
55
56       * - **RMRRM_TABLE_DATA**
57         -
58           Table data from route manger. Route manager sends all route
59           mse, etc.) with this type.
60
61       * - **RMRRM_REQ_TABLE**
62         -
63           Request for table update. RMR will send a message with this a
64           table update from route manger.
65
66       * - **RMRRM_TABLE_STATE**
67         -
68           This message type conveys the state of the route table to the
69           end of a table is noticed.
70
71
72
73
74 System Support Message Types
75 ----------------------------
76
77 These message types are used for systems level communications
78 such as health checks, alarms and probes.
79
80     .. list-table::
81       :widths: 30,70
82       :header-rows: 0
83       :class: borderless
84
85       * - **RIC_HEALTH_CHECK_REQ**
86         -
87           When received the application is expected to return a
88           response to the current "health" of the application.
89
90       * - **RIC_HEALTH_CHECK_RESP**
91         -
92           Health responses are sent with a message of this type.
93
94       * - **RIC_ALARM**
95         -
96           Alarm messages with this type are routed to the alarm
97           collection process.
98
99       * - **RIC_ALARM_QUERY**
100         -
101           Unknown meaning
102
103       * - **RIC_METRICS**
104         -
105           This message type causes the message to be routed to the xAPP
106           responsible redistributing metrics.
107
108
109
110
111 Unclassified Message Types
112 --------------------------
113
114 The following message types have not been clasified into a
115 specific category.
116
117     .. list-table::
118       :widths: 30,70
119       :header-rows: 0
120       :class: borderless
121
122       * - **RIC_SCTP_CONNECTION_FAILURE**
123         -
124           |
125
126       * - **RIC_SCTP_CLEAR_ALL**
127         -
128           |
129
130       * - **E2_TERM_INIT**
131         -
132           |
133
134       * - **E2_TERM_KEEP_ALIVE_REQ**
135         -
136           |
137
138       * - **E2_TERM_KEEP_ALIVE_RESP**
139         -
140           |
141
142       * - **RAN_CONNECTED**
143         -
144           |
145
146       * - **RAN_RESTARTED**
147         -
148           |
149
150       * - **RAN_RECONFIGURED**
151         -
152           |
153
154       * - **RIC_ENB_LOAD_INFORMATION**
155         -
156           |
157
158       * - **RIC_ERROR_INDICATION**
159         -
160           |
161
162       * - **RIC_SN_STATUS_TRANSFER**
163         -
164           |
165
166       * - **RIC_UE_CONTEXT_RELEASE**
167         -
168           |
169
170       * - **RIC_X2_SETUP_REQ**
171         -
172           |
173
174       * - **RIC_X2_SETUP_RESP**
175         -
176           |
177
178       * - **RIC_X2_SETUP_FAILURE**
179         -
180           |
181
182       * - **RIC_X2_RESET**
183         -
184           |
185
186       * - **RIC_X2_RESET_RESP**
187         -
188           |
189
190       * - **RIC_ENB_CONF_UPDATE**
191         -
192           |
193
194       * - **RIC_ENB_CONF_UPDATE_ACK**
195         -
196           |
197
198       * - **RIC_ENB_CONF_UPDATE_FAILURE**
199         -
200           |
201
202       * - **RIC_RES_STATUS_REQ**
203         -
204           |
205
206       * - **RIC_RES_STATUS_RESP**
207         -
208           |
209
210       * - **RIC_RES_STATUS_FAILURE**
211         -
212           |
213
214       * - **RIC_RESOURCE_STATUS_UPDATE**
215         -
216           |
217
218       * - **RIC_SGNB_ADDITION_REQ**
219         -
220           |
221
222       * - **RIC_SGNB_ADDITION_ACK**
223         -
224           |
225
226       * - **RIC_SGNB_ADDITION_REJECT**
227         -
228           |
229
230       * - **RIC_SGNB_RECONF_COMPLETE**
231         -
232           |
233
234       * - **RIC_SGNB_MOD_REQUEST**
235         -
236           |
237
238       * - **RIC_SGNB_MOD_REQUEST_ACK**
239         -
240           |
241
242       * - **RIC_SGNB_MOD_REQUEST_REJ**
243         -
244           |
245
246       * - **RIC_SGNB_MOD_REQUIRED**
247         -
248           |
249
250       * - **RIC_SGNB_MOD_CONFIRM**
251         -
252           |
253
254       * - **RIC_SGNB_MOD_REFUSE**
255         -
256           |
257
258       * - **RIC_SGNB_RELEASE_REQUEST**
259         -
260           |
261
262       * - **RIC_SGNB_RELEASE_REQUEST_ACK**
263         -
264           |
265
266       * - **RIC_SGNB_RELEASE_REQUIRED**
267         -
268           |
269
270       * - **RIC_SGNB_RELEASE_CONFIRM**
271         -
272           |
273
274       * - **RIC_RRC_TRANSFER**
275         -
276           |
277
278       * - **RIC_ENDC_X2_SETUP_REQ**
279         -
280           |
281
282       * - **RIC_ENDC_X2_SETUP_RESP**
283         -
284           |
285
286       * - **RIC_ENDC_X2_SETUP_FAILURE**
287         -
288           |
289
290       * - **RIC_ENDC_CONF_UPDATE**
291         -
292           |
293
294       * - **RIC_ENDC_CONF_UPDATE_ACK**
295         -
296           |
297
298       * - **RIC_ENDC_CONF_UPDATE_FAILURE**
299         -
300           |
301
302       * - **RIC_SECONDARY_RAT_DATA_USAGE_REPORT**
303         -
304           |
305
306       * - **RIC_GNB_STATUS_INDICATION**
307         -
308           |
309
310       * - **RIC_E2_SETUP_REQ**
311         -
312           |
313
314       * - **RIC_E2_SETUP_RESP**
315         -
316           |
317
318       * - **RIC_E2_SETUP_FAILURE**
319         -
320           |
321
322       * - **RIC_E2_RESET_REQ**
323         -
324           |
325
326       * - **RIC_E2_RESET_RESP**
327         -
328           |
329
330       * - **RIC_E2_RAN_ERROR_INDICATION**
331         -
332           |
333
334       * - **RIC_E2_RIC_ERROR_INDICATION**
335         -
336           |
337
338       * - **RAN_E2_RESET_REQ**
339         -
340           |
341
342       * - **RAN_E2_RESET_RESP**
343         -
344           |
345
346       * - **RIC_SUB_REQ**
347         -
348           |
349
350       * - **RIC_SUB_RESP**
351         -
352           |
353
354       * - **RIC_SUB_FAILURE**
355         -
356           |
357
358       * - **RIC_SUB_DEL_REQ**
359         -
360           |
361
362       * - **RIC_SUB_DEL_RESP**
363         -
364           |
365
366       * - **RIC_SUB_DEL_FAILURE**
367         -
368           |
369
370       * - **RIC_SERVICE_UPDATE**
371         -
372           |
373
374       * - **RIC_SERVICE_UPDATE_ACK**
375         -
376           |
377
378       * - **RIC_SERVICE_UPDATE_FAILURE**
379         -
380           |
381
382       * - **RIC_CONTROL_REQ**
383         -
384           |
385
386       * - **RIC_CONTROL_ACK**
387         -
388           |
389
390       * - **RIC_CONTROL_FAILURE**
391         -
392           |
393
394       * - **RIC_INDICATION**
395         -
396           |
397
398       * - **RIC_SERVICE_QUERY**
399         -
400           |
401
402       * - **DC_ADM_INT_CONTROL**
403         -
404           |
405
406       * - **DC_ADM_INT_CONTROL_ACK**
407         -
408           |
409
410       * - **DC_ADM_GET_POLICY**
411         -
412           |
413
414       * - **DC_ADM_GET_POLICY_ACK**
415         -
416           |
417
418       * - **A1_POLICY_REQ**
419         -
420           |
421
422       * - **A1_POLICY_RESP**
423         -
424           |
425
426       * - **A1_POLICY_QUERY**
427         -
428           |
429
430       * - **TS_UE_LIST**
431         -
432           |
433
434       * - **TS_QOE_PRED_REQ**
435         -
436           |
437
438       * - **TS_QOE_PREDICTION**
439         -
440           |
441
442       * - **TS_ANOMALY_UPDATE**
443         -
444           |
445
446       * - **TS_ANOMALY_ACK**
447         -
448           |
449
450       * - **MC_REPORT**
451         -
452           |
453
454       * - **DCAPTERM_RTPM_RMR_MSGTYPE**
455         -
456           |
457
458       * - **DCAPTERM_GEO_RMR_MSGTYPE**
459         -
460           |
461
462       * - **RIC_X2_SETUP**
463         -
464           deprecated
465
466       * - **RIC_X2_RESPONSE**
467         -
468           deprecated
469
470       * - **RIC_X2_RESOURCE_STATUS_REQUEST**
471         -
472           deprecated
473
474       * - **RIC_X2_RESOURCE_STATUS_RESPONSE**
475         -
476           deprecated
477
478       * - **RIC_X2_LOAD_INFORMATION**
479         -
480           deprecated
481
482       * - **RIC_E2_TERMINATION_HC_REQUEST**
483         -
484           deprecated
485
486       * - **RIC_E2_TERMINATION_HC_RESPONSE**
487         -
488           deprecated
489
490       * - **RIC_E2_MANAGER_HC_REQUEST**
491         -
492           deprecated
493
494       * - **RIC_E2_MANAGER_HC_RESPONSE**
495         -
496           deprecated
497
498       * - **RIC_CONTROL_XAPP_CONFIG_REQUEST**
499         -
500           deprecated
501
502       * - **RIC_CONTROL_XAPP_CONFIG_RESPONSE**
503         -
504           deprecated
505
506