ASAP 2.7 Extension Manual

Implementing the ASAP Extension in an Application
HP NonStop ASAP Extension Manual—425265-004
4-16
ASAP_UPDATELIST_ Procedure
Syntax for C Programmers
#include ASAPXH(ASAP_UPDATE_)
/*#pragma asap_update_ */
_tal _extensible short asap_update_ (
long , /* IN REQUIRED */
/* Shared memory segment offset for this domain */
short _far *, /* OUT OPTIONAL */
/* Detailed error */
short , /* IN REQUIRED */
/* Data item being updated. */
long long , /* IN REQUIRED */
/* Value to be used for the update */
short /* IN OPTIONAL */
/* Param value 0 = add, 1 = replace */
);
ASAP_UPDATELIST_ Procedure
Use the ASAP_UPDATELIST_ procedure to update more than one DataItem within a
domain.
error
INT
returns one of these values indicating the outcome of the update many call:
error := ASAP_UPDATELIST_ ( seg^offset !i
[,error^detail] !o
,num !i
,list !i
)
Value Definition
0 No error; the updates were successful.
–1 The calling process is not named.
–2 Parameter missing or in error. Error^detail contains the parameter number.
–3 File-system error. Error^detail contains the file-system error number.
–4 Checksum error. Shared memory has been corrupted.
–5 This domain was not found in the memory location specified by seg^offset.
–6 Statistics shutdown request has been issued. Statistics are disabled.
–7 Attempt to replace a DataItem that is not a constant.
–8 The DataItem in memory experienced an arithmetic overflow and has been
reset to zero. This is only a warning.
–9 Memory address trap detected. The supplied shared memory address
causes a memory trap.