The call to $GETDVI has the following format:SYS$GETDVI [efn],[chan],[devnam],itmlst,[iosb],[astadr],[astprm],[nullarg]
For a complete description of the $GETDVI and $GETDVIW services
and their arguments, refer to the HP OpenVMS System Services Reference
Manual.
Table 2 SYS$GETDVI Item Codes
|
Item Code |
Function |
DVI$_SHDW_CATCHUP_COPYING
|
Returns a Boolean longword.
The value 1 indicates that the device is the target of a copy operation.
|
DVI$_SHDW_COPIER_NODE
|
Returns the name of the
node that is actively performing either the copy or the merge operation,
as a string
|
DVI$_SHDW_DEVICE_COUNT
|
Returns the total number
of devices in the virtual unit, including devices being added as
copy targets, as a longword
|
DVI$_SHDW_GENERATION
|
Returns the current, internal
revision number of the virtual unit, as a quadword.
|
DVI$_SHDW_MASTER
|
Returns a Boolean longword.
The value 1 indicates that the device is a virtual unit.
|
DVI$_SHDW_MASTER_MBR
|
Returns the name of the
master member unit that is used for merge and copy repair operations
and for shadow set recovery operations, as a string.
|
DVI$_SHDW_MASTER_NAME
|
When the specified device
is a shadow set member, $GETDVI returns the virtual unit name for
the shadow set of which it is a member.
Because shadow
set device names can include up to 64 characters, the buffer length
field of this item descriptor should specify 64 (bytes).
If
you specify a virtual unit or a device that is not a shadow set
member, $GETDVI returns a null string.
|
DVI$_SHDW_MBR_COPY_DONE
|
Returns the percentage of
the copy operation that is complete on the current member unit,
as a longword.
|
DVI$_SHDW_MBR_COUNT
|
Returns the number of full source
members in the virtual unit, as a longword. Devices added as copy
targets are not full source members.
|
DVI$_SHDW_MBR_MERGE_DONE
|
Returns the percentage of
the merge operation that has been completed on the member, as a
longword.
|
DVI$_SHDW_MBR_READ_COST
|
Returns the current value
set for the member unit, as a longword. This value can be modified
to use a customer-specified value.
|
DVI$_SHDW_MEMBER
|
Returns a Boolean longword.
The value 1 indicates that the device is a shadow set member.
|
DVI$_SHDW_MERGE_COPYING
|
Returns a Boolean longword.
The value 1 indicates that the device is a merge member of the shadow
set.
|
DVI$_SHDW_MINIMERGE_ENABLE
|
Returns a longword interpreted
as a Boolean. A value of TRUE indicates that the virtual unit will
undergo a minimerge, not a full merge, if a system in the cluster
fails.
|
DVI$_SHDW_NEXT_MBR_NAME
|
Returns the device name
of the next member in the shadow set. If you specify a virtual unit,
$GETDVI returns the member device names in the shadow set. If you
specify the name of a device that is neither a virtual unit nor
a shadow set member, $GETDVI returns a null string.
Because
shadow set device names can include up to 64 characters, the buffer
length field of this item descriptor should specify 64 (bytes).
|
DVI$_SHDW_READ_SOURCE
|
Returns the name of the
member unit that is used for reads, at this point in time, as a
longword. DVI$_SHDW_READ_SOURCE uses the unit that has the lowest
value of the sum of its queue length and read cost for reads. This
is a dynamic value.
|
DVI$_SHDW_SITE
|
Returns as a longword the
site value for the specified value. This value is set by the SET
DEVICE or SET SHADOW command.
|
DVI$_SHDW_TIMEOUT
|
Returns the customer-specified timeout
value set for the device, as a long word. If you do not set a value
by way of the SETSHOWSHADOW utility, the SYSGEN parameter SHADOW_MBR_TWO
is used for member units and MVTIMEOUT is used for virtual units.
|