A.6.5 acsnap query (SnapOPC+ copy status display command) [Windows version only]

NAME

acsnap query - Display the copy status of SnapOPC+

SYNOPSIS

acsnap query -g COPY-GROUP [-p PAIR] [-r][-xml]
acsnap query -estimate -v VOLUME-NAME [-xml]

DESCRIPTION

This command displays the copy status of the SnapOPC+ for the specified copy group or copy pair.
It is also possible to refer to the estimation of the amount of snap data volume updates for the copy-source volume.

The copy-source logical volume and snap generation number are sorted and displayed. (However, a copy pair that has no session is displayed at the bottom of the sort column.)

This command is only supported in Windows version.

OPTIONS

-g COPY-GROUP: This option specifies the 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 displays 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.
This option is only supported in Windows version.

EXIT STATUS

=0 : Completed successfully
>0 : Terminated abnormally

EXAMPLES

Displaying the SnapOPC+ copy status

> acsnap query -g group01


Copy Group Name : group01
Copy Group Type : SnapOPCP
Disk Array Name : E4000 (00E4000M3#####E450S20A####KD4030639004##)

Source    <=> Target    SID  Snap Status                Gen Date     Copied Block
--------- --- --------- ---- ------------------------- ------------- ------------
E4000/0x1 ==> E4000/0x5 0x23 "Copy On Write(Active)"    3   10minute      1048576
E4000/0x1 ==> E4000/0x4 0x22 "Copy On Write(Inactive)"  2   3hour         1048576
E4000/0x1 ==> E4000/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 the SnapOPC+ execution status. If the -r option is specified, no information is displayed. Snap action not startup: No specified session exists. Snap Starting: SnapOPC+ is starting. (The starting process of SnapOPC+ logical copy is in progress) Copy On Write(Active): SnapOPC+ is in process. (Latest snap generation) Copy On Write(Inactive): SnapOPC+ is in process. (Past snap generations) Snap Error Suspend: Error that cannot continue copy process occurred.
OPC Status	Displays OPC executed status. The information is only displayed when the -r option is specified. 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. 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. The output format is as follows. N/A: No copy process is executed. Less than 1H: Displayed on a per minute basis. If below one minute, it is displayed as "0minute". Less than 24H: Displayed on a per hour basis. 24H or more: Displayed on a per day basis.
Gen	Displays snap generation numbers. If the -r option is specified, no information is displayed. 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".

Referring the estimation of the amount of snap data volume updates
```
> acsnap query -estimate -v E4000/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.

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 "A.2.4 acarray detail (ETERNUS disk storage systems detail information display command)". If the access path is incorrect, set the correct access path by referring the "2.2.4 Access Path Settings".
This command is not available for ETERNUS disk storage systems registered as a remote device.