home *** CD-ROM | disk | FTP | other *** search
/ Set of Apple II Hard Drive Images / hard.hdv / HARD / COMMANDS / PROPWR.DOC < prev    next >
Encoding:
Text File  |  1988-03-09  |  12.0 KB  |  397 lines  |  [04] ASCII Text (0x0000)
  1.  
  2.                        =================================
  3.                                ProPOWER Utilities
  4.                        ProDOS(tm) Added Command Handlers
  5.                                  by Bill Tudor
  6.                        =================================
  7.                                     NEMISYS
  8.                             Northeast Micro Systems
  9.                                  5C Kensington
  10.                                  London Square
  11.                             Clifton Park, NY  12065
  12.                               Tel. (518) 383-2858
  13.                           ----------------------------
  14.                           COPYRIGHT 1988 BY BILL TUDOR
  15.                               ALL RIGHTS RESERVED
  16.                              ---------------------
  17.                              Version 1.1  03/21/88
  18.                                    Price: $19
  19.                        =================================
  20.  
  21.                                Table of Contents:
  22.  
  23.                        Introduction.....................1
  24.                        Installing the commands..........1
  25.                        Using the commands...............2
  26.                        The commands.....................3
  27.                           POP........................3
  28.                           BEEP.......................3
  29.                           DATE.TIME.BEEP.............4
  30.                           HOOK & UNHOOK..............5
  31.                           MAP........................7
  32.                           MONITOR....................8
  33.                           ONLINE.....................9
  34.                           ProCOPY....................9
  35.                           SET.GET.INFO..............14
  36.                           TYPE......................17
  37.                           EJECT.....................19
  38.                           DIRCMD....................19
  39.                           SHOWTXT...................21
  40.                        Technical Notes.................23
  41.                        Selector System.................24
  42.                        Date.System.....................26
  43.                        Extras..........................27
  44.                        Legal notes.....................29
  45.  
  46.                                  Copyright 1988
  47.                                     NEMISYS
  48.                             Northeast Micro Systems
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.                                  === Page 1 ===
  68.  
  69.  
  70.  
  71.                   --------------------------------------------
  72.                                  <<<<NOTICE>>>>
  73.  
  74.                This file does NOT contain the complete documentation
  75.           of the programs. For complete documentation and the latest
  76.           versions of the ProDOS added command files, send $19 to
  77.           NEMISYS at the address listed above, or contact me on GEnie.
  78.  
  79.           The following is just a sample of the complete documentation
  80.           (over 30 pages). These files have been provided on GEnie as
  81.           a "preview" of the ProPOWER Utilities package. THEY MAY BE
  82.           TRANSFERRED FREELY BUT NOT SOLD. They are all COPYRIGHT 1988
  83.           by Bill Tudor.
  84.  
  85.           In addition to more command files, the complete version of
  86.           ProPOWER Utilities contains a program selector and ProDOS
  87.           date setter (for those among you who still do not have a
  88.           clock).
  89.  
  90.           I would greatly appreciate any comments and/or suggestions
  91.           regarding the ProPOWER Utilities package. My goal in
  92.           creating these command files was, as it always is, to
  93.           provide good, compatible, and easy to use software for Apple
  94.           II users.
  95.  
  96.  
  97.                                  <<<<NOTICE>>>>
  98.                 ------------------------------------------------
  99.  
  100.  
  101.  
  102.                                  =============
  103.                                  Introduction:
  104.                                  =============
  105.  
  106.                ProPOWER Utilities is a collection of ProDOS added
  107.           command handlers that allow you to add up to 17 NEW ProDOS
  108.           commands to the BASIC.SYSTEM interpreter. Included are
  109.           commands that allow you to copy files from directory to
  110.           directory, inspect the information in a file, map free and
  111.           used space on ANY ProDOS storage device, monitor ProDOS
  112.           activity, use the system date and time, change file
  113.           information, and much, much more. Once a ProDOS added
  114.           command is installed, it is available for use both in
  115.           immediate mode (from the BASIC prompt ']') and deferred mode
  116.           (within a running BASIC program).
  117.  
  118.                The ProDOS added commands on this disk are all
  119.           compatible with each other and can be installed in memory
  120.           separately or all at the same time. They will also be
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130.  
  131.  
  132.  
  133.                                  === Page 2 ===
  134.  
  135.  
  136.           compatible with other added command handlers and ampersand
  137.           (&) routines, provided these routines follow the proper
  138.           protocol specified by Apple Computer, Inc.
  139.  
  140.                             ========================
  141.                             Installing the Commands:
  142.                             ========================
  143.  
  144.                To install a command, simply BRUN the program. This can
  145.           be done from either immediate mode or deferred mode
  146.           (remember to preceed with a 'PRINT CHR$(4)' in deferred
  147.           mode). For example, to install the TYPE command you would
  148.           use:
  149.  
  150.           Immediate mode:               Deferred mode:
  151.  
  152.           ]BRUN TYPE                    10 PRINT CHR$(4);"BRUN TYPE"
  153.               or                                     or
  154.           ]-TYPE                        10 PRINT CHR$(4);"-TYPE"
  155.  
  156.                During installation, the program will load in at $4000
  157.           in memory, "buy" space from BASIC.SYSTEM, hook itself into
  158.           the chain of external command handlers (if any), and
  159.           relocate itself to a safe area of memory. Once installed,
  160.           the added command is at your disposal until BASIC.SYSTEM is
  161.           re-executed. For more information on ProDOS added command
  162.           handlers, see ProDOS Technical Reference Manual, Apple
  163.           Computer. Also, for some technical information on possible
  164.           memory "collisions" during installation, see the 'technical
  165.           notes' section of these instructions.
  166.  
  167.                You can install multiple commands by simply BRUNning
  168.           other command handlers. For example, if you wish to have the
  169.           commands COPY, MOVE, TYPE, MONITOR, and EJECT at your
  170.           disposal, add them as follows (recall that ProDOS has a
  171.           'smart run' or dash <-> command that can be used instead of
  172.           <BRUN>):
  173.  
  174.           Immediate mode:                 Deferred mode:
  175.  
  176.           ]-PROCOPY                       10 PRINT CHR$(4);"-PROCOPY"
  177.           ]-TYPE                          20 PRINT CHR$(4);"-TYPE"
  178.           ]-MONITOR                       30 PRINT CHR$(4);"-MONITOR"
  179.           ]-EJECT                         40 PRINT CHR$(4);"-EJECT"
  180.  
  181.                If there is not enough memory left for a new command to
  182.           fit into memory, a NO BUFFERS AVAILABLE error message will
  183.           be displayed. Refer to each specific command section for
  184.           their memory use information. The amount of memory available
  185.           for added commands depends on the size of any BASIC program
  186.           that may currently be in memory.
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.  
  196.  
  197.  
  198.  
  199.                                  === Page 3 ===
  200.  
  201.  
  202.  
  203.                               ===================
  204.                               Using The Commands:
  205.                               ===================
  206.  
  207.                Once installed, an added command becomes a part of
  208.           BASIC.SYSTEM until the system is re-booted (or BASIC.SYSTEM
  209.           is re-run). The command is at your disposal in both
  210.           immediate and deferred modes. To use a command in immediate
  211.           mode, simply issue the command from the BASIC prompt (']')
  212.           as you would any other ProDOS command (CATALOG, for example)
  213.           using the syntax described in the next section. As an
  214.           example, suppose the BEEP command was installed as described
  215.           above.
  216.  
  217.                To use the command (it simply beeps the speaker), just
  218.           issue it. Again you must preceed the command with a 'PRINT
  219.           CHR$(4)' in deferred mode:
  220.  
  221.           Immediate mode:                    Deferred mode:
  222.  
  223.           ]BEEP                              10 PRINT CHR$(4);"BEEP"
  224.  
  225.           Note that these commands are used in exactly the same manner
  226.           that the "regular" ProDOS commands are used, e.g., to
  227.           CATALOG a disk you would use:
  228.  
  229.           ]CATALOG                        10 PRINT CHR$(4);"CATALOG"
  230.  
  231.                                  ==============
  232.                                  The Commands:
  233.                                  ==============
  234.  
  235.           <<<< Send $19 to NEMISYS for complete documentation. >>>>
  236.  
  237.           A brief description of the commands provided follows:
  238.  
  239.           TYPE      - 'Types' ALL files (Txt, Awp, Bas, Bin, ect.)
  240.           VIEW      - 'Views' bytes in files
  241.           SHOWTXT   - 'Types' Txt files with forward/back scrolling
  242.                        Req's. 80-columns
  243.           DATE.TIME.BEEP - Return date/time on screen or in variable
  244.                            Syntax:DATE   or DATE DA$ ect.
  245.           PROCOPY   - COPYies or MOVEs ALL ProDOS files
  246.                       (including sparse files & single-drive copy)
  247.           MONITOR   - monitors ProDOS activity
  248.                       (MONITOR command toggles monitoring on/off)
  249.           DIRCMD    - Directory of entire volume
  250.           EJECT     - Eject 3.5" drives (it verifies 3.5" drive first)
  251.           HOOK      - 'HOOK'up and 'UNHOOK' ProDOS block devices
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.  
  262.  
  263.  
  264.  
  265.                                  === Page 4 ===
  266.  
  267.  
  268.  
  269.                                   ============
  270.                                   Legal Notes:
  271.                                   ============
  272.  
  273.           COPYRIGHT:
  274.           ----------
  275.                ProPOWER Utilities is COPYRIGHT 1988 by Bill Tudor.
  276.           Send $19 to the address below and you will receive the
  277.           complete ProPOWER Utilities package and a customer ID number
  278.           which, among other things, allows you to receive upgrades
  279.           and technical support.
  280.  
  281.           DISCLAIMER OF LIABILITY:
  282.           -----------------------
  283.           The software in this package has been tested thoroughly,
  284.           however, NEMISYS and/or the author shall not be liable for
  285.           any direct, indirect, incidental, or consequential damages
  286.           resulting from the use of this diskette, manual, or software
  287.           beyond the purchase price of the product.
  288.  
  289.  
  290.                                   -----------
  291.  
  292.  
  293.  
  294.  
  295.  
  296.  
  297.  
  298.  
  299.  
  300.  
  301.  
  302.  
  303.  
  304.  
  305.  
  306.  
  307.  
  308.  
  309.  
  310.  
  311.  
  312.  
  313.  
  314.  
  315.  
  316.  
  317.  
  318.  
  319.  
  320.  
  321.  
  322.  
  323.  
  324.  
  325.  
  326.  
  327.  
  328.  
  329.  
  330.  
  331.                                  === Page 5 ===
  332.  
  333.  
  334.  
  335.           ProDOS is a registered trademark of Apple Computer, Inc. It
  336.           has been licensed to Northeast Micro Systems (NEMISYS) for
  337.           use with the ProPOWER Utilities package.
  338.  
  339.           AppleWorks is a registered trademark of Apple Computer, Inc.
  340.  
  341.           APPLE COMPUTER, INC. MAKES NO WARRANTIES, EITHER EXPRESS OR
  342.           IMPLIED, REGARDING THE ENCLOSED COMPUTER SOFTWARE PACKAGE,
  343.           IT'S MERCHANTABILITY OR ITS FITNESS FOR ANY PARTICULAR
  344.           PURPOSE. THE EXCLUSION OF IMPLIED WARRANTIES IS NOT
  345.           PERMITTED BY SOME STATES. THE ABOVE EXCLUSION MAY NOT APPLY
  346.           NO YOU. THIS WARRANTY PROVIDES YOU WITH SPECIFIC LEGAL
  347.           RIGHTS. THERE MAY BE OTHER RIGHTS THAT YOU MAY HAVE WHICH
  348.           MAY VARY FROM STATE TO STATE.
  349.  
  350.  
  351.  
  352.  
  353.                            ==========================
  354.                                     NEMISYS
  355.                             Northeast Micro Systems
  356.                                  5C Kensington
  357.                                  London Square
  358.                             Clifton Park, NY  12065
  359.                               Tel. (518) 383-2858
  360.                           ===========================
  361.                           March 21, 1988      9:13 pm
  362.                           ProPOWER Utilities  Ver 1.1
  363.           <end
  364.  
  365.  
  366.  
  367.  
  368.  
  369.  
  370.  
  371.  
  372.  
  373.  
  374.  
  375.  
  376.  
  377.  
  378.  
  379.  
  380.  
  381.  
  382.  
  383.  
  384.  
  385.  
  386.  
  387.  
  388.  
  389.  
  390.  
  391.  
  392.  
  393.  
  394.  
  395.  
  396.  
  397.