+xns/ID
Message: Register

+xns/Core/XNSObject
   |
   +--+xns/Core/Message
         |
         +--+xns/ID/Register


Associates an identity ID with locations, or changes registration information if the ID is already registered.

An input identity ID is optional. If no identity ID is provided, then one is assigned and returned.

Either locations or a host identifier must be input. If locations are provided, the identity ID is associated with those locations. If a host identifier is provided, the identity ID is associated with the host identity and, transitively, with all the locations contained within the host identity. If the identity ID is already associated with a host identity, then the existing association is replaced with one to the specified host identity.

While an identity ID can be associated with only one host identity, the host identity may be directly associated with multiple URIs.

To: A host identity.
From: Another host identity or an application acting on behalf of the to-identity.


 

Input
+xns/Core/HostID HostID The ID of the host which will be associated with the identity being registered.
+xns/Core/IdentityID IdentityID The identity ID of the identity being registered.
Boolean IsHost Is the requested ID for a host identity?
+xns/Core/TextList Locations The list of URIs which will be associated with the identity being registered.
 

Output
+xns/Core/IdentityID IdentityID The identity ID of the identity being registered.
 

Exceptions
HostNotFound  
 

Input Detail

HostID

The ID of the host which will be associated with the identity being registered.  

DataType: +xns/Core/HostID
 


IdentityID

The identity ID of the identity being registered. If IdentityID is not provided as an input parameter, then it is assigned and returned.  

DataType: +xns/Core/IdentityID
 


IsHost

Is the requested ID for a host identity? True=the requested ID is for a host identity; False=the requested ID is not for a host identity.  

DataType: Boolean
 


Locations

The list of URIs which will be associated with the identity being registered. This element applies only to host identities.  

DataType: +xns/Core/TextList
 

List: true
 


 

Output Detail

IdentityID

The identity ID of the identity being registered. If IdentityID is not provided as an input parameter, then it is assigned and returned.  

DataType: +xns/Core/IdentityID
 


Publishing Identity: +xns
© 2002 XNSORG
Last Updated: 07/09/2002