Examples

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

These examples show the SDS provisioning request and response contents that are stored within the <soapenv:Body> or <SOAP-ENV:Body> tags. See the Start Transaction Examples for examples of the entire SOAP request/response text.

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:

<updateSubscriberRequest>
  <addressList>
    <imsi>111111111100001</imsi>
    <imsi>111111111100002</imsi>
    <imsi>111111111100003</imsi>
    <msisdn>8004605500</msisdn>
    <msisdn>8004605503</msisdn>
  </addressList>
  <destinationList>
    <ltehss>LTE_HSS_1</ltehss>
  </destinationList>
</updateSubscriberRequest>

Response:

<ns2:sdsResult affected="5" error="0" 
</ns2:sdsResult>

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:

<updateSubscriberRequest>
  <addressList>
    <imsi>111111111100001</imsi>
    <imsi>111111111100002</imsi>
    <imsi>111111111100003</imsi>
    <msisdn>8004605500</msisdn>
  </addressList>
  <destinationList>
    <ltehss>LTE_HSS_4</ltehss>
    <aaa>AAA_4</aaa>
  </destinationList>
</updateSubscriberRequest>

Response:

<ns2:sdsResult affected="4" error="0"
</ns2:sdsResult>

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:

<updateSubscriberRequest group=”y”>
  <addressList>
    <imsi>111111111100001</imsi>
    <imsi>111111111100002</imsi>
    <msisdn>8004605500</msisdn>
  </addressList>
  <destinationList>
  </destinationList>
</updateSubscriberRequest>

Response:

<ns2:sdsResult affected="1" error="0">
</ns2:sdsResult>

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:

<updateSubscriberRequest group=”y”>
  <addressList>
    <imsi>111111111100003</imsi>
    <msisdn>8004605503</msisdn>
  </addressList>
  <destinationList>
  </destinationList>
</updateSubscriberRequest>

Response:

<ns2:sdsResult affected="0" error="2029" description= 
”all routes must have the same destination values”>
</ns2:sdsResult>

Add Account ID to Existing Subscriber

This example adds an Account ID to an existing subscriber. Any of the subscriber 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:

<updateSubscriberRequest group=”y”>
  <addressList>
    <accountId>80044400001234567890111112</accountId>
    <msisdn>8004605500</msisdn>
  </addressList>
  <destinationList>
  </destinationList>
</updateSubscriberRequest>

Response:

<ns2:sdsResult affected="1" error="0">
</ns2:sdsResult>

Modify Destinations for Existing Subscriber

This example modifies one of the destination values 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:

<updateSubscriberRequest>
  <addressList>
    <imsi>111111111100002</imsi>
   </addressList>
   <destinationList>
     <ltehss>LTE_HSS_99</ltehss>
   </destinationList>
</updateSubscriberRequest>

Response:

<ns2:sdsResult affected="3" error="0"
</ns2:sdsResult>

Replace 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 does not matter which of the subscriber's routing entities is used. All entities 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 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:

<updateSubscriberRequest group=”y”>
  <addressList>
    <deleteMsisdn>8004605500</deleteMsisdn>
    <msisdn>8884605500</msisdn>
  </addressList>
  <destinationList>
  </destinationList>
</updateSubscriberRequest>

Response:

<ns2:sdsResult affected="1" error="0">
</ns2:sdsResult>

Replace Account ID, Two IMSI values, and One MSISDN Value

This example replaces several identification 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. All routing entities 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 Account ID value is changed.

Request:

<updateSubscriberRequest>
  <addressList>
    <deleteImsi>111111111100001</deleteImsi>
    <deleteImsi>111111111100002</deleteImsi>
    <deleteMsisdn>8884605500</deleteMsisdn>
    <imsi>888888888800001</imsi>
    <imsi>888888888800002</imsi>
    <msisdn>8884605555</msisdn>
  </addressList>
  <destinationList>
  </destinationList>
</updateSubscriberRequest>

Response:

<ns2:sdsResult affected="1" error="0">
</ns2:sdsResult>

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:

<updateSubscriberRequest group=”y”>
  <addressList>
    <accountId>11111222223333344444555556</accountId>
    <imsi>333333333300001</imsi>
    <imsi>333333333300002</imsi>
    <msisdn>9198675309</msisdn>
  </addressList>
  <destinationList>
    <ltehss>LTE_HSS_3</ltehss>
    <aaa>AAA_3</aaa>
  </destinationList>
</updateSubscriberRequest>

Response:

<ns2:sdsResult affected="1" error="0">
</ns2:sdsResult>

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:

<updateSubscriberRequest group=”y”>
  <addressList>
    <accountId>1111122222</accountId>
    <imsi>333333333300003</imsi>
    <imsi>333333333300004</imsi>
    <msisdn>9198675309</msisdn>
  </addressList>
  <destinationList>
  </destinationList>
</updateSubscriberRequest>

Response:

<ns2:sdsResult affected="0" error="2013" description=
”at least one destination must be specified”>
</ns2:sdsResult>