4.6.5 acsnap query (SnapOPC+ Copy Status Display Command)

NAME

acsnap query - Display the copy status of SnapOPC+

SYNOPSIS

acsnap query -g copyGroup [-p copyPair] [-r] [-date] [-xml]
acsnap query -g copyGroup [-p copyPair] [-r] -all [-xml]
acsnap query -estimate -v volumeName [-xml]

DESCRIPTION

This command displays the copy status of the SnapOPC+ for the specified copy group or copy pair.
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.)

If the -estimate option is specified, the update amount after the monitor session has started is displayed.

OPTIONS

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

-p copyPair: This option specifies a copy pair.
When specifying with the LU to Partition format or the Partition to LU format, you must enclose the entire argument for this option within double quotations (") depending on the shell being used.

-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.
Refer to the table of EXAMPLES for the displayed items.

-estimate: Specify this option when referencing the update amount.

-v volumeName

Specify a logical volume when referencing the update amount.
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.

When specifying the extent start position and the extent size, you must enclose the entire argument for this option within double quotations (") depending on the shell being used.

-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 the -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 the -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.5 When -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 the -a option for the acgroup create 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 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) Snap Deleting: SnapOPC+ processing is being stopped (snap generation is being deleted) 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 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. The information is only displayed when the -r option is specified. Not set: No copy process is executed. Copying: Copy is in process.
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".
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.
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.6 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 the -a option for the acgroup create 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 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) Snap Deleting: SnapOPC+ processing is being stopped (snap generation is being deleted) 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 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. The information is only displayed when the -r option is specified. Not set: No copy process is executed. Copying: Copy is in process.
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".
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.
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 column displays "Snap Error Suspend") State transitions to error suspend (OPC Status column displays "OPC Error Suspend") If any of the following conditions apply, the date is 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 S2)

Referencing the update amount
```
> acsnap query -estimate -v ET001/0x1
Update
------
   10M
```
The following table shows the meanings of the information displayed.
Title
Explanation
Update
Displays the update amount after monitor session is started. The displayed unit is megabyte.

Title	Explanation
Update	Displays the update amount after monitor session is started. The displayed unit is megabyte.

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.