Availability:
     Level 2    , 'J'

  Quick Help:
     Particle Sweep, J[ Start Cyl ],[ End Cyl ],[ Duration mSec ],[ Dwell mSec ],[ JIT mode ]

  Description:
    This command performs the particle sweep operation. To perform particle sweep, a seek
    length is calculated to satisfy the conditions imposed by the input parameters. Seeks of
    this length are repeatedly issued to move the head from the Start Cylinder towards the
    End Cylinder, while pausing the specified dwell time between each successive seek. All
    seeks will be done using head 0, and will be of equal length, time, and dwell. The time
    needed to complete the particle sweep will be approximately equal to the time specified
    by the Duration parameter.
    
  Input Parameters:

    
    0 - Start Cylinder.
    
        This parameter is the cylinder from which the particle sweep will begin.
        Notes:
          1) if Start Cylinder and End Cylinder are the same, then the particle sweep range
          will default to the drive's Max and Min cylinders respectively.
          2) Start Cylinder may be greater than or less than End Cylinder.
    
          Type:    Unsigned 32-bit value
    
          Range:   0 to Maximum Cylinder
    
          Default: 0
    
    1 - End Cylinder.
    
        This parameter is the cylinder on which the particle sweep will end.
        Notes:
          1) if Start Cylinder and End Cylinder are the same, then the particle sweep range
          will default to the drive's Max and Min cylinders respectively.
          2) End Cylinder may be greater than or less than Start Cylinder.
    
          Type:    Unsigned 32-bit value
    
          Range:   0 to Maximum Cylinder
    
          Default: 0
    
    2 - Duration.
    
        This parameter specifies the time in milliseconds that the particle sweep
        will use to move from the Start Cylinder to the End Cylinder including the
        Dwell time.
    
          Type:    Unsigned 32-bit value
    
          Range:   0 to 0xFFFFFFFF
    
          Default: 5000 mSec
    
    3 - Dwell Time In Milliseconds.
          
        This parameter specifies the amount of time in milliseconds for the head to
        remain on track before the next seek is issued.
          
          Type:    Unsigned 32-bit value
    
          Range:   0 to 0xFFFFFFFF
    
          Default: 1 Rev Time In mSec
    
    4 - Servo Seek Speed (JIT mode).
    
        This parameter specifies one of the servo JIT modes, which controls how fast the
        actuator can move from cylinder to cylinder.
        Note: if a JIT mode is requested that is slower than supported, then the
        slowest supported JIT mode will be used.
    

          0x00: RW_SEEK_SPEED_0 - Indicates normal seeks should be executed.
          0x01: RW_SEEK_SPEED_1 - If supported, indicates JIT1 seeks should be executed.
          0x02: RW_SEEK_SPEED_2 - If supported, indicates JIT2 seeks should be executed.
          0x03: RW_SEEK_SPEED_3 - If supported, indicates JIT3 seeks should be executed.
    
          Type:    Unsigned 8-bit value
    
          Range:   0 to 0xFF
    
          Default: Slowest JIT mode
    
  Output Data:


    If an error occurred, the following information will be displayed.
    
          "DiagError aaaaaaaa"
    
       where
    
          aaaaaaaa is the Diagnostic Error Code
    
    If an error occurred, then the following will be displayed:
    
          DiagError aaaaaaaa
       
          where
          
             aaaaaaaa is the diagnostic error code detected
    
    If R/W status information is available upon completion of the diagnostic,
    then the following will be displayed:
    
          "Particle Sweep"
          "R/W Status c, R/W Error dddddddd
    
          where
    
             c is the status that was returned by the R/W subsystem
    
             dddddddd is the error code that was returned by the R/W subsystem
    
  Examples:
 
    Example #1:
    To do a particle sweep using the default conditions, i.e. Start Cylinder = Max Cylinder,
    End Cylinder = Min Cylinder, 5-second duration, 1-rev dwell, and slowest JIT mode:
       
       F3 2>J
 
    Example #2:
    To do a particle sweep using Start Cylinder = 10, End Cylinder = 1000, 6-second
    duration, 200 mSec dwell, and slowest JIT mode:

       F3 >J10,1000,1770,C8
 
    Example #3:
    Error handling of an invalid cylinder entry:
 
       F3 2>Jfffffff
 
       DiagError   00003013
 
  Revision History:

    0001.0000   Initial revision.