D.1.22 acopc query (Command for displaying the status of OPC or QuickOPC copy)

NAME

acopc query - Display of the status of OPC or QuickOPC copy.

SYNOPSIS

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

DESCRIPTION

This command displays the status of OPC or QuickOPC copy for a specified copy group.

OPTIONS

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

-p PAIR: This option specifies a copy pair.

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

-progress: Displays the progress of copy processes.

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

EXIT STATUS

=0: Terminate normally

>0: Terminate abnormally

EXAMPLES

For OPC

When the -progress option is not specified:

> acopc query -g Group01

Copy Group Name : Group01
Copy Group Type : OPC
Disk Array Name : DX80 (00ETERNUSDXL##ET08E21A####LN4310901078##)

Source    <=> Target    SID  OPC Status      Copy Phase Copied Block
--------- --- --------- ---- --------------- ---------- ------------
DX80/0x1  ==> DX80/0x3 0x21  "OPC Executing" "Copying"             0
DX80/0x2  ==> DX80/0x4 0x22  "OPC Executing" "Copying"       1048576

When the -progress option is specified:

> acopc query -g Group01 -progress

Copy Group Name : Group01
Copy Group Type : OPC
Disk Array Name : DX80 (00ETERNUSDXL##ET08E21A####LN4310901078##)

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

For QuickOPC

When the -progress option is not specified:

> acopc query -g Group01

Copy Group Name : Group01
Copy Group Type : QuickOPC
Disk Array Name : DX80 (00ETERNUSDXL##ET08E21A####LN4310901078##)

Source    <=> Target    SID  OPC Status      Copy Phase Copied Block
--------- --- --------- ---- --------------- ---------- ------------
DX80/0x1  ==> DX80/0x3 0x21  "OPC Executing" "Tracking"      1048576
DX80/0x2  ==> DX80/0x4 0x22  "OPC Executing" "Tracking"      1048576

When the -progress option is specified:

> acopc query -g Group01 -progress

Copy Group Name : Group01
Copy Group Type : QuickOPC
Disk Array Name : DX80 (00ETERNUSDXL##ET08E21A####LN4310901078##)

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

The following table shows the meanings of the information displayed.

Table D.10 When the -progress option is not specified
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 the ETERNUS name that was specified with 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.
SID	Displays the session ID for the copy source.
OPC Status	Displays the execution status of the OPC. OPC Starting: The OPC is starting up. OPC Executing: The OPC is executing. OPC action not startup: The specified session does not exist. OPC Error Suspend: An error has occurred, preventing the copy process from continuing.
Copy Phase	Displays the current phase. Copying: Copy processing is executing. Tracking: Copy processing has completed, and tracking is in progress. Copying/Tracking: Both copy processing and tracking are in progress. Not set: Copy processing has not been performed.
Copied Block	Displays the number of blocks that have been copied.

Table D.11 When the -progress option is specified
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 the ETERNUS name that was specified with 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.
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 EC, REC or SnapOPCP, this command ends abnormally.