home *** CD-ROM | disk | FTP | other *** search
/ rtsi.com / 2014.01.www.rtsi.com.tar / www.rtsi.com / OS9 / OSK / CMDS / dmode_25.lhz / Dmode.doc < prev    next >
Text File  |  2005-10-13  |  3KB  |  60 lines
  1. DMODE      - Manipulate RBF device parameters on the options area of a 
  2.             device descriptor.
  3.  
  4. Syntax    : dmode <RBF descriptor> [<RBF parameter list>]
  5. Function  : Change RBF device parameters in a descriptor
  6.             The device is detached, changed, and re-attached
  7.             If it isn't in use this should re-initialise it.
  8. Parameters:
  9.      drv      = Drive number               stp      = Step rate             
  10.      typ(hex) = Device type                dns(hex) = Media density         
  11.      cyl      = Number of cylinders        sid      = Number of sides       
  12.      vfy(hex) = Verify disk writes         sct      = Sectors per track     
  13.      tos      = Sectors on track 0         sas      = Segment allocation    
  14.      ilv      = Interleave factor          tof      = Track base offset     
  15.      sof      = Sector base offset         siz      = Sector size (bytes)   
  16.      ctl(hex) = Control word               try      = Retry count           
  17.      prk      = Hard disk park cyl         lsn      = Logical sector offset 
  18.      tot      = Total cylinders            rts(hex) = Rpm, xfr rate         
  19.      xfr      = Maximum transfer      
  20.  
  21. Execution:
  22.     This program has no options.  It is the RBF equivalent of XMODE for SCF 
  23.     devices.  If it is run with just a device name specified it will report 
  24.     the current parameter settings in the descriptor:
  25.  
  26.         dmode /dd
  27.  
  28.     Parameters which assign specific meanings to particular bits or values
  29.     are reported in hex and the meaning of the current setting is displayed.
  30.  
  31.     Parameters in an RBF descriptor may be reset by specifying them on the
  32.     command line in the form key=n, key=0xh or key=$h. NOTE: if you're using
  33.     the EFFO shell you'll need to escape the dollar sign, so a hex parameter
  34.     should be input as key=0xhh or key=\$hh. Parameters shown in decimal
  35.     must be set in decimal; those shown in hex (and flagged (hex) in a help
  36.     display) must be set in hex:
  37.  
  38.         dmode /d1 stp=3 vfy=$01
  39.  
  40.     sets the step rate to 3 and turns disk verify after write off.  See the
  41.     OS9 technical manual for the meanings of any parameters you don't 
  42.     understand.
  43.  
  44.     When parameters are set the descriptor's module CRC is reset.  dmode is
  45.     an easy way to create new descriptors from an existing one provided that
  46.     the new descriptor is to use the original device driver and RBF file 
  47.     manager.  It is intended to ease the task of reading an unknown disk 
  48.     format, especially in conjunction with LABEL, which can report the
  49.     options with which a disk was formatted provided that LSN 0 can be read
  50.     with an existing descriptor.
  51.  
  52.     Dmode detaches the device once, modifies it, and re-attaches it. If
  53.     the device is not already in use this will force it to be
  54.     re-initialised. The effect is similar to the command sequence:
  55.  
  56.         deiniz /dev; moded dev; load dev; iniz /dev
  57.  
  58.     except that the changes are only applied to the copy of the descriptor
  59.     that is RAM resident.
  60.