VMS Help  —  Lexicals  F$GETDVI  Examples
    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.
Close Help