D.1.25 acsnap query (Command for displaying the status of SnapOPC+ copy)

NAME

acsnap query - Display of the status of SnapOPC+ copy.

SYNOPSIS

acsnap query -g COPY-GROUP [-p PAIR] [-r] [-xml]

[When referring the estimation of the amount of snap data volume updates:]

acsnap query -estimate -v VOLUME-NAME [-xml]

DESCRIPTION

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

You can also refer to the number of updated blocks generated for the copy-source volume.

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.

-estimate: This option estimates the amount of snap data volume updates.

-v VOLUME-NAME

When referring to the estimation of the amount of snap data volume updates, specify a copy-source logical volume.
The following is an example of a format to specify a logical volume.

(1) ETERNUS Disk storage system name
(2) Logical volume number

In addition, you can specify extent start position and extent size, as well.

(1) ETERNUS Disk storage system name
(2) Logical volume number
(3) Extent start position (per block)
(4) Extent size (number of blocks)

A string starting with "0x" represents a hexadecimal number.

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

EXIT STATUS

=0: Terminate normally

>0: Terminate abnormally

EXAMPLES

C:\>acsnap query -g Group01

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

Source    <=> Target    SID  Snap Status                Gen Date     Copied Block
--------- --- --------- ---- ------------------------- ------------- ------------
DX80/0x1  ==> DX80/0x5  0x23 "Copy On Write(Active)"    3   10minute      1048576
DX80/0x1  ==> DX80/0x4  0x22 "Copy On Write(Inactive)"  2   3hour         1048576
DX80/0x1  ==> DX80/0x3  0x21 "Copy On Write(Inactive)"  1   1day          1048576

The following table shows the meanings of the information displayed.

Title	Explanation
Source	Displays a copy-source logical volume.
<=>	Displays a copy direction. The following information is displayed. N/A: No copy process is executed. ==>: Copy process from source to target. <==: Copy process from target to source.
Target	Displays a copy-destination logical volume.
SID	Displays a copy source session ID.
Snap Status	Displays Snapshot type executed status. Snap execution statuses are as follows. * If the -r option is specified, no information is displayed here. Snap action not startup: No specified session exists. Copy On Write(Active): Snapshot type is in process. (Latest snap generation). Copy On Write(Inactive): Snapshot type is in process. (Past snap generations). Snap Error Suspend: Error that cannot continue copy process occurred.
OPC Status	Displays OPC executed status. OPC execution statuses are as follows. * Only when -r option is specified, this information is displayed. OPC action not startup: No specified session exists. OPC Starting: OPC is being started. (OPC logical copy is in boot process.) OPC Executing: OPC is in process. (OPC logical copy completed, physical copy being in process.) OPC Error Suspend: Error that cannot continue copy process occurred.
Copy Phase	Displays the current phase. * If the -r option is specified, no information is displayed here. No set: No copy process is executed. Copying: Copy is in process.
Date	Displays the elapsed time of Snapshot type copy execution. * If the -r option is specified, no information is displayed here. The output format is as follows. N/A: No copy process is being executed. Less than 1H: Displayed on a per minute basis. Less than 24H: Displayed on a per hour basis. 24H or more: Displayed on a per day basis. * If below one minute, it is displayed as "0minute".
Gen	Displays snap generation numbers. * If the -r option is specified, no information is displayed here. For snap generation numbers, 1 is the oldest and as the number is larger, it shows more new generations. * If no copy process is executed, it is displayed as "N/A".
Copied Block	Displays the number of copied blocks. * If no copy process is executed, it is displayed as "N/A". If the number of copied blocks is unclear, "???" is displayed.

[When referring to the amount of snap data volume updates:]

C:\>acsnap query -estimate -v DX80/0x1
Update
------
   10M

The following table shows the meanings of the information displayed.

Title	Explanation
Update	Displays the amount of snap data volume updates in MB.

NOTES

Information such as Copy direction data and SID data may display as "???". It is possible that the copy-source logical volume size and copy-destination logical volume size are different or the access path is incorrect.
Check the size of their logical volumes. If it is different, register the copy pair that the copy-source logical volume size and copy-destination logical volume size are same.
And, check the access path using D.1.4 acarray detail (Command for displaying detailed information about ETERNUS Disk storage systems)r details on how to correctly set the access path, refer to "6.4.1.1 Access Path Settings".
If the copy group type is OPC, QuickOPC, EC or REC, this command ends abnormally. This command is not available for ETERNUS Disk storage systems registered as remote disk storage system.
Copy-source logical volumes and snap generation numbers are sorted when displayed. (However, a pair that has no session is displayed at the bottom of the sort column.)