Examples

Below are examples of how to use the <updateSubscriber> request and likely response. Some of these examples are based upon previous requests; hence, the order of the requests could be important.

Add Stand-Alone Routing Entities

This example creates new stand-alone IMSI and MSISDN routing entities and sets their destination values to the specified values.

The result of this request is:

New IMSI and MSISDN routing entities are created.
All of the destination values for each routing entity are set to specified values.

Request:

<updateSubscriber ent=”subscriberRouting” ns=”dsr” resonly=”n” id=”101”>
  <imsi>111111111100001</imsi>
  <imsi>111111111100002</imsi>
  <imsi>111111111100003</imsi>
  <msisdn>8004605500</msisdn>
  <msisdn>8004605503</msisdn>
  <ltehss>LTE_HSS_1</ltehss>
</updateSubscriber>

Response:

<updateSubscriberResp id=”101”>
  <updateSubscriber ent=”subscriberRouting” ns=”dsr” resonly=”n” id=”101”>
    <imsi>111111111100001</imsi>
    <imsi>111111111100002</imsi>
    <imsi>111111111100003</imsi>
    <msisdn>8004605500</msisdn>
    <msisdn>8004605503</msisdn>
    <ltehss>LTE_HSS_1</ltehss>
  </updateSubscriber>
    <res error=”0” affected=”5”>
</updateSubscriberResp>

Update Stand-Alone Routing Entities Destinations

This example updates existing stand-alone IMSI and MSISDN routing entities with new destination values.

Note: This request does not update all NAI values that were specified in the previous request.

The result of this request is that the IMSI and MSISDN routing entities are updated with specified values.

Request:

<updateSubscriber ent=”subscriberRouting” ns=”dsr” id=”102”>
  <imsi>111111111100001</imsi>
  <imsi>111111111100002</imsi>
  <imsi>111111111100003</imsi>
  <msisdn>8004605500</msisdn>
  <ltehss>LTE_HSS_4</ltehss>
  <aaa>AAA_4</aaa>
</updateSubscriber>

Response:

<updateSubscriberResp id=”102”>
  <res error=”0” affected=”4”/>
</updateSubscriberResp>

Create Subscriber Using Existing Routing Entities (Success)

This example creates a subscriber using existing routing entities that all have the same destination values.

After this request is completed, a new subscriber is created and all of the routing entities are assigned to that subscriber.

Request:

<updateSubscriber ent=”subscriberRouting” ns=”dsr” id=”103” group=”y”>
  <imsi>111111111100001</imsi>
  <imsi>111111111100002</imsi>
  <msisdn>8004605500</msisdn>
</updateSubscriber>

Response:

<updateSubscriberResp id=”103”>
  <res error=”0” affected=”1”/>
</updateSubscriberResp>

Create Subscriber Using Existing Routing Entities (Failure)

This example fails when creating a subscriber using existing routing entities because the existing routing entities have different destination values.

No changes are made to the database because the request failed.

Request:

<updateSubscriber ent=”subscriberRouting” ns=”dsr” id=”104” group=”y”>
  <imsi>111111111100003</imsi>
  <msisdn>8004605503</msisdn>
</updateSubscriber>

Response:

<updateSubscriberResp id=”104”>
  <res error=”2029” affected=”0” description= 
  ”all routes must have the same destination values”/>
</updateSubscriberResp>

Add Account ID to Existing Subscriber

This example adds an Account ID to an existing subscriber. Any of the subscriber's IMSI or MSISDN values can be used. For this example, the MSISDN value is used.

The result of this request is that the subscriber will have an Account ID value.

Request:

<updateSubscriber ent=”subscriberRouting” ns=”dsr” id=”105” group=”y”>
  <accountId>80044400001234567890111112</accountId>
  <msisdn>8004605500</msisdn>
</updateSubscriber>

Response:

<updateSubscriberResp id=”105”>
  <res error=”0” affected=”1”>
</updateSubscriberResp>

Modify Destinations for Existing Subscriber

This example modifies a destination value for an existing subscriber. Any of the subscriber's IMSI, MSISDN or Account ID values can be used. For this example, an IMSI value is used.

Note: It does not matter if group="y" is specified. The same changes are always applied to the whole subscriber.

The result of this request is that all of the subscriber's IMSI and MSISDN routing entities will have a new destination value

Request:

<updateSubscriber ent=”subscriberRouting” ns=”dsr” id=”106”>
  <imsi>111111111100002</imsi>
  <ltehss>LTE_HSS_99</ltehss>
</updateSubscriber>

Response:

<updateSubscriberResp id=”106”>
  <res error=”0” affected=”3”/>
</updateSubscriberResp>

Replace Subscriber's MSISDN value

This example replaces an MSISDN value for an existing subscriber. The new MSISDN routing entity inherits the destination values from an old IMSI or MSISDN routing entity. (It doesn't matter which of the Subscriber's routing entities is used because they all have the same destination values.)

The result of this request is:

The old MSISDN routing entity is deleted from the database.
The new MSISDN routing entity is added to the database, its destination values are set to the subscriber's destination values, and the new MSISDN value is assigned to the subscriber (relationships are established).
Note: If the new MSISDN routing entity already exists in the database, and it has the same destination values as the subscriber, the only change is that the routing entity is assigned to the subscriber.

Request:

<updateSubscriber ent=”subscriberRouting” ns=”dsr” id=”107” group=”y”>
  <deleteMsisdn>8004605500</deleteMsisdn>
  <msisdn>8884605500</msisdn>
</updateSubscriber>

Response:

<updateSubscriberResp id=”107”>
  <res error=”0” affected=”1”/>
</updateSubscriberResp>

Replace Subscriber's Account ID, 2 IMSIs, and 1 MSISDN Values

This example replaces several identification (Account ID, IMSI and MSISDN) values for an existing subscriber. The new IMSI and MSISDN routing entities inherit the destination values from the old IMSI and MSISDN routing entities. It does not matter which of the Subscriber's routing entities is used because they all have the same destination values.

The result of this request is:

The old IMSI and MSISDN routing entities are deleted from the database.
The new IMSI and MSISDN routing entities are added to the database, their destination values are set to the subscriber's destination values, and the routing entities are assigned to the subscriber (relationships are established).
Note: If the new IMSI and MSISDN routing entities already exist in the database and they have the same destination values as the subscriber, the only change is that the new IMSI and MSISDN values are assigned to the subscriber.
The subscriber's Account ID value is changed.

Request:

<updateSubscriber ent=”subscriberRouting” ns=”dsr” id=”108” group=”y”>
  <deleteAccountId>80044400001234567890111112</deleteAccountId>
  <deleteImsi>111111111100001</deleteImsi>
  <deleteImsi>111111111100002</deleteImsi>>
  <deleteMsisdn>8884605500</deleteMsisdn>
  <imsi>888888888800001</imsi>
  <imsi>888888888800002</imsi>
  <msisdn>8884605555</msisdn>
</updateSubscriber>

Response:

<updateSubscriberResp id=”108”>
  <res error=”0” affected=”1”/>
</updateSubscriberResp>

Create Subscriber Using New Routing Entities (Success)

This example creates a subscriber using new routing entities with specified destinations.

The result of this request is:

A new subscriber is created with the specified Account ID, IMSI and MSISDN values.
New IMSI and MSISDN routing entities are created with the specified destinations.

Request:

<updateSubscriber ent=”subscriberRouting” ns=”dsr” id=”109” group=”y”>
  <accountId>11111222223333344444555556</accountId>
  <imsi>333333333300001</imsi>
  <imsi>333333333300002</imsi>
  <msisdn>9198675309</msisdn>
  <ltehss>LTE_HSS_3</ltehss>
  <aaa>AAA_3</aaa>
</updateSubscriber>

Response:

<updateSubscriberResp id=”109”>
  <res error=”0” affected=”1”/>
</updateSubscriberResp>

Create Subscriber Using New Routing Entities (Failure)

This example fails when creating a subscriber using new routing entities because no destinations were specified.

No changes are made to the database because the request failed.

Request:

<updateSubscriber ent=”subscriberRouting” ns=”dsr” id=”110” group=”y”>
  <accountId>1111122222</accountId>
  <imsi>333333333300003</imsi>
  <imsi>333333333300004</imsi>
  <msisdn>9198675309</msisdn>
</updateSubscriber>

Response:

<updateSubscriberResp id=”110”>
  <res error=”2013” affected=”0” description=
  ”at least one destination must be specified”/>
</updateSubscriberResp>