4.7.5 acsnap query (SnapOPC+ copy status display command)

NAME

acsnap query - Display the copy status of SnapOPC+

SYNOPSIS

acsnap query -g COPY-GROUP [-p PAIR] [-r] [-date] [-xml]
acsnap query -g COPY-GROUP [-p PAIR] [-r] -all [-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.
If the -estimate option is specified, the number of updated blocks for the copy destination volume is displayed.
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.)

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.

-date: This option displays the last execution date of SnapOPC+ for the copy pair.

-all: This option specifies the displaying by the extended format.
For the displayed items, refer to the table of EXAMPLES.

-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

The extent start position and the extent size can be specified.

(1) ETERNUS name
(2) Logical volume number
(3) Extent start position (block units)
(4) Extent size (number of blocks)

A character string starting with "0x" expresses a hexadecimal value.

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

EXIT STATUS

=0 : Completed successfully
>0 : Terminated abnormally

EXAMPLES

Displaying the SnapOPC+ copy status

When -date option is not specified:

> acsnap query -g group01


Copy Group Name : group01
Copy Group Type : SnapOPCP
Disk Array Name : ET001 (00ETERNUSDXM##ET44S20A####HK000104######)

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

When -date or -all option is specified:

> acsnap query -g Group01 -date


Copy Group Name : Group01
Copy Group Type : SnapOPCP
Disk Array Name : ET001 (00ETERNUSDXM##ET44S20A####HK000104######)
Source    <=> Target    SID  Snap Status               Gen Date     Copied Block Operation Date
--------- --- --------- ---- ------------------------- --- -------- ------------ ---------------------
ET001/0x1 ==> ET001/0x5 0x23 "Copy On Write(Active)"    3  10minute      1048576 "2010/10/19 12:10:00"
ET001/0x1 ==> ET001/0x4 0x22 "Copy On Write(Inactive)"  2  3hour         1048576 "2010/10/19 09:00:00"
ET001/0x1 ==> ET001/0x3 0x21 "Copy On Write(Inactive)"  1  1day          1048576 "2010/10/18 09:00:00"

The following table shows the meanings of the information displayed.

Table 4.16 When the -date 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 -a option for acgroup create (Copy group creation command).
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 -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(Readying): Concurrent OPC is defined. (Latest snap generation) 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 -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. The information is only displayed when -r option is specified. Not set: No copy process is executed. Copying: Copy is in process.
Gen	Displays snap generation numbers. If -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".
Date	Displays the elapsed time of Snapshot type copy execution. If -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.
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 unknown, it is displayed "???".

Table 4.17 When -date 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 -a option for acgroup create (Copy group creation command).
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 -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(Readying): Concurrent OPC is defined. (Latest snap generation) 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 -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. The information is only displayed when -r option is specified. Not set: No copy process is executed. Copying: Copy is in process.
Gen	Displays snap generation numbers. If -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".
Date	Displays the elapsed time of Snapshot type copy execution. If -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.
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 unknown, it is displayed "???".
Operation Date	If an SnapOPC+ session exists, it displays the date for when the SnapOPC+ 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 acsnap start) State transitions to error suspend (Snap Status field displays "Snap Error Suspend") State transitions to error suspend (OPC Status field 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 field displays "OPC action not startup") If the OPC session's copy status could not be acquired from the device (OPC Status field displays "???") If using a device for which the last execution date recording function is not supported (ETERNUS DX60/DX60 S2/DX80/DX90, ETERNUS DX400 series, ETERNUS DX8000 series, ETERNUS2000, ETERNUS4000, ETERNUS8000)

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

When the copy type of copy group is OPC, QuickOPC, EC or REC, 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.
This command is not available for ETERNUS Disk storage system registered as a remote device.