HP P9000 RAID Manager Reference Guide (T1610-96037, October 2011)

DescriptionOption
Specifies a group name defined in the configuration definition file. The command is executed for
the specified group unless the -d <pair Vol> option is specified.
-g <group>
Specifies paired logical volume name defined in the configuration definition file. When this option
is specified, the command is executed for the specified paired logical volume.
-d <pair Vol>
Searches a group on the configuration definition file (local instance) for the specified raw_device.
If the specified raw_device is found, the command is executed on the paired logical volume (-d) or
-d[g]
<raw_device>
[MU#] group (-dg). This option is effective without specification of “-g <group>” option. If the specified the
raw_device is contained in two or more groups, the command is executed on the first group.
Searches a group on the configuration definition file (local instance) for the specified LDEV, and if
the specified LDEV is contained in the group, the command is executed on the paired logical volume
-d[g] <seq#>
<LDEV#> [MU#]
(-d) or group (-dg). This option is effective without specification of “-g <group>” option. If the specified
LDEV is contained in two or more groups, the command is executed on the first group. The <seq
#> <LDEV #> values can be specified in hexadecimal (by addition of “0x “) or decimal.
Specifies the sequence # of MCU P-VOL, called the Q-marker. If the application gets Q-marker as
the result of execution of pairsyncwait because of timeout or “-nowait”, the application can reconfirm
-m <marker>
the completion of Async transfer by using pairsysncwait with Q-marker. If the application does not
specify Q-marker, RAID Manager uses the latest sequence # when RAID Manager receives
pairsysncwait. It is also possible to wait for the completion from S-VOL side with this option.
Q-Marker format: = iissssssss, where ii = incarnation # of pair volume, and ssssssss = P-VOL serial
#.
Specifies the timeout value to wait for the completion of RCU DFW area. The unit is 100 ms. MCU
gets the latest sequence # from RCU at regular interval.
-t <timeout>
Gets the latest sequence # of MCU PVol and CTGID without waiting. When this option is specified,
the latest sequence # of MCU PVol is reported immediately, and -t <timeout>option is ignored.
-nowait
Suppresses messages to be displayed when this command is executed from a user program. This
option must be specified at the beginning of the command arguments.
-nomsg
Displays the number of remaining Q-Markers within the CT group by adding “QM-Cnt” to the last
column. “QM-Cnt” is shown as follows:
• When specifying “-nowait -fq”:
“QM-Cnt” is shown as the number of remaining Q-Marker at this time within CT group.
• When specifying “-nowait -m <marker> -fq”:
“QM-Cnt” is shown as the number of remaining Q-Marker from the specified <marker> within
CT group.
• When specifying “TIMEOUT” without “-nowait”:
“QM-Cnt” is shown as the number of remaining Q-Marker at this timeout within CT group.
“QM-Cnt” is shown as “-”, if the status for Q-Marker is invalid (i.e., status is “BROKEN” or
“CHANGED”).
Example:
-fq
# pairsyncwait -g oradb -nowait -fq
UnitID CTGID Q-Marker Status Q-Num QM-Cnt
0 3 01003408ef NOWAIT 2 120
# pairsyncwait -g oradb -nowait -m 01003408e0 -fq
UnitID CTGID Q-Marker Status Q-Num QM-Cnt
0 3 01003408e0 NOWAIT 2 105
# pairsyncwait -g oradb -t 50 -fq
UnitID CTGID Q-Marker Status Q-Num QM-Cnt
0 3 01003408ef TIMEOUT 2 5
Specified <group> volume must be PVol with status PAIR. Other cases reply with error (EX_INVVOL).
It is possible to issue pairsysncwait from S-VOL side with -m <marker>.
Restriction
pairsyncwait 95