Allow RTS calls prior to initial route table load
[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      * - **MC_REPORT**
443        -
444          |
445
446      * - **DCAPTERM_RTPM_RMR_MSGTYPE**
447        -
448          |
449
450      * - **DCAPTERM_GEO_RMR_MSGTYPE**
451        -
452          |
453
454      * - **RIC_X2_SETUP**
455        -
456          deprecated
457
458      * - **RIC_X2_RESPONSE**
459        -
460          deprecated
461
462      * - **RIC_X2_RESOURCE_STATUS_REQUEST**
463        -
464          deprecated
465
466      * - **RIC_X2_RESOURCE_STATUS_RESPONSE**
467        -
468          deprecated
469
470      * - **RIC_X2_LOAD_INFORMATION**
471        -
472          deprecated
473
474      * - **RIC_E2_TERMINATION_HC_REQUEST**
475        -
476          deprecated
477
478      * - **RIC_E2_TERMINATION_HC_RESPONSE**
479        -
480          deprecated
481
482      * - **RIC_E2_MANAGER_HC_REQUEST**
483        -
484          deprecated
485
486      * - **RIC_E2_MANAGER_HC_RESPONSE**
487        -
488          deprecated
489
490      * - **RIC_CONTROL_XAPP_CONFIG_REQUEST**
491        -
492          deprecated
493
494      * - **RIC_CONTROL_XAPP_CONFIG_RESPONSE**
495        -
496          deprecated
497
498