ASAP 1.1 Hybrid Manual

HP NonStop ASAP Hybrid Manual – 529729-004
Page 4-15
asap_update and asap_update_ts
Update a single data item for a domain, using the supplied value and math
(operation type).
Data items are defined in the EDL for the application. This EDL must be loaded
into the running ASAP environment.
Declaration
short asap_update (
void *handle, // IN REQUIRED
// Shared memory handle for this domain
const short dataitem, // IN REQUIRED
// Index of the data item being updated
const long long value = 1, // IN OPTIONAL
// Value used to update the data item
const short math = ASAP_MATH_ADD, // IN OPTIONAL
// Math type; see ASAP_MATH constants
short *ptr_error_detail = NULL // OUT OPTIONAL
// Detailed error number, if any
);
short asap_update_ts (
void *handle, // IN REQUIRED
// Shared memory handle for this domain
const short dataitem, // IN REQUIRED
// Index of the data item being updated
const long long value = 1, // IN REQUIRED
// Value used to update the data item
const short math = ASAP_MATH_ADD, // IN OPTIONAL
// Math type; see ASAP_MATH constants
short *ptr_error_detail = NULL // OUT OPTIONAL
// Detailed error number, if any
);
Parameter Descriptions
void *handle
The handle returned from the call to asap_register. This parameter is required.
const short dataitem
The numeric index between 0 and (ASAP_MAX_DATAITEMS - 1) of the item to
update. This parameter is one of the in-memory data items as defined in EDL for
this ASAP domain. This parameter is required.
const long long value
The update value, in 64-bit binary form, representing a positive integer value or
an 8-byte ASCII string. This parameter is optional. The default value is 1.