home *** CD-ROM | disk | FTP | other *** search
/ Simtel MSDOS 1992 September / Simtel20_Sept92.cdr / msdos / emulatrs / ame86.arc / AME86.HLP < prev   
Text File  |  1985-07-30  |  5KB  |  118 lines
  1.  
  2.                               AME86
  3.  
  4.                  Application Migration Executive
  5.                     CP/M-86 emulator for MSDOS
  6.  
  7.          Jean-Marc Lugrin, Digital Equipment Corporation
  8.  
  9.    This emulator allows you to run CP/M-86 programs under MSDOS.
  10. The goal is to ease transfer of already developed applications,
  11. and to allow co-existence of CP/M-86 and MSDOS applications.  The
  12. goal is to emulate CP/M-86 as commonly used on the Rainbow-100
  13. computer.
  14.  
  15.    Programs which depend too heavily on the internal structure of
  16. CP/M-86 are not likely to work correctly.  This includes
  17. communication programs (poly-XXX, Kermit), debuggers (DDT86),
  18. device maintenance programs (STAT, MAINT, FORMAT).  The same class
  19. of program that is easy to transfer to CCPM should run on AME86.
  20. For other limitations see below.  It is possible to develop and
  21. test CP/M-86 programs (using ASM86, GENCMD or MWC or other CP/M-86
  22. compilers) under MSDOS+AME86.
  23.  
  24.    NOTE:  A CP/M-86 license is necessary to use Digital Research
  25. products with AME86.
  26.  
  27.    To run a CP/M-86 program use the command:
  28.  
  29.         AME86 [ path ] CP/M-86-program/[C,S|F,I] [ arguments ]
  30.  
  31.    AME86 will be searched for using the current PATH environment
  32. variable, but the CP/M-86 program must reside in the current
  33. directory or in a directory specified on the command line.
  34. Options must directly follow the name of the program to be loaded
  35. (NO space allowed).  If SWITCHAR is "-", then replace "-" for "/"
  36. in the examples.  The following options are recognized:
  37.  
  38. /C - control-C will NOT abort your program.  Under MSDOS control-C
  39.      may abort your program at any console i/o operation (except
  40.      some direct console i/o), or even at any system request (disk
  41.      i/o or other request) if the option BREAK=ON has been used in
  42.      CONFIG.SYS.  This feature is useful for stopping erroneous
  43.      programs, but may conflict with the way control-C is handled
  44.      by the emulated program.  If you do NOT want control-C
  45.      trapping by MSDOS during execution of the program, use option
  46.      /C.  This should only be used with program known to work
  47.      well, and to work with AME86 (e.g.  RED).
  48.  
  49.      NOTE:  If a program had any file open for writing when
  50.      control-C was issued, the disk may be corrupted.  You should
  51.      run CHKDSK to check disk structure.
  52.  
  53. /S and /F:
  54.      Both options are for similar uses, and are mutually
  55.      exclusive.  Under CP/M-86 (and MSDOS) a program cannot know
  56.      from where it was loaded (which drive).  Under AME86 it
  57.      cannot even know from which directory.  This is a problem
  58.      with program using HELP files or OVERLAYS (like RED, TURBO,
  59.      WS, etc), as they do not know where to look for them.
  60.      Normally they look at the default drive established at load,
  61.      or at the boot drive.  AME86 returns the drive used to load
  62.      the program as the boot drive.  Still the program may look in
  63.      the wrong drive or the wrong directory.  To allow a program a
  64.      way to find overlays or help files, AME86 can give them a
  65.      second chance on OPEN or CHAIN (but NOT on MAKE, SEARCH_FIRST
  66.      or SEARCH_NEXT).  The second chance is given ONLY if the file
  67.      is assumed to be in the drive which was the CURRENT DRIVE
  68.      when the program was loaded or if a PATH was specified on the
  69.      command line, and if option /S or /F was specified.  AME86
  70.      uses a heuristic to avoid trying to open using the same file
  71.      name twice.  Inpact on speed is minimal for option /S with
  72.      floppy drive, with option /F with MDRIVE.
  73.  
  74.      NOTE:  On 0.7-1 a bug precludes the use of /S and /F together
  75.      with a path name.
  76.  
  77. /S - Search:  Allows for a second chance AFTER the file was looked
  78.      in the current directory of the specified drive.
  79.  
  80.      Possible problem:  if the user opens a data file which does
  81.      not exist on the specified drive, and one exists on the load
  82.      drive, the one on the load drive will be used without
  83.      warning.
  84.  
  85. /F - First Search:  FIRST tries to open on the load device and
  86.      pathname if the drive qualifies (is either the default drive
  87.      at load or the effective load drive and a pathname is
  88.      specified).
  89.  
  90.      Possible problem:  if the user tries to open a data file on a
  91.      specific disk, and a file with the same name exists on the
  92.      load drive, the file on the load drive will be used without
  93.      warning.
  94.  
  95. /I - Ignore:  This option gives a better (but less secure)
  96.      emulation of CP/M-86.  The following functionality is
  97.      modified:
  98.  
  99.      1) If the program calls CP/M-86 for an illegal request, AME86
  100.      returns with AX=BX=0.
  101.  
  102.      2) If the program asks for a SEARCH in special mode, AME86
  103.      will attempt to emulate it (for STAT and MAINT).  This does
  104.      not run very well now...
  105.  
  106.      This option should be used carefully.
  107.  
  108. NOTE:  If you use BREAK=ON in your CONFIG.SYS, MSDOS will check
  109. for ^C at any system call.  Your program has no possibility to
  110. intercept this Control/C:  it is aborted.  If you use BREAK=ON,
  111. and your program normally handle ^C itself, you have to be
  112. carrefull to type ^C ONLY when your program ask for some input.
  113. These is not always convenient, you may desire to supress BREAK=ON
  114. or use option /C.
  115.  
  116. Copyright:
  117. Jean-Marc Lugrin, Digital Equipment Corporation, 1983, 1984
  118.