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.