ASAP 1.1 Hybrid Manual

HP NonStop ASAP Hybrid Manual – 529729-004
Page 4-11
Differences from the NonStop ASAPX API
 The domain name parameter is supplied as a standard C null-terminated
string, and the domain name length parameter (domain^name^len) has been
eliminated.
 The segment^id parameter has been eliminated.
 The segment^base parameter has been eliminated.
 The ASAP ID parameter is supplied as a standard C null-terminated string, and
the ID length parameter (id^len) has been eliminated.
 The flags parameter has been replaced by two separate Boolean parameters:
rank_enabled_ind, which is used to specify whether ranking is initially enabled
for the domain; and concat_ind, which is used to indicate whether the PID for
the calling process should be appended to the domain name. There is no
longer an option to specify whether or not domains can perform replace
update operations on nonconstant data items. These operations are always
permitted.
 The timeout value is supplied in milliseconds instead of in hundredths of
seconds.
 The application version parameter is supplied as a standard C null-terminated
string.
 A different range of values and possible errors is returned.
Example
void *Handle; // Handle from asap_register
short ErrorDetail; // Error detail from call
short ReturnValue; // Return value from call
ReturnValue = ::asap_register(“MyApp\\MyDomain”, // Supply the domain name
&Handle, // Returned handle
&ErrorDetail, // Returned error information
“$zoo”, // ASAP ID is $zoo
true, // Enable ranking
true, // Concat PID to domain name
3000, // Wait up to 3 seconds
"01"); // Application version 01