D.1.28 acec query (Command for displaying the status of synchronous high speed copy)

NAME

acec query - Display of the status of synchronous high speed copy.

SYNOPSIS

acec query -g COPY-GROUP [-p PAIR] [-progress] [-r] [-xml]

DESCRIPTION

This command displays the status of synchronous high speed copy of a specified copy group or copy pair.

OPTIONS

-g COPY-GROUP: This option specifies a copy group name.

-p PAIR: This option specifies a copy pair.

-progress: This option displays the progress of copy processes.

-r: This option displays the status of a copy in the reverse direction to the direction that has been specified.

-xml: This option displays the result of the command execution in the XML format.

EXIT STATUS

=0: Terminate normally

>0: Terminate abnormally

EXAMPLES

For EC

When the -progress option is not specified:

> acec query -g ECGroup

Copy Group Name : ECGroup
Copy Group Type : EC
Disk Array Name : DX80 (00ETERNUSDXL##ET08E21A####LN4310901078##)

Source   <=> Target   SID  EC Status               Copy Phase Copied Block
-------- --- -------- ---- ----------------------- ---------- ------------
DX80/0x1 N/A DX80/0x3 N/A  "EC action not startup" "Not set"             0
DX80/0x2 ==> DX80/0x4 0x41 "EC Executing"          "Copying"       1048576

The following table shows the meanings of the information displayed.

Title	Explanation
Copy Group Name	Displays the copy group name.
Copy Group Type	Displays the type of copy that has been set up for the copy group.
Disk Array Name	Displays the Box ID and ETERNUS name that was specified the "-a" option of the acgroup create (Command for creating copy groups).
Source	Displays the logical volume for the copy source.
<=>	Displays the copy direction. N/A: No copying is performed. ==>: Copying from the source to the target. <==: Copying from the target to the source.
Target	Displays the logical volume for the copy destination.
SID	Displays the session ID.
EC Status	Displays the execution status of the EC. EC Starting: The EC is starting up. EC Executing: The EC is executing. EC Suspend: The EC is suspended. EC action not startup: The specified session does not exist. EC Error Suspend: An error has occurred, preventing the copy process from continuing.
Copy Phase	Displays the current phase. Copying: Copy processing is executing. Paired: The copy is in an equivalency maintenance state. Not set: Either the specified session does not exist, or the copy process is not running.
Copied Block	Displays the number of blocks that have been copied.

When the -progress option is specified:

> acec query -g ECGroup -progress

Copy Group Name : ECGroup
Copy Group Type : EC
Disk Array Name : DX80 (00ETERNUSDXL##ET08E21A####LN4310901078##)

Source   <=> Target   Progress Copied Block Total Block
-------- --- -------- -------- ------------ -----------
DX80/0x1 N/A DX80/0x3      N/A          N/A         N/A
DX80/0x2 ==> DX80/0x4      45%       471859     1048576

The following table shows the meanings of the information displayed.

Title	Explanation
Copy Group Name	Displays the copy group name.
Copy Group Type	Displays the type of copy that has been set up for the copy group.
Disk Array Name	Displays the Box ID and ETERNUS name that was specified the "-a" option of acgroup create (Command for creating copy groups).
Source	Displays the logical volume for the copy source.
<=>	Displays the copy direction. N/A: No copying is performed. ==>: Copying from the source to the target. <==: Copying from the target to the source.
Target	Displays the logical volume for the copy destination.
Progress	Displays the progress of copy processes as a percentage. The "N/A" is displayed when the copy process is not executed. If the progress of copy process is unclear, "???" is displayed.
Copied Block	Displays the number of blocks that have been copied. The "N/A" is displayed when the copy process is not executed. If the number of copied blocks is unclear, "???" is displayed.
Total Block	Displays the number of total blocks. If the entire copy block size is unclear, "???" is displayed.

For REC

When the -progress option is not specified:

> acec query -g RECGroup

Copy Group Name        : RECGroup
Copy Group Type        : REC
Disk Array Name        : DX90P (00ETERNUSDXL##ET09E24AG###NP4310901018##)
Remote Disk Array Name : DX90S (00ETERNUSDXL##ET09E24AG###NP4310901019##)

Source    <=> Target    SID(RSID)  EC Status               Copy Phase Copied Block Rcv  Split Xfer
--------- --- --------- ---------- ----------------------- ---------- ------------ ---- ----- -------
DX90P/0x1 N/A DX90S/0x6 N/A        "EC action not startup" "Not set"             0 ---- ----  ----
DX90P/0x2 ==> DX90S/0x7 0x4A(0x11) "EC Executing"          "Copying"             0 auto ----  through
DX90P/0x3 ==> DX90S/0x8 0x4C(0x13) "EC Suspend"            "Paired"        1048576 auto ----  through

The following table shows the meanings of the information displayed.

Title	Explanation
Copy Group Name	Displays the copy group name.
Copy Group Type	Displays the type of copy that has been set up for the copy group.
Disk Array Name	Displays the Box ID and ETERNUS name that was specified with the "-a" option of acgroup create (Command for creating copy groups).
Remote Disk Array Name	Displays the Box ID and ETERNUS name that was specified with the "-remote" option of acgroup create (Command for creating copy groups).
Source	Displays the logical volume for the copy source.
<=>	Displays the copy direction. N/A: No copying is performed. ==>: Copying from the source to the target. <==: Copying from the target to the source.
Target	Displays the logical volume for the copy destination.
SID(RSID)	Displays the Session ID of the ETERNUS Disk storage system (i.e. the Disk Array Name) and the Session ID of the Remote ETERNUS Disk storage system (i.e. the Remote Disk Array Name).
EC Status	Displays the execution status of the EC. EC Starting: The EC is starting up. EC Executing: The EC is executing. EC Suspend: The EC is suspended EC action not startup: The specified session does not exist. EC Error Suspend: An error has occurred, preventing the copy process from continuing. EC Hardware Suspend: The EC has paused because of a hardware error, such as a problem with the path between hardware devices. EC Hardware Suspend(Use REC DISK): REC DISK buffer is in use due to a path error between hardware devices.
Copy Phase	Displays the current phase. Copying: Copy processing is executing. Paired: The copy is in an equivalency maintenance state. Not set: Either the specified session does not exist, or the copy process is not running.
Copied Block	Displays the number of blocks that have been copied.
Rcv	Displays the recovery mode for REC copies. auto: Indicates that the recovery mode is "Automatic". manual: Indicates that the recovery mode is "Manual". ----: Indicates that a REC copy is not being performed.
Split	Displays the split mode for REC copies. auto: Indicates that the split mode is "Automatic". manual: Indicates that the split mode is "Manual". ----: Indicates that either a REC copy is not being performed or that the mode is not synchronous mode.
Xfer	Displays the transfer mode for REC copies. sync: Indicates that the transfer mode is "synchronous". through: Indicates that the transfer mode is "through". consist: Indicates that the transfer mode is "consistency". stack: Indicates that the transfer mode is "stack". ----: a REC copy is not being performed.

When the -progress option is specified:

> acec query -g RECGroup -progress

Copy Group Name        : RECGroup
Copy Group Type        : REC
Disk Array Name        : DX90P (00ETERNUSDXL##ET09E24AG###NP4310901018##)
Remote Disk Array Name : DX90S (00ETERNUSDXL##ET09E24AG###NP4310901019##)

Source    <=> Target    Progress Copied Block Total Block
--------- --- --------- -------- ------------ -----------
DX90P/0x1 N/A DX90S/0x6      N/A          N/A         N/A
DX90P/0x2 ==> DX90S/0x7      45%       471859     1048576
DX90P/0x3 ==> DX90S/0x8     100%      1048576     1048576

The following table shows the meanings of the information displayed.

Title	Explanation
Copy Group Name	Displays the copy group name.
Copy Group Type	Displays the type of copy that has been set up for the copy group.
Disk Array Name	Displays the Box ID and ETERNUS name that was specified with the "-a" option of acgroup create (Command for creating copy groups).
Remote Disk Array Name	Displays the Box ID and ETERNUS name that was specified with the "-remote" option of acgroup create (Command for creating copy groups).
Source	Displays the logical volume for the copy source.
<=>	Displays the copy direction. N/A: No copying is performed ==>: Copying from the source to the target <==: Copying from the target to the source
Target	Displays the logical volume for the copy destination.
Progress	Displays the progress of copy processes as a percentage. The "N/A" is displayed when the copy process is not executed. If the progress of copy process is unclear, "???" is displayed.
Copied Block	Displays the number of blocks that have been copied. The "N/A" is displayed when the copy process is not executed. If the number of copied blocks is unclear, "???" is displayed.
Total Block	Displays the number of total blocks. If the entire copy block size is unclear, "???" is displayed.

NOTES

Information such as Copy direction data and SID data may be displayed as "???".
It is possible that the access path is incorrect. Therefore, check it using acarray detail (Command for displaying detailed information about ETERNUS Disk storage systems).
For details on how to correctly set the access path, refer to "6.4.1.1 Access Path Settings".
If the copy type of a copy group is OPC, QuickOPC or SnapOPCP, this command ends abnormally.