home *** CD-ROM | disk | FTP | other *** search
/ Oakland CPM Archive / oakcpm.iso / sigm / sigmv013.ark / MITSCNVT.DOC < prev    next >
Encoding:
Text File  |  1985-02-10  |  7.1 KB  |  169 lines
  1.     Thi≤ elemen⌠ contain≤ thσ documentatioε fo≥ MITSCNVT.
  2.  
  3. MITSCNV╘á i≤ ß prograφ whicΦ operate≤ unde≥ CP/═ anΣ enable≤á thσ ì
  4. use≥á t∩á lis⌠ thσ director∙ anΣ conver⌠ MIT╙ ALTAI╥á (T═á Perteπ ì
  5. Compute≥á Corp⌐ disδ file≤ t∩ CP/═ files«á  Thσ reasoε conversioε ì
  6. i≤á requireΣ i≤ tha⌠ thσ disδ format≤ arσ differen⌠ anΣ tha⌠á thσ ì
  7. ALTAI╥ DIS╦ i≤ ß harΣ sectoreΣ disδ whicΦ contain≤ 3▓ sector≤á oµ ì
  8. 13╖ byte≤ eacΦ pe≥ track« ┴ CP/═ compatablσ disδ i≤ sof⌠ sectoreΣ ì
  9. anΣ i≤ composeΣ oµ 2╕ sector≤ oµ 12╕ o≥ 25╢ byte≤ eacΦ sector.
  10.  
  11. Thσ ALTAI╥ disδ i≤ capablσ oµ containinτ ß 25╡ entr∙ director∙ oε ì
  12. eacΦ disδ anΣ eacΦ director∙ entr∙ "pointsó t∩ ß threadeΣ lis⌠ oµ ì
  13. sectors«á  Iε orde≥ t∩ ensurσ thσ integrit∙ oµ thσ threadeΣ list¼ ì
  14. eacΦ secto≥ iε thσ lis⌠ contain≤ ß singlσ bytσ whicΦ i≤ thσ "filσ ì
  15. numberóá - aε intege≥ calculateΣ froφ thσ locu≤ oµ thσá director∙ ì
  16. entry«á  If¼á durinτá operation≤á oε thσ chain¼á thσ filσá numbe≥ ì
  17. change≤ ß 'filσ linδ errorº i≤ giveε anΣ thσ prograφ aborts«  Thσ ì
  18. calculatioε fo≥ thσ filσ numbe≥ i≤ giveε erroneousl∙ iε thσá MIT╙ ì
  19. documentatioε anΣ i≤ correcteΣ here:
  20.  
  21.     8*SECTOR+(SLOT+1)
  22.  
  23. Wherσá SECTO╥ i≤ thσ director∙ secto≥ numbe≥ (0-31⌐ iε whicΦá thσ ì
  24. filσá namσá i≤ founΣ anΣ SLO╘ i≤ thσ grou≡  numbe≥ oµ ßá 1╢á bytσ ì
  25. widσ director∙ entr∙ oµ thσ format:
  26.  
  27. Bytes    Description
  28. ------------------------------------------------------
  29. 00-07    ASCII File Name - if the first character is a
  30.     zero (binary zero) the entry is ignored.  If
  31.     it is 0ff (all one bits) this is the last entry
  32.     in the directory.  An ignored entry  is the
  33.     result of deleting a file in the MITS directory.
  34.  
  35.  08    Track address of the first sector in the file.
  36.     Track 0-5 are never used as they are 'system'
  37.     tracks.  Track 70 is the directory track.
  38.  
  39.  09    Sector number of the first sector of the file.
  40.     Sectors are always 0,8,16 or 24.  Sectors are
  41.     allocated in groups of eight.  There is no
  42.     pattern for it, but, because of latency consid-
  43.     erations odd numbered sectors are 16+sector number
  44.     AND 1Fh away from the even sector in a logical
  45.     sense. My calculations indicate this is a poor
  46.     choice and if you have ever heard ALTAIR Disk
  47.     Extended Basic or DOS run, you'll know its not
  48.     too good.
  49.  
  50.  10    Flag to indicate file organization - 4=random
  51.     2=sequential
  52.  
  53. 11-15    Wasted bytes  NOTE: at one time or another the
  54.     program MITSCNVT uses these bytes to store some
  55.     information about each file -not  on the diskè    but in memory.
  56.  
  57. ----------------------------------------------------------
  58.     A≤áá aεáá examplσá le⌠á mσá usσá thσá filσá &OCTBI╬áá fo≥ ì
  59. illustratioε purposes«á  I⌠ - quitσ arbitraril∙ - wil∞ bσ assumeΣ ì
  60. t∩ star⌠ iε tracδ 7▓ secto≥ 0«á Thi≤ woulΣ bσ it≤ director∙ entr∙ ì
  61. iµ i⌠ werσ ß sequentia∞ file:
  62. __________________________________________________________
  63. |  1  |  2  |  3  |  4  |  5  |  6  |  7  |  8  |  9  |....
  64. ----------------------------------------------------------
  65.    &     O     C     T     B     I     N     b    72
  66.  
  67. ----------------------------------------------------------
  68. |  10 |  11 |  12 |  13 |  14 |  15 |  16 | byte number
  69. ----------------------------------------------------------
  70.    0     2     unused bytes------------>
  71.  
  72. Iµ thi≤ werσ thσ 5tΦ entr∙ iε director∙ secto≥ zer∩ i⌠ woulΣ filσ ì
  73. numbe≥ 5.
  74.  
  75.     Movinτ alonτ iε thσ examplσ eacΦ datß filσ begin≤ witΦá ß ì
  76. forma⌠ iε whicΦ thσ datß arσ embedded.
  77.  
  78. The format is as follows:
  79.  
  80. Byte    Description (For Sequential files)
  81. -----------------------------------------------------------
  82. 00    Track number +80h.  This high order bit must be set
  83.     for every track number.  The physical track is
  84.     identified in every sector on that track in this
  85.     manner.
  86.  
  87. 01    Physical sector number of each sector.  Every sector
  88.     is identified this way. Sectors are numbered 0-31.
  89.  
  90. 02    File number.  If =0 then this sector is NOT in use
  91.     at this time.  (When a file is deleted you have to
  92.     wait for each sector in the chain to be rewritten so
  93.     that the file number can be set to zero).
  94.  
  95. 03    Number of data bytes written in this sector
  96.  
  97. 04    Checksum of all data in the sector except bytes 0,1,4
  98.     and 136.  Byte 135 is also not used in the checksum
  99.     calculation.  The checksum is the sum of all of the
  100.     data without regard to overlow as done in an eight bit
  101.     register.
  102.  
  103. 05    Track number of the NEXT data sector in the chain.
  104.  
  105. 06    Sector number of the next data sector in the chain.
  106.     If track and sector number are both zero there is no
  107.     more file (EOF).
  108.  
  109. 07-134    128 words of data.  If the first byte is ffh then theè    file is binary.  If the first byte is other than ffh
  110.     then the file is ASCII.  The first byte is the
  111.     first byte of the first sector of the file - not the
  112.     first byte of any sector.
  113.  
  114. 135    Check byte - always ffH.  This is used to ensure that
  115.     everything else in the sector was in the right place.
  116.  
  117. --------------------------------------------------------------
  118.  
  119.     EacΦá oµá thσá byte≤ iε thesσ sector≤ arσ linkeΣá t∩á thσ ì
  120. othe≥ sector≤ iε ß "forwardó directioε unti∞ byte≤ 5+╢ arσá zero«  ì
  121. Thi≤ signal≤ tha⌠ thσ curren⌠ datß blocδ i≤ thσ las⌠ blocδ iε thσ ì
  122. file«á  Thσá director∙á sector≤ arσ locateΣ iεá tracδá 70«á  EacΦ ì
  123. director∙á secto≥á begin≤ iε thσ 8tΦ bytσ oµ thσ physica∞á secto≥ ì
  124. (thσ firs⌠ ╖ byte≤ arσ garbage).
  125.  
  126.  
  127. USE OF THE PROGRAM:
  128. __________________
  129.  
  130.     Thσ prograφ accept≤ tw∩ type≤ oµ input«á  Thσ firs⌠á typσ ì
  131. oµá inpu⌠ i≤ ß disδ numbe≥ prefixeΣ b∙ aε equal≤ sign«á Thi≤ wil∞ ì
  132. resul⌠á iεá recover∙ oµ thσ MIT╙ director∙ oε tha⌠ disδá anΣá thσ ì
  133. listinτ oµ tha⌠ directory«  A≤ aε example:
  134.  
  135.             =5
  136.  
  137. wil∞á resul⌠á iεá selectioε oµ disδ ╡ anΣá thσá recover∙á oµá thσ ì
  138. directorie≤ oε tha⌠ disδ whicΦ wil∞ bσ listed.
  139.  
  140.     Thσá seconΣ typσ oµ inpu⌠ i≤ ß CP/═ filσ namσ followeΣ b∙ ì
  141. ß filσ type¼á aε equa∞ sigε anΣ ß MIT╙ filσ namσ anΣ disδ number«  ì
  142. Thi≤ wil∞ searcΦ thσ director∙ oε thσ specifieΣ MIT╙ disk¼ locatσ ì
  143. thσ filσ anΣ writσ i⌠ oε thσ CP/═ disδ specified«  A≤ examples:
  144.  
  145.   (1) CPMFILE.MIT=ZCTABLE,0
  146.   (2) DIET.BAS=DIET,0
  147.   (3) OCTOCT.ASM=&OCTOCT,2
  148.  
  149. Iεá examplσ (1⌐ thσ filσ 'ZCTABLEº locateΣ oε MIT╙ disδá zer∩á i≤ ì
  150. copieΣá ont∩á thσá CP/═ disδ a≤ filσ CPMFILE.MIT«á  Iεá thσá nex⌠ ì
  151. example¼á (2)¼á filσá DIE╘á oε disδ zer∩ i≤ copieΣ t∩á CP/═á filσ ì
  152. DIET.BAS«á  Iε thσ las⌠ example¼á MIT╙ filσ &OCTOC╘ oε MIT╙á disδ ì
  153. tw∩á i≤ copieΣ t∩ CP/═ filσ OCTOCT.ASM«á  Thu≤ thσ MIT╙ file≤ arσ ì
  154. alway≤á oε thσ righ⌠ sidσ oµ thσ equal≤ sigε anΣ thσá CP/═á file≤ ì
  155. arσá oε thσ lef⌠ hanΣ side«á  Notσ tha⌠ aε ambiguou≤ filσ namσ i≤ ì
  156. no⌠ permitteΣ becausσ thσ CP/═ file≤ arσ opeε fo≥ writing.
  157.  
  158.     Becausσ thσ file≤ arσ accepteΣ iε lis⌠ form¼á thσ prograφ ì
  159. ma∙ bσ useΣ a≤ ß submi⌠ job«á  Problem≤ witΦ thi≤ prograφ ma∙á bσ ì
  160. submitteΣá iεá writinτ t∩ thσ author«á  Thσ prograφ i≤á copyrigh⌠ ì
  161. 198▒á b∙á thσá author«á Usσá i≤á permitteΣá iεá ßá non-commercia∞ ì
  162. environment«á  Commercia∞á usσ license≤ ma∙ bσ obtaineΣ froφá thσ ì
  163. autho≥á a⌠á ßá reasonablσ cost«á  Conversion≤á caεá bσá performeΣ ìèbetweeεá othe≥ harΣ secto≥ format≤ anΣ cp/φ format«á  Contac⌠á u≤ ì
  164. fo≥ details.
  165.  
  166. CP/═ I╙ ┴ TRADEMAR╦ O╞ DIGITA╠ RESEARCH¼á PACIFI├ GROV┼ CA« MITS¼ ì
  167. ALTAIR¼á PC├á MA┘á B┼ REGISTERE─ TRADEMARK╙á O╞á PERTE├á COMPUTE╥ ì
  168. CORP.¼ CHATSWORT╚ CA.
  169.