Avaya DXX-1015-01 Server User Manual


 
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 elements 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.