Request

The <updateDomainRequest> request provisions domain identifiers. For example, [e-mail] would have John.Smith as the local identifier value and tekelec.com as the domain identifier value.

Each domain identifier contains up to nine destination names. Each destination contains FQDN and realm values, which are used for routing messages. The <updateDomainRequest> request can remove a destination value from existing domain identifier by specifying "none" as the destination name.

The <updateDomainRequest> request can add new domain identifier value or update destination names in existing domain identifier records. These destination changes are applied to the specific domain identifier.

Semantic Rules

• There must be at least one destination specified.
• There must be one domain identifier values specified, and supported up to 10 values.
• All specified destination names must already exist in the database.
• Each destination name type may only be specified once.
• Specifying a destination name of "none" removes the association of that destination from the specified routing entity(s).

Request Format

<updateDomain ent="subscriberRouting" ns="dsr" [resonly="resonly"] [id="id"] [timeout="timeout"] >
    <domain>domainIdentifier</domain>
[
    <domain>domainIdentifier</domain>
          …
    <domain>domainIdentifier</domain>
]
[   <imshss>imshss</imshss>       ]
[   <ltehss>ltehss</ltehss>       ]
[   <pcrf>pcrf</pcrf>             ]
[   <ocs>ocs</ocs>                ]
[   <ofcs>ofcs</ofcs>             ]
[   <aaa>aaa</aaa>                ]
[   <userdef1>userdef1</userdef1> ]
[   <userdef2>userdef2</userdef2> ]
[   <mtchss>mtchss</mtchss>       ]
</updateDomain>

Request Parameters

Table 5-27 <updateDomain> 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 if 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 to 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 are 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 (default is 0)
domain	The domain Identifier name, which is used for configuring external identifier by associating them with local identifier values. Must have one or up to 10 domain identifier values.	A string with 1 to 128 characters.
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 fsecond user defined destination.	A string with 1 to 32 characters.
mtchss (Optional)	The name of the MTC HSS destination.	A string with 1 to 32 characters.