The <readSubscriberResponse> message returns the result of the request to read subscriber routing entities. Only those subscribers or routing entities that are found are returned. The response message contains up to eight destinations (one for each destination type, such as <ltehss>) for each routing entity or subscriber. Only provisioned destination names are displayed. (for example, destination names= "none" are not displayed).
Some variations in the response occur, depending on whether a subscriber or routing entities are being retrieved.
<readSubscriberResponse> <result affected="affected" error="error" [description="description"]> </result> [ <resultSet> [ <imsi imsi="imsi"> [ <imshss>imshss</imshss> ] [ <ltehss>ltehss</ltehss> ] [ <pcrf>pcrf</pcrf> ] [ <ocs>ocs</ocs> ] [ <ofcs>ofcs</ofcs> ] [ <aaa>aaa</aaa> ] [ <userdef1>userdef1</userdef1> ] [ <userdef2>userdef2</userdef2> ] </imsi> ... <imsi imsi="imsi"> [ <imshss>imshss</imshss> ] [ <ltehss>ltehss</ltehss> ] [ <pcrf>pcrf</pcrf> ] [ <ocs>ocs</ocs> ] [ <ofcs>ofcs</ofcs> ] [ <aaa>aaa</aaa> ] [ <userdef1>userdef1</userdef1> ] [ <userdef2>userdef2</userdef2> ] </imsi> ] [ <msisdn msisdn="msisdn"> [ <imshss>imshss</imshss> ] [ <ltehss>ltehss</ltehss> ] [ <pcrf>pcrf</pcrf> ] [ <ocs>ocs</ocs> ] [ <ofcs>ofcs</ofcs> ] [ <aaa>aaa</aaa> ] [ <userdef1>userdef1</userdef1> ] [ <userdef2>userdef2</userdef2> ] </msisdn> ... <msisdn msisdn="msisdn"> [ <imshss>imshss</imshss> ] [ <ltehss>ltehss</ltehss> ] [ <pcrf>pcrf</pcrf> ] [ <ocs>ocs</ocs> ] [ <ofcs>ofcs</ofcs> ] [ <aaa>aaa</aaa> ] [ <userdef1>userdef1</userdef1> ] [ <userdef2>userdef2</userdef2> ] </msisdn> ] </resultSet> ] </readSubscriberResponse>
<readSubscriberResponse> <result affected="affected" error="error" [description="description"]/> [ <resultSet> <subscriber> [ <accountId>accountId</accountId>] [ [ <imsi>imsi</imsi> ] ... [ <imsi>imsi</imsi> ] [ <msisdn>msisdn</msisdn> ] ... [ <msisdn>msisdn</msisdn> ] [ <imshss>imshss</imshss> ] [ <ltehss>ltehss</ltehss> ] [ <pcrf>pcrf</pcrf> ] [ <ocs>ocs</ocs> ] [ <ofcs>ofcs</ofcs> ] [ <aaa>aaa</aaa> ] [ <userdef1>userdef1</userdef1> ] [ <userdef2>userdef2</userdef2> </subscriber> </resultSet> ] </readSubscriberResponse>
Parameter | Description | Values |
---|---|---|
group (Optional) | Indicates if all of the subscriber’s data should be retrieved or just specified IMSI or MSISDN routing entities. | y - Read subscriber and all of its IMSI and MSISDN routing entities. n - Only read specified MSISDN and IMSI routing entities (default). |
error | Error code that indicates whether or not operation was successfully executed. | 0 for success, non-zero for failure. |
affected | The number of routing entities or subscribers (for group=”y”) read. | 0-12 |
description | A textual description associated with the response. This field may contain more information as to why a request failed. | A string with 1 to 1024 characters. |
resultSet | Contains 1 row for each extracted record. Each row contains a stand-alone routing entity (MSISDN or IMSI value and its destination values) or a subscriber (list of related MSISDN, IMSI and Account ID values and the destination values used by all routing entities assigned to the subscriber). | |
subscriber (Optional) | Contains all of the IMSI and MSISDN values for a specific subscriber, an optional Account ID, and all destinations defined for the subscriber. | |
accountId (Optional) | A user-defined Account ID value. | 1 to 26 numeric digits. |
imsi (Optional) | An IMSI (specified in E.212 format) value. | 10 to 15 numeric digits. |
msisdn (Optional) | An MSISDN (specified in E.164 international public telecommunication numbering plan format) value. | 8 to 15 numeric digits. |
imshss (Optional) | The name of the IMS HSS destination. | A string with 1 to 32 characters. |
ltehss (Optional) | The name of the LTE HSS destination. | A string with 1 to 32 characters. |
pcrf (Optional) | The name of the PCRF destination. | A string with 1 to 32 characters. |
ocs (Optional) | The name of the OCS destination. | A string with 1 to 32 characters. |
ofcs (Optional) | The name of the OFCS destination. | A string with 1 to 32 characters. |
aaa (Optional) | The name of the AAA server destination. | A string with 1 to 32 characters. |
userdef1 (Optional) | The name of the first user defined destination. | A string with 1 to 32 characters. |
userdef2 (Optional) | The name of the second user defined destination. | A string with 1 to 32 characters. |
Error Code | Description |
---|---|
SUCCESS | The read request was successfully completed. |
IMSI_NOT_FOUND | IMSI does not exist. |
MSISDN_NOT_FOUND | MSISDN does not exist. |
SUBSCIRIBER_NOT_FOUND | The subscriber could not be found in the database. |
MULTIPLE_SUBSCRIBERS | Specified parameters refer to multiple subscribers. |
ROUTE_TYPE_MISMATCH | Standalone and subscriber routes are not allowed in same command. |
NO_ROUTES_SPECIFIED | At least one MSISDN or IMSI must be specified. |