Avaya DXX-1015-01 User Manual

Page of 74
Chapter 7   ADU Server Methods
66 Agent Data Unit Server Programmer’s Guide
Input Parameters
Returns
C Program Example
status = Vesp_Request( "ADU.Terminate", callback, 0x2132, session,
aduid );
ADU.TerminateMine
IDL Syntax
void TerminateMine( ) ; 
Description
When a client creates, reads, modifies, or transfers an ADU, the client's name is added to an 
internal list of clients. When the TerminateMine method is invoked, the client's name is removed 
from the list for all ADUs. 
The Terminate() method is marginally faster than TerminateMine(), and is therefore preferable 
when the ADUID is known.
It is important to realize that transferring a call does not automatically end a client’s responsibility 
toward the ADU. The client must use the ADU.Terminate() or the ADU.TerminateMine() method 
to signal that it has no further interest in the ADU.
Returns
There is no return value.
C Program Example
status = Vesp_Request ( "ADU.TerminateMine" , callback, 0x2132, session );
ADU.Touch
IDL Syntax
ORBStatus Touch( in string aduid ) ; 
Description
This method accesses an ADU, just as a GetOneValue might, but it modifies or fetches no values. 
As a result, the caller's session and loginid are placed on the internal lists for the ADU, and if the 
ADU was in the DUStore, it is brought into ADU server memory. 
Input Parameters
aduid 
Agent Data Unit Identifier.
VESP_SUCCESS 
Request was successful.
VESP_PARTIAL_
SUCCESS
The ADU was not found in memory.
VESP_ERROR
Specified ADU does not exist.
aduid
Agent Data Unit Identifier.