Oracle® Communications Diameter Signaling Router Subscriber Database Server Provisioning Interface Release 8.3 E93213 |
|
![]() Previous |
![]() Next |
The
<readSubscriber>
request extracts
IMSI, MSISDN, and External Identifier routing and subscriber data. See
Subscriber and Routing Data
for a description of subscriber and routing data. Each routing entity contains
up to nine destination names.
When the
group="y"
attribute is specified, the
request extracts and displays all data associated with the subscriber. The
returned response will have the Subscriber Account ID, all IMSI, MSISDN, and
External Identifier values, and the nine destination values from any of the
subscriber routing entities is returned in the response. All routing entities
for a subscriber have the same destination values; hence, any routing entity
can be used to extract the values.
When
group="y"
is not specified or when
group="n"
is specified, only the
specified IMSI, MSISDN, and External Identifier routing entities are retrieved.
The returned response will have each IMSI, MSISDN, or External Identifier value
along with individual up to nine destination values.
Semantic Rules (requests that do not specify the
group attribute or specify
group="n"
)
imsi
,
msisdn
, or
externalIdentifier
values must be assigned to one
subscriber or must exist in standalone routing entities.
accountId
parameter cannot be
specified.
Semantic Rules (requests that specify
group="y"
)
accountId
,
imsi
,
msisdn
, or
externalIdentifier
values must be assigned to one
subscriber. The specified
imsi
or
msisdn
values cannot exist in a
standalone routing entity.
accountId
parameter can be
specified.
imsi
, 6
msisdn
, 10
externalIdentifier
, and 1
accountId
values can be specified.
Request Format
<readSubscriber ent="subscriberRouting" ns="dsr" [resonly="resonly"] [id="id"] [timeout="timeout"] [group="group"]> [ <accountId>accountId</accountId> ] [ <imsi>imsi</imsi> <imsi>imsi</imsi> ] [ <msisdn>msisdn</msisdn> … <msisdn>msisdn</msisdn> ] [ <externalId>externalIdentifier</externalId> … <externalId>externalIdentifier</externalId> ] </readSubscriber>
Request Parameters
Table 10-17 <readSubscriber> Request Parameters (XML)
Parameter | Description | Values |
---|---|---|
ent | The entity name within the global schema. | subscriberRouting |
ns | The namespace within the global schema. | dsr |
resonly (Optional) | Indicates whether the response should consist of the result only, without including the original request in the response. |
y - Only provide the result, do not include the original request (default). n - Include the original request in the response. |
id (Optional) | Transaction ID value provided in request and passed back in the response. | 1-4294967295 |
timeout (Optional) | The amount of time (in seconds) to wait before being able
to perform a read if another connection is performing a write, or has a
transaction open. Clients waiting to read will be processed in the order that
their requests were received.
If the request is being performed within a transaction, this parameter will have no effect, as the client already has a transaction open. |
0 (return immediately if not available) to 3600 seconds. The default is 0. |
group (Optional) | Indicates if all subscriber data should be retrieved or just specified IMSI, MSISDN, and External Identifier routing entities. |
y - Read subscriber and all of its IMSI, MSISDN, and External Identifier routing entities. n - Only read specified IMSI, MSISDN, and External Identifier routing entities (default). |
accountId (Optional) | A user-defined Account ID value to read. | 1 to 26 numeric digits. |
imsi (Optional) | An IMSI (specified in E.212 format). | 10 to 15 numeric digits. |
msisdn (Optional) | An MSISDN (specified in E.164 international public telecommunication numbering plan format). | 8 to 15 numeric digits. |
externalId (Optional) | An External Identifier (specified in NAI format) value to read. | A string with 3 to 257 characters. |