ADU.IncrValue
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
aduid | Agent Data Unit Identifier. |
name | The name of the ADU element to change or create. |
incr | Increment value. |
Output Parameters
newvalue | The new value of the element, after the increment. |
Returns
VESP_SUCCESS | Request was successful. |
VESP_ERROR | ADU not found, or the element cannot be changed. |
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.