home *** CD-ROM | disk | FTP | other *** search
/ Simtel MSDOS 1992 December / simtel1292_SIMTEL_1292_Walnut_Creek.iso / msdos / sysutl / dosamatc.arc / DOSAMATC.DOC < prev    next >
Text File  |  1985-10-22  |  33KB  |  910 lines
  1.  
  2.  
  3.  
  4.                                   DOSamatic
  5.  
  6.                           User Guide and Reference
  7.  
  8.  
  9.                     Copyright 1985 Marin Pacific Software
  10.  
  11.                              All Rights Reserved
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56. DOSamatic User Guide           May 15, 1985                      Page 1
  57.  
  58.  
  59.  
  60.                               Table of Contents
  61.  
  62.     1. Introduction......................................     3
  63.  
  64.     2. System Requirements...............................     4
  65.  
  66.     3. The DOSamatic Program Disk........................     4
  67.  
  68.     4. Starting DOSamatic.................................    5
  69.  
  70.     5. DOSamatic Basics...................................    5
  71.          The Information Panel............................    5
  72.          The Drive Selection Panel........................    6
  73.          The Directory Selection Panel....................    6
  74.          The File Selection Panel.........................    6
  75.          Comparison with DOS commands.....................    7
  76.  
  77.     6  DOSamatic Commands.................................    7
  78.          Special Keys.....................................    7
  79.               The Cursor Keys.............................    7
  80.               The [ENTER] key.............................    8
  81.               The [ESCAPE] key............................    8
  82.               The [F1] = [HELP] key.......................    8
  83.               The [F2] = [REFRESH] key....................    8
  84.               The [F40] = [SWITCH] key....................    8
  85.          Main Menu........................................    8
  86.               Screen Colors...............................    8
  87.               Executing DOS Commands......................    8
  88.               Exiting DOSamatic...........................    9
  89.               Using a File Mask...........................    9
  90.               Searching for a File........................    9
  91.               Show/Hide Date/Time/Size....................    9
  92.               Show Normal/Hidden Files....................    9
  93.               Sorting the File Display....................    9
  94.               Suppressing Flicker/Snow....................    9
  95.               Labeling a Volume...........................    9
  96.  
  97.          File Menu........................................    9
  98.               Attributes..................................   10
  99.               Browsing ASCII Files........................   10
  100.               Browsing Binary Files.......................   10
  101.               Using Your Debug Program....................   10
  102.               Using Your Edit Program.....................   10
  103.               Executing a BAT, COM, or EXE file...........   10
  104.               Printing a File.............................   10
  105.               Renaming a File.............................   10
  106.  
  107.  
  108.  
  109.  
  110. DOSamatic User Guide           May 15, 1985                      Page 2
  111.  
  112.  
  113.     7. Quick Reference....................................   11
  114.          Table of Keystrokes..............................   11
  115.          How to End DOSamatic.............................   11
  116.  
  117.     8. Multi-Tasking
  118.          How to Use It....................................   12
  119.          Technical Details................................   12
  120.  
  121.          Compatible Software..............................   13
  122.          Cautions.........................................   14
  123.          Encouragements...................................   14
  124.  
  125.     9. Your License Agreement.............................   15
  126.  
  127.  
  128.  
  129.  
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.  
  137.  
  138.  
  139.  
  140.  
  141.  
  142.  
  143.  
  144.  
  145.  
  146.  
  147.  
  148.  
  149.  
  150.  
  151.  
  152.  
  153.  
  154.  
  155.  
  156.  
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166. DOSamatic User Guide           May 15, 1985                      Page 3
  167.  
  168.  
  169.                                1. Introduction
  170.  
  171. DOSamatic is a powerful tool that helps you get the most out of your IBM
  172. Personal Computer or compatible.  It combines a Macintosh ( tm )-like user 
  173. interface that uses "point and press" to perform useful actions with a 
  174. powerful multi-tasking facility which lets you run several programs and the 
  175. same time.
  176.  
  177. DOSamatic is not copy-protected.  You are encouraged to give copies to your 
  178. friends for their use.  If you find the program useful you can send a check 
  179. for $39.00 payable to :
  180.  
  181.                            Marin Pacific Software
  182.                           1001 Bridgeway, Suite 514
  183.                              Sausalito, CA 94965
  184.  
  185. If there is a serial number on the program, please include it along with
  186. your name and mailing address.
  187.  
  188. We will register you as a DOSamatic user, and send you the latest version 
  189. of the program, along with the latest user guide ( currently printed on an 
  190. HP Laserjet to be easy on your eyes! ).  Please send us any suggestions you
  191. may have for enhancements or improvements in DOSamatic.
  192.  
  193. Besides being a nice thing to do, registering brings you several benefits.  
  194. When another user registers a copy with your serial number, we'll send you 
  195. a check for 10 percent of the amount they send us.  We'll also keep you on 
  196. our mailing list so that we can send you other products we develop for your 
  197. examination at no cost.
  198.  
  199. Even if you decide not to register, please do not attempt to delete the 
  200. copyright and order information messages.  We don't copy protect any of our 
  201. packages, and we depend upon you to respect our efforts.
  202.  
  203. Corporate Users Note: Site licenses for multiple copies are available at 
  204. very reasonable terms.
  205.  
  206.  
  207.  
  208.  
  209.  
  210.  
  211.  
  212.  
  213.  
  214.  
  215.  
  216.  
  217.  
  218.  
  219.  
  220.  
  221.  
  222.  
  223.  
  224. DOSamatic User Guide           May 15, 1985                      Page 4
  225.  
  226.  
  227.                            2. System Requirements
  228.  
  229. DOSamatic will run on the IBM PC, PC/XT, PC/AT, 3270PC, and most
  230. compatibles including the Compaqs and the Data General DG/1.  Minimum
  231. requirements are :
  232.  
  233.     128 KB of memory ( although up to 640 KB is useful for running
  234.     multiple tasks ).
  235.  
  236.     PC DOS 2.0, 2.1, 3.0, 3.1, or MS-DOS 2.11.
  237.  
  238.     One diskette drive.
  239.  
  240.     Either a color or a monochrome monitor with 80 column display.
  241.  
  242.  
  243. Note that DOSamatic determines how much memory you actually have, the 
  244. number of disk drives ( including hard disks and RAM disks ) available, and 
  245. the type of monitor you are using.
  246.  
  247.  
  248.                         3. The DOSamatic Program Disk
  249.  
  250. If you receive DOSamatic from Marin Pacific Software or from a friend, 
  251. there should be three files on the diskette :
  252.  
  253. DOSAMATC.COM   - The DOSamatic Program
  254.  
  255. DOSAMATC.DOC   - This manual in ASCII text format.
  256.  
  257. DOSAMATC.HLP   - File containing HELP screens used by DOSamatic.
  258.  
  259. If you receive your program disk from us, there may be other files on the 
  260. disk to help you install DOSamatic.  Just use the DOS TYPE command to 
  261. display the contents of the file call READ.ME to find out what is on your 
  262. program disk.
  263.  
  264. Unlike many copy-protected programs, the DOSamatic program disk is only 
  265. required when you start the program.  If you wish to use the HELP facility 
  266. however, the DOSamatic program disk must be available.  See the section on 
  267. starting DOSamatic for more details.
  268.  
  269.  
  270.  
  271.  
  272.  
  273.  
  274.  
  275.  
  276.  
  277.  
  278.  
  279. DOSamatic User Guide           May 15, 1985                      Page 5
  280.  
  281.  
  282.                             4. Starting DOSamatic
  283.  
  284. Starting DOSamatic is easy.  Simply place the program diskette in the 
  285. current default disk drive ( not necessary for hard disk users ), type 
  286. "DOSAMATC", and press [ENTER].  DOSamatic will start and assume you wish to 
  287. use the current default drive for the HELP file.  You can specify which 
  288. drive should be used for HELP by typing : "DOSAMATC C:" before pressing 
  289. [ENTER], which will tell DOSamatic to look for the HELP file on drive C.
  290.  
  291. DOSamatic will display the Marin Pacific Software logo screen, and then the 
  292. license agreement under which you may use the program.  Please do not try 
  293. to alter the program to suppress these messages.
  294.  
  295. Finally, DOSamatic will display its main screen with the Information, Drive 
  296. Selection, Directory Selection, and File Selection Panels.
  297.  
  298.  
  299.                              5. DOSamatic Basics
  300.  
  301. The Information Panel
  302.  
  303. After starting DOSamatic, you will see a full screen display - the main 
  304. DOSamatic screen.  The screen consists of an Information Panel at the top
  305. which shows you:
  306.  
  307.     The default disk drive, the volume label of the drive, and the current 
  308.     directory for that drive.
  309.  
  310.     Disk space information including total KB ( kilobytes ) on the 
  311.     diskette, the KB available ( free ), the available KB as a percent of 
  312.     the total, and the number of files displayed along with the KB of 
  313.     space they occupy.
  314.  
  315.     Total RAM ( random access memory ) on your PC, and the RAM available 
  316.     for running additional programs.
  317.  
  318.     The version of DOS you are using
  319.  
  320.     The number of tasks ( programs ) you are currently running ( including 
  321.     DOSamatic ).
  322.  
  323.     The status of the keyboard shift keys ( in the top right corner ).
  324.     Press the Scroll Lock key several times to see how this feature works.
  325.  
  326. Below the Information Panel are the three Selection Screens.
  327.  
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334. DOSamatic User Guide           May 15, 1985                      Page 6
  335.  
  336.  
  337.  
  338. The Drive Selection Panel
  339.  
  340. In the panel labelled "Drives" is a list of the available drive letters on
  341. your system.  Use the cursor keys to move the large reverse video cursor
  342. bar onto a drive letter, and then press [ENTER].  The selected drive letter
  343. will become the DOS default drive, and the Information, Directory,
  344. Selection, and File Selection Panels will be refreshed to show information
  345. about the drive you have selected.
  346.  
  347. If you change the diskette in a drive, then you will need to select that
  348. drive again to read the new diskette.
  349.  
  350. The Directory Selection Panel
  351.  
  352. The panel labelled "Directories" shows you a list of all the directories on 
  353. your diskette which are accessible from the directory which is currently 
  354. active.  To view a different directory, place the cursor bar on the desired 
  355. directory and press [ENTER].  Note the two special directory entries, 
  356. <root> and <parent>, which enable you to jump to directly to the root 
  357. directory, or back one step in the current directory chain.
  358.  
  359. If there are too many directories to fit in the window, then the window 
  360. will scroll up and down as you move the cursor keys off the ends.
  361.  
  362. When the cursor bar is in the Directory Selection Panel, pressing [INSERT] 
  363. creates a new directory, and DOSamatic will prompt you for its name and 
  364. extension.  Press [ESCAPE] if you change your mind about creating the new 
  365. directory.
  366.  
  367. Pressing [DELETE] when the cursor bar is placed on a directory name will 
  368. delete that directory ( DOSamatic does check to make sure you want to do 
  369. that ).
  370.  
  371. The File Selection Panel
  372.  
  373. The panel labelled "Files" shows you a list of all the files in the current 
  374. directory on the default disk.  Placing the cursor bar on a file name and 
  375. pressing [ENTER] opens a pull-down menu at the right side of the screen 
  376. from which you may select operations to be performed on the file.
  377.  
  378. If there are too many files to fit in the window, then the window will 
  379. scroll up and down as you move the cursor keys off the ends.
  380.  
  381. When the cursor bar is in the File Selection Panel, pressing [INSERT]
  382. creates a new file, and DOSamatic will prompt you for its name and
  383. extension.  Press [ESCAPE] if you change your mind about creating the new
  384. file.
  385.  
  386.  
  387.  
  388.  
  389.  
  390.  
  391. DOSamatic User Guide           May 15, 1985                      Page 7
  392.  
  393.  
  394.  
  395. Pressing [DELETE] when the cursor bar is placed on a file name will delete
  396. that file ( DOSamatic does check to make sure you want to do that ).  If
  397. the file has special attributes, you may need to activate the Attribute
  398. Selection Panel and make changes before attempting to delete the file.
  399.  
  400. Comparison with DOS Commands
  401.  
  402. Note that the Directory and File Selection Panels show you the same
  403. information that the DOS DIR command would, except that all the files in
  404. the current directory are available for your viewing.
  405.  
  406. The Information Panel gives you the same information that the DOS CD,
  407. CHKDSK, VOL, and VER commands would.
  408.  
  409. The use of the [INSERT] and [DELETE] keys replaces use of the DOS MKDIR, 
  410. RMDIR, and ERASE commands.
  411.  
  412.  
  413.                             6. DOSamatic Commands
  414.  
  415. Special Keys
  416.  
  417. By using only a few keys, plus pull-down menus, DOSamatic lets you perform 
  418. complex functions without the need to memorize complex keystroke 
  419. sequences.  These are:
  420.  
  421.  
  422. The Cursor Keys              These keys let you move the cursor bar within 
  423.                             and between windows.  On the IBM PC keyboard 
  424.                             they are arranged as:
  425.  
  426.                             [HOME]     [UP  ]    [PAGE UP  ]
  427.  
  428.                             [LEFT]     [    ]    [RIGHT    ]
  429.  
  430.                             [END ]     [DOWN]    [PAGE DOWN]
  431.  
  432. Within any active panel, the [HOME], [UP], [PAGE UP], [END], [DOWN], and  
  433. [PAGE DOWN] keys work as you would expect to move the cursor bar within 
  434. the panel.  For the Drive, Directory, and File Selection Panels, [LEFT] 
  435. and [RIGHT] move the bar between panels, but have no effect for other 
  436. panels.
  437.  
  438. During prompting for input lines, [LEFT] and [RIGHT] work as you would
  439. expect, [HOME] moves you to the beginning of the input line, [END] moves
  440. you to the end, and [CTRL]+[END] will delete all characters from the
  441. current position to the end of the input line.
  442.  
  443.  
  444.  
  445.  
  446.  
  447.  
  448. DOSamatic User Guide           May 15, 1985                      Page 8
  449.  
  450.  
  451.  
  452. The [ENTER] key              This key is used to select a drive, directory, 
  453.                             file, or panel option, or to signal the end of 
  454.                             an input line.  Think of it as the Activator 
  455.                             key.
  456.  
  457. The [ESCAPE] key             This key functions as a Deactivator key which 
  458.                             lets you jump from the current panel to a 
  459.                             previous one.  It lets you shift between the 
  460.                             Main Menu Panel and the Drive, Directory, and 
  461.                             File Selection Panels.
  462.  
  463. The [F1] = [HELP] key        Will cause a context-sensitive help screen 
  464.                             explaining what your current options are to be 
  465.                             displayed.
  466.  
  467. The [F2] = [REFRESH] key     This key will refresh the display screen when 
  468.                             if it ever gets damaged.
  469.  
  470. The [F40] = [SWITCH] key     This "hot key" lets you jump from one active 
  471.                             task to another.  It is equivalent to pressing
  472.                             the [ALT] and [F10] keys simultaneously.  If no
  473.                             subtasks are active, [F40] has no effect.
  474.  
  475. The Main Menu Panel
  476.  
  477. If the cursor bar is in the Drive Selection, Directory Selection, or File 
  478. Selection panels, pressing [ESCAPE] activatees the Main Menu Panel.  This 
  479. pull-down menu lets you execute a number of system functions.  Move the 
  480. cursor bar to one of the functions and press [ENTER] to activate it.  
  481. Pressing [ESCAPE] will return you to the panel you were in before you 
  482. activated the Main Menu Panel.
  483.  
  484. The Main Menu Panel functions are :
  485.  
  486.     Color On/Off       Lets you switch color on and off.  Monochrome 
  487.                        monitors with graphics adapters usually look best 
  488.                        with color off.
  489.  
  490.     DOS Commands       Pressing this key lets you issue any legal DOS 
  491.                        command if memory is available.  You are prompted
  492.                        for the command at the bottom of the screen.
  493.  
  494.  
  495.  
  496.  
  497.  
  498.  
  499.  
  500.  
  501.  
  502.  
  503.  
  504.  
  505. DOSamatic User Guide           May 15, 1985                      Page 9
  506.  
  507.  
  508.  
  509.     Exit               Use this selection to end DOSamatic and return to
  510.                        DOS.  You can't do this if any sub-tasks are still
  511.                        running.
  512.  
  513.     Filemask           Upon selecting this option, you are prompted for a
  514.                        file mask, and DOSamatic will then display only
  515.                        those files matching the mask.  For example,
  516.                        entering *.COM will result in the display of only
  517.                        those files with extension of COM.
  518.  
  519.     Search             Selecting this item you are prompted for a filename
  520.                        and extension, and DOSamatic will search all 
  521.                        directories on the default drive for that file.  
  522.                        Using *.EXE, for example, DOSamatic will find all 
  523.                        files with an extension of EXE.
  524.  
  525.     Show Date/Time     This selection switches the display of file date, 
  526.                        time, and KB occupied on and off.
  527.  
  528.     Show Hidden Files  This item switches on and off the display of files 
  529.                        with the special DOS attributes of SYSTEM and/or
  530.                        HIDDEN.  For example, the files IBMBIO.COM and 
  531.                        IBMDOS.COM are system and hidden files present on
  532.                        the DOS system disk.
  533.  
  534.     Sort               Selecting this item opens a sort pull-down menu in 
  535.                        which you specify the sort key, and the order ( 
  536.                        ascending or descending ).  The files are not 
  537.                        re-sorted until the diskette is read again.
  538.  
  539.     Sound On/Off       Switches on and off the use of sound cues with 
  540.                        DOSamatic.
  541.  
  542.     Suppress Flicker   For IBM Color Graphics Adaptors, writing directly 
  543.                        to the screen memory in 80 column alphanumeric mode 
  544.                        will cause "snow".  To prevent this, the video must 
  545.                        be shut off momentarily, causing a small amount of 
  546.                        display flicker.  Many other adapters do not have 
  547.                        this problem, and you can reduce display flicker by 
  548.                        selecting this item.
  549.  
  550.     Volume Label       Selecting this option allows you to create or 
  551.                        change an 11-character volume label for the 
  552.                        diskette in the default drive.
  553.  
  554.  
  555. The File Menu Panel
  556.  
  557. Pressing [ENTER] when the cursor bar is in the File Selection Panel opens
  558. the File Menu Panel pull-down menu.  This menu shows you a number of
  559. actions which you can perform upon the selected file when you press the
  560. [ENTER] key.  You can return to the File Selection Panel at any time by
  561. pressing [ESCAPE].  The following functions can be performed on the
  562. selected file:
  563.  
  564.  
  565. DOSamatic User Guide           May 15, 1985                      Page 10
  566.  
  567.  
  568.     Attributes         Selecting this item will open the Attributes Panel, 
  569.                        which displays the files attributes and lets you 
  570.                        modify them if desired.  For example, you can hide 
  571.                        files or make them read-only to prevent 
  572.                        unauthorized viewing or deletion.
  573.  
  574.     Browse ASCII       Displays the contents of the selected file, 
  575.                        assuming that it is in ASCII text format.
  576.  
  577.     Browse Binary      Provides both an ASCII and a hexadecimal display of 
  578.                        file contents for files in non-text format.
  579.  
  580.     Copy               Lets you copy the current file to another file.
  581.  
  582.     Debug              Activates the IBM/Microsoft DEBUG program to debug 
  583.                        the selected file.  This function assumes that the 
  584.                        DEBUG program is in the root directory of drive A:. 
  585.                        You can of course use any program named DEBUG.COM 
  586.                        in its place.
  587.  
  588.     Edit               Activates the IBM/Microsoft EDLIN program to edit
  589.                        the selected file.  This function assumes that the 
  590.                        DDLIN program is in the root directory of drive A:. 
  591.                        You can of course use any program named EDLIN.COM 
  592.                        in its place.
  593.  
  594.     Execute            The most powerful capability of DOSamatic, allows 
  595.                        you to execute any other program in available 
  596.                        memory.  The selected file must have an extension 
  597.                        of BAT, COM, or EXE.  BAT files receive all 
  598.                        available memory, but COM or EXE files can be 
  599.                        restricted to run in a portion of memory.
  600.  
  601.                        You are prompted for the amount of memory in KB to 
  602.                        be used.  You are also asked if this is a graphics 
  603.                        program, which requires additional storage for a 
  604.                        screen buffer.
  605.  
  606.                        Once your selected program starts, you can jump 
  607.                        immediately back to DOSamatic by pressing [F40] = 
  608.                        [ALT] + [F10] = [SWITCH].  If you have memory left, 
  609.                        you can start other programs ( up to a limit of 7 
  610.                        additional programs ) and switch among them using 
  611.                        the [SWITCH] key.
  612.  
  613.     Print              Prints the selected file to LPT1:.  Use this for 
  614.                        small files for which you want a quick copy.
  615.  
  616.     Rename             Lets you rename the selected file.
  617.  
  618.  
  619.  
  620.  
  621.  
  622.  
  623. DOSamatic User Guide           May 15, 1985                      Page 11
  624.  
  625.                        7. Quick Reference to DOSamatic
  626.  
  627. Active Panel           Key        Action
  628.  
  629. Drive Selection        [ENTER]    Select Drive
  630.                       [ESCAPE]   Activate Main Menu
  631.                       [LEFT]     Go to File Selection Panel
  632.                       [RIGHT]    Go to Directory Selection Panel
  633.  
  634. Directory Selection    [DELETE]   Remove selected directory
  635.                       [ENTER]    Select Directory
  636.                       [ESCAPE]   Activate Main Menu
  637.                       [INSERT]   Make a new directory
  638.                       [LEFT]     Go to Drive Selection Panel
  639.                       [RIGHT]    Go to File Selection Panel
  640.  
  641. File Selection         [DELETE]   Erase selected file
  642.                       [ENTER]    Activate File Menu Panel
  643.                       [ESCAPE]   Activate Main Menu
  644.                       [INSERT]   Create a new file
  645.                       [LEFT]     Go to Directory Selection Panel
  646.                       [RIGHT]    Go to Drive Selection Panel
  647.  
  648. Main Menu              [ENTER]    Perform indicated action
  649.                       [ESCAPE]   Deactivate Main Menu Panel
  650.  
  651. File Menu              [ENTER]    Perform indicated action
  652.                       [ESCAPE]   Return to File Selection Panel
  653.  
  654.  
  655. Sort Selection         [ENTER]    Use indicated sort criteria
  656.                       [ESCAPE]   Return to Main Menu Panel
  657.  
  658. Attribute Menu         [ENTER]    Make indicated attribute change
  659.                       [ESCAPE]   Return to File Menu Panel
  660.  
  661. ** ALL PANELS **       [F1]       Help ( context sensitive ).
  662.                       [F2]       Refresh Screen
  663.                       [F40]      Jump to another task if one is active 
  664.                                  (See Execute option of File Menu Panel).
  665.  
  666. In all panels the cursor keys not mentioned above will move the cursor bar 
  667. up and down within the panel.
  668.  
  669. Ending DOSamatic
  670.  
  671. Press the [ESCAPE] key until the Main Menu Panel is displayed, place the
  672. cursor bar on EXIT, and press [ENTER].  A more drastic way to end is to
  673. hold down the [ALT] key, and press the digits 2, 5, 5 in order on the
  674. numeric keypad.  Be careful with that method of ending.
  675.  
  676.  
  677.  
  678.  
  679.  
  680. DOSamatic User Guide           May 15, 1985                      Page 12
  681.  
  682.  
  683.                               8. Multi-Tasking
  684.  
  685. One of the most useful capabilities of DOSamatic is the ability to run from 
  686. 1 to 7 other programs simultaneously, switching between them by pressing a 
  687. single "hot key."  In this section we describe how to use this feature, how 
  688. the multi-tasking context switch is performed, and the compatibility of 
  689. various popular software packages with this feature.
  690.  
  691. How to Use It
  692.  
  693. Previously, you learned how to execute programs from DOSamatic by placing 
  694. the cursor bar on the program name, pressing [ENTER] to activate the File 
  695. Menu, and then placing the cursor on the EXECUTE option and pressing 
  696. [ENTER] again.  DOSamatic asks you for any required parameters, and then 
  697. requests the amount of memory in which you wish the program to run.  If the 
  698. available memory is 322 KB, say, you might wish to have your program use 
  699. 128 KB.
  700.  
  701. DOSamatic will then ask if this is a graphics program.  If you reply by 
  702. typing [Y], DOSamatic reserves an additional 16 KB of memory to preserve 
  703. the graphics screen when you start switching among programs.  Otherwise, 
  704. DOSamatic reserves 4 KB of memory for your program screen.
  705.  
  706. After your program starts, you can return to DOSamatic at any time by 
  707. pressing [F40], i.e. pressing the [ALT] key and the [F10] key 
  708. simultaneously.  This key combination was selected because very few 
  709. programs actually use it for anything ( although there are some ), and 
  710. because it is easy to hit with the left hand on the standard PC keyboard.
  711.  
  712. You can now switch at will between DOSamatic and your other program simply 
  713. by pressing [F40] = [ALT] + [F10].  If you did not use all the available 
  714. memory for your program, you can load additional programs from DOSamatic as 
  715. you did before, and use the hot key to switch among them all.  The Task 
  716. field at the top of the display tracks how many programs you have running.
  717.  
  718. Technical Details
  719.  
  720. DOSamatic performs its task switching by intercepting program calls to the 
  721. BIOS and DOS keyboard handlers.  It is always checking for the hot key, and 
  722. when pressed goes into action.  DOSamatic also monitors some of the BIOS 
  723. video monitor calls, since the BIOS does not preserve all video 
  724. information.  Finally, DOSamatic intercepts calls to the DOS memory control 
  725. functions to limit program requests for memory.
  726.  
  727. Programs that bypass the keyboard services and manipulate the hardware
  728. directly will not let you jump back to DOSamatic.  However, pop-up 
  729. applications like Sidekick (tm) can be installed successfully before you 
  730. start DOSamatic and can be used during your DOSamatic session.
  731.  
  732. Certain programs manipulate PC hardware directly, so DOSamatic has no way 
  733. of knowing what they are doing.  This is especially true of graphics.  See 
  734. the notes on Lotus 123 (tm) and SuperCalc 3 (tm).
  735.  
  736.  
  737.  
  738. DOSamatic User Guide           May 15, 1985                      Page 13
  739.  
  740.  
  741. Compatible Software
  742.  
  743. The following programs have been tested by various users with DOSamatic and
  744. have behaved in a reasonable manner.  If there is a comment, it reflects
  745. any incompatibilities which may arise.  No comments are made when there is
  746. no known compatibility problem.
  747.  
  748. Program           Vendor               Comments
  749.  
  750. BASIC             IBM/Microsoft
  751.  
  752. CrossTalk         MicroStuf
  753.  
  754. DOS 2.x, 3.X      IBM/Microsoft        When loading a secondary copy of the 
  755.                                       command processor COMMAND.COM, it 
  756.                                       must be given all remaining memory.  
  757.                                       If you are loading this, load it 
  758.                                       last.
  759. DEBUG             IBM/Microsoft
  760.  
  761. Displaywrite 2    IBM                  DW 2 reserves all available memory 
  762.                                       when it loads.  It apparently does
  763.                                       not use the DOS function call to 
  764.                                       check available memory.
  765.  
  766. DOSamatic         Marin Pacific        You can run one or more copies of 
  767.                                       DOSamatic as tasks, but don't try to 
  768.                                       run any sub-tasks from the copies.
  769. EDLIN             IBM/Microsoft
  770.  
  771. Lotus 123         Lotus Development    Lotus works well, with a few 
  772.                                       exceptions.  Lotus manipulates video 
  773.                                       hardware directly.  The cursor often 
  774.                                       blinks in the wrong place, although 
  775.                                       this stops as soon as you hit any 
  776.                                       keystroke.  Do not try to leave 
  777.                                       Lotus while a graph is displayed.
  778.  
  779. MultiMate         MultiMate Corp.      [F40] sometimes has a meaning - 
  780.                                       press [ESCAPE] after switching back 
  781.                                       into MultiMate if there is a problem.
  782. Norton Utilities  Peter Norton
  783.  
  784. PC-Talk III       Headlands Press
  785.  
  786. SIM3278           SIMWARE
  787.  
  788. SuperCalc 3       Sorcim/IUS           The border color on color monitors
  789.                                       and the graphics colors are not
  790.                                       preserved, although you can switch
  791.                                       while a graph is displayed.
  792.  
  793.  
  794.  
  795. DOSamatic User Guide           May 15, 1985                      Page 14
  796.  
  797.  
  798. Turbo Pascal      Borland Int'l        Do not jump unless you are editing a 
  799.                                       file.  The hot key is interpreted as 
  800.                                       a Quit instruction.
  801.  
  802. Volkswriter       Lifetree             
  803.  
  804. Word Microsoft    Word is a graphics program, at least if you have the 
  805.                  Color Graphics Adapter.
  806.  
  807. Wordstar          MicroPro Int'l
  808.  
  809. Cautions
  810.  
  811. There are some problems whenever you try to implement multi-tasking on a 
  812. machine which is not really designed for it.  These are mainly because 
  813. DOSamatic has no real control over what the programs you execute are 
  814. doing.  Two things you must absolutely avoid, however, are :
  815.  
  816.     Never attempt to run COMMAND.COM ( the DOS command processor ) in less 
  817.     than the total remaining memory.  The system will hang in an 
  818.     unrecoverable error.  So if you are going to run a number of programs 
  819.     including a second copy of DOS as tasks, start all the others before
  820.     you start up COMMAND.COM, and give COMMAND.COM all the remaining 
  821.     memory.
  822.  
  823.     Be extremely careful when you end a program.  Always end programs in 
  824.     the reverse of the order in which you start them.  If you start A, B, 
  825.     and C in that order, you must end them in the order C, B, A. Failing 
  826.     to do this will generally lead to an unrecoverable error and the big 
  827.     red switch.
  828.  
  829. Encouragements
  830.  
  831. We can't possibly test all the programs which you might want to run as 
  832. DOSamatic tasks.  Most programs will run just fine, however, and we would 
  833. be pleased to hear of your experiences.  Just drop us a note at our mailing 
  834. address and we'll make sure to include any interesting comments which you 
  835. may have in future editions of this manual.
  836.  
  837.  
  838.  
  839.  
  840.  
  841.  
  842.  
  843.  
  844.  
  845.  
  846.  
  847.  
  848.  
  849.  
  850.  
  851.  
  852.  
  853. DOSamatic User Guide           May 15, 1985                      Page 15
  854.  
  855.  
  856.                           9. Your License Agreement
  857.  
  858. DOSamatic is the sole property of Marin Pacific Software Company.  You are
  859. granted a limited, non-exclusive license to evaluate DOSamatic on a trial
  860. basis, and to make copies for other users to do so.
  861.  
  862. You may not:
  863.  
  864.     Remove copyright and other notices from the program and documentation
  865.     which are placed there by Marin Pacific Software.
  866.  
  867.     Re-sell the program for any charge or "disk fee"
  868.  
  869.     Make any representations on behalf of Marin Pacific Software.
  870.  
  871. Marin Pacific Software makes no warranty, express or implied, as to the 
  872. suitability of DOSamatic for any particular purpose.  You must determine 
  873. that yourself.  In addition, you should understand that using a program of 
  874. this type on an IBM PC or compatible has inherent risks and that you may 
  875. inadvertently damage or destroy valuable programs or data.  Marin Pacific 
  876. Software expressly declines to assume liability for any use of this program 
  877. by you, and your use of DOSamatic constitutes your agreement to hold us
  878. blameless.
  879.  
  880. If you regularly use DOSamatic, you should register your trial copy by 
  881. sending a check or money order for $39.00 to
  882.  
  883.                  Marin Pacific Software Company
  884.                  1001 Bridgeway, Suite 514
  885.                  Sausalito, CA 94965
  886.  
  887. Please enclose your name and address, any serial number which may appear on
  888. your trial copy, and any comments you may have.  Marin Pacific will send 
  889. you the latest version of DOSamatic ( we are improving it all the time ) 
  890. and the DOSamatic user guide.  In addition, when other users register 
  891. copies with your serial number, we will send you a check for 10 % of the 
  892. amount they send us, if it is no less than $39.00.
  893.  
  894. Registered users may upgrade to new versions of DOSamatic at any time for a 
  895. small charge required to cover diskette, handling and postage. (currently 
  896. $5.00 ).
  897.  
  898. Multiple use site licenses for corporations are available at significant 
  899. discounts from single copy prices, and customization is possible for 
  900. high-volume purchasers.
  901.  
  902.  
  903.  
  904.  
  905.  
  906.  
  907.  
  908.  
  909.  
  910.