
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.