home *** CD-ROM | disk | FTP | other *** search
/ CP/M / CPM_CDROM.iso / starlet / genienec / power241.lbr / POWER241.DQC / POWER241.DOC
Text File  |  1979-12-31  |  20KB  |  555 lines
  1. POWER 2.41 (CPMPOWER) DOCUMENTATION
  2.  
  3.      Note:  This documentation is preliminary and will
  4.             be revised at any time the author is able 
  5.             to acquire new information about CPMPOWER.
  6.  
  7. ********************************************************************************
  8.  
  9. POWER241 (aka CPMPOWER) is an early public domain version of the proprietary
  10. CP/M utility POWER! by Pavel Breder, which is marketed by COMPUTING! of San
  11. Francisco, California.  There appears to be no documentation for version 2.41
  12. other than a help file (CPMPOWER.DOC) which, if resident on the logged disk,
  13. can be called from the POWER241's menu.
  14.  
  15. Since the current version of the proprietary POWER! appears to be 2.57, it is
  16. conceivable that a later version of the public domain program may be floating
  17. around somewhere.  2.41 contains 28 commands, compared to the advertized 57 in
  18. POWER!  Having seen the latter in operation, there is no question that it pro-
  19. duces a much prettier screen and is somewhat easier to use.  However, for most
  20. purposes the enhancements are not sufficiently useful to justify purchase of
  21. the proprietary version -- at a list price of $169 -- if the public domain ver-
  22. sion is available:  All major commands appear to be present in version 2.41.
  23. The main omissions appear to be commands that are useful to programmers and
  24. hackers; these facilities are better handled by such public domain programs as
  25. DU, EDFILE, DISKDOC, DISKED, REZ/RESOURCE, and so on.  
  26.  
  27. Because I do not have access to a manual for POWER!, this documentation is
  28. based on my own experimentation with version 2.41, as well as a review of the
  29. proprietary version written by Alan Miller in the April, 1983, issue of Inter-
  30. face Age, beginning on page 106.  If anyone reading this happens to own a copy
  31. of POWER!, please inform me of any errors or omissions.  Contact me through:
  32.  
  33.             Valley Technical RCPM   602-938-7480
  34.             Garden of Eden BBS      602-991-0144
  35.  
  36.                         or
  37.  
  38.                    Deke Barker 
  39.                    OmniGraphics
  40.                    Box 8696
  41.                    Scottsdale, AZ  85252
  42.  
  43. ********************************************************************************
  44.  
  45. POWER241 (hereinafter called POWER) is a multi-function CP/M utility of a type
  46. resembling WASH, SWEEP, VFILER, and NSWP.  It should operate on most systems
  47. that use CP/M 1.4, 2.x, or MP/M.  It should also operate on CP/M 3.0, but I
  48. am unable to verify this.  It requires a minimum of 20k of memory, of which
  49. it occupies about 8k.
  50.  
  51. For most purposes, this utility effectively replaces PIP, STAT, XDIR, UNERA,
  52. FINDBAD, and the resident commands TYPE, ERA, REN, and DIR.  Because of certain
  53. rarely used facilities in PIP and STAT (concatenation for example), it would
  54. be unwise to eliminate them completely from one's library.  Also, since POWER
  55. is not able to squeeze/unsqueeze or type/print squeezed files, POWER cannot
  56. replace NSWP2xx.  (I retain the latter on a disk with my communications and
  57. library programs.)
  58.  
  59. To boot POWER, simply type POWER at the 'A>' prompt.  The following will then
  60. appear:
  61.  
  62.            CPMPOWER 2.41 by PAVEL BREDER  (c) 1981
  63.  
  64.                    revised as of 09/26/81
  65.  
  66.  
  67. A>
  68.  
  69.  
  70. Note that this is the same as the normal CP/M prompt, which can cause 
  71. some confusion unless one modifies the CCP the automatically load POWER
  72. at all warm boots.
  73.  
  74. ********************************************************************************
  75.  
  76. COMMANDS   [Items in brackets [] are entered by the user.]
  77.  
  78.  
  79. When entering a command, the user generally has the choice of typing the com-
  80. mand alone or with a filename/filetype parameter.  The first main command oper-
  81. ation listed (CHECK) shows both choices.  For subsequent commands, I have used
  82. the command + parameter method to save disk space and to avoid typist's cramp.
  83. When a command is typed without parameters, note that the directory is repro-
  84. duced exactly as it appears on the disk and not in alphabetical order.
  85.  
  86. To perform a command on a file that is not on the currently logged disk, type
  87. the command followed by a space and the new drive designation/colon.  
  88.  
  89.          A> [COPY B:]  or  A> [COPY B:VDO.COM]
  90.  
  91.  
  92. --------------------------------------------------------------------------------
  93.  
  94. COMMAND              FUNCTION
  95. ===================  ====================
  96.          EXAMPLE
  97.          ====================
  98.  
  99. --------------------------------------------------------------------------------
  100.  
  101.  
  102. ?                    List directory of available commands.
  103.  
  104.          A> [?]      
  105.  
  106.             ?                   LOG                 DIR 
  107.             COPY                USER                DEST  
  108.             CRT                 INFO                STAT
  109.             DISK                TEST                RECLAIM 
  110.             EXIT                TYPE                TYPEH
  111.             TYPEA               TYPEX               SIZE
  112.             CHECK               ERA                 REN
  113.             RUN                 JMP                 EXEC
  114.             SETDIR              SETSYS              SETREAD
  115.             SETWRITE
  116.  
  117.  
  118. *********
  119.  
  120. ^C                   Perform a warm boot and return to POWER.  (NOTE:  Warm
  121.                        boots occurring naturally after running a program from
  122.                        POWER will NOT return to POWER unless the CCP has been
  123.                        modified with AUTOLOAD, AUTOBOOT, SETAUTO, AUTOMOD, or
  124.                        a similar program.  See note at the end of this file.)
  125.  
  126.  
  127. *********
  128.  
  129. ^S                   Toggle scroll off/on.  (Pressing any key will cause the
  130.                        scrolling to resume; it is simply good practice to use
  131.                        ^S for both purposes.)
  132.  
  133.  
  134. *********
  135.  
  136. CHECK                Do a checksum (16 bit CRC -- cyclical redundancy check) on
  137.                        the file in question; this can be written down and com-
  138.                        pared with CRCs for supposedly identical files on other
  139.                        disks.
  140.  
  141.         A> [CHECK]
  142.        
  143.         A:   1= -        .100*
  144.         A:   2= -MACRO80 .LAN*
  145.         A:   3= (GO       .COM*
  146.         A:   4= M80      .COM
  147.         A:   5= L80      .COM
  148.         A:   6= LD80     .COM
  149.         A:   7= CREF80   .COM
  150.         A:   8= CCPLOC   .COM
  151.         A:   9= REZ      .COM
  152.         A:  10= SYSGEN   .COM
  153.         A:  11= UNLOADN  .COM
  154.         A:  12= VDO      .COM
  155.         A:  13= XSUB     .COM
  156.         A:  14= XLATE    .COM
  157.         ? [10]
  158.  
  159.         A:SYSGEN  .COM  (Y/N) ?[Y]Yes - checksum...62C7
  160.  
  161.  
  162. *********
  163.  
  164. COPY                 Copy a file or a group of files between drives.  A CRC
  165.                        is used to verify integrity of transfer.
  166.                      
  167.         A> [COPY VDO.COM]
  168.  
  169.         destination drive :[B]
  170.  
  171.         B:=A:VDO     .COM (Y/N) ?[Y]Yes
  172.        
  173.  
  174. *********
  175.  
  176. CRT                  ***NOT IMPLEMENTED***
  177.  
  178.  
  179. *********
  180.  
  181. DEST                 ***NOT IMPLEMENTED***
  182.  
  183.  
  184. *********
  185.  
  186. DIR                  List disk directory, including $SYS, $DIR, $R/O, and $R/W
  187.                        attributes.  The symbol '(' before a filename indicates
  188.                        that it is a system file ($SYS).  The symbol '*' after a
  189.                        filename indicates that it is a read-only file ($R/O).
  190.  
  191.         A> [DIR]   
  192.  
  193.         A:  -       .100*
  194.         A:  -MACRO80.LAN*
  195.         A:  (GO     .COM*
  196.         A:  M80     .COM
  197.         A:  L80     .COM
  198.         A:  LD80    .COM
  199.         A:  CREF80  .COM
  200.         A:  CCPLOC  .COM
  201.         A:  REZ     .COM
  202.         A:  SYSGEN  .COM
  203.         A:  UNLOADN .COM
  204.         A:  VDO     .COM
  205.         A:  XSUB    .COM
  206.         A:  XLATE   .COM
  207.  
  208.  
  209. *********
  210.  
  211. DISK                 Show disk information.  (The information below refers to 
  212.                        a single density Osborne 1.)
  213.  
  214.         A> [DISK]
  215.         Disk                A:
  216.         Disk capacity:       92 Kilobytes
  217.         Tracks:              40
  218.         Sectors/track:       20
  219.         Groupsize (1):       16 (sectors per group)
  220.         Groupsize (2):        2 Kilobytes (per group)
  221.         Total groups:        46
  222.         Dir entries:         64 (32 bytes each)  [[maximum entries]]
  223.         Dir size:             2 Kilobytes
  224.         System tracks:        3
  225.         Used space:          84K  Free space:                6K
  226.  
  227.  
  228. *********
  229.  
  230. ERA                  Prompted (Y/N) erase utility for single or multiple
  231.                        files.
  232.          
  233.         A> [ERA VDO.COM]
  234.         A: 12= VDO     .COM
  235.         Procede (Y/N) ?[Y]Yes
  236.  
  237.         A:RECORD  .COM (Y/N) ?[Y]Yes
  238.  
  239.  
  240. *********
  241.  
  242. EXEC nnnn            Jump to a specific address and return to POWER.  (This
  243.                        function is of limited use except to experienced pro-
  244.                        grammers, who will find other public domain programs 
  245.                        more complete.)
  246.  
  247.  
  248. *********
  249.  
  250. EXIT                 Exit POWER.
  251.  
  252.  
  253. *********
  254.  
  255. INFO                 Type CPMPOWER.DOC if located on the logged disk, or if
  256.                        located on another drive and the command INFO is fol-
  257.                        lowed by the drive designation (as INFO B).  See the
  258.                        file CPMPOWER.DOC.
  259.  
  260.  
  261. *********
  262.  
  263. JMP  nnnn            Jump to a specific address and return to CP/M. See EXEC.
  264.  
  265.  
  266. *********
  267.  
  268. LOG                  List POWER default settings.  The first group of settings
  269.                        (A, B, C, D) refer to the COPY function.  The second 
  270.                        setting (1-5) establishes the number of columns in a
  271.                        directory  listing.  The third (R) toggles the 'request'
  272.                        function on and off.  The fourth (V) function is another
  273.                        toggle-key the purpose of which I have yet to discover.
  274.                        The last function (S) toggles the listing of system 
  275.                        files in directories.  (See the note at the end of this
  276.                        file for an explanation of how to alter the default
  277.                        settings.)  
  278.                     
  279.                        The 'S' default must be 'ON' in order to change a file's
  280.                        status (or manipulate it in any way) if that file is
  281.                        a system ($SYS) file.
  282.  
  283.          A> [LOG]
  284.  
  285.          Defaults (use [n] to set or change)
  286.  
  287.          D        If file exist A-overlay, B-back up, C-ask, D-skip
  288.          1        columns in directory
  289.          R (ON)   request Y/N on current file
  290.          V (OFF)  read after write flag
  291.          S (OFF)  show system files
  292.  
  293.          USER in use:00,  destination USER:00
  294.  
  295.  
  296. *********
  297.  
  298. RECLAIM              Unerase erased files; BE VERY CAREFUL -- like UNERA, this
  299.                        facility is not foolproof.  It will only work if the
  300.                        file has not been over-written.  It is best used in
  301.                        cases where a file was accidently erased, and no further
  302.                        data has been entered onto the disk in question.  
  303.  
  304.          A> [RECLAIM] --- DELETED FILES ---
  305.  
  306.          A:FORMAT  .COM - recover (Y/N) ?[N]No
  307.          A:N       .COM - recover (Y/N) ?[N]No
  308.          A:DU-V86  .COM - recover (Y/N) ?[Y]Yes WAIT...
  309.          A:DISKED  .COM - recover (Y/N) ?[N]No
  310.  
  311.  
  312. *********
  313.  
  314. REN                  Prompted file renaming utility.  Will accept the old name
  315.                      but not the new name as a parameter on the command line.
  316.  
  317.          A> [REN VDO.COM]
  318.          A:  12= VDO     .COM
  319.   
  320.          A:VDO     .COM = new NAME:[EDIT.COM]
  321.          A:VDO     .COM = EDIT    .COM  rename (Y/N) ?[Y]Yes
  322.  
  323.  
  324. *********
  325.  
  326. RUN                  Command (.COM) file execution facility.  Once a command
  327.                        file has completed execution, a warm boot is performed
  328.                        and control returns to the normal CCP.  (See note at
  329.                        the end of this file for a method to reboot POWER auto-
  330.                        matically.)
  331.  
  332.          A> [RUN VDO.COM]
  333.          A: 12= VDO     .COM
  334.  
  335.          A:RUN VDO     .COM (Y/N) ?[Y]Yes
  336.  
  337.  
  338. *********
  339.  
  340. SETDIR               The 'SET... ' commands set and reset the directory and
  341. SETREAD                read/write attributes of any file:  SETDIR causes a  
  342. SETSYS                 file to appear in a standard directory listing, while
  343. SETWRITE               SETSYS gives a file $SYS attributes; SETREAD makes a
  344.                        file read-only, while SETWRITE makes it read-write.
  345.                        File attributes appear in the directory listing as fol-
  346.                        lows: 
  347.  
  348.                                $SYS = '(' preceding the filename:  (MYFILE.COM
  349.                                $R/O = '*' following the filename:   MYFILE.COM* 
  350.                                $SYS and $R/O:                      (MYFILE.COM*  
  351.  
  352.                        $DIR and $R/W have no character designation: MYFILE.COM
  353.                        
  354.          A> [SETREAD VDO.COM]
  355.          A: 12= VDO     .COM
  356.  
  357.          A:VDO     .COM (Y/N) ?[Y]Yes
  358.  
  359.                      
  360. *********
  361.  
  362. SIZE                 Lists file parameters:  Number of sectors, size of file
  363.                        rounded to next 1k, space occupied on the disk (depends
  364.                        on group size of your system -- my system uses 2k
  365.                        groups), and total unused space.  The latter is useful
  366.                        to know when building libraries, as files are packed
  367.                        with no free space using LU, LUX, ARCHIVE and similar
  368.                        utilities.
  369.     
  370.  
  371.          A> [SIZE VDO.COM]
  372.          A: 17= MYFILE  .COM
  373.  
  374.          A:MYFILE  .COM (Y/N) ?[Y]YES - 22 sectors  3k  4k  10 unused sectors
  375.  
  376.  
  377. *********
  378.  
  379. STAT                 Lists disk free space and disk Read/Write status to the
  380.                        screen.  If the logged drive is A, giving the command
  381.                        STAT B: will list the free space for both A and B to the
  382.                        screen.
  383.  
  384.          A> [STAT B:]
  385.  
  386.          A: R/W Used space:           88K   Free space:              2K
  387.          B: R/O Used space:           78K   Free space:             12K
  388.  
  389.  
  390. *********
  391.  
  392. TEST                 Tests a disk for bad sectors (like FINDBAD) and locks out
  393.                        those sectors by combining them in a file $$$$$$$$.$$$
  394.                        with $R/O and $SYS attributes.
  395.  
  396.          A> [TEST] --- DISK CHECKSUM & TEST ---
  397.  
  398.          Disk checksum... D348
  399.          Bad blocks...... NONE
  400.  
  401.  
  402. *********
  403.  
  404. TYPE                 Lists an ASCII file to the CRT; continuous scrolling until
  405.                        a ^S is typed.
  406.  
  407.          A> [TYPE B:MYTEXT.TXT]
  408.          B:   4= MYTEXT.TXT
  409.         
  410.          B:MYTEXT  .TXT (Y/N) ?[Y]Yes
  411.  
  412.          The quick brown fox jumps over the lazy dogs. The quick brown fox
  413.          jumps over the lazy dogs.  The quick brown fox jumps over the lazy
  414.          .
  415.          .
  416.          .
  417.          the lazy dogs.
  418.  
  419.  
  420. *********
  421.  
  422. TYPEA                Lists ASCII characters in a binary file (.COM or .REL) to
  423.                        the CRT; continuous scrolling.
  424.  
  425.          A> [TYPEA B:N.COM]
  426.          B: 16= N       .COM 
  427.     
  428.          B:N       .COM (Y/N) ?[Y]Yes
  429.  
  430.          0100: .4.N.COM  Ver. 2
  431.          0110: .1  (c) Norman H
  432.          0120: . Strassner  2/2
  433.          0130: 0/84!..0"$.1"...
  434.          0140: !.."..D.^..!..^.
  435.          .
  436.          .
  437.          .
  438.          2D50: ................
  439.  
  440.  
  441. *********
  442.  
  443. TYPEH                Lists any file to the CRT in hex; continuous scrolling.
  444.  
  445.          A> [TYPEH B:N.COM]
  446.          B: 16= N       .COM
  447.  
  448.          B:N       .COM (Y/N) ?[Y]Yes
  449.  
  450.          0100: C334014E2E434F4D20205665722E2032
  451.          .
  452.          .
  453.          .
  454.          2D50 000000000000000000000000000000000
  455.  
  456.  
  457. *********
  458.  
  459. TYPEX                Lists binary file to the CRT in hex, with ASCII characters
  460.                        shown below the hex notation as they appear in the file;
  461.                        continuous scrolling.
  462.  
  463.          A> [TYPEX B:N.COM]
  464.          B: 16= N       .COM
  465.  
  466.          B:N       .COM (Y/N) ?[Y]Yes
  467.  
  468.          0100: C334014E2E434F4D20205665722E2032
  469.          ----: . 4 . N . C O M     V e r .   2
  470.          .
  471.          .
  472.          .
  473.          2D50: 00000000000000000000000000000000
  474.          ----: . . . . . . . . . . . . . . . . 
  475.  
  476.  
  477. *********
  478.  
  479. USER  n              Set user number from 0 to 31; note that CP/M normally
  480.                        accepts user numbers from 0 to 15 only.
  481.  
  482.          A> [USER 3]
  483.          A>             [[The system is now in User #3]]
  484.  
  485.  
  486. ********************************************************************************
  487.  
  488.  
  489. If the user wishes to CHECK, COPY, ERA, REN, SETxxx, or SIZE several files,
  490. s/he can do so by typing the command without parameters.  When the '?' prompt
  491. appears at the bottom of the list of files, s/he has the alternative of typing
  492. a single number, two or more numbers separated by spaces, two numbers separated
  493. by a dash ('-'), or a single number followed by a dash.  For example, if the
  494. command COPY is issued without parameters, a numbered list of files on the de-
  495. fault drive will be sent to the screen, followed by the '?' prompt.  The user
  496. then has the following alternatives, assuming the disk has 15 files:
  497.  
  498.          ? 4        Copy file #4
  499.          ? 4 6 7    Copy files #4, #6, and #7
  500.          ? 4-7      Copy files #4, #5, #6, and #7
  501.          ? 4-       Copy files #4 through the last file on the disk (#15)
  502.  
  503.  
  504. *********
  505.  
  506. To alter the default settings (see LOG), type 'LOG' at the prompt and deter-
  507. mine which settings are to be changed.  At the next prompt, type 'LOG [nnnnn]',
  508. where 'nnnnn' are the new settings.  NOTE:  The brackets must be included as
  509. part of the parameter(s).  For example:
  510.  
  511.          A> [LOG]
  512.  
  513.          D         If file exist A-overlay, B-back up, C-ask, D-skip
  514.          1         columns in directory
  515.          R (ON)    request Y/N on current file
  516.          V (OFF)   read after write flag
  517.          S (OFF)   show system files
  518.  
  519.          USER in use:00,    destination USER:00
  520.  
  521. If it is decided to overlay a file of the same name when copying from one disk
  522. to another, and further to have a two column directory, the command would be:
  523.  
  524.          A> [DIR [A2]]
  525.  
  526. One can also alter defaults when entering other commands:  'COPY [A2]'.
  527.  
  528.  
  529. *********
  530.  
  531.  
  532. Issuing a ^C while in POWER does not cause the system to exit POWER.  However,
  533. a system reset/cold boot as well as a warm boot will return control to the 
  534. normal CCP.  Since most programs issue a warm boot when through executing, it
  535. would be good to have the system automatically return to POWER.
  536.  
  537. A number of public domain programs (AUTOLOAD, AUTOBOOT, AUTOMOD, SETAUTO) are
  538. able to modify the CCP to automatically boot a program plus any parameters.  It
  539. is suggested that one of these programs be used on all disks containing POWER.
  540.  
  541. Since the user will generally want the same default settings at all times, the
  542. best procedure is to use one of the 'autoload' commands.  When changing the 
  543. CCP to automatically load POWER, use 'POWER LOG [nnnnn]' as the command line to
  544. be loaded.  Thus, every time a cold or warm boot is performed, POWER will be
  545. loaded with the desired parameters.
  546.  
  547. ********************************************************************************
  548.  
  549.  
  550.  
  551. Deke Barker
  552. 07SEP84
  553. d parameters.
  554.  
  555. ************************