Avaya Interaction Center DXX-1015-01 - Manual (Page 59)

ADU.IncrValue
Issue 1.0 June 2002 59
ADU.IncrValue
IDL Syntax
ORBStatus IncrValue( in ADU_ID aduid, in string name, in long incr,
out string newvalue ) ;
Description This method is a useful alternative to using SetOneValue and GetOneValue to modify a value
when there is a risk that two applications might conflict.
This method changes one ADU data element. If the element does not exist it is created. An element
that exists is overwritten if permission allows. The value of the element is treated as a number and
is converted to a long integer (by use of the C function atol). The specified increment is added, and
the element’s value is set to the result. Elements that do not exist are treated as if they contained a
zero (0). The increment may be a negative value.
The atol function is robust in that if it cannot recognize a number, it returns 0. The method stores
the resulting, incremented value as a decimal digit string without extraneous spaces or leading
zeros. Thus, incrementing “x2” by one results in “1” and incrementing “00034E6” by one results
in “35”.
Input Parameters
Output Parameters
Returns
C Program Example
char *result;
status = Vesp_Request( "ADU.IncrValue", callback, 0x2132, session,
aduid, "some_numeric_element", 1L, &result );
ADU.Monitor
IDL Syntax ORBStatus Monitor( in string monitorcriteria ) ;
Description This method changes Assign criteria. It works like Assign in all respects. You must have
previously assigned (and have not since deassigned) to use this method.
aduid Agent Data Unit Identifier.
name The name of the ADU element to change or create.
incr Increment value.
newvalue The new value of the element, after the increment.
VESP_SUCCESS Request was successful.
VESP_ERROR ADU not found, or the element cannot be changed.