ADU.FindOrCreate

status = Vesp_Request( "ADU.FindByKey", callback, 0x2132, session, "key", "1137", &aduid );

ADU.FindOrCreate

IDL Syntax ORBStatus FindOrCreate( in SeqCouple match, in SeqCouple, oncreate, out string vdu_id) ;

Description This method searches the local server for an ADU that exactly matches all names and values in the match. It does not support wildcards. If a match is not found on the local server, it searches other ADU servers. If a match is found, it returns the id of the ADU. If multiple matches are found, the id of the most recently created ADU is returned.

If ADU.FindOrCreate does not find a match, the local server creates the ADU with the names and values from the combined list of match and oncreate. The id is then returned. This is the only case where the oncreate parameter is used.

Note: This method is intended to by used by the Avaya Toolkit. If you know the ADU needs to be created, it is recommended that you use the Create method because it is considerably faster and much more efficient.

Input Parameters

name

Search key to find ADU.

value

Value to match if name is found.

Output Parameters

aduid

Agent Data Unit Identifier.

Returns

VESP_SUCCESS

Request was successful..

VESP_ERROR

Requires values to find ADU. The match parameter may be empty.

ADU.ForceTerminate

IDL Syntax ORBStatus ADU.ForceTerminate(in string duid)

Description Forces the ADU object to be deleted from memory and from the database both, so it can no longer be used.

ADU.ForwardEvent

IDL Syntax ORBStatus ForwardEvent( in unsigned long handleis, in Event Event) ;

Issue 1.0 June 2002 53

Page 53
Image 53
Avaya DXX-1015-01 manual ADU.FindOrCreate, ADU.ForceTerminate, ADU.ForwardEvent