10.1.19 Packet domain event reporting +CGEREP
27.0073GPPAT command set for User Equipment (UE)Release 18TS
Table 127: +CGEREP parameter command syntax
Command |
Possible response(s) |
+CGEREP=[<mode>[,<bfr>]] |
+CME ERROR: <err> |
+CGEREP? |
+CGEREP: <mode>,<bfr> |
+CGEREP=? |
+CGEREP: (list of supported <mode>s),(list of supported <bfr>s) |
Description
Set command enables or disables sending of unsolicited result codes, +CGEV: XXX from MT to TE in the case of certain events occurring in the Packet Domain MT or the network. <mode> controls the processing of unsolicited result codes specified within this command. <bfr> controls the effect on buffered codes when <mode> 1 or 2 is entered. If a setting is not supported by the MT, ERROR or +CME ERROR: is returned. Refer clause 9.2 for possible <err> values.
Read command returns the current mode and buffer settings.
Test command returns the modes and buffer settings supported by the MT as compound values.
Defined values
<mode>: integer type
0 buffer unsolicited result codes in the MT; if MT result code buffer is full, the oldest ones can be discarded. No codes are forwarded to the TE.
1 discard unsolicited result codes when MT‑TE link is reserved (e.g. in on‑line data mode); otherwise forward them directly to the TE
2 buffer unsolicited result codes in the MT when MT‑TE link is reserved (e.g. in on‑line data mode) and flush them to the TE when MT‑TE link becomes available; otherwise forward them directly to the TE
<bfr>: integer type
0 MT buffer of unsolicited result codes defined within this command is cleared when <mode> 1 or 2 is entered
1 MT buffer of unsolicited result codes defined within this command is flushed to the TE when <mode> 1 or 2 is entered (OK response shall be given before flushing the codes)
Defined events
The events are valid for all accesses unless explicitly mentioned.
For network attachment, the following unsolicited result codes and the corresponding events are defined:
+CGEV: NW DETACH
The network has forced a PS detach. This implies that all active contexts have been deactivated. These are not reported separately.
+CGEV: ME DETACH
The mobile termination has forced a PS detach. This implies that all active contexts have been deactivated. These are not reported separately.
For MT class, the following unsolicited result codes and the corresponding events are defined:
+CGEV: NW CLASS <class>
The network has forced a change of MT class. The highest available class is reported (see +CGCLASS). The format of the parameter <class> is found in command +CGCLASS.
+CGEV: ME CLASS <class>
The mobile termination has forced a change of MT class. The highest available class is reported (see +CGCLASS). The format of the parameter <class> is found in command +CGCLASS.
For PDP context activation, the following unsolicited result codes and the corresponding events are defined:
+CGEV: NW PDN ACT <cid>[,<WLAN_Offload>]
The network has activated a context. The context represents a Primary PDP context. The <cid> for this context is provided to the TE. The format of the parameter <cid> is found in command +CGDCONT.
<WLAN_Offload>: integer type. An integer that indicates whether traffic can be offloaded using the specified PDN connection via a WLAN or not. This refers to bit 1 (E-UTRAN offload acceptability value) and bit 2 (UTRAN offload acceptability value) in the WLAN offload acceptability IE as specified in 3GPP TS 24.008 [8] clause 10.5.6.20.
0 offloading the traffic of the PDN connection via a WLAN when in S1 mode or when in Iu mode is not acceptable.
1 offloading the traffic of the PDN connection via a WLAN when in S1 mode is acceptable, but not acceptable in Iu mode.
2 offloading the traffic of the PDN connection via a WLAN when in Iu mode is acceptable, but not acceptable in S1 mode.
3 offloading the traffic of the PDN connection via a WLAN when in S1 mode or when in Iu mode is acceptable.
NOTE 1: This event is not applicable for EPS and 5GS.
+CGEV: ME PDN ACT <cid>[,<reason>[,<cid_other>[,<WLAN_Offload>[,<SSC>,<old-cid>,[<MA_3GPP>,<MA_N3GPP>]]]]]
The mobile termination has activated a context. The context represents a PDN connection or a Primary PDP context. The <cid> for this context is provided to the TE. This event is sent either in result of explicit context activation request (+CGACT), or in result of implicit context activation request associated to attach request (+CGATT=1). The format of the parameter <cid> is found in command +CGDCONT. The format of the parameter <WLAN_Offload> is defined above.
<reason>: integer type; indicates the reason why the context activation request for PDP type IPv4v6 was not granted. This parameter is only included if the requested PDP type associated with <cid> is IPv4v6, and the PDP type assigned by the network for <cid> is either IPv4 or IPv6.
0 IPv4 only allowed
1 IPv6 only allowed
2 single address bearers only allowed.
3 single address bearers only allowed and MT initiated context activation for a second address type bearer was not successful.
<cid_other>: integer type; indicates the context identifier allocated by MT for an MT initiated context of a second address type. MT shall only include this parameter if <reason> parameter indicates single address bearers only allowed, and MT supports MT initiated context activation of a second address type without additional commands from TE, and MT has activated the PDN connection or PDP context associated with <cid_other>.
<SSC>: integer type; indicates whether the established PDU session is requested by the network for SSC mode 2 or SSC mode 3 PDU session anchor relocation as specified in 3GPP TS 23.501 [165] and 3GPP TS 24.501 [161].
1 the established PDU session is requested by the network for SSC mode 2 PDU session anchor relocation.
2 the established PDU session is requested by the network for SSC mode 3 PDU session anchor relocation.
<old-cid>: integer type; indicates the context identifier of the QoS flow of the default QoS rule of the SSC mode 2 or SSC mode 3 PDU session where the network requests relocation of the PDU session anchor.
<MA_3GPP>: integer type;
0 the established PDU session is an MA PDU session and the user plane resources are not established over 3GPP access.
1 the established PDU session is an MA PDU session and the user plane resources are established over 3GPP access.
<MA_N3GPP>: integer type;
0 the established PDU session is an MA PDU session and the user plane resources are not established over non-3GPP access.
1 the established PDU session is an MA PDU session and the user plane resources are established over non-3GPP access.
NOTE 1A: For legacy TEs supporting MT initiated context activation without TE requests, there is also a subsequent event +CGEV: ME PDN ACT <cid_other> returned to TE.
+CGEV: NW ACT <p_cid>, <cid>, <event_type>[,<WLAN_Offload>]
The network has activated a context. The <cid> for this context is provided to the TE in addition to the associated primary <p_cid>. The format of the parameters <p_cid> and <cid> are found in command +CGDSCONT. The format of the parameter <WLAN_Offload> is defined above.
<event_type>: integer type; indicates whether this is an informational event or whether the TE has to acknowledge it.
0 Informational event
1 Information request: Acknowledgement required. The acknowledgement can be accept or reject, see +CGANS.
+CGEV: ME ACT <p_cid>, <cid>, <event_type>[,<WLAN_Offload>]
The network has responded to an ME initiated context activation. The <cid> for this context is provided to the TE in addition to the associated primary <p_cid>. The format of the parameters <p_cid> and <cid> are found in command +CGDSCONT. The format of the parameters <event_type> and <WLAN_Offload> are defined above.
For PDP context deactivation, the following unsolicited result codes and the corresponding events are defined:
+CGEV: NW DEACT <PDP_type>, <PDP_addr>, [<cid>]
The network has forced a context deactivation. The <cid> that was used to activate the context is provided if known to the MT. The format of the parameters <PDP_type>, <PDP_addr> and <cid> are found in command +CGDCONT.
+CGEV: ME DEACT <PDP_type>, <PDP_addr>, [<cid>]
The mobile termination has forced a context deactivation. The <cid> that was used to activate the context is provided if known to the MT. The format of the parameters <PDP_type>, <PDP_addr> and <cid> are found in command +CGDCONT.
+CGEV: NW PDN DEACT <cid>[,<WLAN_Offload>[,<SSC>]]
The network has deactivated a context. The context represents a PDN connection or a Primary PDP context. The associated <cid> for this context is provided to the TE. The format of the parameter <cid> is found in command +CGDCONT. The format of the parameters <WLAN_Offload> and <SSC> are defined above.
NOTE 2: Occurrence of this event replaces usage of the event +CGEV: NW DEACT <PDP_type>, <PDP_addr>, [<cid>].
+CGEV: ME PDN DEACT <cid>
The mobile termination has deactivated a context. The context represents a PDN connection or a Primary PDP context. The <cid> for this context is provided to the TE. The format of the parameter <cid> is found in command +CGDCONT.
NOTE 3: Occurrence of this event replaces usage of the event +CGEV: ME DEACT <PDP_type>, <PDP_addr>, [<cid>].
+CGEV: NW DEACT <p_cid>, <cid>, <event_type>[,<WLAN_Offload>]
The network has deactivated a context. The <cid> for this context is provided to the TE in addition to the associated primary <p_cid>. The format of the parameters <p_cid> and <cid> are found in command +CGDSCONT. The format of the parameters <event_type> and <WLAN_Offload> are defined above.
NOTE 4: Occurrence of this event replaces usage of the event +CGEV: NW DEACT <PDP_type>, <PDP_addr>, [<cid>].
+CGEV: ME DEACT <p_cid>, <cid>, <event_type>
The network has responded to an ME initiated context deactivation request. The associated <cid> is provided to the TE in addition to the associated primary <p_cid>. The format of the parameters <p_cid> and <cid> are found in command +CGDSCONT. The format of the parameter <event_type> is defined above.
NOTE 5: Occurrence of this event replaces usage of the event +CGEV: ME DEACT <PDP_type>, <PDP_addr>, [<cid>].
For PDP context modification, the following unsolicited result codes and the corresponding events are defined:
+CGEV: NW MODIFY <cid>, <change_reason>, <event_type>[,<WLAN_Offload>[,<PDU-lifetime>]]
The network has modified a context. The associated <cid> is provided to the TE in addition to the <change_reason> and <event_type>. The format of the parameter <cid> is found in command +CGDCONT or +CGDSCONT. The format of the parameters <change_reason>, <event_type>, and <WLAN_Offload> are defined above.
<change_reason>: integer type; a bitmap that indicates what kind of change occurred. The <change_reason> value is determined by summing all the applicable bits. For example if both the values of QoS changed (Bit 2) and WLAN_Offload changed (Bit 3) have changed, then the <change_reason> value is 6.
NOTE 5A: The WLAN offload value will change when bit 1 or bit 2 or both of the indicators in the WLAN offload acceptability IE change, see the parameter <WLAN_Offload> defined above.
Bit 1 TFT changed
Bit 2 Qos changed
Bit 3 WLAN Offload changed
Bit 4 Relocation of PDU session anchor requested
Bit 5 PDP address or PDP type changed
Bit 6 ATSSS parameters changed
Bit 7 P-CSCF restoration requested
<PDU-lifetime>: integer type; indicates the PDU session address lifetime value in seconds for relocation of SSC mode 3 PDU session anchor, see 3GPP TS 23.501 [165] and 3GPP TS 24.501 [161].
+CGEV: ME MODIFY <cid>, <change_reason>, <event_type>[,<WLAN_Offload>]
The mobile termination has modified a context. The associated <cid> is provided to the TE in addition to the <change_reason> and <event_type>. The format of the parameter <cid> is found in command +CGDCONT or +CGDSCONT. The format of the parameters <change_reason>, <event_type> and <WLAN_Offload> are defined above.
For other PDP context handling, the following unsolicited result codes and the corresponding events are defined:
+CGEV: REJECT <PDP_type>, <PDP_addr>
A network request for context activation occurred when the MT was unable to report it to the TE with a +CRING unsolicited result code and was automatically rejected. The format of the parameters <PDP_type> and <PDP_addr> are found in command +CGDCONT.
NOTE 6: This event is not applicable for EPS and 5GS.
+CGEV: NW REACT <PDP_type>, <PDP_addr>, [<cid>]
The network has requested a context reactivation. The <cid> that was used to reactivate the context is provided if known to the MT. The format of the parameters <PDP_type>, <PDP_addr> and <cid> are found in command +CGDCONT.
NOTE 7: This event is not applicable for EPS and 5GS.
Implementation
Optional.