home *** CD-ROM | disk | FTP | other *** search
/ Oakland CPM Archive / oakcpm.iso / sigm / vol157 / ataribus.lbr / AS.DQC / AS.DOC
Text File  |  1985-03-13  |  6KB  |  123 lines
  1. AS.COM
  2. ------
  3.  
  4.      This is the main utility of the ATARIBUS system.  It is the software
  5. interface between the ATARI and the CP/M system providing simulated disk
  6. drives and the use of your CP/M LST: or console devices as the ATARI
  7. printer P: device.
  8.  
  9.      You must first patch AS.COM for the serial port setup of your system.
  10. See PATCHING.DOC for details.  After patching AS you start it up like:
  11.  
  12.     x>AS<return>
  13.  
  14. Where 'x' is the default CP/M drive and <return> is the carriage return key
  15. on your CP/M system.  After AS loads it will clear the screen and then
  16. display the current ATARI drive assignments, printer assignment and a list
  17. of valid commands.   First a word about what makes up one of the faked
  18. ATARI drives.
  19.  
  20.      AS.COM provides up to four pseudo-drives to the ATARI.  To ATARI DOS
  21. they appear as devices D1: through D4:.  What they actually are is 90k
  22. byte CP/M disk files.  The records of these disk files are treated as sectors
  23. of the ATARI disk.
  24.      There is only one way to create a Pseudo-Disk (PD) file, that is through
  25. the 'A'ssign command of AS.  Just press 'A' and you will then see a short
  26. list of existing PD files, if any, and you be prompted for the ATARI drive
  27. number you wish to assign the file to.  Just type a digit from 1 through 4.
  28. If there is already a PD file assigned to that drive it will be closed and
  29. unassigned first.
  30.      Now you will be asked to enter in the CP/M filename of a PD file to
  31. assign to the drive.  You should enter the filename AND extension. A drive
  32. specification may optionally preceed the filename.
  33.      The standard extensions for these PD files are ATR, AT1, AT2, AT3 or
  34. AT4.  'ATR' should be used in most cases.  The other forms are treated a
  35. bit specially.  The 'A'ssign command will show all files with an extension
  36. matching '.AT?' on the default CP/M drive.
  37.      When AS.COM is run, it will search the default CP/M drives for files
  38. named '*.AT#' where '*' means any name at all and '#' is a digit from 1
  39. through 4.  Any files found will be assigned by default to ATARI drive
  40. number '#'.  Thus you can have common files be automatically assigned
  41. whenever you use AS.  In the case of duplicate '#'s, the one appearing
  42. first in the CP/M directory will be assigned.
  43.      If the filename you enter for the 'A'ssign command does not exist,
  44. AS will create it for you.  This is the only way to create a PD file.
  45. The creation process takes a minute or two so don't get nervous.  You
  46. must have at least 90k, or possibly 92k depending on the allocation size
  47. used on your CP/M drives, available on the drive where the file is being
  48. created.  The created file will appear as a blank formatted diskette to
  49. the ATARI DOS.
  50.      The AS menu screen shows which files are assigned to which ATARI
  51. drives.  A blank line following a 'D#:' means that the drive is currently
  52. unassigned.
  53.  
  54.      The 'U'nassign command is used to remove the association of a file
  55. with an ATARI drive.  Just press 'U' then enter the number of the ATARI
  56. drive you want to unassign.
  57.  
  58.      If you press the <return> key alone to any prompt of the 'A' or 'U'
  59. commands, the command will be aborted.
  60.  
  61.      Note that real ATARI disk drives can co-exist with AS as long as
  62. there are no duplicate assignments of drive numbers.  If both a real
  63. drive and a PD are assigned to the same number, you will get garbage
  64. when you try to access that drive but no damage will be done.
  65.  
  66.  
  67.      By default, AS will intercept bus commands to the ATARI 'P:' or
  68. printer device and will print them on the standard CP/M list device
  69. 'LST:'.  You can use the 'L'ist device toggle command to switch the
  70. printer device to the CP/M console screen.  The current list device
  71. is shown in the AS menu after the 'P:'.
  72.  
  73.      The built-in ATARI printer handler does some strange things when
  74. an ATARI End Of Line (EOL) character is printed.  It will pad the rest
  75. of the 40 character printer buffer with blanks and then send the
  76. buffer to the printer.  This causes all sorts of strange indentations
  77. in a listing done through AS.  To combat this, AS will, be default, strip
  78. off all the padded spaces after EOLs in printed data.  If for some
  79. reason you don't want this done, use the 'S'trip spaces toggle to cause
  80. spaces after an EOL to be printed.  Press it again to revert back to
  81. the default.  The current setting of this option is displayed in the
  82. AS menu on the line following the 'P:' printer device setting.
  83.  
  84.      As a protection against accidental alterations of data, all the
  85. default PD files, '*.AT#' files, are marked as WRITE PROTECTED by
  86. default.  Any attempts to write to one of these drives will return
  87. a WRITE PROTECT ERROR to the ATARI.  You can write enable these files,
  88. or write protect a file you assigned yourself, with the 'W'rite protect
  89. toggle command.  Just enter the drive number and it will be WRITE
  90. PROTECTED if it currently isn't, or WRITE ENABLED if it's currently
  91. protected.
  92.  
  93.      The 'C'hange CP/M default drive command is used to, amazingly
  94. enough, change the CP/M default drive.  Just enter the drive letter,
  95. A through P, and it will become the default drive which is searched
  96. for '.AT?' files by the 'A'ssign command.
  97.  
  98.      The 'D'irectory command will display all files on a given CP/M
  99. drive.  Just enter the drive letter, or press <return> for the current
  100. default drive.
  101.  
  102.  
  103.      The 'Q'uit command will close all currently assigned PD files and
  104. then return to CP/M.  You will be given a chance to abort the command
  105. in case you typed it accidentally.
  106.  
  107.  
  108.      You can boot from a PD file assigned to drive 1, if you have a
  109. copy of ATARI DOS in it.  You should get a copy of DOS and then boot
  110. it on your 810, or borrow a friend's 810, which is assigned to drive
  111. 1.  Then assign a PD file as drive 2 and use the WRITE DOS FILES command
  112. of DOS to put a copy of the DOS in the PD file.  Once you have it in
  113. a PD file, you can boot from the PD file and THEN use the WRITE DOS FILES
  114. command to put DOS in other PD files.
  115.  
  116.  
  117.      That's about it for AS.  For other operations on PD files, such as
  118. listng files present in them or converting between the ATARI DOS files
  119. in the PDs and CP/M files, see the AFC.DOC file.
  120.  
  121.  
  122.                         Dave
  123.