BAIC — SwapSIM()

Home Location Register (HLR) Release 9.1 Subscriber Provisioning Reference Manual CLI Command Syntax Hlr[]>AddSIM()SimId={Sim Id #}; PrimaryIMSI={PrimaryIMSI #}; AlgorithmName={Algo name}; SimType={Sim Type}; Ki32HexChar={Ki key #}; PUK={PUK} SwapSIM() The SwapSIM() operation can be used to switch the SIM (with one or many IMSIs) of a subscriber to another SIM (with one or many IMSIs) that is unassigned (not linked to a SubscriptionID), while keeping the same MSISDN(s) and all the data of the subscriber provisioned as is in its profile (HLR Service Profile, MSISDN and association). The SwapSIM() operation can only be performed under the following conditions:

The old and new SIM cards must exist in both the Sim and SimImsiMap entities. The new SIM must be unassigned, which means it must not be linked to any subscriber (SubscriptionID: ‘null’). The new IMSI(s) of the new SIM cards must not be provisioned in the MsIsdnImsiProfileAssociation table because the operation changes the IMSI, but do not overwrite an existing IMSI (association). In other words, the new SIM cards must not be already assigned. The number of IMSIs for the new SIM card (provisioned in the SimImsiMap entity) must be greater or equal to the number of IMSIs provisioned in the MsIsdnImsiProfileAssociation entity for the old SIM card.

When executing the SwapSIM() operation, the following parameters can be specified: Mandatory parameters: OldSimId: SimId already assigned to the SubscriptionID NewSimId: new unused SimId (SimId already provisioned in the Sim entity, but unassigned to any SubscriptionID) Optional parameters: SubscriptionID: SubscriptionID of the subscriber for which you wish to swap SIM cards AutoMap: bool (0 or 1) that indicates whether the Tekelec ngHLR must change all the old IMSIs defined in the MsIsdnImsiProfileAssociation entity with the new IMSIs by using a MCC/MNC best matching mechanism.

If this parameter is set to ‘0’, the Network Operator must map manually all the IMSIs, by editing the MsIsdnImsiProfileAssociation and making sure that the IMSIs of the new SIM card should have the same MCC/MNC as the ones of the old SIM card. If this parameter is set to ‘1’ (default value), all alternate IMSIs used in the MsIsdnImsiProfileAssociation entity of the Old SIM ID must match (MCC/MNC match: first 5/6 digits of the IMSI) with all the alternate IMSIs of the New SIM ID. Important:

In case of failure:If there are still some alternate IMSIs not matched, the SIM Swap operation will fail and the Network Operator must execute again the SwapSIM() operation, but this time with the AutoMap option set to ‘0’ and map manually all the IMSIs. DeleteOldSIM: bool (0 or 1) that indicates whether the Tekelec ngHLR must delete the old SIM data entry from the Sim entity. If this parameter is set to ‘0’ (default value), after the completion of the SIM swap, the SubscriptionID of the old SIM card is changed to “NULL”. This means that the data of the old Sim card remains 212 910-6701-001 Revision A, June 2013