8.2 Mapping of Parameters for the Update Location Procedure
29.3053GPPInterWorking Function (IWF) between MAP based and Diameter based interfacesRelease 17TS
8.2.1 ULR mapping to UpdateGprsLocationArg
When the IWF needs to construct a MAP-UpdateGprsLocation message as a result of receiving an ULR command (see sections 7.2.1 step 2, and 7.2.2 step 2), the IWF shall open a MAP dialogue in application context version 3 and populate sub-parameters of UpdateGprsLocationArg as described below:
imsi in UpdateGprsLocationArg shall be populated with the value of the User-Name AVP received within ULR.
sgsn-Number in UpdateGprsLocationArg shall be populated with the value of the SGSN.Number AVP if present within ULR, otherwise it shall be populated with a value locally assigned to the IWF and consistent with SS7 routing principles.
sgsn-Address in UpdateGprsLocationArg shall be populated with the IP-address of the source node sending the ULR command.
extensionContainer in UpdateGprsLocationArg shall be absent.
sgsn-Capability in UpdateGprsLocationArg shall be populated as follows:
– solsaSupportIndicator shall be absent;
– extensionContainer shall be absent;
– superChargerSupportedInServingNetworkEntity shall be absent;
– gprsEnhancementSupportIndicator shall be present;
– supportedCamelPhases shall be absent or shall indicate no support of any CAMEL phase;
– supportedLCS-CapabilitySet shall be absent or shall indicate no support of any LCS capability set;
– offeredCamel4CSIs shall be absent;
– smsCallBarringSupportIndicator shall be absent;
– supportedRAT-TypesIndicator shall be present and populated with the value received within the RAT-Type AVP in the received ULR;
– supportedFeatures shall be present if a SupportedFeature AVP was present in the received ULR which indicated support of odbs and regsubs.
informPreviousNetworkEntity in UpdateGprsLocationArg shall be absent;
ps-LCS-NotSupportedByUE in UpdateGprsLocationArg shall be absent
v-gmlc-Address in UpdateGprsLocationArg shall be absent.
add-info in UpdateGprsLocationArg shall be present if a Terminal-Information AVP was present in the received ULR. If present the parameter shall be poulated with the received IMEI and software version; skipSubscriberDataUpdate in add-info shall be absent.
eps-info in UpdateGprsLocationArg shall be present.
– if the S6a/S6d indicator within the ULR-Flags AVP was set, the parameter shall contain isr-Information with updateLocation indication, and if a Single-Registration-Indication was present in the received ULR-Flags AVP then the isr-Information shall also contain a cancelSGSN indication, and if an InitialAttachIndicator was present in the received ULR-Flags AVP then the isr-Information shall also contain initialAttachIndicator;
– if the S6a/S6d indicator within the ULR-Flags was not set, the parameter shall contain isr-Information with updateLocation indication, and if an InitialAttachIndicator was present within the ULR-Flags AVP, the parameter shall contain isr-Information with initialAttachIndicator.
servingNodeTypeIndicator in UpdateGprsLocationArg shall be present if the S6a/S6d-Indicator was present in the ULR-Flags AVP within the received ULR.
skipSubscriberData Update in UpdateGprsLocationArg shall be present if a skip subscriber data indication was receive within the ULR-Flags within ULR.
usedRAT-Type in UpdateGprsLocationArg shall be populate with the value received within the RAT-Type AVP within ULR.
gprsSubscriptionDataNotNeeded in UpdateGprsLocationArg shall be present if bit 3 (GPRS-Subscription-Data-Indicator) was not set in the ULR-Flags AVP received within ULR.
nodeTypeIndicator in UpdateGprsLocationArg shall be present if bit 4 (Node-Type-Indicator) was set in the ULR-Flags AVP received within ULR.
areaRestricted in UpdateGprsLocationArg shall be absent.
ue-reachableIndicator in UpdateGprsLocationArg shall be absent.
ue-srvcc-Capability in UpdateGprsLocationArg shall be present if a UE-SRVCC-Capability AVP was present in the received ULR. If present the parameter shall be populated with the received ue-srvcc-Capability.
mmeNumberforMTSMS in UpdateGprsLocationArg shall be populated with the value of the MME-Number-for-MT-SMS AVP if present within ULR.
sms-Only in UpdateGprsLocationArg shall be populated with the value of the SMS-Only AVP if present within ULR.
smsRegisterRequest in UpdateGprsLocationArg shall be populated with the value of the SMS-Register-Request AVP if present within ULR.
adjacentPLMN-List in UpdateGprsLocationArg shall be constructed with the values of the Adjacent-PLMNs grouped AVP, if present within ULR.
8.2.2 UpdateGprsLocationRes/Error/InsertSubscriberDataArg/ActivateTraceModeArg mapping to ULA
When the IWF needs to construct an ULA command as a result of receiving an UpdateGprsLocation Ack/Error message (see sections 7.2.1 step 5, and 7.2.2 step 7), the IWF shall populate AVPs of ULA as described below:
Result-Code / Experimental-Result AVP shall be set to:
– DIAMETER_SUCCESS if an UpdateGprsLocationRes parameter was received in a TCAP ResultLast component;
– DIAMETER_ERROR_USER_UNKNOWN if an error of unknownSubscriber without a diagnostic parameter or with a diagnostic parameter of imsiUnknown was received;
– DIAMETER_ERROR_UNKNOWN_SUBSCRIPTION if an error of unknownSubscriber with a diagnostic parameter of gprs-eps-SubscriptionUnknown was received;
– DIAMETER_ERROR_RAT_NOT_ALLOWED if an error of roamingNotAllowed with a roamingNotAllowedParam containing an additionalRoamingNotAllowedCause of "supportedRAT-TypesNotAllowed" was received;
– DIAMETER_ERROR_ROAMING_NOT_ALLOWED if an error of roamingNotAllowed without "supportedRAT-TypesNotAllowed" was received;
– an appropriate DIAMETER base protocol result code otherwise.
Auth-Session-State AVP shall be set to the value NO_STATE_MAINTAINED (1).
Supported-Features AVP shall be absent.
ULA-Flags AVP: Flags shall be set as follows:
– SeparationIndication shall be set to 1 if the sgsn-mmeSeparationSupported parameter was present within UpdateGprsLocationRes; otherwise shall be set to 0.
– MME Registered for SMS shall be set to 1 if the mmeRegisteredforSMS parameter was present within UpdateGprsLocationRes; otherwise shall be set to 0.
Subscription-Data AVP shall be present if MAP InsertSubscriberData messages have been received from the HSS and a "skip-subscriber-Data" indication was not present in the received ULR command or a MAP ActivateTraceMode message has been received from the HSS. If present the AVP shall be populated as follows:
Subscriber status AVP shall be present if a subscriberStatus parameter was present in a received SubscriberData parameter within InsertSubscriberDataArg. If so, values shall be mapped appropriately.
MSISDN AVP shall be present if an msisdn parameter was present in a received SubscriberData parameter within InsertSubscriberDataArg.
STN-SR AVP shall be present if an stn-sr parameter was present in a received EPS-SubscriptionData parameter within InsertSubscriberDataArg.
Network-Access-Mode AVP shall be present if a networkAccessMode parameter was present within InsertSubscriberDataArg.
Operator-Determined-Barring AVP shall be present if an odb-GeneralData parameter was present within an odb-Data parameter within a SubscriberData parameter within InsertSubscriberDataArg.
HPLMN-ODB AVP shall be present if an odb-HPLMN-Data parameter was present within an odb-Data parameter within a SubscriberData parameter within InsertSubscriberDataArg.
Regional-Subscription-Zone-Code AVPs shall be present if ZoneCodes were present within an regionalSubscriptionData parameter within a SubscriberData parameter within InsertSubscriberDataArg.
Access-Restriction-Data AVP shall be present if accessRestrictionData or ext-AccessRestrictionData parameters were present within InsertSubscriberDataArg, and/or a ho-to-non-3GPP-Access-Not-Allowed parameter was present in an eps-SubscriptionData parameter within InsertSubscriberDataArg.
APN-OI-Replacement AVP shall be present if an apn-oi-Replacement parameter was present within an eps-SubscriptionData parameter within InsertSubscriberDataArg.
3GPP-Charging-Characteristics AVP shall be present if a chargingCharacteristics parameter was present within InsertSubscriberDataArg.
AMBR AVP shall be present if an ambr parameter was present within an eps-SubscriptionData parameter within InsertSubscriberDataArg.
APN-Configuration-Profile AVP shall be present if an apn-ConfigurationProfile parameter was present within an eps-SubscriptionData parameter within InsertSubscriberDataArg.
RAT-Frequency-Selection-Priority-ID AVP shall be present if a rfsp-id parameter was present within an eps-SubscriptionData parameter within InsertSubscriberDataArg.
Adjacent-Access-Restriction-Data AVP shall be present if adjacentAccessRestrictionDataList was present within InsertSubscriberDataArg.
– IMSI-Group-Id AVP shall be present if imsi-Group-Id-List was present within InsertSubscriberDataArg.
– Trace-Data AVP shall be present if a MAP ActivateTraceMode message has been received from the HSS. Sub-AVPs in Trace-Data AVP shall be populated as follows:
– Trace-Reference AVP shall be present and populated with the values received within the traceReference and traceReference2 parameters within ActivateTraceModeArg.
– Trace-Depth-List AVP shall be present if a Trace-DepthList parameter was present within ActivateTraceModeArg.
– Trace-NE-Type-List AVP shall be present if a TraceNE-TypeList parameter was present within ActivateTraceModeArg.
– Trace-Depth-List AVP shall be present if a Trace-DepthList parameter was present within ActivateTraceModeArg.
– Trace-Interface-List AVP shall be present if a TraceInterfaceList parameter was present within ActivateTraceModeArg.
– Trace-Event-List AVP shall be present if a TraceEventList parameter was present within ActivateTraceModeArg.
– OMC-Id AVP shall be present if a OMC-Id parameter was present within ActivateTraceModeArg.
– Trace-Collection-Entity AVP shall be present if a TraceCollectionEntity parameter was present within ActivateTraceModeArg.
– MDT-Configuration AVP shall be present if a MDT-Configuration parameter was present within ActivateTraceModeArg.
GPRS-Subscription-Data AVP shall be present if a gprsSubscriptionData parameter was present within InsertSubscriberDataArg.
LCS-Info AVP shall be present if a LCS Information parameter was present within InsertSubscriberDataArg.
CSG-Subscription-Data AVPs shall be populated with information received within the csg-SubscriptionDataList parameter within InsertSubscriberDataArg.
Roaming-Restricted-Due-To-Unsupported-Feature AVP shall be present and set to "Roaming-Restricted-Due-To-Unsupported-Feature (0)" if the parameter roamingRestrictedInSgsnDueToUnsupportedFeature was present within InsertSubscriberDataArg. Otherwise shall be absent.
Teleservice-List AVP shall be present if a Teleservice List parameter was present within InsertSubscriberDataArg.
Call-Barring-Info AVPs shall be present if call barring SS-code and SS-status parameters were present within InsertSubscriberDataArg and the SS-Code AVP and SS-Status AVP within the Call-Barring-Info AVPs shall be populated with the values of the received call barring SS-code and SS-status parameters within InsertSubscriberDataArg.
MDT-User-Consent AVP shall be present if a MDT User Consent parameter was present within InsertSubscriberDataArg.
Subscribed-VSRVCC AVP shall be present if a Subscribed vSRVCC parameter was present in a received EPS-SubscriptionData parameter within InsertSubscriberDataArg.
PS-and-SMS-Only-Service-Provision AVP shall be present if a psAndSMS-OnlyServiceProvision parameter was present within InsertSubscriberDataArg.
SMS-In-SGSN-Allowed AVP shall be present if an smsInSGSNAllowed parameter was present within InsertSubscriberDataArg.
8.2.3 UpdateGprsLocationArg mapping to ULR
When the IWF needs to construct an ULR command as a result of receiving an UpdateGprsLocation message without a pdn-gw-update parameter within eps-info and without an isr-Information parameter within eps-info not indicating updateLocation or without a skipSubscriberDataUpdate parameter within add-info (see section 7.2.2 step 3), the IWF shall populate AVPs of ULR as described below:
Auth-Session-State AVP shall be set to the value NO_STATE_MAINTAINED (1).
User-Name AVP shall be populated with the value received within the imsi parameter of UpdateGprsLocationArg.
Supported-Features AVP shall be populated with a value mapped from received parameter supportedFeatures within sgsn-Capability.
Terminal-Information AVP shall be present if an add-info parameter was received within UpdateGprsLocationArg. If present the received value of the imeisv parameter shall be mapped onto IMEI and (if present) Software Version.
RAT-Type AVP shall be populated with the value received within the usedRAT-Type parameter of UpdateGprsLocationArg
ULR-Flags AVP: Flags shall be set as follows:
Single-Registration-Indication shall be set to 1 if the ISR-Information parameter within the EPS-Info parameter within UpdateGprsLocationArg is present and indicates "cancelSGSN"; otherwise shall be set to 0.
– S6a/S6d-Indicator shall be set to 1 if the servingNodeTypeIndicator parameter was present in UpdateGprsLocationArg; otherwise shall be set to 0.
– Skip Subscriber Data shall be set to 1 if a skipSubscriberData parameter was present in UpdateGprsLocationArg; otherwise shall be set to 0.
– GPRS-Subscription-Data-Indicator shall be set to 1 if the "GPRS Subscription Data not needed Indicator" was absent from UpdateGprsLocationArg; otherwise shall be set to 0.
– Node-Type-Indicator shall be set to 1 if the "Node-Type Indicator" was present in UpdateGprsLocationArg; otherwise shall be set to 0.
– Initial-Attach-Indicator shall be set to 1 if the initialAttachIndicator parameter within the ISR-Information parameter within the EPS-Info parameter within UpdateGprsLocationArg is present; otherwise shall be set to 0.
Visited-PLMN-Id AVP shall populated with a value derived from the sgsn-Number parameter received within UpdateGprsLocationArg.
SGSN-Number AVP shall be populated with the value received within the SGSN Number parameter of UpdateGprsLocationArg.
UE-SRVCC-Capability AVP shall be present if a ue-srvcc-Capability parameter was present in UpdateGprsLocationArg. If present the AVP shall be populated with the received ue-srvcc-Capability parameter.
MME-Number-for-MT-SMS AVP shall be populated with the value received within the mmeNumberforMTSMS parameter of UpdateGprsLocationArg.
SMS-Register-Request AVP shall be populated with the value received within the smsRegisterRequest parameter of UpdateGprsLocationArg.
SMS-Only AVP shall be populated with the value received within the sms-Only parameter of UpdateGprsLocationArg.
Adjacent-PLMNs AVP shall be constructed with the values received within the adjacentPLMN-List parameter of UpdateGprsLocationArg.
8.2.4 ULA mapping to InsertSubscriberDataArg/ ActivateTraceModeArg/UpdateGprsLocationRes/Error
When the IWF needs to construct a MAP InsertSubscriberData messages and/or a MAP- ActivateTraceMode message and/or a MAP-UpdateGprsLocation Ack message, as a result of receiving an ULA command (see sections 7.2.2 steps 5 and 6), the IWF shall populate sub-parameters of InsertSubscriberDataArg, ActivateTraceModeArg and UpdateGprsLocationRes/Error as described below:
InsertSubscriberDataArg:
imsi in InsertSubscriberDataArg shall be absent.
msisdn in InsertSubscriberDataArg shall be populated with the value received within the MSISDN AVP within the Subscription-Data AVP within ULA.
category in InsertSubscriberDataArg shall be absent.
subscriberStatus in InsertSubscriberDataArg shall be populated with the value received within the Subscriber-Status AVP within the Subscription-Data AVP within ULA.
bearerServiceList in InsertSubscriberDataArg shall be absent.
teleserviceList in InsertSubscriberDataArg shall be absent
provisionedSS in InsertSubscriberDataArg shall be absent.
odb-Data in InsertSubscriberDataArg shall be populated with the value received within the Operator-Determined-Barring AVP and HPLMN-ODB AVP AVP within the Subscription-Data AVP within ULA.
roamingRestrictedDueToUnsupportedFeature in InsertSubscriberDataArg shall be absent.
regionalSubscriptionData in InsertSubscriberDataArg shall be populated with the value received within the Regional-Subscription-Zone-Code AVPs within the Subscription-Data AVP within ULA.
vbsSubscriptionData in InsertSubscriberDataArg shall be absent.
vgcsSubscriptionData in InsertSubscriberDataArg shall be absent
vlrCamelsubscriptionInfo in InsertSubscriberDataArg shall be absent.
naea-PreferredCI in InsertSubscriberDataArg shall be absent.
gprsSubscriptionData in InsertSubscriberDataArg shall be populated with GPRS-Subscription Data received within the Subscription-Data AVP within ULA.
roamingRestrictedInSgsnDueToUnsupportedFeature in InsertSubscriberDataArg shall be present if a Roaming-Restricted-Due-To-Unsupported-Feature AVP Subscription-Data AVP within ULA.
networkAccessMode in InsertSubscriberDataArg shall be populated with the value received within the Network-Access-Mode AVP within the Subscription-Data AVP within ULA.
lsaInformation in InsertSubscriberDataArg shall be absent.
lmu-Indicator in InsertSubscriberDataArg shall be absent
lcsInformation in InsertSubscriberDataArg shall be absent.
istAlertTimer in InsertSubscriberDataArg shall be absent.
superChargerSupportedInHLR in InsertSubscriberDataArg shall be absent.
mc-SS-Info in InsertSubscriberDataArg shall be absent.
cs-AllocationRetentionPriority in InsertSubscriberDataArg shall be absent.
sgsn-CAMEL-SubscriptionInfo in InsertSubscriberDataArg shall be absent.
chargingCharacteristics in InsertSubscriberDataArg shall be populated with the value received within the 3GPP-Charging-Characteristics AVP within the Subscription-Data AVP within ULA.
accessRestrictionData and ext-AccessRestrictionData in InsertSubscriberDataArg shall be populated according to the values received within the Access-Restriction-Data AVP within the Subscription-Data AVP within ULA.
ics-Indicator in InsertSubscriberDataArg shall be absent.
LCS Information in InsertSubscriberDataArg shall be populated with the value received within the LCS-Info AVP within the Subscription-Data AVP within ULA.
Teleservice List in InsertSubscriberDataArg shall be populated with the value received within the Teleservice-List AVP within the Subscription-Data AVP within ULA.
SS-code and SS-status parameters of Call Barring Information List in InsertSubscriberDataArg shall be populated with the values of SS-Code AVP and SS-Status AVP received within the Call-Barring-Info AVPs within the Subscription-Data AVP within ULA.
psAndSMS-OnlyServiceProvision in InsertSubscriberDataArg shall be populated with the value received within the Subscription-Data AVP within ULA.
smsInSGSNAllowed in InsertSubscriberDataArg shall be populated with the value received within the Subscription-Data AVP within ULA.
adjacentAccessRestrictionDataList in InsertSubscriberDataArg shall be constructed with the values received within the Adjacent-Access-Restriction-Data AVP within the Subscription-Data AVP within ULA.
imsi-Group-Id-List in InsertSubscriberDataArg shall be constructed with the values received within the IMSI-Group-Id AVP within the Subscription-Data AVP within ULA.
Sub-parameters of eps-SubscriptionData in InsertSubscriberDataArg shall be populated as follows:
apn-oi-Replacement shall be populated with the value received in the APN-OI-Replacement AVP within the Subscription-Data AVP within ULA.
rfsp-id shall be populated with the value received within the RAT-Frequency-Selection-Priority-ID AVP within the Subscription-Data AVP within ULA.
ambr shall be populated with the value received within the AMBR AVP within the Subscription-Data AVP within ULA.
apn-ConfigurationProfile shall be populated with the value received within the APN-Configuration-Profile AVP within the Subscription-Data AVP within ULA.
stn-sr shall be populated with the value received within the STN-SR AVP within the Subscription-Data AVP within ULA.
csg-SubscriptionDataList shall be populated with values received within CSG-Subscription-Data AVPs within the Subscription-Data AVP within ULA.
ue-ReachabilityRequestIndicator shall be absent.
mdtUserConsent shall be populated with the value received within MDT-User-Consent AVP within the Subscription-Data AVP within ULA.
subscribed-vsrvcc shall be present if the Subscribed-VSRVCC AVP is present within the Subscription-Data AVP within ULA.
pcscf-Restoration-Request shall be absent.
ActivateTraceModeArg:
imsi in ActivateTraceModeArg shall be absent.
TraceReference shall be populated with the value of Trace-ID part of the Trace-Reference AVP received within the Trace-Data AVP within the Subscription-Data AVP within ULA.
TraceType shall be present with any value.
TraceReference2 shall be populated with the value of MCC+MNC part of the Trace-Reference AVP received within the Trace-Data AVP within the Subscription-Data AVP within ULA.
TraceDepthList shall be populated with the value received in the Trace-Depth-List AVP within the Trace-Data AVP within the Subscription-Data AVP within ULA.
TraceNE-TypeList shall be populated with the value received in the Trace-NE-Type-List AVP within the Trace-Data AVP within the Subscription-Data AVP within ULA.
TraceInterfaceList shall be populated with the value received in the Trace-Interface-List AVP within the Trace-Data AVP within the Subscription-Data AVP within ULA.
TraceEventList shall be populated with the value received in the Trace-Event-List AVP within the Trace-Data AVP within the Subscription-Data AVP within ULA.
Omc-Id shall be populated with the value received in the OMC-Id AVP within the Trace-Data AVP within the Subscription-Data AVP within ULA
TraceCollectionEntity shall be populated with the address received within the Trace-Collection-Entity AVP within the Subscription-Data AVP within ULA.
UpdateGprsLocationRes:
hlr-Number in UpdateGprsLocationRes shall be populated with a value locally assigned to the IWF and consistent with SS7 routing principles.
extensionContainer in UpdateGprsLocationRes shall be absent.
add-Capability in UpdateGprsLocationRes shall be present.
sgsn-mmeSeparationSupported in UpdateGprsLocationRes shall be present if the Separation Indication within the ULA-Flags AVP was set to 1 within ULA.
MDT-Configuration shall be populated with the value received within the MDT-Configuration AVP within the Subscription-Data AVP within ULA.
mmeRegisteredforSMS in UpdateGprsLocationRes shall be present if the "MME registered for SMS" flag within the ULA-Flags AVP was set to 1 within ULA.
UpdateGprsLocation Error:
An error of unknownSubscriber with unknownSubscriberParam containing a unknownSubscriberDiagnostic of "imsiUnknown" shall be sent if the received ULA command contains an Experimental-Result AVP with a value of "User Unknown".
An error of unknownSubscriber with unknownSubscriberParam containing a unknownSubscriberDiagnostic of "gprs-epsSubscriptionUnknown" shall be sent if the received ULA command contains an Experimental-Result AVP with a value of "Unknown EPS Subscription".
Other values within the Result-Code / Experimental-Result AVP shall be mapped onto an appropriate MAP error.