C.1.22 acsnap query (Status display command for snapshot type Advanced Copy)

NAME

acsnap query - Displays the status of snapshot type Advanced 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

Snapshot type copy statuses of a specified copy group or pair are displayed.

It is also possible to refer to the estimation of the amount of snap data volume updates for the copy-source volume.

OPTIONS

-g COPY-GROUP

This option specifies the copy group name.
Only when the type of a copy group is as follows, the copy group is specifiable.

SnapOPCP

-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: 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 name
(2) Logical volume number

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

EXIT STATUS

=0: Completed successfully

>0: Terminated 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. * If the -r option is not specified, no information is displayed here. 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 not 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 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".

[When referring 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 the acarray detail (Command for displaying detailed information about ETERNUS storage systems).
For details on how to correctly set the access path, refer to "6.4.1.2 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 a remote device.
Copy-source logical volumes and snap generation numbers are sorted to be displayed. (However, a pair that has no session is displayed at the bottom of the sort column.)