14.3.7 listesd (displays a list of store data files)
- Organization of this subsection
(1) Description
This subcommand displays a list of store data files in the cluster.
(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
-
Closing
-
Closed
-
(3) Format
eztool listesd [-v] [-d path-name-of-store-data-file-storage-location] [--format format-name] [--columns column-name[,column-name]...] [--filter filter-condition] [--match matching-condition]
(4) Options and arguments
(a) -v or --verbose
Specify this option if you want to display the details of the command execution results.
(b) -d path-name-of-store-data-file-storage-location or --directory path-name-of-store-data-file-storage-location
This option specifies the path name of the store data file storage location.
Specify this option if you want to display a list of store data files that are located under a specified directory.
The path name cannot be a directory that contains an asterisk (*), double quotation mark ("), question mark (?), vertical bar (|), less-than sign (<), or greater-than sign (>).
If a relative path is specified as the path of the store data file storage location, the specified path is treated as being relative to the management directory.
(c) --format format-name
For details about this option, see 14.4.2 How to specify the display format.
(d) --columns column-name[,column-name]...
For details about this option, see 14.4.3 How to specify column filters.
(e) --filter filter-condition
For details about this option, see 14.4.4 How to specify row filters.
(f) --match matching-condition
For details about this option, see 14.4.5 How to specify a condition match.
(5) Output example
The following shows output examples of the eztool listesd command's execution results.
For details about the components of the displayed information, see 14.4.1 Components of the displayed information.
If option -v or --verbose is omitted
If option -v or --verbose is specified
The following tables list and describe the summary and content information that are displayed.
No. |
Summary name |
Description |
Whether displayed |
|
---|---|---|---|---|
-v or --verbose option |
||||
Omitted |
Specified |
|||
1 |
TotalCount |
Total number of store data file keys |
Y |
Y |
2 |
export |
Number of store data file keys and the upper limit on the number of generations of the store data files that are output when the eztool export command (with the argument omitted) is executed This information is displayed in the following format: Number of store data file keys/upper limit on the number of generations This information is not displayed if 0 is specified as the upper limit on the number of generations. |
Y |
Y |
3 |
stop |
Number of store data file keys and the upper limit on the number of generations of the store data files that are output when the eztool stop command is executed This information is displayed in the following format: Number of store data file keys/upper limit on the number of generations This information is not displayed if 0 is specified as the upper limit on the number of generations. |
Y |
Y |
4 |
other |
Number of store data file keys of store data files that are output when the eztool export command (with an argument and the -s or --single option specified) is executed |
Y |
Y |
5 |
latest |
Store data file keys of the store data files that are to be imported when the eztool import command (with the argument omitted) is executed If there are no applicable store data file keys, none is displayed. |
Y |
Y |
- Legend:
-
Y: Displayed
No. |
Column name |
Description |
Whether displayed |
|
---|---|---|---|---|
-v or --verbose option |
||||
Omitted |
Specified |
|||
1 |
Type |
Types of store data files# One of the following is displayed:
|
Y |
Y |
2 |
StoreDataFileKey |
Store data file keys# The store data file keys are displayed in ascending order of the ASCII code. |
Y |
Y |
3 |
FileName |
Store data file name |
N |
Y |
4 |
FileSize(MB) |
Store data file size (megabytes) The digits after the decimal point are truncated. |
N |
Y |
5 |
Server |
IP address of the EADS server containing the store data files and the port number of the EADS server that is used to communicate with the EADS client This information is displayed in the following format: IP address:port number |
N |
Y |
6 |
AbsolutePath |
Store data file name (absolute path) |
N |
Y |
- Legend:
-
Y: Displayed
N: Not displayed
- Notes:
-
The execution results are displayed according to the following priorities:
-
The value of Type is displayed in the order of export, stop, and other.
-
The rows for the same Type value are displayed in natural order of the StoreDataFileKey values.
-
If the -v or --verbose option is specified, the rows for the same Type and StoreDataFileKey values are displayed in natural order of the Server values.
-
- #
-
If the execution results contain multiple cells with the same value consecutively, only the first such cell is displayed and the other cells are omitted.
(6) 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 |
150 |
The command failed during execution. |
|
8 |
200 |
The command failed due to a timeout. |
- When the --match option is specified:
-
If the condition was satisfied, the subcommand returns 0; otherwise, the subcommand returns 1. If the command's execution failed, the return code is the same as when the --match option is not specified.
(7) Notes
If the command times out during output processing, the output results might not be complete. The command might time out even if output processing is complete. If this happens, increase the command's timeout value, and then re-execute the command.