home *** CD-ROM | disk | FTP | other *** search
/ Oakland CPM Archive / oakcpm.iso / cpm / dskutl / msodball.arc / MSODBALL.DOC < prev   
Encoding:
Text File  |  1994-01-12  |  15.0 KB  |  349 lines
  1. MSODBALL v2.00                                     J. Elliott, 14 December 1993.
  2. ================================================================================
  3.  
  4.   In this documentation, the acronym DOS means the PC operating systems MSDOS,
  5. PCDOS and DRDOS.
  6.  
  7.   If you have used MSODBALL or MSODBALA v1.00, please read the section entitled
  8. "update information".
  9.  
  10.  
  11. Introduction
  12. ▓▓▓▓▓▓▓▓▓▓▓▓
  13.  
  14.   MSODBALL is a format-conversion utility for use on an Amstrad CP/M computer
  15. which has a 3.5" 720k disc drive (A: or B:).
  16.  
  17.   It can convert a standard CP/M (or LocoScript) 720k disc to a non-standard
  18. DOS format. Conversely, it can convert a DOS disc in this non-standard format
  19. to CP/M 720k format.
  20.  
  21.   Format-conversion usually is much quicker than copying files between CP/M and
  22. standard DOS-format discs. Also, only one disc is needed. However there is a
  23. risk that specialised programs (see below for a list of known examples) may not
  24. be able to use the non-standard DOS format.
  25.  
  26.   It is emphasised that MSODBALL merely enables files on a disc to be accessed
  27. by either the CP/M or the DOS operating systems. There is no guarantee that the
  28. files accessed will be of use under both systems. Usually only ASCII files are
  29. usable directly, although some CP/M machine-code programs may be executed under
  30. DOS by way of public domain or shareware emulation programs. If you save BASIC
  31. programs as ASCII files, they can be adapted for DOS-type BASIC (Locomotive
  32. made a version of Mallard BASIC for the PC - I don't know whether it is still
  33. available).
  34.  
  35.   MSODBALL runs under CP/M. Type:
  36.  
  37. MSODBALL  <RETURN>
  38.  
  39. to start.
  40.  
  41. Screen Messages
  42. ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓
  43.   If you have two disc drives, you will see the message
  44.  
  45.     "Two drives detected - use A: or B: ?"
  46.  
  47.   appear. Only drives A: and B: can be used. Users of GEM or InSyder hard discs
  48. should type A: or B: and the program will use the appropriate floppy drive C: or
  49. D:.
  50.   When you select a drive it will then be used for the entire duration of the
  51. program. To change to the other drive, leave the program and run it again.
  52.  
  53.   The main message sequence can be represented pictorially as:
  54.  
  55. +--------------------------------------------------+
  56. | E (xamine disc in drive A:) or Q (uit to CP/M) ? |
  57. +---------------------------------------+----------+
  58.                                         |
  59.     +-----------------------------------+-------------------------------+
  60.     |                                   |                               |
  61. +---+-------------------------+   +-----+------------+   +--------------+---+
  62. | Disc cannot be converted -  |   | CP/M 720k format |   | DOS oddball      |
  63. | Not a suitable disc format. |   | detected.        |   | format detected. |
  64. +-----------------------------+   +-----+------------+   +--------------+---+
  65.                                         |                               |
  66.     +----------------------------+------+---------+                     |
  67.     |                            |                |                     |
  68. +---+-------------------------+  |  +-------------+---------------+     |
  69. | Disc cannot be converted -  |  |  | Disc cannot be converted -  |     |
  70. | Not enough free space.      |  |  | Too many user 0 files.      |     |
  71. +-----------------------------+  |  +-----------------------------+     |
  72.                                  |                                      |
  73. +--------------------------------+--------------+                       |
  74. | C (onvert to DOS oddball format) or Q (uit) ? |                       |
  75. +-----------------------------------------------+                       |
  76.                                                                         |
  77.     +----------------------------+----------------+---------------------+
  78.     |                            |                |
  79. +---+-------------------------+  |  +-------------+-----------------------+
  80. | Disc cannot be converted -  |  |  | Disc cannot be converted -          |
  81. | Too many directory entries. |  |  | unsuitable sub-directory structure. |
  82. +-----------------------------+  |  +-------------------------------------+
  83.                                  |
  84. +--------------------------------+------------+
  85. | C (onvert to CP/M 720k format) or Q (uit) ? |
  86. +---------------------------------------------+
  87.  
  88. Some other messages you may see are:
  89.  
  90. "No files found"
  91.  
  92.  - The disc is empty (DOS discs only).
  93.  
  94. "No files in User 0."
  95.  
  96.  - There are no files in User Area 0. There may or may not be files in other
  97.   user areas (CP/M discs only).
  98.  
  99. "Disc cannot be converted - The directory is corrupted."
  100.  
  101.  - The directory is claiming that the disc contains more than 706k of files.
  102.   Since this is not possible, the program decides that the directory is not
  103.   trustworthy. If any one file is supposedly bigger than 706k, its name is
  104.   printed for diagnostic purposes.
  105.  
  106. "Convert file date-stamps (Y/N) ?"
  107.  
  108.  - DOS files all have a date-stamp, which says when the file was last updated.
  109.   In CP/M, this is optional, so when the disc is being converted from DOS to
  110.   CP/M format you may be asked whether you want to use this option. LocoScript 1
  111.   and AMSDOS cannot use discs with date-stamps.
  112.  
  113. "<something> is password protected. Type password or press ENTER to abandon"
  114.  
  115.  - See the section on "Password conversion" below.
  116.  
  117. Notes on Screen Messages
  118. ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓
  119.  
  120.   The CP/M user 0 directory (or the DOS root directory) will be displayed if
  121. the disc examined is suitable for conversion, looking similar to a listing
  122. produced by DIR (in DOS, DIR /W). Any underlined filenames are DOS sub-
  123. directories. In addition, in the CP/M to DOS direction, a display of file
  124. allocation by user is shown, similar to that produced by SHOW [USERS].
  125.  
  126.   Insufficient disc- or directory-space messages are likely to occur only if a
  127. disc is almost full in its original format. Respective capacities are:-
  128.  
  129. CP/M 720k format:   Max directory entries = 256, File space = 706K.
  130. DOS oddball format: Max root directory entries = 240, File and sub-directory
  131.                     space = 706K.
  132.  
  133.   The figures on disc usage for a disc in DOS oddball format do not include
  134. sub-directories, so there may be more free space shown by MSODBALL than by
  135. DOS programs like DIR.
  136.  
  137. CP/M User-Numbers and DOS Sub-Directories
  138. ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓
  139.  
  140.   CP/M user areas (or Locoscript groups) and DOS sub-directories both allow
  141. multiple files with the same name to exist on a disc.
  142.  
  143.   MSODBALL supports CP/M user areas and sub-directories of the DOS root
  144. directory. It attempts to avoid filename ambiguity by equating user areas and
  145. sub-directories in the following way:-
  146.  
  147. CP/M to DOS conversion: Files found in CP/M User Area 0 are placed in the
  148. DOS root directory. Files found in user areas 1 to 15 are placed in sub-
  149. directories with names USER#01 to USER#15 (but see "Empty files" below).
  150.  
  151. DOS to CP/M conversion: Files found in the root directory are placed in CP/M
  152. User Area 0. Files found in up to 15 sub-directories of the root directory are
  153. placed in user areas 1 to 15, with each sub-directory name preserved as the
  154. name of an empty file in the relevant user area.
  155.  
  156.   After a disc has been converted to CP/M format, type DIR [USER=ALL] or
  157. SHOW [USERS] to see what files have been placed where.
  158.  
  159.   Since LocoScript uses user areas 8 to 15 as storage for "limbo" files, it is
  160. inadvisable to use discs which have files in these user areas under LocoScript.
  161. This also means that after a disc has been converted to and from DOS format,
  162. limbo files will not necessarily be in the same groups that they were in
  163. before, and some may have been "recovered" and inhabit formerly empty groups.
  164.  
  165.  
  166. File attributes and datestamps
  167. ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓
  168.  
  169.   When files are being converted, their attributes (eg read-only, archive)
  170. are converted with them. Here is the full list of how they are converted:
  171.  
  172. CP/M to DOS:
  173.  
  174. Read-Only -> Read-Only
  175. Archive   -> Archive
  176. System    -> Hidden.
  177. The attributes F1-F4 are not converted.
  178.  
  179. DOS to CP/M:
  180.  
  181. Read-Only -> Read-Only
  182. Archive   -> Archive
  183. Hidden    -> System
  184. System    -> F4.
  185.  
  186.   Datestamps are converted in the CP/M to DOS direction, and optionally in the
  187. DOS to CP/M direction. The option will not be offered if there is not enough
  188. room in the directory for the extra information.
  189.   The CP/M "update date" is taken as being interchangeable with the DOS file
  190. date. If there is no date entry for a file, the date will be set to be the
  191. current date as given by the computer's clock. When converting from DOS to CP/M
  192. format, the "update" and "access" datestamps are used; the "access date" is set
  193. to be the current date.
  194.   Disc labels are transferred correctly in both directions.
  195.  
  196. Password conversion:
  197. ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓
  198.   In CP/M and DRDOS (but not MSDOS or PCDOS) files can have a password.
  199. When a disc is converted, CP/M passwords are changed to DRDOS passwords, and
  200. vice versa. Discs with DRDOS passwords can be used normally under MSDOS or
  201. PCDOS, but the passwords will be ignored.
  202.   Password conversion between the formats works as follows:
  203.  
  204. CP/M to DRDOS:
  205.  
  206.   If a disc has a password, MSODBALL will need this password to be typed before
  207. conversion can proceed. The disc password will become the volume label password.
  208. File passwords are automatically converted.
  209.   If password protection is not enabled for a disc (eg SET [PROTECT=OFF] has
  210. been used), all passwords will be removed during conversion.
  211.  
  212. DRDOS to CP/M:
  213.  
  214.   Because of the way DRDOS passwords are stored, it is impossible to convert
  215. them automatically into CP/M passwords. Therefore, during conversion, you will
  216. have to type the password of every password-protected file. MSODBALL will try
  217. to minimize this typing. For example, if all the files on the disc have the
  218. same password, then you will only have to type the password once.
  219.   Directory passwords are not converted.
  220.  
  221. Limitations and empty files:
  222. ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓
  223.   On a disc converted to DOS format, file sizes are multiples of 128 bytes.
  224.  
  225.   MSODBALL cannot convert DOS oddball-format discs which have more than 15
  226. sub-directories or which have sub-directories of sub-directories.
  227.  
  228.   Empty files are treated as follows:
  229.  
  230.   Empty files in User 0 are not transferred.
  231.   The last empty file in each User 1-15 becomes the name of the corresponding
  232. sub-directory. So, if a LocoScript disc had a group called LETTERS, this would
  233. be converted to the sub-directory LETTERS.GRP. If the group had not been named,
  234. the sub-directory would have preserved its USER#nn name. On being converted
  235. back, the sub-directory LETTERS.GRP would become the LocoScript group LETTERS.
  236.   Since sub-directory names cannot be duplicated, you will find that if there
  237. are two or more user areas with the same "name" (for example, if there is an
  238. empty file called CONT in user areas 1, 2 and 3), then the sub-directory names
  239. will be slightly different (in the above example, you would have the sub-
  240. directories CONT, CONT.0, CONT.1 respectively).
  241.  
  242. Some programs incompatible with DOS Oddball Format:
  243. ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓
  244.  
  245.   This is by no means a complete list. It merely details the programs that I
  246. have tested and found wanting.
  247.  
  248. Under CP/M:
  249.  
  250. * MSDISC and MSDISCA cannot use DOS oddball discs.
  251.  
  252. Under DOS:
  253.  
  254. * The Norton Disc Doctor does not recognise DOS oddball discs, and attempts to
  255.  "repair" them. The process is fatal for the disc concerned.
  256.  
  257. Others:
  258.  
  259. * The Apple File Exchange program on the Apple Macintosh does not recognise DOS
  260.  oddball discs. This means that MSODBALL cannot be used to transfer data
  261.  directly to Macs.
  262.  
  263.  
  264. Update information for v1.00 users:
  265. ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓
  266.  
  267.   This program replaces both MSODBALL and MSODBALA v1.00. Some of the messages
  268. have changed slightly, and there are a few other changes:
  269.  
  270. 1. If you have two disc drives, you can choose which one to use at the
  271.   beginning of the program.
  272. 2. The cursor is a reversed-video *, not a ?.
  273. 3. You are offered the option to convert date-stamps from DOS to CP/M
  274.   format. If you intend to use the disc under LocoScript 1 or AMSDOS, answer No;
  275.   otherwise it depends on whether you prefer to use time-stamped discs under
  276.   CP/M.
  277. 4. File sizes are not shown in the directory listing. Sub-directories are
  278.   shown underlined rather than followed by <DIR>.
  279.  
  280. Technical differences are described later.
  281.  
  282. Error codes
  283. ▓▓▓▓▓▓▓▓▓▓▓
  284.   If the program ends with the report "CP/M Error On x:" then the "Extended
  285. BIOS Function" that it mentions is:
  286.  
  287. 0086: Error in reading from the disc.
  288. 0089: Error in writing to the disc.
  289.  
  290.  
  291. Physical-Sector Usage
  292. ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓
  293.  
  294. CP/M 720k:     1 (disc spec) + 8 (unused) + 16 (directory of 256 entries)
  295.         + 1412 (files) + 3 (unused) = 1440 sectors = 720K.
  296.  
  297. DOS oddball:    4 (boot) + 6 (2 FATs) + 15 (root directory of 240 entries)
  298.         + 1412 (files + sub-dirs) + 3 (unused) = 1440 sectors = 720K.
  299.  
  300.  
  301. Changes from v1.00
  302. ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓
  303.  
  304.   Version 2.00 was written from scratch. The only code in common with v1.00
  305. is the DOS Oddball boot sector.
  306.  
  307. 1. MSODBALL v2.00 (8k) replaces MSODBALL v1.00 and MSODBALA v1.00 (18k each).
  308.   This results in a 28k saving of disc space.
  309. 2. Date-stamps and disc labels are converted. MSODBALL/MSODBALA v1.00 corrupted
  310.   the directories of discs with date-stamps or disc labels, by treating the
  311.   date-stamps/labels as real files.
  312. 3. Empty files become sub-directory names, so LocoScript group-names are
  313.   preserved.
  314. 4. The unhelpful message "Disc-related error" has been replaced by a set of
  315.   messages explaining what the error is.
  316. 5. CP/M and DRDOS passwords are supported.
  317. 6. The program will run on any Amstrad CP/M computer (ie PCW/CPC/Spectrum +3).
  318. 7. Discs with corrupted directories are more likely to be detected.
  319.  
  320.   Once a disc has been converted to CP/M format by MSODBALL v2.00, it is no
  321. longer recognised as a CP/M disc by MSODBALL/MSODBALA v1.00. I do not know
  322. why.
  323.  
  324. Use of CP/M sector editors
  325. ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓
  326.  
  327.   The CP/M sector editor DU87 can be made to read DOS oddball format discs, if
  328. used in conjunction with the DU51 formatter. To use, type:
  329.  
  330.    DU51 <RETURN>
  331.  
  332.   Use option 1 (select disc type), then the drive you are editing your disc in.
  333. Then choose "Fixed format"; then format F - "MSDOS Oddball". Leave DU51.
  334.  
  335.   Now run DU87 and insert the DOS oddball disc. DU87DATA.DOC describes the
  336. arrangement of such a disc.
  337.  
  338.   When you have finished, use DU51 to change the drive you were using back to
  339. "Auto Select".
  340. ________________________________________________________________________________
  341.  
  342. The DOS Oddball format and boot sector were invented by G R Mortreuil.
  343. ________________________________________________________________________________
  344.  
  345. MSODBALL (c) 1993 J C Elliott. Parts (c) 1991 G R Mortreuil. This program is
  346. released to the public domain on condition that it is not sold for profit and
  347. is not distributed without this documentation.
  348. ________________________________________________________________________________
  349.