home *** CD-ROM | disk | FTP | other *** search
/ CP/M / CPM_CDROM.iso / mbug / mbug106.arc / DBSRC102.LBR / DBSOURCE.HQP / DBSOURCE.HLP
Text File  |  1979-12-31  |  5KB  |  196 lines
  1.           DBSOURCE HELP  Version 1.02  3-1-85
  2.            (C) 1985 by Merlin R. Null
  3.  
  4.      DBSOURCE  will take  a  dBASE II  command file that has been
  5. encoded with ENCODE , Ashton-Tates's  DBCODE or with  Gene Head's
  6. DB-SQZ5 and generate  a runable source file.  DBSOURCE  can  also
  7. send the output to the printer or you may view the output on your
  8. console.
  9.  
  10.      This type of file is encoded for one of two reasons.  First,
  11. it protects the  program  file  from  being  viewed or  modified.
  12. Second, the encoded programs run about 30%  faster.  I feel  that
  13. the latter reason is far more important.  The level of protection
  14. that this type of encoding offers is only moderate.  Programs run
  15. faster because the files are partially tokenized and all comments
  16. are removed.
  17.  
  18.      Encoded command files are for use with  dBASE II version 2.4
  19. or higher.   A decoded file might require some translation to run
  20. on an earlier version of dBASE II.
  21.  
  22.            Calling a Directory Listing
  23.  
  24.      To call a directory from the title screen simply  enter  the
  25. drive you wish to list.
  26.  
  27. Filename.CMD or Drive:? A:
  28.  
  29.    This will list the directory of drive A and  give  the  prompt
  30. again.
  31.  
  32. Directory of drive A:
  33. FOO    .CMD    DBSOURCE.BAS    DBSOURCE.COM    BRUN    .COM    A10    .CMD
  34. ENCODE    .BAS    ENCODE    .COM    MBASIC    .COM    D    .COM    SAMPLE    .CMD
  35. BOOKS    .DBF    BOOKS    .FRM    DBASE    .COM    TERM    .DAT    CLEARSET.BAS
  36. CLEARSET.COM    DBASEMSG.TXT    DBASEOVR.COM    B4    .CMD    R2D2    .CMD
  37. INDENT4    .BAS    INDENT4    .COM    ELIZA    .BAS    A10    .SRC    A10    .BAK
  38. CLONE    .CMD    TEST    .CMD    CLONE    .SRC    A10    .OLD    DBSRC2    .BAS
  39. DBSRC2    .COM
  40. Filename.CMD or Drive:?
  41.  
  42.  
  43.  
  44.     The ZCPR like drive call of A; will also work to call the
  45. directory, even if you are not running ZCPR.
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.         Viewing an Encoded dBASE II File
  63.  
  64.     To view  the  encoded  dBASE II  command  file  "SAMPLE.CMD",
  65. simply type in the file name at the title screen prompt.
  66.  
  67. Filename.CMD or Drive:? SAMPLE.CMD
  68.  
  69.      Just use control S to stop the  scrolling  of  the  file  or
  70. control C to quit the program.   The file  to be viewed must have
  71. the extension .CMD
  72.  
  73.  
  74.  
  75.  
  76.  
  77.  
  78.  
  79.  
  80.  
  81.  
  82.                  Options
  83.  
  84. P    Send the output to the printer.  Does not generate a file.
  85. F    Send the output to a file.
  86. N    Turn off console output.  May be used only in combination
  87.     with P or F options.
  88.  
  89.      All  options  must  preceded  by  a  space.    Extra  spaces
  90. entered with the options  do  not  matter.   SAMPLE.CMD P F N  is
  91. equivalent to SAMPLE.CMD PFN.
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.              Direct output to Printer
  103.  
  104.      Use the P option to direct the output to the printer:
  105.  
  106. Filename.CMD or Drive? SAMPLE.CMD P
  107.  
  108.      This does not generate a disk file.   It will only print the
  109. file and display the output on the screen.
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.             Generating a Source File
  122.  
  123.      To generate a runnable source file from an encoded  dBASE II
  124. program, use the "F" option.
  125.  
  126. Filename.CMD or Drive:? SAMPLE.CMD F
  127.  
  128.      This will write a  file  called  SAMPLE.SRC.   If SAMPLE.SRC
  129. already exists, you will be prompted with the message:
  130.  
  131.             []=========[]
  132.             [] WARNING []
  133.             []=========[]
  134.  
  135.            SAMPLE.SRC already exists!
  136.  
  137.  
  138. Do you wish to overwrite SAMPLE.SRC?
  139.  
  140.  
  141.      If you answer YES, the old SAMPLE.SRC will be  erased  and a
  142. new SAMPLE.SRC will take it's place.  If you answer NO,  the  old
  143. SAMPLE.SRC will be renamed to SAMPLE.BAK and you will  have a new
  144. file named SAMPLE.SRC.  If a file named SAMPLE.BAK is already was
  145. present on the disk, it will be erased.
  146.  
  147.      All of the erasing and file name changes are done after  the
  148. generation of a SAMPLE.TMP file.   If there are  no  errors,  the
  149. SAMPLE.TMP file is renamed  to  SAMPLE.SRC  and  all  other  file
  150. changes done.   This  prevents  the  replacement of a file with a
  151. half finished one.  If all goes well, you should  never  see  the
  152. temporary file.  It will be present on the disk after DBSOURCE is
  153. run only if you are running it in the MBASIC interpreter and stop
  154. the operation in mid stream  with  control C.   In  the  compiled
  155. version, the temporary file is erased when a control C is entered
  156. and the entire operation is  aborted.   This can not be done with
  157. the interpreter  as control C suspends operation of DBSOURCE.  If
  158. you wish to continue with the interpreter, type  in  CONT.   This
  159. will pick up operation where you left off and finish the file.
  160.  
  161.  
  162.  
  163.      If everything goes OK and you have a SAMPLE.BAK on the disk,
  164. you should see the following messages:
  165.  
  166. Erasing SAMPLE.BAK
  167. Changing SAMPLE.SRC to SAMPLE.BAK
  168. Changing SAMPLE.TMP to SAMPLE.SRC
  169.  
  170.      This is just to let you know what is going  on.   With  many
  171. programs there is a rush to check the directory  after  operation
  172. to see if everything went OK.  Using DBSOURCE you will know  what
  173. file operations have been done.  The  "F" option may be used with
  174. the "N" option to suppress the console output.  Just enter:
  175.  
  176. Filename.CMD or Drive:? SAMPLE.CMD FN
  177.  
  178. This sends  the  output  go  only  to  the  new  file.   The  new
  179. SAMPLE.SRC  file  will  be generated slightly faster with the "N"
  180. option.
  181.  
  182.  
  183.      To run the source file, you mast  rename  it  to  SAMPLE.CMD.
  184. Do this only if you first either move the file  to  another  disk,
  185. or erase the existing SAMPLE.CMD file.
  186.  
  187.  
  188.  
  189.  
  190.  
  191.               END OF THE HELP FILE
  192.  
  193.  
  194.  
  195. T.   This
  196. will pick up operation where you l