4.6.2 acopc query (OPC/QuickOPC Copy Status Display Command)

NAME

acopc query - Display the copy status of OPC or QuickOPC

SYNOPSIS

acopc query -g copyGroup [-p copyPair] [-r] [-progress] [-date] [-xml]
acopc query -g copyGroup [-p copyPair] [-r] -all [-xml]

DESCRIPTION

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

OPTIONS

-g copyGroup: This option specifies the copy group name.

-p copyPair: 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: This option displays the progress of copy processes.

-date: This option displays the last execution date of OPC or QuickOPC for the copy pair.

-all: This option specifies the displaying by the extended format.
Refer to the table of EXAMPLES for the displayed items.

-xml: This option specifies when displaying by the XML format.

EXIT STATUS

=0: Completed successfully
>0: Terminated abnormally

EXAMPLES

For OPC

When the -progress and -date options are not specified:

> acopc query -g Group01

Copy Group Name : Group01
Copy Group Type : OPC
Disk Array Name : ET001 (00ETERNUSDXM##ET44S20A####HK000104######)

Source    <=> Target    SID  OPC Status      Copy Phase Copied Block
--------- --- --------- ---- --------------- ---------- ------------
ET001/0x1 ==> ET001/0x3 0x21 "OPC Executing" "Copying"             0
ET001/0x2 ==> ET001/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 : ET001 (00ETERNUSDXM##ET44S20A####HK000104######)

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

When the -date option is specified:

> acopc query -g Group01 -date

Copy Group Name : Group01
Copy Group Type : OPC
Disk Array Name : ET001 (00ETERNUSDXM##ET44S20A####HK000104######)

Source    <=> Target    SID  OPC Status      Copy Phase Copied Block Operation Date
--------- --- --------- ---- --------------- ---------- ------------ ---------------------
ET001/0x1 ==> ET001/0x3 0x21 "OPC Executing" "Copying"             0 "2010/10/20 09:00:00"
ET001/0x2 ==> ET001/0x4 0x22 "OPC Executing" "Copying"       1048576 "2010/10/20 09:00:00"

When the -progress and -date options are specified, or the -all option is specified:

> acopc query -g Group01 -progress -date

Copy Group Name : Group01
Copy Group Type : OPC
Disk Array Name : ET001 (00ETERNUSDXM##ET44S20A####HK000104######)

Source    <=> Target    SID  OPC Status      Copy Phase Progress Copied Block Total Block Operation Date
--------- --- --------- ---- --------------- ---------- -------- ------------ ----------- ---------------------
ET001/0x1 ==> ET001/0x3 0x21 "OPC Executing" "Copying"        0%            0     1048576 "2010/10/20 09:00:00"
ET001/0x2 ==> ET001/0x4 0x22 "OPC Executing" "Copying"       45%      1048576     2330168 "2010/10/20 09:00:00"

For QuickOPC

When the -progress and -date options are not specified:

> acopc query -g Group01

Copy Group Name : Group01
Copy Group Type : QuickOPC
Disk Array Name : ET001 (00ETERNUSDXM##ET44S20A####HK000104######)

Source    <=> Target    SID  OPC Status      Copy Phase Copied Block
--------- --- --------- ---- --------------- ---------- ------------
ET001/0x1 ==> ET001/0x3 0x21 "OPC Executing" "Tracking"      1048576
ET001/0x2 ==> ET001/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 : ET001 (00ETERNUSDXM##ET44S20A####HK000104######)

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

When the -date option is specified:

> acopc query -g Group01 -date

Copy Group Name : Group01
Copy Group Type : QuickOPC
Disk Array Name : ET001 (00ETERNUSDXM##ET44S20A####HK000104######)

Source    <=> Target    SID  OPC Status      Copy Phase         Copied Block Operation Date
--------- --- --------- ---- --------------- ------------------ ------------ ---------------------
ET001/0x1 ==> ET001/0x3 0x21 "OPC Executing" "Copying/Tracking"            0 "2010/10/20 09:00:00"
ET001/0x2 ==> ET001/0x4 0x22 "OPC Executing" "Copying/Tracking"      1048576 "2010/10/20 09:00:00"

When the -progress and -date options are specified, or the -all option is specified:

> acopc query -g Group01 -progress -date

Copy Group Name : Group01
Copy Group Type : QuickOPC
Disk Array Name : ET001 (00ETERNUSDXM##ET44S20A####HK000104######)

Source    <=> Target    SID  OPC Status      Copy Phase         Progress Copied Block Total Block Operation Date
--------- --- --------- ---- --------------- ------------------ -------- ------------ ----------- ---------------------
ET001/0x1 ==> ET001/0x3 0x21 "OPC Executing" "Copying/Tracking"       0%            0     1048576 "2010/10/20 09:00:00"
ET001/0x2 ==> ET001/0x4 0x22 "OPC Executing" "Copying/Tracking"      45%      1048576     2330168 "2010/10/20 09:00:00"

The following table shows the meanings of the information displayed.

Table 4.1 When -progress and -date Options Are 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 for the acgroup create command.
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. Readying: Concurrent OPC is defined. 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. If the copy process finishes and is in Tracking status, it displays the number of blocks that have not been updated since after the last execution of the logical copy. The "N/A" is displayed when the copy process is not executed. If the number of copied blocks is unknown, it is displayed "???".

Table 4.2 When -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 for the acgroup create command.
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 processes is unknown, it is displayed "???".
Copied Block	Displays the number of blocks that have been copied. If the copy process finishes and is in Tracking status, it displays the number of blocks that have not been updated since after the last execution of the logical copy. The "N/A" is displayed when the copy process is not executed. If the number of copied blocks is unknown, it is displayed "???".
Total Block	Displays the number of total blocks. If the number of total blocks is unknown, it is displayed "???".

Table 4.3 When -date 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 for the acgroup create command.
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. Readying: Concurrent OPC is defined. 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. If the copy process finishes and is in Tracking status, it displays the number of blocks that have not been updated since after the last execution of the logical copy. The "N/A" is displayed when the copy process is not executed. If the number of copied blocks is unknown, it is displayed "???".
Operation Date	If an OPC session exists, it displays the date for when the OPC session state transitions indicated below last occurred (last execution date) in a "yyyy/mm/dd hh:mm:ss" format. The displaying of the date is performed on the basis of the target device's time zone. Starting logical copy (execution of acopc start or acopc start -diff) State transitions to error suspend (OPC Status column displays "OPC Error Suspend") If any of the following conditions apply, the date will be displayed as "----/--/-- --:--:--." If an OPC session does not exist (OPC Status column displays "OPC action not startup") If the OPC session's copy status could not be acquired from the device (OPC Status column displays "???") If using a device for which the last execution date recording function is not supported (ETERNUS DX60/DX60 S2/DX80/DX90, DX400 series, DX8000 series)

Table 4.4 When -progress and -date Options Are Specified, or -all 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 for the acgroup create command.
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. Readying: Concurrent OPC is defined. 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.
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 processes is unknown, it is displayed "???".
Copied Block	Displays the number of blocks that have been copied. If the copy process finishes and is in Tracking status, it displays the number of blocks that have not been updated since after the last execution of the logical copy. The "N/A" is displayed when the copy process is not executed. If the number of copied blocks is unknown, it is displayed "???".
Total Block	Displays the number of total blocks. If the number of total blocks is unknown, it is displayed "???".
Operation Date	If an OPC session exists, it displays the date for when the OPC session state transitions indicated below last occurred (last execution date) in a "yyyy/mm/dd hh:mm:ss" format. The displaying of the date is performed on the basis of the target device's time zone. Starting logical copy (execution of acopc start or acopc start -diff) State transitions to error suspend (OPC Status column displays "OPC Error Suspend") If any of the following conditions apply, the date will be displayed as "----/--/-- --:--:--." If an OPC session does not exist (OPC Status column displays "OPC action not startup") If the OPC session's copy status could not be acquired from the device (OPC Status column displays "???") If using a device for which the last execution date recording function is not supported (ETERNUS DX60/DX60 S2/DX80/DX90, DX400 series, DX8000 series)

NOTES

When the copy type of copy group is EC, REC or SnapOPCP, this command cannot be executed.
Information such as Copy direction data and SID data may display as "???". Refer to "5.3 Resolving for Displaying "???" in Advanced Copy Status" and take action.
The copying progress for OPC and QuickOPC may not reach 100% due to such things as data updates to the copy source.
If Copy Phase column is either of the following, the copying is complete.
- Not Set (when the copy type is OPC)
- Tracking (when the copy type is QuickOPC)