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.

You can execute this subcommand when the EADS server is running.
This subcommand executes in descending order of the EADS server positions (Position).

eztool removeall [-g group-name|-s] cache-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.

Specify this option to delete the values whose master copy (original) is located on the EADS server on which this subcommand is executed.

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)

Table 14‒40: Return codes returned by the eztool removeall command
No.	Return code		Description
No.	eads.command.compat parameter omitted in the command properties	0300 specified in the eads.command.compat parameter in the command properties	Description
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.

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.