HELPLIB.HLB  —  ANALYZE  /MEDIA  Qualifiers

1    /BAD_BLOCKS

  /BAD_BLOCKS[=LIST]

   Adds the specified bad blocks to the detected bad block file
   (DBBF). If the /BAD_BLOCK qualifier is specified along with the
   /EXERCISE qualifier, the medium is tested once the bad blocks are
   added to the DBBF.

   If you do not specify a value for the /BAD_BLOCK qualifier, you are
   prompted as follows:

        BAD_BLOCKS =

   In prompt mode, BAD reports any duplicate bad blocks.

   Qualifier Value

   List

        Specifies the bad block locations to be added to the DBBF. Valid
        codes for specifying bad block locations are:

        Code                  Meaning

        LBN                   Specifies the logical block number (LBN)
                              of a single bad block.

        LBN:count             Specifies a range of contiguous bad blocks
                              starting at the logical block number (LBN)
                              and continuing for "count" blocks.

        SEC.TRK.CYL           Specifies the physical disk address (sector,
                              track, and cylinder) of a single bad
                              sector. This code is valid only for last
                              track devices.

        SEC.TRK.CYL:count     Specifies a range of bad sectors starting
                              at the specified physical disk address
                              (sector, track, and cylinder) and
                              continuing for "count" sectors. This code
                              is valid only for last track devices.

                              You can specify these formats in any
                              integer combination or radix combination.

                                   Note

           The term "block" denotes a standard unit of 512
           bytes, whereas the term "sector" denotes the
           physical size of the device sector, which is not
           always the same for all devices. For example, an
           RL02 has a sector size of 256 bytes, while an RK07
           has a standard sector size of 512 bytes.

2    /EXERCISE

  /EXERCISE=(FULL,[NO]KEEP,PATTERN)
  /NOEXERCISE (default)

   Controls whether the media should actually be tested. You can
   update the DBBF without erasing the contents of the volume by
   using the /NOEXERCISE qualifier along with the /BAD_BLOCKS
   qualifier.

   Qualifier Keywords

   FULL

        Causes BAD to test the media using three test patterns (0s,
        1s, and "worst case") instead of the default single "worst
        case" pattern. The FULL keyword can be used only with
        /EXERCISE.  Note that the "worst case" test pattern always
        remains on media tested with the /EXERCISE qualifier.

   KEEP

        Ensures the preservation of the current software detected bad
        block file (SDBBF). The keep keyword is the default when
        /NOEXERCISE is specified.

   NOKEEP

        Causes BAD to create a new SDBBF. The NOKEEP keyword is the
        default when /EXERCISE is specified. This keyword cannot be
        used with the /NOEXERCISE qualifier.

   PATTERN=(value[,...])

        Allows users to specify the value of a test pattern to be
        used as "worst case". Up to an octaword of test pattern
        data may be specified in decimal (%D), hexadecimal (%X),
        or octal (%O) radixes. The default radix is decimal.

        The pattern is specified in longwords. If two or more
        longwords are specified, they must be enclosed in
        parentheses and separated by commas.

3    /LOG

  /LOG
  /NOLOG (default)

   Specifies whether a message is sent to the current SYS$OUTPUT
   device and SYS$ERROR, indicating the total number of bad blocks
   detected by BAD.

4    /OUTPUT

  /OUTPUT[=filespec]

   Specifies whether the contents of the DBBF are written to the
   specified file.  If you omit the /OUTPUT qualifier, no output
   is generated.

   If you specify /OUTPUT but omit the filespec, the contents of
   the DBBF are written to the current SYS$OUTPUT device.

   When you specify /OUTPUT, the /SHOW=AFTER qualifier is implied.

   Qualifier Value

   filespec

        Identifies the output file for storing the results of the
        medium analysis. If you specify a file type and omit the
        file name, the default file name ANALYZE is used. The default
        file type is ANL. If you omit the filespec, the results are
        output to the current SYS$OUTPUT device.

        No wildcard characters are allowed in the file specification.

5    /RETRY

  /RETRY
  /NORETRY (default)

   Enables the device driver to retry soft errors.

6    /SHOW

  /SHOW[=(keyword[,...])]

   Lists the contents of the DBBF before or after (or both) the
   medium is exercised or modified.

   Qualifier Keywords

   [NO]BEFORE,[NO]AFTER

       Specifies whether the contents of the DBBF are listed before or
       after (or both) the medium is exercised. After is the default.
Close Help