Request

The <updateDomainRequest> request provisions domain identifiers. For example, John.Smith@tekelec.com 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

The request must be inserted between the <soapenv:Body> and </soapenv:Body> XML tags of a SOAP request message as shown in SOAP Request Messages.

<updateDomainRequest [timeout="timeout"]>
  <domainList>
    <domain>domainIdentifier</domain>
[
    <domain>domainIdentifier</domain>
          …
    <domain>domainIdentifier</domain>
]
  </domainList>
  <destinationList>
[   <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>       ]
  <destinationList>
</updateDomainRequest>

Request Parameters

Table 9-25 <updateDomainRequest> Parameters (SOAP)

Parameter	Description	Values
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 upto 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)		A string with 1 to 32 characters.
ofcs (Optional)	The name of the OCS 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.