1.$ ERR = F$GETDVI("_DQA0","ERRCNT")
$ SHOW SYMBOL ERR
ERR = 0 Hex = 00000000 Octal = 000000
This example shows how to use the F$GETDVI function to return
an error count for the device DQA0. You must place quotation
marks (" ") around the device name DQA0 and the item ERRCNT
because they are string literals.
2.$ LIBRARY/EXTRACT=$DCDEF/OUTPUT=$DCDEF.TXT SYS$LIBRARY:STARLET.MLB
This example shows how to create a file, $DCDEF.TXT, containing
a list of values for device types and device classes from
the STARLET library. The device classes begin with 'DC$', and
device types begin with 'DT$'.
Note that most modern SCSI disks and tapes return the generic
DEVTYPE code (DT$_GENERIC_DK or DT$_GENERIC_MK), therefore you
should use the DEVICE_TYPE_NAME item:
$ X=F$GETDVI("XDELTA$DKA0:","DEVICE_TYPE_NAME")
$ SHOW SYMBOL X
X = "RZ29B"
3.$ WRITE SYS$OUTPUT F$GETDVI ( "$1$DGA30", "PATH_SWITCH_TO_TIME", -
_$ "PGA0.5000-1FE1-0001=5782" )
19-MAY-2006 14:47:41.77
This example shows the use of the optional path name parameter
for F$GETDVI. If a path is not specified, information for the
multipath current path is returned. To determine the paths for
a multipath device, use the F$MULTIPATH lexical function.
4.$ SSD_USAGE_REMAINING = F$GETDVI("DKA100:","SSD_USAGE_REMAINING")
$ SHOW SYMBOL SSD_USAGE_REMAINING
SSD_USAGE_REMAINING = 100 Hex = 00000064 Octal = 00000000144
$ SSD_LIFE_REMAINING = F$GETDVI("DKA100:","SSD_LIFE_REMAINING")
$ SHOW SYMBOL SSD_LIFE_REMAINING
SSD_LIFE_REMAINING = 610372 Hex = 00095044 Octal = 00002250104
This example shows how to use the F$GETDVI function to return the
wear out gas gauge data for the Solid State Drive (SSD) connected
to a node in the Host Bus Adapters (HBA) mode and returns "-1" for
other disks.
SSD_USAGE_REMAINING - Reports in percentage the remaining life
of SSD available for use.
SSD_LIFE_REMAINING - Estimates the remaining life, in days, of
the SSD drive based on its percent usage
remaining.
Note: The return value of SSD_USAGE_REMAINING "0" indicates that
the device is worn out; it cannot accept any more writes and requires
replacement. The estimated wear out information is based on the
workload the device is running and the calculation is based on the
endurance usage reported by VSI SSD drives.