14.3.21 removeall (deletes all data)
- Organization of this subsection
(1) Description
This subcommand deletes a specified range of keys and all the values associated with those keys.
(2) Rules
-
You can execute this subcommand when the EADS server is running.
-
This subcommand executes in descending order of the EADS server positions (Position).
(3) Format
eztool removeall [-g group-name|-s] cache-name
(4) Options and arguments
(a) -g group-name or --group group-name
Specify this option to delete the values that belong to a specific group.
For details about the data that can be specified as group names, see 15.2.2(2) Data that can be specified as group names.
(b) -s or --single
Specify this option to delete the values whose master copy (original) is located on the EADS server on which this subcommand is executed.
(c) cache-name
This option specifies the name of the cache that contain the values to be deleted.
The following characters are permitted for a cache name:
-
If cache property files were not used to create caches
A maximum of 32 single-byte characters in ASCII codes 0x20 to 0x7E
-
If cache property files were used to create caches
A maximum of 32 single-byte alphanumeric characters (0 to 9, A to Z, and a to z)
(5) Return code
No. |
Return code |
Description |
|
---|---|---|---|
eads.command.compat parameter omitted in the command properties |
0300 specified in the eads.command.compat parameter in the command properties |
||
1 |
0 |
0 |
Command execution was successful. |
2 |
101 |
101 |
Initialization of the command failed. |
3 |
120 |
The command failed due to a syntax error. |
|
4 |
150 |
The command failed during execution. |
|
5 |
200 |
The command failed due to a timeout. |
(6) Notes
-
Executing this subcommand enables you to delete all values in a specified range without having to create an application program. However, if you cannot obtain the intended results by using this subcommand's options and arguments, you will have to create an application program, such as in the following cases:
-
Specifying multiple keys to delete the values associated with each key
-
Implementing processing to be performed if the subcommand fails to delete some of the data
-
-
If data is added while this subcommand is executing, the following occurs, depending on the area where the added data is stored:
-
If the added data is stored in the area from which data has already been deleted
The added data is not deleted.
-
If the added data is stored in the area from which data has not been deleted
The added data is deleted.
-
-
If EADS servers are added to or restored in the cluster while this subcommand is executing, the added or restored EADS servers are excluded as processing targets. As a result, some of the data might not be deleted. If this occurs, re-execute the subcommand.