20.1.19 ead_remove_node() (deletes values by using a batch operation with EADS server specification)
- Organization of this subsection
(1) Description
Using a batch operation, this function deletes keys and values that were copied from a specified EADS server.
If the deletion processing fails for some reason during batch deletion of keys and values, the function returns an error code that indicates the cause of the failure.
(2) Format
#include <eads.h> void ead_remove_node ( const EAD_CACHE *cp, /* In */ const ead_node *target_node, /* In */ int *error_code /* Out */ );
(3) Arguments
- cp
-
Specifies the handle (pointer) to the cache where the values to be deleted are stored.
Specify the handle (pointer) obtained from ead_start_cache() when access to the cache was started.
- target_node
-
Specifies a pointer to the EADS server (ead_node structure) on which the batch deletion processing is to be executed.
You can only specify the pointer of the ead_node structure obtained by using the EADS client library. If you specify any other pointer, correct operation is not guaranteed.
For the format and details of the ead_node structure, see 20.1.50 ead_node structure (object used in a user function with an EADS server specified).
An error results if the address information (IP address and port number) managed by the specified ead_node structure does not match the address information of any EADS servers maintained by the EADS client.
- error_code
-
Specifies the pointer from which to retrieve the error code.
For details about error codes, see 20.2 Error codes in the client library (C).
(4) Notes
-
If deletion processing fails, data to be deleted might still remain. Check the execution results and take the appropriate action. If necessary, re-execute ead_remove_node() (deletes values by using a batch operation with EADS server specification).
-
Because caches are not locked while operations are ongoing, a target value might be changed by another cache operation during batch operation.
-
When batch operations are performed on a large amount of data, a large amount of memory might be required by EADS clients and EADS servers.
-
When batch operations are performed on a large amount of data, it might take a long time to complete the processing. To ensure proper operation, make sure that you design a timeout value that is appropriate for the processing time.