This is merely a historical archive of years 2008-2021, before the migration to mailman3.
A maintained and still updated list archive can be found at https://lists.osmocom.org/hyperkitty/list/gerrit-log@lists.osmocom.org/.
Vadim Yanitskiy gerrit-no-reply at lists.osmocom.orgVadim Yanitskiy has uploaded this change for review. ( https://gerrit.osmocom.org/11836 Change subject: chapters/gsup.adoc: document MO-/MT-forwardSM messages ...................................................................... chapters/gsup.adoc: document MO-/MT-forwardSM messages Change-Id: Ie0150756c33c1352bc4eb49421824542c711175c Related Change-Id: Ibe325c64ae2d6c626b232533bb4cbc65fc2b5d71 Related Change-Id: Ibf49474a81235096c032ea21f217170f523bd94e Related: OS#3587 --- M common/chapters/gsup.adoc 1 file changed, 225 insertions(+), 0 deletions(-) git pull ssh://gerrit.osmocom.org:29418/osmo-gsm-manuals refs/changes/36/11836/1 diff --git a/common/chapters/gsup.adoc b/common/chapters/gsup.adoc index e87d979..7568fe2 100644 --- a/common/chapters/gsup.adoc +++ b/common/chapters/gsup.adoc @@ -504,6 +504,129 @@ can be used to notify the MSC that a structured supplementary service is successfully activated or deactivated, etc. +==== MO-forwardSM Request + +Direction: SGSN / MSC => ESME (through VLR and HLR) + +[options="header",cols="5%,45%,20%,10%,10%,10%"] +|=== +|IEI|IE|Type|Presence|Format|Length +| |Message Type|<<gsup-ie-msgtype>>|M|V|1 +|01|IMSI|<<gsup-ie-imsi>>|M|TLV|2-10 +|40|SM-RP-MR (Message Reference)|<<gsup-ie-sm-rp-mr>>|M|TLV|1 +|41|SM-RP-DA (Destination Address)|<<gsup-ie-sm-rp-da>>|M|TLV|2-... +|42|SM-RP-OA (Originating Address)|<<gsup-ie-sm-rp-oa>>|M|TLV|2-... +|43|SM-RP-UI (SM TPDU)|<<gsup-ie-sm-rp-ui>>|M|TLV|1-... +|=== + +This message is used to forward _MO (Mobile Originated)_ short messages +from SGSN (PS domain) / MSC (CS domain) to an ESME (External Short Message +Entity). The corresponding MAP service (defined in 3GPP TS 29.002) is +*MAP-MO-FORWARD-SHORT-MESSAGE*, described in section 12.2. + +_MO-forwardSM Request_ is triggered by both _RP-DATA_ message transfer +attempt and _RP-SMMA_ notification attempt on the _SM-RL (Relay Layer)_. + +==== MO-forwardSM Error + +Direction: ESME (through VLR and HLR) => SGSN / MSC + +[options="header",cols="5%,45%,20%,10%,10%,10%"] +|=== +|IEI|IE|Type|Presence|Format|Length +| |Message Type|<<gsup-ie-msgtype>>|M|V|1 +|01|IMSI|<<gsup-ie-imsi>>|M|TLV|2-10 +|40|SM-RP-MR (Message Reference)|<<gsup-ie-sm-rp-mr>>|M|TLV|1 +|44|SM-RP-Cause (Cause value)|<<gsup-ie-sm-rp-cause>>|M|TLV|1 +|43|SM-RP-UI (diagnostic field)|<<gsup-ie-sm-rp-ui>>|O|TLV|1-... +|=== + +This message is used to indicate a negative result of a _MO (Mobile Originated)_ +short message delivery from SGSN (PS domain) / MSC (CS domain) to an ESME +(External Short Message Entity). Thus it triggers an _RP-ERROR_ on the _SM-RL +(Relay Layer)_ of SGSN (PS domain) / MSC (CS domain). The corresponding MAP +service (defined in 3GPP TS 29.002) is *MAP-MO-FORWARD-SHORT-MESSAGE*, +described in section 12.2. + +==== MO-forwardSM Result + +Direction: ESME (through VLR and HLR) => SGSN / MSC + +[options="header",cols="5%,45%,20%,10%,10%,10%"] +|=== +|IEI|IE|Type|Presence|Format|Length +| |Message Type|<<gsup-ie-msgtype>>|M|V|1 +|01|IMSI|<<gsup-ie-imsi>>|M|TLV|2-10 +|40|SM-RP-MR (Message Reference)|<<gsup-ie-sm-rp-mr>>|M|TLV|1 +|=== + +This message is used to indicate a successful result of a _MO (Mobile Originated)_ +short message delivery from SGSN (PS domain) / MSC (CS domain) to an ESME +(External Short Message Entity). Thus it triggers an _RP-ACK_ on the _SM-RL +(Relay Layer)_ of SGSN (PS domain) / MSC (CS domain). The corresponding MAP +service (defined in 3GPP TS 29.002) is *MAP-MO-FORWARD-SHORT-MESSAGE*, +described in section 12.2. + +==== MT-forwardSM Request + +Direction: ESME (through VLR and HLR) => SGSN / MSC + +[options="header",cols="5%,45%,20%,10%,10%,10%"] +|=== +|IEI|IE|Type|Presence|Format|Length +| |Message Type|<<gsup-ie-msgtype>>|M|V|1 +|01|IMSI|<<gsup-ie-imsi>>|M|TLV|2-10 +|40|SM-RP-MR (Message Reference)|<<gsup-ie-sm-rp-mr>>|M|TLV|1 +|41|SM-RP-DA (Destination Address)|<<gsup-ie-sm-rp-da>>|M|TLV|2-... +|42|SM-RP-OA (Originating Address)|<<gsup-ie-sm-rp-oa>>|M|TLV|2-... +|43|SM-RP-UI (SM TPDU)|<<gsup-ie-sm-rp-ui>>|M|TLV|1-... +|=== + +This message is used to forward _MT (Mobile Terminated)_ short messages +from an ESME (External Short Message Entity) to SGSN (PS domain) / MSC +(CS domain). The corresponding MAP service (defined in 3GPP TS 29.002) is +*MAP-MT-FORWARD-SHORT-MESSAGE*, described in section 12.9. + +==== MT-forwardSM Error + +Direction: SGSN / MSC => ESME (through VLR and HLR) + +[options="header",cols="5%,45%,20%,10%,10%,10%"] +|=== +|IEI|IE|Type|Presence|Format|Length +| |Message Type|<<gsup-ie-msgtype>>|M|V|1 +|01|IMSI|<<gsup-ie-imsi>>|M|TLV|2-10 +|40|SM-RP-MR (Message Reference)|<<gsup-ie-sm-rp-mr>>|M|TLV|1 +|44|SM-RP-Cause (Cause value)|<<gsup-ie-sm-rp-cause>>|M|TLV|1 +|43|SM-RP-UI (diagnostic field)|<<gsup-ie-sm-rp-ui>>|O|TLV|1-... +|=== + +This message is used to indicate a negative result of a _MT (Mobile Terminated)_ +short message delivery from an ESME (External Short Message Entity) to SGSN +(PS domain) / MSC (CS domain). The corresponding MAP service (defined in 3GPP +TS 29.002) is *MAP-MT-FORWARD-SHORT-MESSAGE*, described in section 12.9. + +_MT-forwardSM Error_ is triggered by _RP-ERROR_ on the _SM-RL (Relay Layer)_. + +==== MT-forwardSM Result + +Direction: SGSN / MSC => ESME (through VLR and HLR) + +[options="header",cols="5%,45%,20%,10%,10%,10%"] +|=== +|IEI|IE|Type|Presence|Format|Length +| |Message Type|<<gsup-ie-msgtype>>|M|V|1 +|01|IMSI|<<gsup-ie-imsi>>|M|TLV|2-10 +|40|SM-RP-MR (Message Reference)|<<gsup-ie-sm-rp-mr>>|M|TLV|1 +|=== + +This message is used to indicate a successful result of a _MT (Mobile Terminated)_ +short message delivery from an ESME (External Short Message Entity) to SGSN +(PS domain) / MSC (CS domain). The corresponding MAP service (defined in 3GPP +TS 29.002) is *MAP-MT-FORWARD-SHORT-MESSAGE*, described in section 12.9. + +_MT-forwardSM Result_ is triggered by _RP-ACK_ on the _SM-RL (Relay Layer)_. + === Information Elements [[gsup-ie-msgtype]] @@ -534,6 +657,12 @@ |0x20|Supplementary Service Request |0x21|Supplementary Service Error |0x22|Supplementary Service Result +|0x24|MO-forwardSM Request +|0x25|MO-forwardSM Error +|0x26|MO-forwardSM Result +|0x28|MT-forwardSM Request +|0x29|MT-forwardSM Error +|0x2a|MT-forwardSM Result |=== [[gsup-ie-ipaddr]] @@ -760,6 +889,11 @@ |0x30|Session ID|<<gsup-ie-session-id>> |0x31|Session State|<<gsup-ie-session-state>> |0x35|Supplementary Service Info|<<gsup-ie-ss-info>> +|0x40|SM-RP-MR (Message Reference)|<<gsup-ie-sm-rp-mr>> +|0x41|SM-RP-DA (Destination Address)|<<gsup-ie-sm-rp-da>> +|0x42|SM-RP-OA (Originating Address)|<<gsup-ie-sm-rp-oa>> +|0x43|SM-RP-UI (SM TPDU)|<<gsup-ie-sm-rp-ui>> +|0x44|SM-RP-Cause (RP Cause value)|<<gsup-ie-sm-rp-cause>> |=== [[gsup-ie-empty]] @@ -952,3 +1086,94 @@ |0x02|CONTINUE|Used to continue an existing session |0x03|END|Used to terminate an existing session |=== + +[[gsup-ie-sm-rp-mr]] +==== SM-RP-MR (Message Reference) + +According to TS GSM 04.11, every single message on the _SM-RL (SM +Relay Layer)_ has an unique _message reference (see 8.2.3)_, that +is used to link an _RP-ACK_ or _RP-ERROR_ message to the associated +(preceding) _RP-DATA_ or _RP-SMMA_ message transfer attempt. + +In case of TCAP/MAP, this message reference is being mapped to the +_Invoke ID_. But since GSUP has no _Invoke ID IE_, and it is not +required for other applications (other than SMS), a special +<<gsup-ie-sm-rp-mr>> is used to carry the message reference +value \'as-is' (i.e. in range 0 through 255). + +[[gsup-ie-sm-rp-da]] +==== SM-RP-DA (Destination Address) + +This IE represents the destination address used by the short message service +relay sub-layer protocol. It can be either of the following: + +* IMSI (see clause 7.6.2.1); +* LMSI (see clause 7.6.2.16, not implemented!); +* MSISDN (see clause 7.6.2.17); +* roaming number (see clause 7.6.2.19, not implemented!); +* service centre address (see clause 7.6.2.27). + +Coding of this IE is described in <<gsup-sm-rp-oda>>. +See 3GPP TS 29.002, section 7.6.8.1 for details. + +[[gsup-ie-sm-rp-oa]] +==== SM-RP-OA (Originating Address) + +This IE represents the originating address used by the short message service +relay sub-layer protocol. It can be either of the following: + +* MSISDN (see clause 7.6.2.17); +* service centre address (see clause 7.6.2.27). + +Coding of this IE is described in <<gsup-sm-rp-oda>>. +See 3GPP TS 29.002, section 7.6.8.2 for details. + +[[gsup-sm-rp-oda]] +==== Coding of SM-RP-DA / SM-RP-OA IEs + +Basically, both <<gsup-ie-sm-rp-da>> / <<gsup-ie-sm-rp-oa>> IEs contain a single +nested TLV of the following format: + +.Coding of SM-RP-DA / SM-RP-OA IEs +[options="header",cols="5%,5%,10%,80%"] +|=== +|Field|Presence|Length|Description +|T|M|1|Identity type +|L|M|1|Identity length +|V|O|...|Encoded identity itself +|=== + +where the identity type can be one of the following: + +.Identity types of SM-RP-DA / SM-RP-OA IEs +[options="header",cols="15%,85%"] +|=== +|Type|Description +|0x00|Special value in libosmocore's API +|0x01|IMSI (see clause 7.6.2.1) +|0x02|MSISDN (see clause 7.6.2.17) +|0x03|Service centre address (see clause 7.6.2.27) +|0xff|Special (means omit) value for noSM-RP-DA and noSM-RP-OA +|=== + +[[gsup-ie-sm-rp-ui]] +==== SM-RP-UI (SM TPDU) + +This IE represents the user data field carried by the short message service +relay sub-layer (i.e. _SM-TL (Transfer Layer)_) protocol. In case of errors +(i.e. _MO-/MT-forwardSM Error_ messages), this IE may contain optional +diagnostic field payload from _RP-ERROR_ message. + +See 3GPP TS 29.002, section 7.6.8.4 for details. + +[[gsup-ie-sm-rp-cause]] +==== SM-RP-Cause (RP Cause value) + +According to TS GSM 04.11, _RP-Cause_ is a variable length element always +included in the _RP-ERROR_ message, conveying a negative result of an +_RP-DATA_ message transfer attempt or _RP-SMMA_ notification attempt. + +The mapping between error causes in TS GSM 04.11 and TS GSM 09.02 (MAP) +is specified in TS GSM 03.40. But since GSUP has no generic _User Error IE_, +and it is not required for other applications (other than SMS), a special +<<gsup-ie-sm-rp-cause>> is used to carry the cause value \'as-is'. -- To view, visit https://gerrit.osmocom.org/11836 To unsubscribe, or for help writing mail filters, visit https://gerrit.osmocom.org/settings Gerrit-Project: osmo-gsm-manuals Gerrit-Branch: master Gerrit-MessageType: newchange Gerrit-Change-Id: Ie0150756c33c1352bc4eb49421824542c711175c Gerrit-Change-Number: 11836 Gerrit-PatchSet: 1 Gerrit-Owner: Vadim Yanitskiy <axilirator at gmail.com> -------------- next part -------------- An HTML attachment was scrubbed... URL: <http://lists.osmocom.org/pipermail/gerrit-log/attachments/20181119/07ec43de/attachment.htm>