14.3.10 getposition (displays data storage locations)

(1) Description

This subcommand displays the EADS servers that store a specified key or group.

To Page Top

(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)

• This subcommand can be executed when the EADS servers are in the following status:

  • Initializing

  • Initialized

  • Running

  • Closing

  • Closed

  • Isolated

  • Stopping

• If the -l or --local option is specified, this subcommand can be executed regardless of the cluster or EADS server status.

• If an EADS server to be added to the cluster has not yet participated in the cluster, this subcommand cannot be executed on that EADS server.

To Page Top

(3) Format

eztool getposition key-or-group-name [-l]
                   [--format format-name]
                   [--columns column-name[,column-name]...]
                   [--filter filter-condition]
                   [--match matching-condition]

To Page Top

(4) Options and arguments

To Page Top

(5) Output example

The following shows an output example of the eztool getposition command's execution results.

For details about the components of the displayed information, see 14.4.1 Components of the displayed information.

The following tables list and describe the summary and content information that are displayed.

Table 14‒25: Summary information displayed by the eztool getposition command

No.	Summary name	Description
1	ReplicationCount	Data multiplicity
2	HashValue	Hash value of the specified key or group name

Table 14‒26: Content information displayed by the eztool getposition command

No.	Column name	Description
1	No.	Data priority# Displayed in ascending order.
2	IP_Address	IP address of EADS server
3	ClientPort	EADS server's port number used for communication with the EADS clients
4	Position	Location of EADS server (hash value)

#

If redundant copies of data have been created, this information is displayed in order, beginning with the EADS server on which the original data is stored, followed by the EADS servers to which the data has been copied.

In this example, No.1 indicates the EADS server on which the original data is stored and the subsequent numbers starting with No.2 indicate the EADS servers to which data has been copied.

To Page Top

(6) Return code

The following table lists the return codes that this subcommand returns.

Table 14‒27: Return codes returned by the eztool getposition command

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.

To Page Top

(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.

• This subcommand results in an error if all EADS servers are isolated.

To Page Top