home *** CD-ROM | disk | FTP | other *** search
/ CP/M / CPM_CDROM.iso / cpm / database / creator.lbr / CREATOR.DZC / CREATOR.DOC
Encoding:
Text File  |  1987-10-25  |  7.0 KB  |  148 lines
  1.   QUICK DOCUMENTATION FOR THE CREATOR AND REPORTOR
  2.        SEGMENTED VERSION FOR 48K CP/M SYSTEMS
  3.  
  4.      The   CREATOR  (tm)  and  REPORTOR  (tm)   are, 
  5. respectively,  a  database  program generator and  a 
  6. report program generator for Microsoft BASIC version 
  7. 5.2  or higher.  Versions of this program  are  also 
  8. available  for Radio Shack BASIC (I,II,  or III) and 
  9. for the IBM PC.
  10.      This program has been sold at prices as high as 
  11. $295  since February 1980;  there is no  resemblance 
  12. between this program and another program called  the 
  13. CREATOR,  being sold by STC since June 1982.  A suit 
  14. is  pending  against STC for their use of  the  name 
  15. CREATOR.
  16.      To  run the CREATOR,  just enter BASIC and  run 
  17. MENU;  choose  the  'run CREATOR' option  from  that 
  18. menu. Or, enter BASIC and run CREATOR directly.
  19.      You  should customize the CREATOR and  REPORTOR 
  20. for your particular terminal,  or the 'clear screen' 
  21. attribute  will not work correctly in your generated 
  22. programs. This set-up code is explained in the first 
  23. few lines of the CREATOR.BAS and REPORTOR.BAS.   The 
  24. standard  set-up is for the Televideo 910  terminal, 
  25. but  by the time  you  get a copy it may have   been  
  26. changed    by   someone  else.   Please  leave   the 
  27. explanations alone so anyone  getting a copy of  the 
  28. CREATOR from you  will be able to figure out what to 
  29. do.
  30.      This version differs from the standard versions 
  31. of  the CREATOR and REPORTOR.  There are  additional 
  32. files,   called   overlays,   for  the  CREATOR  and 
  33. REPORTOR.  These files are CREATOR.OVL, CREATOR.OVR, 
  34. and  REPORTOR.OVL.  These files must be  present  in 
  35. order  to  run the specified programs;  the  CREATOR 
  36. overlays for the CREATOR,  and the REPORTOR  overlay 
  37. for the REPORTOR.
  38.      The overlays will reduce the memory required to 
  39. run the CREATOR and REPORTOR.  48K systems should be 
  40. able  to  run the programs  successfully;  even  44K 
  41. systems might be able to run the programs,  though I 
  42. do not recommend use on 44K systems, since you might 
  43. not   be   able  to  run  the   generated   programs 
  44. themselves.
  45.      You  may use record lengths up to 256 bytes and 
  46. up  to  45 fields in each  data  file.  The  program 
  47. indicates  that  up to 47 fields are  possible  (and 
  48. they   might  be,  depending on the field types  and 
  49. edits),   but  that cannot be guaranteed under CP/M. 
  50. 45 fields should always be safe, though.
  51.      If  your record length is bigger than 128,  you 
  52. must remember to enter BASIC with the /S:XXX  switch 
  53. set  for the actual record length you intend to use. 
  54. If you don't, you will get an error message when you 
  55. try to open your data file.
  56.      The  sort program which works with the  CREATOR 
  57. and  REPORTOR  is  not in  the  public  domain.  Two 
  58. versions  of  that sort are  available.  The  first, 
  59. called CHEAPSORT (tm) level I, will sort on up to 50 
  60. fields  at once,  ascending or descending,  and  can 
  61. take  any  data  type used  in  Microsoft  BASIC  or 
  62. FORTRAN,  including  derived types (such as are used 
  63. in the CREATOR or PROGEN). Sort speed depends on the 
  64. number and type of keys, record lengths, disk access 
  65. speed, media type, etc., but varies from 200 to 1100 
  66. records per minute. This sort can handle up to 32767 
  67. records per file, and each record may be up to 32767 
  68. bytes  in  length  (limited  by  memory  available). 
  69. CHEAPSORT level I costs $11.00,  and comes with  the 
  70. standard CP/M package, costing $40.00.
  71.      Level  II  CHEAPSORT  comes  with  a   separate 
  72. version  capable of reading a command file,  but  is 
  73. otherwise  the  same  as level  I.  Level  II  costs 
  74. $25.00.
  75.      Both  sorts require  fixed-length,  fixed-field 
  76. records (the kind CREATOR writes,  and the kind most 
  77. Microsoft  BASIC  programs use).  Neither sort  will 
  78. handle  sequential  or  CBASIC-style  random  files. 
  79. After  all,  who  wants to use  those  space-wasting 
  80. record types, anyway?
  81.      Source code is available for each sort.  Source 
  82. code  for  Level I costs an additional  $11.00,  and 
  83. source code for level II costs an additional $25.00. 
  84. With  a little effort,  the sorts could probably  be 
  85. modified  to  handle CBASIC random  files  (but  not 
  86. sequential).  I'm  certainly  not  going to  do  it, 
  87. though .  .  .  I don't want to encourage the use of 
  88. CBASIC  for anything,  given the kind of BASIC it is 
  89. (incredibly slow and a real disk space-waster).
  90.      If  you got either version of the sort  from  a 
  91. friend  and your conscience is bothering  you,  just 
  92. send  me  $5 (level I) or $10 (level II)  and  we'll 
  93. call it square.  I don't want to know who you got it 
  94. from,  either.  Just  think of it as an  'unofficial 
  95. dealer'  plan.  I really want to know how  the  sort 
  96. works out, and I want comments on its performance so 
  97. I can plan enhancements in the future:  since people 
  98. with 'illegal' copies are reluctant to speak up (and 
  99. probably  outnumber  'legal' users),  I figure  that 
  100. making it easy to become legal will benefit both  of 
  101. us.  I'm not ripping anyone off at these prices,  so 
  102. please . . . make it 'legal', o.k.?
  103.      COMPLETE written documentation for the  CREATOR 
  104. and  REPORTOR is available for $10 + $1 postage  and 
  105. handling  in  the U.S.,  Canada,  and  Mexico.  Make 
  106. checks or money orders payable in U.S.  funds  drawn 
  107. on a U.S.  bank,  please.  Otherwise,  I usually net 
  108. about  30%  of the face amount.  Not too  good!  You 
  109. don't have to wait for your checks to clear, either.
  110.      I  have  a real bundle of  other  software  for 
  111. sale;   the  CREATOR,  REPORTOR  and  CHEAPSORT  are 
  112. available  for  TRSDOS and MSDOS  (IBM  PCDOS),  and 
  113. approximately  20 other programs are also for  sale. 
  114. Among  them are the advanced version of the  CREATOR 
  115. (called PROGEN/REPGEN:  $99.00, for CP/M and PCDOS), 
  116. a  spelling checker/indexer,  the PBASIC BASIC  pre-
  117. processor  (as  reviewed by Jerry Pournelle  in  the 
  118. April  issue of BYTE magazine),   a random file data 
  119. extractor  (compatible with most  word  processors),  
  120. and many others. Please write for my catalog.
  121.      All my software is guaranteed for thirty  days. 
  122. If  you  are not satisfied with its performance  for 
  123. any reason, just return it for a full refund of your 
  124. purchase price.  That's my complete guarantee;  seen 
  125. anything else like it lately?
  126.      A newsletter for CREATOR users is available for 
  127. $10  per year.  It will be published  quarterly.  It 
  128. will  include hints on enhancing  performance,  news 
  129. from  users on the applications they have generated, 
  130. 'bug' reports and fixes (I hope there aren't any  of 
  131. those!)  and information on new versions planned  or 
  132. released.
  133.      For information,  orders,  or a catalog, please 
  134. write to:
  135.  
  136. T.N.T. Software, Inc.
  137. 34069 Hainesville Road
  138. Round Lake, IL 60073
  139.  
  140. Best  wishes  on your use of  my  software;  may  it 
  141. perform  to your expectations and not merely to  its 
  142. design limitations.
  143.  
  144. Bruce W.Tonkin
  145. Round Lake, IL
  146. May 15, 1983
  147.  
  148.