home *** CD-ROM | disk | FTP | other *** search
/ DP Tool Club 8 / CDASC08.ISO / VRAC / CONADD12.ZIP / CONADD.DOC < prev    next >
Encoding:
Text File  |  1993-08-30  |  17.0 KB  |  547 lines
  1.     │
  2.     │
  3.     │
  4.     │
  5.     │
  6.     │
  7.     │
  8.     │
  9.     │
  10.     │
  11.     │
  12.     │
  13.     │
  14.     │
  15.     │
  16.     │
  17.     │
  18.     │    CONADD v 1.2 (c) CONCEPT SYSTEMS 1993
  19.     │
  20.     │    Written by Paul Giraud.
  21.     │
  22.     │    DOCUMENTATION FILE
  23.     │
  24.     │
  25.     │
  26.     │
  27.     │
  28.     │
  29.     │
  30.     │
  31.     │
  32.     │
  33.     │
  34.     │
  35.     │
  36.     │
  37.     │
  38.  
  39.  
  40. For ordering information, see the file REGISTER.FRM.  included in this
  41. archive.
  42.  
  43.  
  44. First all the legal stuff:
  45.  
  46.  
  47. LICENSE AGREEMENT AND WARRANTY DISCLAIMER.
  48. ------------------------------------------
  49.  
  50. You should carefully read  the  following  terms and conditions before
  51. using this software.  Use of this software indicates  your  acceptance
  52. of  these terms and conditions.  If you do not agree with them, do not
  53. use the software.
  54.  
  55.  
  56. SHAREWARE VERSION.
  57. ------------------
  58.  
  59. You are hereby licensed to: use  the Shareware Version of the software
  60. for a 30 day evaluation period; make as many copies of  the  Shareware
  61. version  of  this  software  and documentation as you wish; give exact
  62. copies of the original Shareware version to anyone; and distribute the
  63. Shareware version of the software  and documentation in its unmodified
  64. form via electronic means.  There is no charge for any of the above.
  65.  
  66. You  are  specifically  prohibited  from   charging,   or   requesting
  67. donations, or any such copies, however made; and from distributing the
  68. software  and/or  documentation  with  other  products  (commercial or
  69. otherwise) without prior written permission, subject to the conditions
  70. in this license, without specific written permission.
  71.  
  72.  
  73. EVALUATION AND REGISTRATION
  74. ---------------------------
  75.  
  76. This is not  free  software.   This  license  allows  you  to use this
  77. software for evaluation purposes without charge for  a  period  of  30
  78. days.   If  you use this software after the 30 day evaluation period a
  79. registration fee of  R30.00/US$30  plus  $5  shipping  and handling is
  80. required.  Payments can be in South African Rands by Cheque or  Postal
  81. Order, or in US Dollars via  bank  draft  or by Credit Card, we accept
  82. VISA & Mastercard.
  83.  
  84. Send payment to:
  85.  
  86.         P GIRAUD
  87.         32 Burn Street
  88.         Waverley
  89.         Johannesburg
  90.         South Africa
  91.         2090
  92.  
  93. When  payment  is  received I will post a private message to you on my
  94. BBS - The  Concept  BBS,  with  the  registration  number  of your new
  95. purchase.
  96.  
  97.  
  98. CREDIT CARD REGISTRATIONS.
  99. --------------------------
  100.  
  101. I you wish to register by credit card please refer to the REGISTER.FRM
  102. document included in the archive
  103.  
  104. One registered copy of CONADD may be dedicated to a single  person  or
  105. BBS  system  who  uses  the  software on one or more computers or to a
  106. single workstation used by multiple people.
  107.  
  108. You may access the  registered  version  of  CONADD through a network,
  109. provided that you have obtained individual licenses for  the  software
  110. covering  all  workstations  that will access the software through the
  111. network.
  112.  
  113.  
  114. NON REGISTERED EVALUATION VERSION.
  115. ----------------------------------
  116.  
  117. Until this program is registered there are certain areas that will not
  118. be accessible.  In the case of CONADD only two features are crippled:
  119.  
  120.     The program will not utilize any TEMP path specification specified
  121.     in the configuration file.
  122.                
  123.     This program will only operate  on  TEN archives in each run until
  124.     registered.
  125.  
  126. The  program  will  also  display  UNREGISTERED  EVALUATION   in   the
  127. registration   space  on  the  main  screen.   registration  has  its'
  128. advantages ......
  129.  
  130.  
  131. DISCLAIMER OF WARRANTY.
  132. ----------------------
  133.  
  134. This software and the accompanying files  are sold "as is" and without
  135. warranties  as  to  performance  of  merchantability  or   any   other
  136. warranties whether expressed or implied.
  137.  
  138. Because  of  the various hardware and software environments into which
  139. CONADD may be used, no warranty of fitness for a particular purpose is
  140. offered.
  141.  
  142. Good data processing procedure dictates that any program be thoroughly
  143. tested with non-critical data  before  relying  on  it.  The user must
  144. assume the entire risk of using the program.   Any  liability  of  the
  145. seller will be limited exclusively to product replacement or refund of
  146. purchase price.
  147.  
  148. INTRODUCTION.
  149. -------------
  150.  
  151. Ever had the daunting task of locally uploading a bunch of  new  files
  152. onto  your  BBS and had to use PCBoard's local upload ???  Well CONADD
  153. was born as a result of  this  very reason.  I am faced with literally
  154. 100s of upload on a weekly basis and doing it  via  the  local  upload
  155. facility used to take hours ....
  156.  
  157. CONADD  cuts  this  time into minutes.  Used in conjunction with CONINS
  158. you can locally upload 100 files  into your new upload directory or in
  159. fact anywhere on your board that your  want,  and  at  the  same  time
  160. update  the  DIR file list for that area.  This version of CONADD will
  161. work with any BBS DIR File list  provided  it can find it and you know
  162. what info must go where in the list.
  163.  
  164.  
  165. PROGRAM REQUIREMENTS.
  166. ---------------------
  167.  
  168. The program requires the following:
  169.  
  170.     512 KB RAM 
  171.     PKZIP.EXE & PKUNZIP.EXE v 1.1, 1.93A, 2.04G
  172.  
  173.  
  174. INSTALLATION.
  175. -------------
  176.  
  177. The self extracting CONADD archive contains the following files :
  178.  
  179.     CONADD  .COM    - The CONADD executable file.
  180.     CONADD  .CFG    - Sample configuration file.
  181.     CONADD  .DOC    - The CONADD documentation.
  182.     CONADD  .HST    - CONADD Version history file
  183.     README  .1ST    - New Features not included in this document.
  184.     REGISTER.FRM    - Concept Systems Software registration form.
  185.     PRODUCTS.CON    - Concept Systems Software catalogue.
  186.     FILE_ID .DIZ    - Description file.
  187.  
  188. Note that the archive should display -AV when extracting the files, if
  189. not the archive has been tampered with.  The latest version of  CONADD
  190. can be downloaded from my bulletin board -
  191.  
  192.     The Concept BBS
  193.     Phone : (011) 440-6246
  194.     Speed : 2400 - 38400
  195.     Hours : 24 hours.
  196.  
  197. All  the  Concept  Systems  software  is available in the Concept Soft
  198. Conference - Conference 10.
  199.  
  200. Installation is easy - if  you  have  a  utility directory you may use
  201. this directory otherwise create a directory for CONADD and  unzip  the
  202. archive into whichever directory you want.
  203.  
  204. Placing  the executable file into the DOS PATH will make CONADD easier
  205. to use.  Please ENSURE that the configuration file that you create  is
  206. in  your  DOS path - or CONADD will not work as described - in fact it
  207. will probably hang up your machine.
  208.  
  209. The next thing to do is  create  or modify the CONADD.CFG file to suit
  210. your  system.   Please  note  that  unlike  my  other  utilities   the
  211. configuration  file  name  can be changed as you might like to utilize
  212. CONADD with several different CONFIG files.  Also please note that the
  213. config need not be in the  same  directory as the executable, but when
  214. executing CONADD the configuration file must be on the same  drive  as
  215. CONADD or the program will not work.
  216.  
  217. '----------------------------------------------------------------------------
  218. ' CONFIG FILE LAYOUT
  219. '
  220. ' CONADD  v 1.1 (c) Concept Systems 1993
  221. '────────────────────────────────────────────────────────────────────────────
  222. '  Line 1  - Register Name
  223. '  Line 2  - Register Number
  224. '  Line 3  - DIR File Path and Name
  225. '  Line 4  - File Path for FILES
  226. '  LIne 5  - Off Line Path
  227. '  Line 6  - Path to PKZIP
  228. '  Line 7  - ZIP Version
  229. '  Line 8  - TEMP Path
  230. '  Line 9  - Size column
  231. '  Line 10 - Date column
  232. '  Line 11 - PCBoard "|" column
  233. '  Line 12 - Descrption column
  234. '  Line 13 - Date stamp type | TODAY | OLD (archive date) (T|O)
  235. '  Line 14 - SCAN Archives (Y/N)
  236. '  Line 15 - Path to SCAN.EXE (if 14 is no then NONE)
  237. '  Line 16 - SCAN PARAMETERS  (if 14 is no then NONE)
  238. '  Line 17 - Include Zip COMMENT (Y/N)
  239. '  Line 18 - Path & Name of comment file (if 17 = NO then NONE)
  240. '  Line 19 - Use CONADD Log facility (Y/N)
  241. '  Line 20 - Locate & name of LOGFILE
  242. ────────────────────────────────────────────────────────────────────────────
  243.  
  244. The configuration file consists of twenty lines  and  ONLY  THE  FIRST
  245. TWENTY LINES of this file are read by the program.
  246.  
  247.  
  248. Line 1 :- Registration Name
  249. ---------------------------
  250.  
  251. If you have  registered  CONADD  the  name  that  you completed on the
  252. registration form should be inserted onto this line - EXACTLY  as  you
  253. entered it on the form.
  254.  
  255. If  not  registered  enter  your  name  on this line or leave the line
  256. blank.
  257.  
  258.  
  259. Line 2 :- Registration Number
  260. -----------------------------
  261.  
  262. After registering CONADD you  will receive a personalized registration
  263. number - enter this number on this line.  If  you  haven't  registered
  264. either leave the line blank or enter 00000000.
  265.  
  266.  
  267. Line 3 :- DIR File Path & Name
  268. ------------------------------
  269.  
  270. This line points CONADD to the path and location of the FILE LIST that
  271. it must update.  If the FILE LIST does not exist CONADD will create it
  272. for you automatically.
  273.  
  274. eg: C:\PCB\LST\DIR001
  275.  
  276.  
  277. Line 4 :- Move File Path
  278. ------------------------
  279.  
  280. This line points CONADD to the path where you wish the  files  in  the
  281. current  directory  moved to, providing everything is OK.  CONADD will
  282. check the ARCHIVE for two things:
  283.  
  284.     1.  FILE_ID.DIZ - If the  DIZ  file  is not found CONADD will move
  285.         the  ARCHIVE  to  an OFFLINE directory that you specify in the
  286.         next line of the CONFIG FILE.
  287.         
  288.     2.  ARCHIVE INTEGRITY - If the  ARCHIVE is OK CONADD will move the
  289.         file.  If not  CONADD  will  move  the  file  to  the  OFFLINE
  290.         directory
  291.         
  292. eg: C:\PCB\UPLOAD
  293.  
  294.         
  295. Line 5 :- OFFLINE Path.
  296. -----------------------
  297.  
  298. Should  the  archive  to  be  moved not have a DIZ file or the archive
  299. integrity is bad CONADD  will  move  the  file into this directory for
  300. scrutiny by yourself.
  301.  
  302. eg: C:\PCB\OFFLINE
  303.  
  304.  
  305. Line 6 :- PKZIP.EXE Path
  306. ------------------------
  307.  
  308. Enter  the  path to PKZIP.EXE on this line - if left blank the program
  309. will not work.  CONADD will verify  that PKZIP exists at this location
  310. so please enter the correct path.
  311.  
  312.     eg : C:\ZIP
  313.          C:\ZIP\
  314.  
  315.  
  316. Line 7 :- PKZIP.EXE Version
  317. ---------------------------
  318.          
  319. Due to the fact that PKZIP v 1.1 behaves a little differently  to  the
  320. newer  version  2.x pf PKZIP this line distinguishes which version you
  321. are currently using.  If blank CONADD will default to version handling
  322. and if you are using PKZIP v 1.1 the screens WILL BE OVERWRITTEN.
  323.  
  324.     For PKZIP v 1.1 enter a 1
  325.         PKZIP v 2.x enter a 2
  326.  
  327.  
  328. Line 8 :- TEMP Path.         
  329. --------------------
  330.  
  331. If you have a RAM drive  or  fast  TEMP drive CONADD will utilize this
  332. drive for searches - enter the path to this drive.  If left blank  the
  333. program  will  use  the  DOS  default defined in the PC's environment.
  334. (Registered version only)
  335.  
  336.     eg D:\
  337.        E:\TEMP\ 
  338.  
  339.  
  340. Line 9 :- File list SIZE Column Start.
  341. --------------------------------------
  342.  
  343. This item configures the column where CONADD will insert the file size
  344. of the archive currently being processed.  In PCBoard  DIR  Lists  the
  345. default is column 14
  346.  
  347. PCBoard Format:
  348.  
  349.          1           2         3           4         5           6
  350. 1234567890123456789012345678901234567890123456789012345678901234567890
  351. TEST.ZIP     xxxxxxxx    xxxxx | This is where the description starts
  352.              │
  353.  
  354.              The size column in a PCB DIR list file
  355.  
  356.  
  357. Line 10 :- File list DATE Column Start.
  358. ---------------------------------------
  359.  
  360. This item configures the column where CONADD will insert the file date
  361. of the archive currently being processed.  In PCBoard  DIR  Lists  the
  362. default is column 24
  363.  
  364. PCBoard Format:
  365.  
  366.          1           2         3           4         5           6
  367. 1234567890123456789012345678901234567890123456789012345678901234567890
  368. TEST.ZIP     xxxxxxxx    xxxxx | This is where the description starts
  369.                          │
  370.  
  371.              The date column in a PCB DIR list file
  372.  
  373.  
  374. Line 11 :- File list SEPARATOR column START (PCBoard specific)
  375. --------------------------------------------------------------
  376.  
  377. This item configures  the  column  where  CONADD  will insert the file
  378. separator of the archive currently being processed.   In  PCBoard  DIR
  379. Lists the default is column 32 and the default separator is '|'
  380.  
  381. PCBoard Format:
  382.  
  383.          1           2         3           4         5           6
  384. 1234567890123456789012345678901234567890123456789012345678901234567890
  385. TEST.ZIP     xxxxxxxx    xxxxx   This is where the description starts
  386.                                  |
  387.                                  │
  388.  
  389.              The file separator in a PCB DIR list file
  390.  
  391.  
  392. Line 12 :- File list DESCRIPTION column START.
  393. ----------------------------------------------
  394.  
  395. This item configures  the  column  where  CONADD  will insert the file
  396. description  of the the archive currently being processed.  In PCBoard
  397. DIR Lists the default is column 34.
  398.  
  399. PCBoard Format:
  400.  
  401.          1           2         3           4         5           6
  402. 1234567890123456789012345678901234567890123456789012345678901234567890
  403. TEST.ZIP     xxxxxxxx    xxxxx   This is where the description starts
  404.                                |
  405.                                  │
  406.  
  407.              The file separator in a PCB DIR list file
  408.  
  409.  
  410. Line 13 :- Date update FLAG.
  411. ----------------------------
  412.  
  413. By default CONADD will add the date  of the oldest file in the archive
  414. being processed to the DIR File List.  I have had requests  while  the
  415. program  was  in  BETA  for  a  switch to be added so that CONADD will
  416. update the file list with the current system date.  This has been done
  417. and the syntax is as follows.
  418.  
  419. eg: T - Tells CONADD to update the list with the current system date
  420.  
  421.     O - or a blank  tells  CONADD  to  update the list with the oldest
  422.         date found in the archive.
  423.         
  424.  
  425. Line 14:- SCAN Archives
  426. -----------------------
  427.  
  428. Conadd  now  has  the  facility to scan an archive for virii - in this
  429. column type either Y or N. Bu  typing Y CONADD will check each archive
  430. for virii using the VIRUS SCANNER - SCAN.EXE  by  McAffe.   Note  that
  431. this  is the only virus scanner supported by CONADD currently.  Should
  432. you want to disable this feature type an N in this line.
  433.  
  434.  
  435. Line 15:- PATH to SCAN.EXE
  436. --------------------------
  437.  
  438. If you have selected Y in  line  14,  scan for virus, on line 15 enter
  439. the drive and path to your SCAN.EXE, this field may contain a trailing
  440. backslash. If you answered N in line 14 then leave this field blank.
  441.  
  442.     eg:
  443.  
  444.         H:\ZIP\
  445.         
  446.  
  447. Line 16:- SCAN.EXE command line parameters.
  448. -------------------------------------------
  449.  
  450. If you  have  selected  Y  in  line  14,  scan  for  virus,  enter the
  451. parameters to use with the SCAN.EXE, a full list of parameters may  be
  452. gleaned from the SCAN documentation.
  453.  
  454.     eg:
  455.         /NOMEM /NOPAUSE /NOBREAK 
  456.         
  457.  
  458. Line 17:- Insert .ZIP COMMENT.
  459. ------------------------------
  460.  
  461. If you want CONADD  to  include  a  .ZIP  comment  -  answer Y in this
  462. position. If you wish to exclude this feature type an N.
  463.  
  464.  
  465. Line 18:- Name and location of .ZIP comment.
  466. --------------------------------------------
  467.  
  468. If you answer Y in line 17, Insert .ZIP Comment, you must  insert  the
  469. drive,  path  and  filename  of  the text file to add to the ZIP files
  470. being processed. If you answered N then leave this line blank
  471.  
  472.     eg:
  473.         H:\UTIL\CONADD.CMT
  474.  
  475.  
  476. Line 19:- Enable CONADD Logging.
  477. --------------------------------
  478.  
  479. By default the CONADD logging  facility  is  turned  off - if you wish
  480. CONADD to log your sessions enter a Y in this line.
  481.  
  482.  
  483. Line 20:- Name and location of CONADD Log File.
  484. -----------------------------------------------
  485.  
  486. If you answered Y in line 19, Enable CONADD Logging,  you  must  enter
  487. the  drive,  path and file name of the logfile that you wish CONADD to
  488. write to.
  489.  
  490.     eg:
  491.         H:\LOG\CONADD.LOG
  492.  
  493.  
  494. USING CONADD.
  495. -------------
  496.  
  497. Using the program is simple:
  498.  
  499. 1. Change to the directory where your archives are located.
  500.  
  501. 2. Ensure that you complete the configuration file correctly.
  502.  
  503. 3. On the command line type:
  504.  
  505.     CONADD [Drive:\Path\Name of CONFIG file.]
  506.     
  507. eg  CONADD C:\LIST\CONADD.CFG
  508.  
  509.  
  510. Press enter and off you  go  -  it's that simple.  CONADD will display
  511. its' progress on the screen.
  512.  
  513. Please note as I mentioned earlier  ensure that the CONADD.CFG file on
  514. the same drive that CONADD is executed from or the  program  will  not
  515. work and will report an error.
  516.  
  517. This version of CONADD should work with most type of BBS lists and  if
  518. it  doesn't  and you would really like it to please contact and I will
  519. do what I can to help.
  520.  
  521.  
  522. SUPPORT.
  523. --------
  524.  
  525. Should you wish to  comments  or  make recommendations, Please leave a
  526. message on the above mentioned board, I will answer any mail  left  on
  527. the  board - and will certainly entertain an new ideas for the program
  528. should there be any.  Mail should  be  address to either SYSOP or PAUL
  529. GIRAUD when left on the BBS.
  530.  
  531. A plea to all users - please  read the DOCS before using CONADD I have
  532. been inundated with calls from users that say that CONADD doesn't work
  533. and  only  to  find  that  when  following  the  correct  installation
  534. procedures the program works fine.
  535.  
  536.  
  537. TIPS.
  538. -----
  539.  
  540. If you are in a hurry  I  suggest turning off the VIRUS SCAN FEATURE
  541. and ZIP COMMENT FEATURES, they will slow down the whole process.
  542.  
  543. If you are a registered user of CONADD I highly recommend  that  you
  544. install  a  RAMDRIVE  and  select  the same as your temporary drive,
  545. CONADD will  actually  utilize  the  RAMDRIVE  and  the  whole SCAN,
  546. COMMENT and insertion procedure will speed up about 30-40%.
  547.