home *** CD-ROM | disk | FTP | other *** search
/ Brotikasten / BROTCD01.iso / cpm / msdosem.txt < prev    next >
Text File  |  1993-08-08  |  17KB  |  449 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.                     MS-DOS   E m u l a t o r   f o r   CP/M +
  17.                                    DEMO version
  18.                                   User's Manual
  19.  
  20.                                   Nichita Sandru
  21.  
  22.                             Copyright (c) SanDES, 1990
  23.  
  24.  
  25.                                       - 2 -
  26.  
  27.  
  28.  
  29.               1. Introduction
  30.  
  31.               The MS-DOS Emulator is a program which allows the user  to
  32.           handle files on MS-DOS disks under the control of  CP/M  Plus.
  33.           CP/M commands  like  DIR,  ERA,  etc.  may be used with MS-DOS
  34.           disks exactly as with CP/M disks.
  35.  
  36.               The MS-DOS Emulator cannot  run  MS-DOS  programs  because
  37.           they need an Intel 8086/88 family  processor.  They cannot run
  38.           on a Z80.
  39.  
  40.               The MS-DOS Emulator automatically recognizes MS-DOS disks,
  41.           when they are inserted into the disk drive.
  42.  
  43.               The emulator can only be used on a banked CP/M system.  It
  44.           takes about 8 Kbytes in RAM bank 0 and 4 Kbytes in common RAM.
  45.           It can serve up to 16 disk drives, 5.25" (40 tracks) and  3.5"
  46.           formats.
  47.  
  48.               This demo version is public  domain.  It contains a subset
  49.           of the  capabilities  of  the  commercial  version.  It may be
  50.           freely copied and distributed, together with this manual,  but
  51.           altering the program or the manual is not permitted.  The demo
  52.           version of the emulator may not be sold for  profit.  Only the
  53.           cost of materials, copying and postage may be asked.
  54.           
  55.               The DEMO version consists of the following files:
  56.           
  57.               - MSDOS.DOC    - This user's manual.
  58.               - MSDOS.COM    - The emulator.
  59.  
  60.           
  61.               2. The MS-DOS Format
  62.           
  63.               An MS-DOS disk has 4 areas:
  64.           
  65.               - The  BOOT  sector  -  1'st  sector  on  track  0  -
  66.               containing a  program  which  loads  the  MS-DOS  and
  67.               starts  it  (on  a  PC  compatible),  together   with
  68.               information about the disk format.
  69.               
  70.               - The FAT ("File Allocation Table") area containing a
  71.               "map" of the disk, showing the  sectors  occupied  by
  72.               the files in the Data area.
  73.               
  74.               - The DIR ("DIRectory") area containing  a  directory
  75.               of the files on the  disk.  Each file has an entry in
  76.               this directory, containing a description of the file.
  77.               The MS-DOS Emulator designates  the  DIR  area  as  a
  78.               directory file with the name "\".
  79.  
  80.  
  81.                                       - 3 -
  82.  
  83.  
  84.               
  85.               - The Data area containing the files.
  86.               
  87.               Two kinds of files can be found on an  MS-DOS  disk:  Data
  88.           files  and  directory  files.  The data  files  contain  text,
  89.           programs  etc.  A directory file has the same structure as the
  90.           DIR area and it can contain entries for other directory files.
  91.           A directory file always contains two entries:
  92.           
  93.               - An  entry  with  the  name  ".",   describing   the
  94.               directory file itself;
  95.               
  96.               - An  entry  with  the  name  "..",  designating  the
  97.               directory where the directory file  is  listed.  This
  98.               directory may be the DIR area  or  another  directory
  99.               file.
  100.               
  101.               The directory files form a tree structure,  with  the  "\"
  102.           directory as root. The path to a directory is called "path".
  103.  
  104.               The following MS-DOS formats are  recognized  by  the  MS-
  105.           DOS Emulator:
  106.           
  107.               - 5.25" 160 Kbytes, SS.
  108.               - 5.25" 180 Kbytes, SS.
  109.               - 5.25" 320 Kbytes, DS.
  110.               - 5.25" 360 Kbytes, DS. (Standard PC/XT);
  111.               - 3.5"  720 Kbytes (PC/AT).
  112.               
  113.           
  114.               3. The CP/M Format
  115.           
  116.               A CP/M disk has 3 areas:
  117.           
  118.               - The system area (the first 0 ... 3 tracks);
  119.               
  120.               - The DIR  area  containing  file  descriptions.  The
  121.               large files are split into several areas ("extents"),
  122.               each with its own entry in the directory. These files
  123.               use several entries in the directory.
  124.               
  125.               - The data area, divided into 16 "user"  areas.  This
  126.               area may be selected by CP/M's "USER n" command,  "n"
  127.               being the number of the area (0 ...  15).  The "USER"
  128.               commands allow  only  access  to  the  files  in  the
  129.               selected area and to the files in the  0  area  which
  130.               are designated as "system" files.
  131.  
  132.  
  133.                                       - 4 -
  134.  
  135.  
  136.           
  137.               4. File Management by the MS-DOS Emulator
  138.           
  139.               The emulator is almost transparent with regard  to  MS-DOS
  140.           disk and totally transparent when you deal  with  CP/M  disks.
  141.           The only differences concern the handling of directory  files,
  142.           time stamping and the use of passwords  on  MS-DOS  disk.  The
  143.           directory files are gathered into the "USER 1" area.  They can
  144.           be listed with:
  145.           
  146.               USER 1
  147.               DIR
  148.           
  149.               Only  the  files  described  in  the  currently   selected
  150.           directory file can be handled  with  CP/M  commmands  or  BDOS
  151.           functions.  The directory  files  are  selected  with  the  CD
  152.           command.
  153.           
  154.               The DEMO version of the emulator does not time  stamp  MS-
  155.           DOS disks.
  156.  
  157.               Passwords cannot be used on MS-DOS disks,  because  MS-DOS
  158.           doesn't allow it.
  159.           
  160.               A special entry, named  "other.dir",  is  present  in  the
  161.           "USER  1"  area.  There is no file with this name on the disk.
  162.           The entry is created by the emulator in order to allocate  the
  163.           sectors belonging to files with  no  entries  in  the  current
  164.           directory.  In  this  way  the  files  are  protected  against
  165.           overwriting.
  166.           
  167.           
  168.               5. Commands
  169.           
  170.               The MS-DOS emulator is started by:
  171.           
  172.               MSDOS
  173.           
  174.               After the program is started,  the  following  message  is
  175.           displayed:
  176.           
  177.               MS-DOS Emulator V1.03 # DEMO
  178.               (c) SanDES 1990
  179.           
  180.               A third line follows, displaying supplementary information
  181.           (the computer type f. ex.).  If the MS-DOS Emulator is already
  182.           started, the following warning is displayed:
  183.           
  184.               *** MS-DOS emulator already started ***
  185.  
  186.  
  187.                                       - 5 -
  188.  
  189.  
  190.               Another message may be displayed:
  191.           
  192.               *** Not enough common memory ***
  193.           
  194.           This means that there is not enough room  for  the  emulator's
  195.           buffers in RAM (it needs at least 2 Kbytes), because there are
  196.           other programs in the upper area of RAM (SUBMIT, GET or PUT f.
  197.           ex.).  This problem may  be  solved  by  starting  the  MS-DOS
  198.           Emulator before the other programs.
  199.           
  200.               The emulator can be stopped by:
  201.           
  202.               MSDOS OFF
  203.           
  204.               The  emulator  has  a  built-in  command   for   selecting
  205.           directory files. It can be used as follows:
  206.           
  207.               CD directory file
  208.           
  209.           "directory file" becomes the current directory.
  210.           
  211.               CD ..
  212.           
  213.           The directory containing the entry  describing  the  currently
  214.           selected directory file becomes the new current directory.
  215.           
  216.               CD
  217.           
  218.           Resets the drive and selects  the  "\"  directory  as  current
  219.           directory.  This command can be  used  after  a  disk  change,
  220.           instead of CTRL/C.
  221.           
  222.               CD .
  223.           
  224.           Resets the drive and retains the same cur