14.3.27 deleteecf (deletes cache files)
This subsection is applicable when you are using disk caches or two-way caches.
- Organization of this subsection
(1) Description
This subcommand deletes the cache files for a specified cache.
When this subcommand is executed, the following cache files are deleted in accordance with parameters specified in the cache property file on each EADS server:
-
directory-specified-in-the-eads.cache.disk.info.dir-parameter-in-the-cache-properties/cache-name/eads_info_[EADS-server-ID#]_[cache-name].ecf
#: Integer from 01 to 96
-
directory-specified-in-the-eads.cache.disk.info.dir-parameter-in-the-cache-properties/cache-name/eads_index_[EADS-server-ID#1]_[cache-name]_[range-ID#1]_[nnnnn#2].ecf
#1: Integer from 01 to 96
#2: Sequential file number (5-digit integer)
-
directory-specified-in-the-eads.cache.disk.n.dir-parameter-in-the-cache-properties/cache-name/eads_data_[EADS-server-ID#1]_[cache-name]_[range-ID#1]_[nnnnn#2].ecf
#1: Integer from 01 to 96
#2: Sequential file number (5-digit integer)
The following directories are also deleted if they are empty after the cache files have been deleted:
-
directory-specified-in-the-eads.cache.disk.info.dir-parameter-in-the-cache-properties/cache-name
-
directory-specified-in-the-eads.cache.disk.n.dir-parameter-in-the-cache-properties/cache-name
(2) Rules
-
This subcommand can be executed only when the status of the cluster is one of the following:
-
Cluster available (AVAILABLE)
-
Cluster partially available (PARTIALLY_AVAILABLE)
-
-
The target of this subcommand is the EADS servers whose cluster participation status is online. This subcommand cannot be executed if the cluster contains any EADS server whose cluster participation status is standby. You can determine the cluster participation status with the eztool status command.
-
This subcommand can be executed when the target EADS servers are in the following status:
-
Initialized
-
Running
-
Closed
If the -l or --local option is specified, the subcommand can be executed only when the local EADS server is stopped.
-
(3) Format
eztool deleteecf cache-name [-l]
(4) Options and arguments
(a) cache-name
This option specifies the cache name for the cache files to be deleted.
Specify the cache name as a maximum of 32 single-byte alphanumeric characters (0 to 9, A to Z, a to z).
(b) -l or --local
Specify this option if you want to delete the cache files only on the EADS server on which the command is executed.
For example, specify this option when a system in which data was updated and deleted frequently has become isolated and you want to delete cache files that are not needed for restoration before performing restoration in order to reduce the time required for importing data.
When this option is specified, the cache files are deleted only if the target EADS server is stopped. The cache files are not deleted while the target EADS server is running.
(5) Return code
The following table lists the return codes that this subcommand returns.
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 |
110 |
Connection establishment failed. |
|
4 |
111 |
The command failed due to a communication timeout. |
|
5 |
120 |
The command failed due to a syntax error. |
|
6 |
130 |
The command failed because it could not be executed. |
|
7 |
131 |
The command failed because another command was executing. |
|
8 |
150 |
The command failed during execution. |
|
9 |
200 |
The command failed due to a timeout. |
(6) Notes
-
Cache files cannot be deleted while they are being used by EADS servers. If there is no cache property file for the specified cache, the cache files cannot be deleted.