5.16.1 Request
The
<readSubscriberNai> request
extracts (reads) NAI routing entities and displays the first eight destination
values for each routing entity.
Semantic Rules
- Between 1 and 10 user names must be specified.
- The host name must already exist in the database.
Request Format
<readSubscriberNai ent="subscriberRouting" ns="dsr" [resonly="resonly"]
[id="id"]>
<host>host</host>
<user>user</user>
[
<user>user</user>
…
<user>user</user>
]
</readSubscriberNai>Request Parameters
Table 5-24 <readSubscriberNai> 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. |
|
| 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 write if another connection is performing a write, or has a transaction open. Clients waiting to write 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. |
| host | A host name. | A string with 1 to 64 characters. |
| user | A user name to be associated with the host to form an NAI. | A string with 1 to 64 characters. |